Method: accounts.campaignReport.generate

Genera il report sulla campagna in base alle specifiche fornite.

Richiesta HTTP

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Nome risorsa dell'account per cui generare il report. Esempio: accounts/pub-9876543210987654

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
Campi
reportSpec

object (CampaignReportSpec)

Specifiche del report sulle campagne.

Corpo della risposta

Risposta dell'API Campaign Report.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Campi
rows[]

object (ReportRow)

I dati dei report sulle campagne del publisher specificato. L'API restituirà al massimo 100.000 righe.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

Per saperne di più, consulta la OAuth 2.0 Overview.

CampaignReportSpec

La specifica per la generazione di un report sulle campagne. Ad esempio, la specifica per ottenere IMPRESSIONS e CLICKS suddivisi per CAMPAIGN_ID può essere simile al seguente esempio:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
Rappresentazione JSON 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
Campi
dateRange

object (DateRange)

L'intervallo di date per cui viene generato il report. L'intervallo massimo è di 30 giorni.
dimensions[]

enum (Dimension)

Elenco delle dimensioni del report. La combinazione di valori di queste dimensioni determina la riga del report. Se non vengono specificate dimensioni, il report restituisce una singola riga di metriche richieste per l'intero account.
metrics[]

enum (Metric)

Elenco delle metriche del report. Un report deve specificare almeno una metrica.
languageCode

string

Lingua utilizzata per qualsiasi testo localizzato, ad esempio determinati valori delle dimensioni applicabili. Il tag lingua è definito in IETF BCP47. Se non specificato o non valido, il valore predefinito è "en-US".

Dimensione

Le dimensioni del report sulla campagna.

Enum
DIMENSION_UNSPECIFIED Valore predefinito di una dimensione non specificata. Non utilizzare.
DATE Una data nel formato AAAAMMGG (ad esempio "20210701").
CAMPAIGN_ID L'ID univoco della campagna, ad esempio "123456789", coerente con l'ID campagna dell'API Elenco campagne.
CAMPAIGN_NAME Il nome della campagna.
AD_ID L'ID univoco dell'annuncio, ad esempio "123456789".
AD_NAME Il nome dell'annuncio, che potrebbe non essere univoco.
PLACEMENT_ID L'ID univoco specifico del fornitore dell'app in cui viene inserito l'annuncio. Ad esempio, com.goog.bar per Android e 123456789 per le app per iOS.
PLACEMENT_NAME Il nome dell'app in cui viene inserito l'annuncio.
PLACEMENT_PLATFORM La piattaforma dell'app in cui viene inserito l'annuncio.
COUNTRY Il nome del paese di destinazione.
FORMAT Formato dell'unità pubblicitaria (ad esempio "banner", "native"), una dimensione di pubblicazione degli annunci.

Metrica

Le metriche del report sulla campagna.

Enum
METRIC_UNSPECIFIED Valore predefinito per un campo non impostato. Non utilizzare.
IMPRESSIONS Il numero di volte in cui un annuncio viene mostrato all'utente.
CLICKS Il numero di volte in cui un utente fa clic su un annuncio.
CLICK_THROUGH_RATE Il numero di clic ricevuti da un annuncio diviso per il numero di volte in cui l'annuncio viene visualizzato.
INSTALLS Il numero di volte in cui le app sono state scaricate sui dispositivi.
ESTIMATED_COST Il costo stimato di pubblicazione di un annuncio della campagna, anziché di un annuncio che genera entrate. La valuta è la valuta dei report per le campagne.
AVERAGE_CPI Il costo per installazione medio. Indica l'importo medio speso per acquisire un nuovo utente. La valuta è la valuta dei report per le campagne.
INTERACTIONS Il numero di volte in cui un utente interagisce con un annuncio. che consiste di clic e coinvolgimenti.