Mises en correspondance de blocs d'annonces

Les mises en correspondance de blocs d'annonces sont des paramètres de configuration tiers qui correspondent à un bloc d'annonces AdMob et lui permettent d'envoyer une demande d'annonce à un réseau publicitaire tiers.

Lors de la création d'un groupe de médiation, les mises en correspondance de blocs d'annonces sont utilisées comme paramètre pour chaque ligne du groupe de médiation . Elles permettent au bloc d'annonces spécifié d'envoyer des requêtes à des réseaux publicitaires tiers. Contrairement à l'interface utilisateur AdMob, les mises en correspondance de blocs d'annonces doivent être créées indépendamment en dehors des groupes de médiation et des lignes de groupes de médiation. Une fois créées, vous pouvez répertorier toutes les mises en correspondance de blocs d'annonces et les utiliser comme paramètre lorsque vous créez ou mettez à jour des lignes de groupes 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 Consulter toutes les données AdMob Il peut s'agir d'informations sur votre compte , de vos paramètres d'inventaire et de médiation, de vos rapports et d'autres données. Aucune donnée sensible (paiements, détails de vos campagnes, etc.) ne sera concernée.

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

curl (ligne de commande)

Requêtes à l'aide de curl

  1. Chargez le fichier de secrets 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é à un compte Google qui a accès à l'API AdMob. Votre application sera autorisée à accéder aux données au nom 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 un chemin d'accès à un credentials.json fichier 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. Répertoriez 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 votre ID de 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. Répertoriez 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 votre ID de bloc d'annonces, qui suit le format "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consultez les instructions pour trouver votre ID de 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",
     }
   }
}