Groupes de médiation

L'API AdMob vous permet de créer, de lister et de mettre à jour des groupes de médiation, y compris :

  • Spécifier le ciblage des groupes de médiation, y compris le ciblage par région, format, plate-forme et IDFA
  • Ajouter des lignes de groupe de médiation à un groupe de médiation existant
  • Afficher les groupes de médiation qui font partie d'un test A/B de médiation et les lignes de groupe de médiation qui appartiennent à chaque variante : A ou B

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.

Créer

Pour créer un groupe de médiation, vous devez spécifier les informations de ciblage du groupe de médiation, y compris les blocs d'annonces concernés. L'exemple suivant crée un groupe de médiation pour les annonces interstitielles Android pour deux blocs d'annonces. Une ligne de groupe de médiation est ajoutée lors de la création pour la source d'annonces InMobi. Vous n'avez pas besoin d'inclure le réseau AdMob, car il sera ajouté par défaut lors de la création.

Dans l'extrait de code ci-dessous, remplacez pub-XXXXXXXXXXXXXXXX par votre ID d'éditeur.

Remplacez ensuite YYYYYYYYYY par les 10 derniers chiffres de votre ID de bloc d'annonces, en respectant le format suivant :

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Comme il y a deux blocs d'annonces dans cet exemple, YYYYY11111 fait référence au premier bloc d'annonces et WWWWW11111 au mappage du premier bloc d'annonces. YYYYY22222 et WWWWW22222 font référence au deuxième bloc d'annonces et à la deuxième mise en correspondance des blocs d'annonces.

curl (ligne de commande)

Remplacez WWWWWWWWWW par l'ID de mappage de votre bloc d'annonces. Pour obtenir l'ID de mise en correspondance du bloc d'annonces, vous pouvez utiliser la méthode accounts.adUnits.adUnitMappings.list.

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

Liste

Remplacez pub-XXXXXXXXXXXXXXXX par votre ID d'éditeur pour afficher vos groupes de médiation.

curl (ligne de commande)

Exemple de requête :

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

Exemple de réponse :

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

Correctif

Voici la liste des masques de champ permettant de mettre à jour un groupe de médiation. Les mises à jour des champs répétés, tels que les éléments d'une liste, remplacent entièrement les valeurs existantes par de nouvelles valeurs. Pour modifier des valeurs individuelles dans une carte, vous pouvez utiliser l'indexation par clé.

Les masques de champ suivants sont acceptés pour les mises à jour des groupes de médiation :

  • targeting.adUnitIds
  • mediationGroupLines[mediationGroupLineId]
  • mediationGroupLines[mediationGroupLineId].state
  • mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

Pour mettre à jour un groupe de médiation avec une nouvelle ligne de groupe de médiation, utilisez un nombre négatif distinct pour mediationGroupLineId. Pour mettre à jour les lignes de groupe de médiation existantes, référencez l'ID de ligne de groupe de médiation dans update_mask et dans la charge utile, comme indiqué ci-dessous.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl (ligne de commande)

L'exemple ci-dessous ajoute trois lignes de médiation à un groupe de médiation existant. updateMask inclut les trois lignes du groupe de médiation avec des valeurs négatives distinctes en tant qu'espace réservé :

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

Vous devez convertir les caractères spéciaux, car toutes les URL doivent respecter la syntaxe de la spécification Uniform Resource Identifier (URI). Par conséquent, updateMask devient :

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

Pour exécuter l'exemple suivant, remplacez pub-XXXXXXXXXXXXXXXX par votre référence éditeur et ZZZZZZZZZZ par l'ID de votre groupe de médiation. L'ID du groupe de médiation est disponible dans l'UI AdMob ou à l'aide de la méthode accounts.mediationGroups:list.

Remplacez YYYYYYYYYY par les 10 derniers chiffres de votre ID de bloc d'annonces, en respectant le format suivant :

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Remplacez WWWWWWWWWW par l'ID de mappage de votre bloc d'annonces. Pour obtenir l'ID de mise en correspondance du bloc d'annonces, vous pouvez utiliser la méthode accounts.adUnits.adUnitMappings.list.

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF