Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Gruppi di mediazione

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

Specifica del targeting per gruppo di mediazione inclusi targeting per regioni, formato, piattaforma e IDFA
Aggiunta di nuove righe del gruppo di mediazione a un gruppo di mediazione esistente
Visualizzazione dei gruppi di mediazione che fanno parte di un esperimento A/B di mediazione e delle righe dei gruppi di mediazione che appartengono a ciascuna variante: A o B

Esempi

Una volta create 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`	Visualizzare tutti i dati di AdMob. Questi potrebbero includere informazioni sull'account, 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 le informazioni sul targeting del gruppo di mediazione, incluse le unità pubblicitarie pertinenti. L'esempio seguente crea un nuovo gruppo di mediazione per gli annunci interstitial per Android per due unità pubblicitarie. Al momento della creazione viene aggiunta una riga del gruppo di mediazione per l'origine annuncio InMobi. Non è necessario includere la rete AdMob, perché verrà aggiunta per impostazione predefinita al momento della creazione.

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

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

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

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

curl (riga di comando)

Sostituisci WWWWWWWWWW con l'ID mappatura unità pubblicitarie. L'ID mappatura unità pubblicitarie può essere trovato utilizzando il metodo 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 ID publisher per visualizzare i tuoi 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 delle maschere dei campi per aggiornare un gruppo di mediazione. Gli aggiornamenti ai campi ripetuti, come gli elementi di un elenco, sostituiscono completamente i valori esistenti con i nuovi valori. Gli aggiornamenti ai singoli valori in una mappa possono essere eseguiti tramite l'indicizzazione in base alla chiave.

Per gli aggiornamenti dei gruppi di mediazione sono supportate le seguenti maschere di campo:

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

Per aggiornare un gruppo di mediazione con una nuova riga del gruppo di mediazione, utilizza un numero negativo distinto per mediationGroupLineId. Per aggiornare le righe dei gruppi di mediazione esistenti, fai riferimento all'ID riga del gruppo di mediazione sia in update_mask sia nel 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 aggiunge tre nuove righe di mediazione a un gruppo di mediazione esistente. updateMask include le tre righe del gruppo di mediazione con valori negativi distinti come segnaposto:

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

Devi tradurre i caratteri speciali perché tutti gli URL devono essere conformi alla sintassi specificata dalla specifica Uniform Resource Identifier (URI), 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 del tuo gruppo di mediazione. L'ID gruppo di mediazione si trova nell'interfaccia utente di AdMob o utilizzando il metodo accounts.mediationGroups:list.

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

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

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