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()).
Richiedi estratto
Invia un corpo di richiesta
Reports.request() standard, ma specifica "reportType": "ad".
{
...
"reportType": "ad",
"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'annuncio: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, le parole chiave e gli annunci hanno ciascuno un proprio stato. Vedi 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, formattato in ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente dell'annuncio, 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ì |
account |
Nome account motore. | attributo | String |
Sì |
accountId |
ID account motore di 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 annuncio. | attributo | String |
Sì |
adId |
ID annuncio DS. Un valore pari a 0 indica che l'annuncio non è stato 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 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 1 dell'annuncio. | attributo | String |
Sì |
adDescription2 |
Riga descrittiva dell'annuncio 2; 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 URL 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 |
Riga 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 2 vengono combinati con adDisplayUrl per creare l'URL mostrato su un annuncio. | attributo | String |
Sì |
adPathField2 |
Campo percorso annuncio 2. I campi Percorso 1 e 2 vengono combinati con adDisplayUrl per creare l'URL mostrato su 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 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ì |
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ì |