Questa pagina è stata tradotta dall'API Cloud Translation.

Gruppi di mediazione

L'API AdMob ti consente di creare, elencare e aggiornare gruppi di mediazione, tra cui:

Specificare il targeting del gruppo di mediazione inclusi targeting per regione, formato, piattaforma e IDFA
Aggiungere nuove righe del gruppo di mediazione a un gruppo di mediazione esistente
Visualizzare i gruppi di mediazione che fanno parte di un esperimento A/B di mediazione e cosa linee del gruppo di mediazione appartengono a ciascuna variante: A o B

Esempi

Dopo aver creato le credenziali OAuth 2.0, puoi iniziare a utilizzare l'API AdMob. Per richiedere l'accesso utilizzando OAuth 2.0: l'applicazione avrà bisogno anche delle informazioni sull'ambito.

Ecco le informazioni sull'ambito OAuth 2.0:

Ambito	Significato
`https://www.googleapis.com/auth/admob.monetization`	Visualizzare, creare e modificare le impostazioni di monetizzazione di AdMob.
`https://www.googleapis.com/auth/admob.readonly`	Visualizza tutti i dati AdMob. Potrebbero essere inclusi l'account informazioni, impostazioni di inventario e mediazione, report e altri dati. Non sono inclusi dati sensibili, come i dettagli sui pagamenti o sulle campagne.

Crea

Per creare un gruppo di mediazione, devi specificare il targeting del gruppo di mediazione incluse le unità pubblicitarie pertinenti. L'esempio seguente crea una nuova gruppo di mediazione per gli annunci interstitial per Android per due unità pubblicitarie. Un gruppo di mediazione viene aggiunta al momento della creazione dell'origine annuncio InMobi. Non è necessario includere alla rete AdMob, poiché verrà aggiunta per impostazione predefinita al momento della creazione.

Nello snippet di codice riportato di seguito, sostituisci pub-XXXXXXXXXXXXXXXX con il tuo publisher ID.

Poi sostituisci YYYYYYYYYY con le ultime 10 cifre dell'unità pubblicitaria ID, conforme nel formato:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Poiché in questo esempio sono presenti due unità pubblicitarie, YYYYY11111 si riferisce al primo annuncio e WWWWW11111 alla mappatura della prima unità pubblicitaria. YYYYY22222 e WWWWW22222 si riferisce alla seconda mappatura delle unità pubblicitarie e delle unità pubblicitarie.

curl (riga di comando)

Sostituisci WWWWWWWWWW con l'ID mappatura dell'unità pubblicitaria. ID mappatura unità pubblicitaria può essere trovato utilizzando 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"
      }
  }
}

Elenco

Sostituisci pub-XXXXXXXXXXXXXXXX con il tuo publisher ID per visualizzare i gruppi di mediazione.

curl (riga di comando)

Richiesta di esempio:

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)"

Esempio di risposta:

{
"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"
      }
    },
  }]
}

Patch

Ecco l'elenco dei campi mascherine per aggiornare un gruppo di mediazione. Aggiornamenti a campi ripetuti, ad esempio elementi in un sostituisci completamente i valori esistenti con nuovi valori. Aggiornamenti a singoli utenti in una mappa può essere eseguita attraverso l'indicizzazione dalla chiave.

Per gli aggiornamenti del gruppo di mediazione sono supportate le seguenti maschere dei campi:

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

Per aggiornare un gruppo di mediazione con una nuova riga, utilizza una riga numero negativo di mediationGroupLineId. Per aggiornare la mediazione esistente alle righe del gruppo di mediazione, fai riferimento all'ID riga del gruppo di mediazione sia in update_mask che in il payload, come mostrato di seguito.

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

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

curl (riga di comando)

L'esempio riportato di seguito consente di aggiungere tre nuove linee di mediazione a un gruppo di mediazione esistente. updateMask include le 3 righe del gruppo di mediazione con un valore negativo distinto come segnaposto:

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

Devi tradurre i caratteri speciali perché tutti gli URL devono essere conformi a la sintassi specificata dalla specifica URI (Uniform Resource Identifier), quindi updateMask diventa:

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

Per eseguire l'esempio seguente, sostituisci pub-XXXXXXXXXXXXXXXX con il tuo ID publisher e ZZZZZZZZZZ con l'ID gruppo di mediazione. La mediazione Puoi trovare l'ID gruppo nell'interfaccia utente di AdMob o utilizzando la accounts.mediationGroups:list .

Sostituisci YYYYYYYYYY con le ultime 10 cifre dell'unità pubblicitaria ID, nel formato:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Sostituisci WWWWWWWWWW con l'ID mappatura dell'unità pubblicitaria. L'ID mappatura dell'unità pubblicitaria può essere trovato utilizzando 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

Gruppi di mediazione Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Esempi

Crea

curl (riga di comando)

Elenco

curl (riga di comando)

Patch

curl (riga di comando)

Gruppi di mediazione