Tipo di report: annuncio

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.

columnNameDescrizioneComportamentoTipoFiltrabile
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ì