Metriche sul rendimento e attributi di configurazione per gli annunci.
Questo report può essere restituito solo da una richiesta asincrona (ovvero tramite il metodo Reports.request()).
Estratto della richiesta
Invia un corpo della richiesta
Reports.request()
normale, ma specifica "reportType": "ad".
{
...
"reportType": "ad",
"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'annuncio: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, le parole chiave e gli annunci hanno ciascuno il proprio stato. Visualizza lo stato. |
attributo | Status |
Sì |
engineStatus |
Stato aggiuntivo dell'annuncio nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) includono active, eligible, creative deleted, creative approved family safe e così via. |
attributo | String |
Sì |
creationTimestamp |
Timestamp della creazione dell'annuncio, nel formato ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente dell'annuncio, 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ì |
account |
Nome dell'account motore. | attributo | String |
Sì |
accountId |
ID account motore DS. | attributo | ID |
Sì |
accountEngineId |
ID dell'account nell'account motore esterno. | attributo | String |
Sì |
accountType |
Tipo di account motore: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu o Comparison Shopping. |
attributo | Engine type |
Sì |
campaign |
Nome campagna. | attributo | String |
Sì |
campaignId |
ID campagna DS. | attributo | ID |
Sì |
campaignStatus |
Lo stato della campagna che contiene questo elemento. | attributo | Status |
Sì |
adGroup |
Nome gruppo di annunci. | attributo | String |
Sì |
adGroupId |
ID gruppo di annunci DS. | attributo | ID |
Sì |
adGroupStatus |
Lo stato del gruppo di annunci che contiene questo elemento. | attributo | Status |
Sì |
ad |
Nome dell'annuncio. | attributo | String |
Sì |
adId |
ID annuncio DS. Un valore pari a 0 indica che l'annuncio non è attribuito. | attributo | ID |
Sì |
adEngineId |
ID dell'annuncio nell'account motore esterno. | attributo | ID |
Sì |
isUnattributedAd |
Indica se le metriche in questa riga non sono attribuibili a un annuncio specifico. Ad esempio, un annuncio con un formato non supportato o un URL clickserver errato può impedire a DS di attribuire le metriche a un annuncio. | attributo | Boolean |
Sì |
adHeadline |
Titolo dell'annuncio. | attributo | String |
Sì |
adHeadline2 |
Titolo 2 dell'annuncio; non disponibile per alcuni motori. | attributo | String |
Sì |
adHeadline3 |
Titolo 3 dell'annuncio; non disponibile per alcuni motori. | attributo | String |
Sì |
adDescription1 |
Riga descrittiva dell'annuncio 1. | attributo | String |
Sì |
adDescription2 |
Riga descrittiva 2 dell'annuncio; non disponibile per alcuni motori. | attributo | String |
Sì |
adDisplayUrl |
URL di visualizzazione dell'annuncio. | attributo | String |
Sì |
adLandingPage |
Pagina di destinazione dell'annuncio. Consulta la sezione URL pagina di destinazione e clickserver. | attributo | String |
Sì |
adType |
Il tipo di annuncio: Text, Product, Dynamic search, Mobile app install, Call-Only, Expanded text o Expanded dynamic search. |
attributo | Ad type |
Sì |
adPromotionLine |
Linea di promozione dell'annuncio. Un breve messaggio promozionale per un annuncio di prodotto. | attributo | String |
Sì |
adLabels |
Nomi delle etichette assegnate direttamente a questo annuncio. Le etichette ereditate non sono incluse. | attributo | String list |
Sì |
adPathField1 |
Campo Percorso annuncio 1. I campi Percorso 1 e Percorso 2 vengono combinati con adDisplayUrl per formare l'URL mostrato in un annuncio. | attributo | String |
Sì |
adPathField2 |
Campo Percorso annuncio 2. I campi Percorso 1 e Percorso 2 vengono combinati con adDisplayUrl per formare l'URL mostrato in un annuncio. | attributo | String |
Sì |
effectiveLabels |
Nomi di tutte le etichette ereditate o assegnate direttamente a questo annuncio. | attributo | String list |
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ì |
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ì |