Dati dei report per gli inserzionisti, tra cui:
- le metriche sul rendimento di tutti gli account motore e le campagne di un inserzionista.
- Attributi di configurazione di un inserzionista.
Richiedi estratto
Invia un corpo di richiesta
Reports.request() o
Reports.generate() standard, ma specifica "reportType": "advertiser".
{
...
"reportType": "advertiser",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
Per ogni colonna da restituire o filtrare nel report, specifica il valore columnName elencato nella tabella seguente.
Facoltativamente, puoi specificare
headerText,
startDate
ed endDate.
Tieni presente che alcune colonne non possono essere filtrate; fai riferimento a "Filtrabile" nella tabella seguente.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
|---|---|---|---|---|
status |
Lo stato dell'inserzionista: Active, Paused o Removed. |
attributo | Status |
Sì |
creationTimestamp |
Timestamp della creazione dell'inserzionista, formattato in ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente dell'inserzionista, formattato in ISO 8601. | attributo | Timestamp |
Sì |
agency |
Nome agenzia. | attributo | String |
Sì |
agencyId |
ID agenzia DS. | attributo | ID |
Sì |
advertiser |
Nome inserzionista. | attributo | String |
Sì |
advertiserId |
ID inserzionista DS. | attributo | ID |
Sì |
dfaAdvertiserId |
ID dell'inserzionista Campaign Manager associato a questo inserzionista DS. | attributo | ID |
Sì |
dfaNetworkId |
ID della rete Campaign Manager associata a questo inserzionista DS. | attributo | ID |
Sì |
dfaNetworkTimeZone |
Fuso orario della rete Campaign Manager associata a questo inserzionista DS in formato database fuso orario IANA, come America/New_York. |
attributo | String |
Sì |
advertiserCurrencyCode |
Codice valuta dell'inserzionista in formato ISO 4217. | attributo | String |
Sì |
googleAnalyticsTimeZone |
Il fuso orario della vista di Google Analytics collegato a questo inserzionista di DS. Utilizza il formato di database del fuso orario IANA, ad esempio America/New_York. |
attributo | String |
Sì |
dfaActions |
Il numero totale di azioni di Campaign Manager. | metrica | Integer |
Sì |
dfaRevenue |
Entrate aggregate generate dalle transazioni di Campaign Manager. | metrica | Money |
Sì |
dfaTransactions |
Il numero totale di transazioni di Campaign Manager. | metrica | Integer |
Sì |
dfaWeightedActions |
Somma ponderata di azioni di Campaign Manager. | metrica | Number |
Sì |
dfaActionsCrossEnv |
Il numero totale di azioni Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaRevenueCrossEnv |
Entrate aggregate generate dalle transazioni cross-environment di Campaign Manager. | metrica | Money |
Sì |
dfaTransactionsCrossEnv |
Il numero totale di transazioni Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaWeightedActionsCrossEnv |
Somma ponderata di azioni Campaign Manager cross-environment. | metrica | Number |
Sì |
avgCpc |
Costo per clic medio. | metrica | Money |
Sì |
avgCpm |
Costo per mille impressioni medio. | metrica | Money |
Sì |
avgPos |
Posizione media. | metrica | Number |
Sì |
clicks |
Clic aggregati. | metrica | Integer |
Sì |
cost |
Costo aggregato pagato agli account motore. | metrica | Money |
Sì |
ctr |
Percentuale di clic media | metrica | Number |
Sì |
impr |
Il numero totale di impressioni. | metrica | Integer |
Sì |
adWordsConversions |
I dati impostati dall'inserzionista per la generazione di report nella colonna Conversioni di Google Ads. Quando viene creata un'azione di conversione di Google Ads, l'inserzionista può scegliere se conteggiare queste conversioni nella colonna Report sulle conversioni. | metrica | Number |
Sì |
adWordsConversionValue |
Valore aggregato delle conversioni di Google Ads. | metrica | Number |
Sì |
adWordsViewThroughConversions |
Il numero totale di conversioni view-through di Google Ads. | metrica | Integer |
Sì |
visits |
Il numero totale di visite in DS. | metrica | Integer |
Sì |
searchImpressionShare |
Solo Google Ads e Bing Ads. Il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, nella stringa < 10%. |
metrica | Impression share |
Sì |
searchBudgetLostImpressionShare |
Solo Google Ads e Bing Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla rete di ricerca a causa di un budget insufficiente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
searchRankLostImpressionShare |
Solo Google Ads e Bing Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla rete di ricerca a causa di un ranking dell'annuncio scadente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
displayImpressionShare |
Solo Google Ads. Il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, nella stringa < 10%. |
metrica | Impression share |
Sì |
displayBudgetLostImpressionShare |
Solo Google Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla Rete Display a causa di budget insufficiente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
displayRankLostImpressionShare |
Solo Google Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla Rete Display a causa di un ranking dell'annuncio scadente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
qualityScoreAvg |
Solo Google Ads e Bing Ads. La media ponderata in base alle impressioni del punteggio di qualità (QS) del motore in tutti i giorni e tutte le parole chiave nell'ambito del report. | metrica | Number |
Sì |
topOfPageBidAvg |
Solo Google Ads. Offre un valore approssimativo dell'offerta CPC media necessaria durante l'intervallo di tempo del report affinché gli annunci vengano visualizzati regolarmente nelle prime posizioni sopra i risultati di ricerca. | metrica | Money |
Sì |
absoluteTopImpressionPercentage |
La percentuale di impressioni dell'annuncio che viene mostrata come primo annuncio sopra i risultati di ricerca organica. | metrica | Impression share |
Sì |
searchAbsoluteTopImpressionShare |
Numero di impressioni ricevute nella posizione superiore assoluta (il primo annuncio sopra i risultati di ricerca organica) diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere nella posizione superiore. | metrica | Impression share |
Sì |
topImpressionPercentage |
La percentuale di impressioni degli annunci che viene visualizzata in qualsiasi punto sopra i risultati di ricerca organica. | metrica | Impression share |
Sì |
searchTopImpressionShare |
Impressioni ricevute nella posizione superiore (ovunque sopra i risultati di ricerca organica) rispetto al numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. | metrica | Impression share |
Sì |
searchBudgetLostAbsoluteTopImpressionShare |
Indica con quale frequenza il tuo annuncio non è stato mostrato per primo sopra i risultati di ricerca organici a causa di un budget ridotto. | metrica | Impression share |
Sì |
searchBudgetLostTopImpressionShare |
Aiuta a capire la frequenza con cui il tuo annuncio non è stato pubblicato in nessuna posizione al di sopra dei risultati di ricerca organica a causa di un budget ridotto. | metrica | Impression share |
Sì |
searchRankLostAbsoluteTopImpressionShare |
Indica con quale frequenza il tuo annuncio non è stato mostrato per primo sopra i risultati di ricerca organica a causa di un ranking dell'annuncio scadente. | metrica | Impression share |
Sì |
searchRankLostTopImpressionShare |
Indica una stima della frequenza con cui il tuo annuncio non è stato pubblicato in nessuna posizione sopra i risultati di ricerca organica a causa di un ranking dell'annuncio scadente. | metrica | Impression share |
Sì |
date |
Segmenta il report in base al giorno; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni giorno. Questa colonna restituisce la data di ogni riga. | segmento | Date |
Sì |
monthStart |
Segmenta il report in base ai mesi: ogni riga e le metriche aggregate vengono suddivise in più righe, una per mese. Questa colonna restituisce il primo giorno del mese di ogni riga. | segmento | Date |
Sì |
monthEnd |
Segmenta il report in base ai mesi: ogni riga e le metriche aggregate vengono suddivise in più righe, una per mese. Questa colonna restituisce l'ultimo giorno del mese di ogni riga. | segmento | Date |
Sì |
quarterStart |
Segmenta il report per trimestri e ogni riga e le metriche aggregate vengono suddivise in più righe, una per trimestre. Questa colonna restituisce il primo giorno del trimestre di ogni riga. | segmento | Date |
Sì |
quarterEnd |
Segmenta il report per trimestri e ogni riga e le metriche aggregate vengono suddivise in più righe, una per trimestre. Questa colonna restituisce l'ultimo giorno del trimestre di ogni riga. | segmento | Date |
Sì |
weekStart |
Segmenta il report per settimane (da domenica a sabato); ogni riga e le metriche aggregate vengono suddivise in più righe, una per settimana. Questa colonna restituisce il primo giorno (domenica) di ogni riga. | segmento | Date |
Sì |
weekEnd |
Segmenta il report per settimane (da domenica a sabato); ogni riga e le metriche aggregate vengono suddivise in più righe, una per settimana. Questa colonna restituisce l'ultimo giorno (sabato) di ogni riga. | segmento | Date |
Sì |
yearStart |
Segmenta il report in base agli anni: ogni riga e le metriche aggregate vengono suddivise in più righe, una per anno. Questa colonna restituisce il primo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
yearEnd |
Segmenta il report in base agli anni: ogni riga e le metriche aggregate vengono suddivise in più righe, una per anno. Questa colonna restituisce l'ultimo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
deviceSegment |
Segmenta il report in base al dispositivo; ogni riga e le metriche aggregate vengono suddivise in più righe, fino a una per ogni segmento di dispositivi. Questa colonna restituisce il segmento dispositivi di ogni riga. | segmento | Device segment |
Sì |
floodlightGroup |
Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce il nome del gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | String |
Sì |
floodlightGroupId |
Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce l'ID del gruppo Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | ID |
Sì |
floodlightGroupTag |
Segmenta il report in base ai gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce il tag di gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | String |
Sì |
floodlightActivity |
Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce il nome dell'attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | String |
Sì |
floodlightActivityId |
Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce l'ID attività Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | ID |
Sì |
floodlightActivityTag |
Segmenta il report in base alle attività Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce il tag attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, come i clic e le visite. | segmento | String |
Sì |