Mises en correspondance de blocs d'annonces

Les mappages de blocs d'annonces sont des paramètres de configuration tiers qui sont mappés sur un bloc d'annonces AdMob et lui permettent d'envoyer une demande d'annonce à un réseau publicitaire tiers.

Lorsque vous créez un groupe de médiation, les mises en correspondance des blocs d'annonces sont utilisées comme paramètre pour chaque ligne du groupe de médiation. Elles servent de paramètres pour le bloc d'annonces spécifié afin d'envoyer des demandes à des réseaux publicitaires tiers. Contrairement à l'interface utilisateur AdMob, les mises en correspondance de blocs d'annonces doivent être créées indépendamment des groupes et des lignes de groupe de médiation. Une fois les mises en correspondance créées, vous pouvez les lister toutes et les utiliser comme paramètre lorsque vous créez ou mettez à jour des lignes de groupe de médiation avec de nouvelles mises en correspondance de blocs d'annonces.

Exemples

Une fois les identifiants OAuth 2.0 créés, vous pouvez commencer à utiliser l'API AdMob. Pour demander l'accès via OAuth 2.0, votre application aura également besoin des informations sur le champ d'application.

Voici les informations sur le champ d'application OAuth 2.0 :

Champ d'application Signification
https://www.googleapis.com/auth/admob.monetization Consulter, créer et modifier vos paramètres de monétisation AdMob
https://www.googleapis.com/auth/admob.readonly Consultez toutes les données AdMob. Il peut s'agir d'informations sur le compte, de paramètres d'inventaire et de médiation, de rapports et d'autres données. Aucune donnée sensible (paiements, détails de vos campagnes, etc.) ne sera concernée.

Pour commencer à créer votre première mise en correspondance de blocs d'annonces :

curl (ligne de commande)

Requêtes utilisant curl

  1. Chargez le fichier de code secret du client et générez des identifiants d'autorisation.

    La première fois que vous effectuez cette étape, vous êtes invité à accepter une invite d'autorisation dans votre navigateur. Avant d'accepter, assurez-vous d'être connecté avec un compte Google ayant accès à l'API AdMob. Votre application sera autorisée à accéder aux données du compte actuellement connecté.

    Pour l'authentification et l'autorisation, nous vous recommandons d'utiliser oauth2l, un outil de ligne de commande simple pour travailler avec Google OAuth 2.0. Installez oauth2l et exécutez la commande ci-dessous, en remplaçant path_to_credentials_json par le chemin d'accès à un fichier credentials.json que vous téléchargez lorsque vous enregistrez votre application cloud. Lors de la première exécution, la commande vous guide tout au long du flux d'autorisation OAuth 2.0. Les exécutions suivantes actualisent automatiquement le jeton.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Lister les sources d'annonces.

    Obtenez des informations sur les sources d'annonces AdMob en remplaçant pub-XXXXXXXXXXXXXXXX par votre référence éditeur. Consultez les instructions pour trouver votre référence éditeur.

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Exemple de réponse :

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. Répertoriez les adaptateurs.

    Remplacez SSSSSSSSSSSSSSSSSSSS par l'ID de la source d'annonces pour les adaptateurs qui vous intéressent.

    Utilisez la commande suivante pour obtenir la liste des adaptateurs :

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Exemple de réponse pour la source d'annonces du réseau AdMob avec l'ID 5450213213286189855 :

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. Créez une mise en correspondance de blocs d'annonces.

    Remplacez YYYYYYYYYY par le fragment de votre ID de bloc d'annonces. Le fragment d'ID de bloc d'annonces correspond aux 10 derniers chiffres de votre ID de bloc d'annonces, qui suit le format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consultez les instructions pour trouver l'ID de votre bloc d'annonces.

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. Lister toutes les mises en correspondance de blocs d'annonces

    Remplacez YYYYYYYYYY par le fragment de votre ID de bloc d'annonces. Le fragment d'ID de bloc d'annonces correspond aux 10 derniers chiffres de l'ID de votre bloc d'annonces au format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consultez les instructions pour trouver l'ID de votre bloc d'annonces.

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}