Mappature delle unità pubblicitarie

Le mappature delle unità pubblicitarie sono impostazioni di configurazione di terze parti che vengono associate a un'unità pubblicitaria AdMob e le 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 alla rete pubblicitaria di terze parti. A differenza dell'interfaccia utente di AdMob, le mappature delle unità pubblicitarie devono essere create indipendentemente dai gruppi di mediazione e dalle righe del gruppo di mediazione. Dopo la creazione, puoi elencare tutte le mappature delle unità pubblicitarie e utilizzarle come parametro per creare o aggiornare le righe del gruppo di mediazione con nuove mappature delle unità pubblicitarie.

Esempi

Dopo aver creato le credenziali OAuth 2.0, 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.

Per iniziare a creare la tua prima mappatura delle unità pubblicitarie:

curl (riga di comando)

Richieste utilizzando curl

  1. Carica il file 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 con cui è attualmente eseguito l'accesso.

    Per l'autenticazione e l'autorizzazione, ti consigliamo di utilizzare oauth2l, un semplice strumento a riga di comando per lavorare con OAuth 2.0 di Google. Installa oauth2l ed esegui il comando riportato di seguito, sostituendo path_to_credentials_json con il percorso di un file credentials.json scaricato durante la registrazione dell'applicazione cloud. Per la prima esecuzione, il comando ti guida nel 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.

    Per ottenere le informazioni sulle origini annuncio AdMob, sostituisci 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 dell'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 della 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 ID unità pubblicitaria è costituito dalle 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 è costituito dalle 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",
         }
       }
    }