Mappature delle unità pubblicitarie

Le mappature delle unità pubblicitarie sono impostazioni di configurazione di terze parti che vengono mappate a un'unità pubblicitaria AdMob e consentono di effettuare una richiesta di annuncio a una rete pubblicitaria di terze parti.

Quando crei un gruppo di mediazione, le mappature delle unità pubblicitarie vengono utilizzate come parametro per ogni riga del gruppo di mediazione come impostazioni per l'unità pubblicitaria specificata per effettuare richieste di reti pubblicitarie di terze parti. A differenza dell'interfaccia utente AdMob, le mappature delle unità pubblicitarie devono essere create in modo indipendente al di fuori dei gruppi di mediazione e delle righe dei gruppi di mediazione. Dopo la creazione, puoi elencare tutte le mappature delle unità pubblicitarie e utilizzarle come parametro durante la creazione o l'aggiornamento delle righe dei gruppi di mediazione con nuove mappature delle unità pubblicitarie.

Esempi

Con le credenziali OAuth 2.0 create, puoi iniziare a utilizzare l'API AdMob. Per richiedere l'accesso utilizzando OAuth 2.0, la tua applicazione avrà bisogno anche delle informazioni relative all'ambito.

Ecco le informazioni relative all'ambito di 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 dati includono quelli dell'account, le impostazioni dell'inventario e di mediazione, i report e altro ancora. Non sono inclusi dati sensibili, come i dettagli sui pagamenti o sulle campagne.

Inizia a creare la tua prima mappatura delle unità pubblicitarie:

curl (riga di comando)

Richieste tramite curl

  1. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questo passaggio, ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso all'API AdMob. La tua applicazione sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

    Per l'autenticazione e l'autorizzazione, ti consigliamo di utilizzare oauth2l, un semplice strumento a riga di comando per lavorare con Google OAuth 2.0. Installa oauth2l ed esegui il comando riportato di seguito, sostituendo path_to_credentials_json con un percorso a un file credentials.json che scarichi quando registri la tua applicazione cloud. Per la prima esecuzione, il comando ti guida attraverso il flusso di autorizzazione OAuth 2.0. Le esecuzioni successive aggiornano automaticamente il token.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Elenca le origini annuncio.

    Ottieni le informazioni sull'origine annuncio AdMob sostituendo pub-XXXXXXXXXXXXXXXX con il tuo ID publisher. Consulta le istruzioni su come trovare il tuo ID publisher.

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

    Esempio di risposta:

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. Elenca gli adattatori.

    Sostituisci SSSSSSSSSSSSSSSSSSSS con l'ID origine annuncio per gli adattatori di interesse.

    Utilizza il seguente comando per ottenere un elenco di adattatori:

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

    Risposta di esempio per l'origine annuncio Rete AdMob con 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"
     }]
  }]
}

  4. Crea una mappatura delle unità pubblicitarie.

    Sostituisci YYYYYYYYYY con il frammento dell'ID unità pubblicitaria. Il frammento dell'ID dell'unità pubblicitaria sono le ultime 10 cifre dell'ID unità pubblicitaria che segue il formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulta le istruzioni per trovare l'ID unità pubblicitaria.

    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

  5. Elenca tutte le mappature delle unità pubblicitarie.

    Sostituisci YYYYYYYYYY con il frammento dell'ID unità pubblicitaria. Il frammento dell'ID unità pubblicitaria sono le ultime 10 cifre dell'ID unità pubblicitaria nel formato "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Consulta le istruzioni per trovare l'ID unità pubblicitaria.

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