Questa pagina è stata tradotta dall'API Cloud Translation.

API Ads Activity Report alpha

Il report Attività pubblicitaria è un visualizzazione centralizzata del rendimento degli annunci. Combina i dati, le metriche e dell'API Network Report e dell'API del report sulla mediazione, nonché dati sulle offerte in un unico report unificato.

L'API Ads Activity Report fornisce ulteriori miglioramenti della funzionalità Mediazione API Report e API Network Report, come illustrato nella seguente tabella:

	API Network Report	API Mediazione Report	API Ads Activity Report
Prestazioni della rete	✅	✅	✅
Rendimento della struttura a cascata		✅	✅
Rendimento delle offerte			✅
Rendimento dell'esperimento A/B di mediazione			✅
Report orari			✅
Dimensioni report	100.000	100.000	500.000

Metriche, dimensioni e filtri delle dimensioni

Le seguenti metriche sono state aggiunte all'API Ads Activity Report in oltre a molte delle metriche disponibili nell'API Network Report e l'API Mediazione Report.

Metrica	Descrizione
BID_REQUEST	Il numero di richieste inviate all'origine annuncio per l'asta.
BIDS_IN_AUCTION	Il numero di offerte inviate dall'origine annuncio che hanno partecipato alle aste di questo tipo.
WINNING_BIDS	Il numero di offerte che hanno vinto un'asta.

Le seguenti nuove dimensioni sono incluse nell'API Ads Activity Report.

Dimensione	Descrizione
SETTIMANA	La data del primo giorno di una settimana (in base alla lingua indicato nelle impostazioni di localizzazione) nel formato AAAAMMGG (ad ad esempio "20210701"). È possibile specificare un solo valore tra DATE, WEEK o MONTH dimensione temporale.
HOUR	L'ora in formato HH nel fuso orario PST. Ad esempio, "05" alle 5:00 PST, "13" alle 13:00 PST. Nella richiesta deve essere specificata anche la dimensione DATE. R viene restituito un massimo di 28 giorni di dati quando è specificata la dimensione ORA. Date di inizio dell'intervallo di date superiori a 28 giorni prima della data corrente restituiscono un errore.
MEDIATION_AB_TEST (nome esperimento)	Mostra il rendimento in base al test A/B di mediazione. È obbligatorio specificare questo se è specificata la dimensione VARIANT.
MEDIATION_AB_TEST_VARIANT (variante A, variante B)	Mostra il rendimento in base alla variante del test A/B di mediazione.

Nome dimensione nell'API Mediazione Report	Nome dimensione nell'API Ads Activity Report	Descrizione
AD_UNIT¹	AD_UNIT_ID	L'ID univoco dell'unità pubblicitaria (ad es. "123456789").
AD_UNIT¹	AD_UNIT_NAME	Il nome dell'unità pubblicitaria.
APP¹	APP_ID	L'ID univoco dell'app mobile (ad esempio "1234567890").
APP¹	APP_NAME	Il nome dell'app.
AD_SOURCE¹	AD_SOURCE_ID	L'ID univoco dell'origine annuncio, ad esempio "1234567890123456789".
AD_SOURCE¹	AD_SOURCE_NAME	Il nome dell'origine annuncio, ad esempio "Rete AdMob".
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_ID	L'ID univoco dell'istanza dell'origine annuncio, ad esempio "123456789012".
AD_SOURCE_INSTANCE¹	AD_SOURCE_INSTANCE_NAME	Il nome dell'istanza dell'origine annuncio, ad esempio "AdMob (predefinito)".
GRUPPO_MEDIATION¹	MEDIATION_GROUP_ID	L'ID univoco del gruppo di mediazione, ad esempio "1234567890".
GRUPPO_MEDIATION¹	MEDIATION_GROUP_NAME	L'ID univoco del gruppo di mediazione, ad esempio "AdMob (predefinito)".

¹: vedi Scalars per ulteriori informazioni.

Le seguenti dimensioni hanno un formato aggiornato.

Nome dimensione nell'API Mediazione Report	Descrizione nell'API Mediation Report	Descrizione nell'API Ads Activity Report
ESTIMATED_EARNINGS	Gli utili stimati del publisher AdMob. L'unità di valuta (USD, EUR o altro) delle metriche relative alle entrate sono determinati dalla localizzazione per la valuta. L'importo è in micro. Ad esempio, 6,50 $ corrisponde a rappresentato come 6500000. Gli utili stimati per gruppo di mediazione e per livello di istanza dell'origine annuncio sono supportati a partire dal 20 ottobre 2019. Gli utili stimati di terze parti mostra 0 per le date precedenti al 20 ottobre 2019.	Gli utili stimati del publisher AdMob. L'unità di valuta (USD, EUR o altro) delle metriche relative alle entrate sono determinati dalla localizzazione per la valuta.
OBSERVED_ECPM	L'eCPM medio stimato della rete pubblicitaria di terze parti. L'unità di valuta (USD, EUR o altro) delle metriche relative alle entrate sono determinate dalla localizzazione per la valuta. L'importo è in micro. Ad esempio, 2,30 $ corrisponde rappresentato come 2300000. L'eCPM medio stimato per gruppo di mediazione e per livello di istanza dell'origine annuncio a partire dal 20 ottobre 2019. Media stimata di terze parti L'eCPM mostrerà 0 per le date precedenti al 20 ottobre 2019.	eCPM medio per tutti gli annunci. L'unità di valuta (USD, EUR o altro) di Le metriche relative alle entrate sono determinate dall'impostazione di localizzazione per la valuta. L'eCPM medio per gruppo di mediazione e per livello di istanza dell'origine annuncio è supportati a partire dal 20 ottobre 2019. OBSERVED_ECPM mostrerà 0 per le date prima del 20 ottobre 2019.

Scalars

Le seguenti dimensioni sono state aggiornate nell'API Ads Activity Report per essere valori scalari anziché oggetti. Questo semplificherà la risposta e ridurrà complessità.

Dimensioni interessate nell'API Report sulla mediazione e nell'API Network Report:

AD_UNIT
APP
AD_SOURCE
AD_SOURCE_INSTANCE
MEDIATION_GROUP

Esempio di dati di risposta ai report
Formato della dimensione Mediazione / API di rete	"AD_UNIT": { "value":"ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY", "displayLabel": "Test ad unit name" }
Formato della dimensione dell'API AAR	"AD_UNIT_NAME": "Test ad unit name", "AD_UNIT_ID": "ca-app-pub-XXXXXXXXXXXXXXXXX/YYYYYYYYYY"

Report orari

Ora puoi visualizzare il rendimento in base all'ora nell'API AdMob. I report orari sono disponibili per un massimo di 28 giorni.

È necessario specificare anche la dimensione DATE nella richiesta per recuperare l'orario e i dati di Google Cloud. Vengono restituiti i dati di un massimo di 28 giorni quando la dimensione ORA è specificato. Date di inizio dell'intervallo di date superiori a 28 giorni prima della data la data corrente restituisce un errore.

Report di dimensioni maggiori

L'API Ads Activity Report consente di recuperare un totale di 500.000 righe. Per per ulteriori informazioni, consulta la guida alle quote.

Fai una richiesta

Per inviare una richiesta, segui questi passaggi.

curl (riga di comando)

Richieste mediante curl

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

La prima volta che esegui questo passaggio ti verrà chiesto di accettare un richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google autorizzato ad accedere all'API AdMob. Il tuo l'applicazione sarà autorizzata ad accedere ai dati per conto di qualsiasi è 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 seguente, sostituendo path_to_credentials_json con un percorso in un file credentials.json che scarichi quando registri il tuo un'applicazione cloud. Per la prima esecuzione, il comando ti guida attraverso Flusso di autorizzazione OAuth 2.0. Le esecuzioni successive aggiornano il token automaticamente.
```
~/go/bin/oauth2l header --json path_to_credentials_json \
        https://www.googleapis.com/auth/admob.readonly
```

Generare un report sull'attività pubblicitaria.

curl -X POST https://admob.googleapis.com/v1alpha/accounts/pub-XXXXXXXXXXXXXXXX/adsActivityReport:generate \
     -H "Content-Type: application/json" \
     -H "$(~/go/bin/oauth2l header --json path_to_credentials_json https://www.googleapis.com/auth/admob.readonly)"  --data @- << EOF
      {
        "report_spec": {
        "date_range": {
          "start_date": {"year": 2023, "month": 1, "day": 1},
          "end_date": {"year": 2023, "month": 1, "day": 2}
        },
        "dimensions": ["DATE", "HOUR", "MEDIATION_AB_TEST", "VARIANT", "AD_SOURCE_ID", "AD_SOURCE_NAME"],
        "metrics": ["CLICKS", "BID_REQUEST","WINNING_BIDS", "IMPRESSIONS", "ESTIMATED_EARNINGS" ],
        "dimension_filters": [{"dimension": "COUNTRY", "matches_any": {"values": ["US"]}}],
        "sort_conditions": [{"metric":"CLICKS", "order": "DESCENDING"}],
        "localization_settings": {"currency_code": "USD", "language_code": "en-US"}
        }
      }
EOF

Esempio di risposta:

{
"rows": [
  {
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant A"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 0
      },
      "BID_REQUEST": {
        "integerValue": "27"
      },
      "WINNING_BIDS": {
        "doubleValue": 0.1111111111111111
      },
      "IMPRESSIONS": {
        "integerValue": "2"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0
      }
    }
  },
{
    "dimensionValues": {
      "DATE": {
        "value": "20221102"
      },
      "HOUR": {
        "value": "23"
      },
      "MEDIATION_AB_TEST": {
        "value": "Mediation AB Test"
      },
      "VARIANT": {
        "value": "Variant B"
      },
      "AD_SOURCE_ID": {
        "value": "5450213213286189855"
      },
      "AD_SOURCE_NAME": {
        "value": "AdMob Network"
      }
    },
    "metricValues": {
      "CLICKS": {
        "doubleValue": 1
      },
      "BID_REQUEST": {
        "integerValue": "6"
      },
      "WINNING_BIDS": {
        "doubleValue": 1
      },
      "IMPRESSIONS": {
        "integerValue": "3"
      },
      "ESTIMATED_EARNINGS": {
        "doubleValue": 0.000427519
      }
    }
  }
]}