- Richiesta HTTP
- Parametri del percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CampaignReportSpec
- Dimensione
- Metrica
- Esempi
- Prova!
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 |
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 ( |
Campi | |
---|---|
reportSpec |
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 ( |
Campi | |
---|---|
rows[] |
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 ( |
Campi | |
---|---|
dateRange |
L'intervallo di date per il quale viene generato il report. L'intervallo massimo è 30 giorni. |
dimensions[] |
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[] |
Elenco delle metriche del report. Un report deve specificare almeno una metrica. |
languageCode |
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. |