Dati dei report per gli inserzionisti, tra cui:
- Metriche sul rendimento di tutti gli account motore e le campagne di un inserzionista.
- Attributi di configurazione per un inserzionista.
Estratto della richiesta
Invia un corpo della richiesta normale
Reports.request() o
Reports.generate(), ma specifica "reportType": "advertiser".
{
...
"reportType": "advertiser",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
Per ogni colonna che vuoi che venga restituita o filtrata nel report,
specifica il valore columnName elencato nella tabella seguente.
Se vuoi, puoi anche specificare
headerText,
startDate e
endDate.
Tieni presente che alcune colonne non possono essere filtrate; fai riferimento a "Filtrabile" nella tabella di seguito.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
|---|---|---|---|---|
status |
Lo stato dell'inserzionista: Active, Paused o Removed. |
attributo | Status |
Sì |
creationTimestamp |
Timestamp della creazione dell'inserzionista, nel formato ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente dell'inserzionista, nel formato 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 nel formato del database dei fusi orari IANA, ad esempio 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 del database IANA Time Zone, 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 delle azioni di Campaign Manager. | metrica | Number |
Sì |
dfaActionsCrossEnv |
Il numero totale di azioni di Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaRevenueCrossEnv |
Entrate aggregate generate dalle transazioni di Campaign Manager in più ambienti. | metrica | Money |
Sì |
dfaTransactionsCrossEnv |
Il numero totale di transazioni di Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaWeightedActionsCrossEnv |
Somma ponderata delle azioni di Campaign Manager in più ambienti. | 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 configurato per essere registrati 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 dei report 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 ai 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 avresti potuto ottenere. Viene restituito come numero compreso tra 0,1 e 1 oppure, se la quota è inferiore a 0,1, la stringa < 10%. |
metrica | Impression share |
Sì |
searchBudgetLostImpressionShare |
Solo Google Ads e Bing Ads. La percentuale di tempo durante il quale i tuoi annunci non sono stati mostrati sulla rete di ricerca a causa di budget insufficiente. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
searchRankLostImpressionShare |
Solo Google Ads e Bing Ads. La percentuale di tempo durante il quale i tuoi annunci non sono stati mostrati nella rete di ricerca a causa del ranking dell'annuncio scadente. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 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 avresti potuto ottenere. Viene restituito come numero compreso tra 0,1 e 1 oppure, 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. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 0,9, come stringa > 90%. |
metrica | Impression share |
Sì |
displayRankLostImpressionShare |
Solo Google Ads. La percentuale di tempo durante il quale i tuoi annunci non sono stati mostrati sulla Rete Display a causa del ranking dell'annuncio scadente. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 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à (PG) dell'algoritmo per tutti i giorni e le parole chiave nell'ambito del report. | metrica | Number |
Sì |
topOfPageBidAvg |
Solo Google Ads. Approssima l'offerta CPC media necessaria durante l'intervallo di tempo del report per la pubblicazione regolare dei tuoi annunci nelle prime posizioni sopra i risultati di ricerca. | metrica | Money |
Sì |
absoluteTopImpressionPercentage |
Percentuale di impressioni degli annunci 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) diviso per il numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. | metrica | Impression share |
Sì |
topImpressionPercentage |
Percentuale di impressioni degli annunci pubblicate in qualsiasi posizione al di sopra dei 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 al di sopra dei risultati di ricerca organica a causa di un budget insufficiente. | metrica | Impression share |
Sì |
searchBudgetLostTopImpressionShare |
Ti aiuta a capire quante volte 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 al di sopra dei risultati di ricerca organica a causa di un ranking dell'annuncio insufficiente. | 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 insufficiente. | metrica | Impression share |
Sì |
date |
Suddivide il report per giorni. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni giorno. Questa colonna restituisce la data di ogni riga. | segmento | Date |
Sì |
monthStart |
Suddivide il report per mesi. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni mese. Questa colonna restituisce il primo giorno del mese di ogni riga. | segmento | Date |
Sì |
monthEnd |
Suddivide il report per mesi. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni mese. Questa colonna restituisce l'ultimo giorno del mese di ogni riga. | segmento | Date |
Sì |
quarterStart |
Suddivide il report per trimestri. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni trimestre. Questa colonna restituisce il primo giorno del trimestre di ogni riga. | segmento | Date |
Sì |
quarterEnd |
Suddivide il report per trimestri. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni trimestre. Questa colonna restituisce l'ultimo giorno del trimestre di ogni riga. | segmento | Date |
Sì |
weekStart |
Suddivide il report per settimane (da domenica a sabato); ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni settimana. Questa colonna restituisce il primo giorno (domenica) di ogni riga. | segmento | Date |
Sì |
weekEnd |
Suddivide il report per settimane (da domenica a sabato); ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni settimana. Questa colonna restituisce l'ultimo giorno (sabato) di ogni riga. | segmento | Date |
Sì |
yearStart |
Suddivide il report per anni. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni anno. Questa colonna restituisce il primo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
yearEnd |
Suddivide il report per anni. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni anno. Questa colonna restituisce l'ultimo giorno dell'anno di ogni riga. | segmento | Date |
Sì |
deviceSegment |
Suddivide il report per dispositivo. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, fino a una per ogni segmento di dispositivo. Questa colonna restituisce il segmento del dispositivo di ogni riga. | segmento | Device segment |
Sì |
floodlightGroup |
Segmenta il report in base ai gruppi Floodlight. Ogni riga e le relative metriche aggregate vengono 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, ad esempio clic e visite. | segmento | String |
Sì |
floodlightGroupId |
Segmenta il report in base ai gruppi Floodlight. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce l'ID gruppo Floodlight DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, ad esempio clic e visite. | segmento | ID |
Sì |
floodlightGroupTag |
Segmenta il report in base ai gruppi Floodlight. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, fino a una per ogni gruppo Floodlight. Questa colonna restituisce il tag gruppo Floodlight di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, ad esempio clic e visite. | segmento | String |
Sì |
floodlightActivity |
Segmenta il report in base alle attività Floodlight. Ogni riga e le relative metriche aggregate vengono 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, ad esempio clic e visite. | segmento | String |
Sì |
floodlightActivityId |
Segmenta il report in base alle attività Floodlight. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, fino a una per ogni attività Floodlight. Questa colonna restituisce l'ID attività Floodlight DS di ogni riga. Tieni presente che alcune metriche non hanno valori segmentati Floodlight, ad esempio clic e visite. | segmento | ID |
Sì |
floodlightActivityTag |
Segmenta il report in base alle attività Floodlight. Ogni riga e le relative metriche aggregate vengono 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, ad esempio clic e visite. | segmento | String |
Sì |