Metriche di rendimento e attributi di configurazione per gli annunci.
Questo report può essere restituito solo da una richiesta asincrona (ovvero, tramite Reports.request()).
Richiedi estratto
Invia un normale messaggio di errore
Reports.request()
corpo della richiesta, ma specifica "reportType": "ad".
{
...
"reportType": "ad",
"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'annuncio: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, le parole chiave e gli annunci hanno un 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, formattato in ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente dell'annuncio, 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ì |
account |
Nome 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 annuncio. | attributo | String |
Sì |
adId |
ID annuncio DS. Il valore 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 metriche a un annuncio. | attributo | Boolean |
Sì |
adHeadline |
Titolo dell'annuncio. | attributo | String |
Sì |
adHeadline2 |
Titolo dell'annuncio 2; non è disponibile per alcuni motori. | attributo | String |
Sì |
adHeadline3 |
Titolo dell'annuncio 3; non è disponibile per alcuni motori. | attributo | String |
Sì |
adDescription1 |
Riga descrittiva 1 dell'annuncio. | 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 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 di 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 formare 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 formare l'URL mostrato su un annuncio. | attributo | String |
Sì |
effectiveLabels |
Nomi di tutte le etichette ereditate o direttamente assegnate a questo annuncio. | attributo | String list |
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ì |
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ì |