Method: accounts.campaignReport.generate

Genera un report 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)

Specifica del report sulla campagna.

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 del report sulla campagna del publisher specificato. L'API restituisce 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 ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

CampaignReportSpec

La specifica per la generazione di un report Campagna. Ad esempio, la specifica per ottenere le IMPRESSIONI e i CLIC suddivisi in base a CAMPAIGN_ID può avere il 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 il quale viene generato il report. L'intervallo massimo è 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, come alcuni valori di dimensione applicabili. Il tag della lingua è definito nello standard 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 es. "20210701").
CAMPAIGN_ID L'ID univoco della campagna, ad esempio "123456789", che è coerente con l'ID campagna dell'API degli elenchi di 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 è posizionato l'annuncio. Ad esempio, com.goog.bar per le app Android e 123456789 per le app per iOS.
PLACEMENT_NAME Il nome dell'app in cui è posizionato l'annuncio.
PLACEMENT_PLATFORM La piattaforma dell'app in cui è posizionato l'annuncio.
COUNTRY Il nome del paese target.
FORMAT Formato dell'unità pubblicitaria (ad esempio "banner", "nativo"), 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 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 della pubblicazione di un annuncio della campagna anziché di un annuncio che genera entrate. La valuta è quella dei report per le campagne.
AVERAGE_CPI Il costo medio per installazione. Indica l'importo medio speso per acquisire un nuovo utente. La valuta è quella dei report per le campagne.
INTERACTIONS Il numero di volte in cui un utente interagisce con un annuncio. Sono clic e coinvolgimenti.