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

Groupes de médiation

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

Spécifier le ciblage des groupes de médiation y compris le ciblage par régions, format, plate-forme et IDFA
Ajouter de nouvelles lignes de groupes de médiation à un groupe de médiation existant
Identifier les groupes de médiation participant à un test A/B et les groupes les lignes de groupe de médiation appartenant à 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 a aussi besoin du champ d'application.

Voici les informations concernant le niveau d'accès 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 de comptes les informations, les paramètres d'inventaire et de médiation, les 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 le ciblage du groupe de médiation. des informations, y compris les blocs d'annonces pertinents. L'exemple suivant crée un objet groupe de médiation pour les annonces interstitielles Android de deux blocs d'annonces. Un groupe de médiation est ajoutée lors de la création de la source d'annonce InMobi. Vous n'avez pas besoin d'inclure au réseau AdMob, car il sera ajouté par défaut au moment de la création.

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

Remplacez ensuite YYYYYYYYYY par les 10 derniers chiffres de votre bloc d'annonces. ID, conformité au 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 bloc et WWWWW11111 à la mise en correspondance du premier bloc d'annonces. YYYYY22222 et WWWWW22222 fait référence à la deuxième mise en correspondance des blocs d'annonces et des blocs d'annonces.

curl (ligne de commande)

Remplacez WWWWWWWWWW par l'ID de mise en correspondance de votre bloc d'annonces. ID de mise en correspondance du bloc d'annonces sont accessibles via le 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 éditeur. ID 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"
      }
    },
  }]
}

Correction

Voici la liste des champs masques pour mettre à jour un groupe de médiation. Mises à jour de champs répétés, tels que les éléments d'une liste, remplacez complètement les valeurs existantes par de nouvelles. Mises à jour de l'utilisateur d'une carte peut être indexée par la clé.

Les masques de champ suivants sont compatibles avec la mise à 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 une méthode nombre négatif pour mediationGroupLineId. Mettre à jour la médiation existante groupe de lignes, référencez l'ID de ligne du groupe de médiation dans les champs update_mask et la charge utile, comme illustré ci-dessous.

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

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

curl (ligne de commande)

Dans l'exemple ci-dessous, trois nouvelles lignes de médiation sont ajoutées à un groupe de médiation existant. Le updateMask inclut les trois lignes du groupe de médiation avec des mots clés à exclure distincts comme espace réservé:

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

Vous devez traduire les caractères spéciaux, car toutes les URL doivent respecter le format la syntaxe spécifiée par la spécification URI (Uniform Resource Identifier), Ainsi, 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 la référence éditeur et ZZZZZZZZZZ par l'ID de votre groupe de médiation. La médiation Vous pouvez trouver l'ID de groupe dans l'interface utilisateur d'AdMob ou à l'aide du accounts.mediationGroups:list .

Remplacez YYYYYYYYYY par les 10 derniers chiffres de votre bloc d'annonces. ID, au format suivant:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Remplacez WWWWWWWWWW par l'ID de mise en correspondance de votre bloc d'annonces. ID de mise en correspondance du bloc d'annonces sont accessibles via le 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

Groupes de médiation Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Exemples

Créer

curl (ligne de commande)

Liste

curl (ligne de commande)

Correction

curl (ligne de commande)

Groupes de médiation