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 della 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 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 del 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 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 per CAMPAIGN_ID può avere il seguente aspetto:

{
  "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 di metriche del report. Un report deve specificare almeno una metrica.
languageCode

string

Lingua utilizzata per il testo localizzato, ad esempio determinati valori di dimensione applicabili. Il tag della lingua è definito nel codice BCP47 di IETF. Il valore predefinito è "en-US" se non specificato o non valido.

Dimensione

Le dimensioni del report sulle campagne.

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", che è coerente con l'ID campagna dell'API campaign list.
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 Android e 123456789 per le app 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 dell'annuncio.

Metrica

Le metriche del report sulle campagne.

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 per la 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. Si tratta di clic e coinvolgimenti.