Cette page a été traduite par l'API Cloud Translation.

Mises en correspondance de blocs d'annonces

Les mappages de blocs d'annonces sont des paramètres de configuration tiers qui correspondent à un bloc d'annonces AdMob et lui permettent d'envoyer une requête d'annonce à un réseau publicitaire tiers.

Lorsque vous créez un groupe de médiation, les mises en correspondance de blocs d'annonces sont utilisées comme paramètre pour chaque ligne de groupe de médiation et comme paramètres pour le bloc d'annonces spécifié afin d'effectuer des demandes de réseau publicitaire 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 groupe de médiation. Une fois la création effectuée, vous pouvez lister tous les mappages de blocs d'annonces et les utiliser comme paramètre lorsque vous créez ou mettez à jour des lignes de groupe de médiation avec de nouveaux mappages 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:

Portée	Signification
`https://www.googleapis.com/auth/admob.monetization`	Consultez, créez et modifiez 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 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.

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

curl (ligne de commande)

Requêtes à l'aide de curl

Chargez le fichier de secrets 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 l'invitation, 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 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 permettant de 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 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
```

Répertorier les sources d'annonces.

Pour obtenir des informations sur la source d'annonces AdMob, remplacez pub-XXXXXXXXXXXXXXXX par votre ID d'éditeur. Consultez les instructions pour savoir comment 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",
   }
 ]
}

Répertoriez les adaptateurs.

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

Exécutez 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"
     }]
  }]
}

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

Remplacez YYYYYYYYYY par le fragment d'ID de votre bloc d'annonces. Le fragment d'ID de bloc d'annonces correspond aux 10 derniers chiffres de l'ID de votre bloc d'annonces, qui se présente sous 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

Répertoriez toutes les mises en correspondance de blocs d'annonces.

Remplacez YYYYYYYYYY par le fragment de l'ID de votre bloc d'annonces. Le fragment d'ID de bloc d'annonces correspond aux 10 derniers chiffres de votre ID de bloc d'annonces au 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",
     }
   }
}