I dati dei report per gli inserzionisti, tra cui:
- Metriche sul rendimento per tutti gli account motore e le campagne di un inserzionista.
- Attributi di configurazione di un inserzionista.
Richiedi estratto
Invia un normale messaggio di errore
Reports.request() oppure
Reports.generate()
corpo della richiesta, ma specifica "reportType": "advertiser"
.
{ ... "reportType": "advertiser", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Per ogni colonna che vuoi venga restituita o filtrata nel report,
specificare columnName
nella tabella seguente.
Puoi anche specificare
headerText,
startDate,
ed endDate.
Tieni presente che alcune colonne non possono essere filtrate. consulta la sezione "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 dell'agenzia. | attributo | String |
Sì |
agencyId |
ID agenzia DS. | attributo | ID |
Sì |
advertiser |
Nome dell'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 IANA Time Zone Database, 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 collegata a questo inserzionista DS. Utilizza il formato di database del fuso orario IANA, ad esempio America/New_York . |
attributo | String |
Sì |
dfaActions |
Il numero totale di azioni Campaign Manager. | metrica | Integer |
Sì |
dfaRevenue |
Le entrate aggregate generate dalle transazioni di Campaign Manager. | metrica | Money |
Sì |
dfaTransactions |
Il numero totale di transazioni Campaign Manager. | metrica | Integer |
Sì |
dfaWeightedActions |
Somma ponderata delle azioni di Campaign Manager. | metrica | Number |
Sì |
dfaActionsCrossEnv |
Il numero totale di azioni di Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaRevenueCrossEnv |
Le entrate aggregate generate dalle transazioni del gestore della campagna cross-environment. | metrica | Money |
Sì |
dfaTransactionsCrossEnv |
Il numero totale di transazioni Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaWeightedActionsCrossEnv |
Somma ponderata delle azioni di 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 che l'inserzionista ha impostato per essere riportati 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 Conversioni dei report. | 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 DS. | metrica | Integer |
Sì |
searchImpressionShare |
Solo Google Ads e Bing Ads. Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, la 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 visualizzati sulla rete di ricerca a causa di un budget insufficiente. Restituisce un numero compreso tra 0 e 0,9 o, 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 tempo 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 o, se la quota è maggiore di 0,9, come stringa > 90% . |
metrica | Impression share |
Sì |
displayImpressionShare |
Solo Google Ads. Indica il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che avresti potuto ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, la 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 perché il budget era insufficiente. Restituisce un numero compreso tra 0 e 0,9 o, se la quota è maggiore di 0,9, come stringa > 90% . |
metrica | Impression share |
Sì |
displayRankLostImpressionShare |
Solo Google Ads. Indica la percentuale di tempo 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 o, 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à del motore per tutti i giorni e le parole chiave nell'ambito del report. | metrica | Number |
Sì |
topOfPageBidAvg |
Solo Google Ads. Offre una stima approssimativa dell'offerta CPC media necessaria durante l'intervallo di tempo del rapporto affinché gli annunci vengano pubblicati regolarmente nelle prime posizioni sopra i risultati di ricerca. | metrica | Money |
Sì |
absoluteTopImpressionPercentage |
Percentuale di impressioni dell'annuncio pubblicate come primo annuncio sopra i risultati di ricerca organica. | metrica | Impression share |
Sì |
searchAbsoluteTopImpressionShare |
Impressioni ricevute nella posizione superiore assoluta (il primo annuncio sopra i risultati di ricerca organica) divise per il numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. | metrica | Impression share |
Sì |
topImpressionPercentage |
Percentuale di impressioni dell'annuncio pubblicate in qualsiasi punto sopra i risultati di ricerca organica. | metrica | Impression share |
Sì |
searchTopImpressionShare |
Impressioni ricevute nella posizione superiore (in qualsiasi punto 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 una stima della frequenza con cui il tuo annuncio non è stato il primo annuncio sopra i risultati di ricerca organica 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 sopra i risultati di ricerca organica a causa di un budget ridotto. | metrica | Impression share |
Sì |
searchRankLostAbsoluteTopImpressionShare |
Indica una stima della frequenza con cui il tuo annuncio non è stato il primo annuncio 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 ai giorni; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni giorno. Questa colonna restituisce la data di ogni riga. | segmento | Date |
Sì |
monthStart |
Segmenta il report per mesi. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni mese. Questa colonna restituisce il primo giorno del mese di ogni riga. | segmento | Date |
Sì |
monthEnd |
Segmenta il report per mesi; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni mese. Questa colonna restituisce l'ultimo giorno del mese di ogni riga. | segmento | Date |
Sì |
quarterStart |
Segmenta il report per trimestri. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni trimestre. Questa colonna restituisce il primo giorno del trimestre di ogni riga. | segmento | Date |
Sì |
quarterEnd |
Segmenta il report per trimestri. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni 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 relative metriche aggregate sono suddivise in più righe, una per ogni 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 relative metriche aggregate sono suddivise in più righe, una per ogni settimana. Questa colonna restituisce l'ultimo giorno (sabato) di ogni riga. | segmento | Date |
Sì |
yearStart |
Segmenta il report per anni. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni anno. Questa colonna restituisce il primo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
yearEnd |
Segmenta il report per anni. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni anno. Questa colonna restituisce l'ultimo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
deviceSegment |
Segmenta il report per dispositivo. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni segmento di dispositivi. Questa colonna restituisce il segmento dei dispositivi di ogni riga. | segmento | Device segment |
Sì |
floodlightGroup |
Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce il nome del gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. | segmento | String |
Sì |
floodlightGroupId |
Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce l'ID gruppo Floodlight di DS di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. | segmento | ID |
Sì |
floodlightGroupTag |
Segmenta il report per gruppi Floodlight; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni gruppo Floodlight. Questa colonna restituisce il tag gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e 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, una per ogni attività Floodlight. Questa colonna restituisce il nome dell'attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e 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, 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 Floodlight segmentati, come clic e 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, una per ogni attività Floodlight. Questa colonna restituisce il tag attività Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori Floodlight segmentati, come clic e visite. | segmento | String |
Sì |