Tipo di report: campagna

Metriche sul rendimento e attributi di configurazione per le campagne.

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": "campaign".

{
...
  "reportType": "campaign",
  "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.

columnNameDescrizioneComportamentoTipoFiltrabile
status Un alias per l'attributo campaignStatus. attributo Status
engineStatus Stato aggiuntivo della campagna nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) sono disapproved, budget constrained e così via. attributo String
creationTimestamp Timestamp della creazione della campagna, formattato in ISO 8601. attributo Timestamp
lastModifiedTimestamp Timestamp della modifica più recente della campagna, formattato in ISO 8601. attributo Timestamp
agency Nome agenzia. attributo String
agencyId ID agenzia DS. attributo ID
advertiser Nome inserzionista. attributo String
advertiserId ID inserzionista DS. attributo ID
account Nome account motore. attributo String
accountId ID account motore di DS. attributo ID
accountEngineId ID dell'account nell'account motore esterno. attributo String
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
campaign Nome campagna. attributo String
campaignId ID campagna DS. attributo ID
campaignStatus Lo stato della campagna: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, le parole chiave, gli annunci e i target hanno un proprio stato. Vedi lo stato. attributo Status
campaignEngineId ID della campagna nell'account motore esterno. attributo ID
campaignStartDate Data di inizio della campagna. attributo Date
campaignEndDate Data di fine della campagna. attributo Date
bingAdsBudgetType Come viene controllato il budget per le campagne di Bing Ads: Daily budget, Monthly even spend, Monthly accelerated spend, Daily accelerated spend o Daily even spend. attributo Microsoft Advertising budget type
dailyBudget Budget giornaliero della campagna. attributo Money
monthlyBudget Budget mensile della campagna. attributo Money
deliveryMethod Metodo di erogazione del budget della campagna: Standard o Accelerated. attributo Budget delivery method
adWordsBidStrategy La strategia di offerta che Google Ads utilizza per questa campagna: Manual cpc, Manual cpm, Percent cpa, Budget optimizer o Conversion optimizer. Le campagne che utilizzano le strategie di offerta di DS sono impostate su Manual cpc o Manual cpm. attributo AdWords bid strategy
yahooJapanBidStrategy La strategia di offerta Yahoo! JAPAN utilizza per questa campagna: Manual cpc o Budget optimizer. Le campagne che utilizzano le strategie di offerta di DS sono impostate su Manual cpc. attributo Yahoo! JAPAN bid strategy
keywordNearMatchEnabled Indica se la parola chiave vicina alla corrispondenza è attivata per la campagna: Enabled o Disabled. attributo Keyword match setting
campaignMobileBidAdjustment La percentuale di aggiustamento delle offerte per dispositivi mobili. Ad esempio, 0,2 significa un aumento del 20%, quindi le offerte per dispositivi mobili sono 1,2 volte l'offerta predefinita. L'intervallo di valori validi varia in base al motore esterno. attributo Number
campaignTabletBidAdjustment La percentuale di aggiustamento delle offerte per tablet. Ad esempio, 0,2 significa un aumento del 20%, quindi le offerte per tablet sono 1,2 volte l'offerta predefinita. L'intervallo di valori validi varia in base al motore esterno. attributo Number
campaignDesktopBidAdjustment La percentuale di aggiustamento delle offerte per computer. Ad esempio, 0,2 significa un aumento del 20%, quindi le offerte per computer sono 1,2 volte l'offerta predefinita. L'intervallo di valori validi varia in base al motore esterno. attributo Number
networkTarget Il tipo di reti su cui viene pubblicizzata la campagna. attributo String No
yahooGeoTargets Targeting geografico per le campagne di Yahoo! Search Marketing. Consulta la sezione Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
campaignLabels Nomi delle etichette assegnate direttamente a questa campagna; le etichette ereditate non sono incluse. attributo String list
campaignType Indica il tipo di campagna: Manual, Inventory, Inventory - PLA, Shopping, Comparison shopping, Mobile app install, Universal app o Smart shopping. attributo Campaign type
effectiveBidStrategyId ID DS della strategia di offerta assegnata a questa entità oppure ereditata da questa entità. attributo ID
effectiveBidStrategy Il nome della strategia di offerta assegnata a questa entità oppure ereditata da questa entità. attributo String
bidStrategyInherited Indica se la strategia di offerta di questa entità è ereditata. attributo Boolean
deviceTargets Targeting per dispositivo a livello di campagna; una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
effectiveDeviceTargets Targeting per dispositivo a livello di campagna; una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
languageTargets Lingua target a livello di campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
countryTargets Paesi target inclusi nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
provinceTargets Regioni target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
metroTargets Regioni target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
cityTargets Città target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveCountryTargets Paesi target inclusi nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveProvinceTargets Regioni target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveMetroTargets Regioni target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveCityTargets Città target incluse nella campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
excludedCountryTargets Paesi target esclusi dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
excludedProvinceTargets Provincie target escluse dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
excludedMetroTargets Regioni target escluse dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
excludedCityTargets Città target escluse dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveLabels Nomi di tutte le etichette ereditate o assegnate direttamente a questa campagna. attributo String list
clicksWithFeedItemShowing Fa clic su qualsiasi link presente nell'annuncio mentre era visualizzato l'elemento del feed. Questa colonna restituisce solo un valore nel report di un elemento del feed o in un report segmentato in base a una colonna di elementi del feed. metrica Integer
costWithFeedItemShowing Costo di tutti gli annunci quando l'elemento del feed era pubblicato. Questa colonna restituisce solo un valore nel report di un elemento del feed o in un report segmentato in base a una colonna di elementi del feed. metrica Money
dfaActions Il numero totale di azioni di Campaign Manager. metrica Integer
dfaRevenue Entrate aggregate generate dalle transazioni di Campaign Manager. metrica Money
dfaTransactions Il numero totale di transazioni di Campaign Manager. metrica Integer
dfaWeightedActions Somma ponderata di azioni di Campaign Manager. metrica Number
dfaActionsCrossEnv Il numero totale di azioni Campaign Manager cross-environment. metrica Number
dfaRevenueCrossEnv Entrate aggregate generate dalle transazioni cross-environment di Campaign Manager. metrica Money
dfaTransactionsCrossEnv Il numero totale di transazioni Campaign Manager cross-environment. metrica Number
dfaWeightedActionsCrossEnv Somma ponderata di azioni Campaign Manager cross-environment. metrica Number
avgCpc Costo per clic medio. metrica Money
avgCpm Costo per mille impressioni medio. metrica Money
avgPos Posizione media. metrica Number
clicks Clic aggregati. metrica Integer
cost Costo aggregato pagato agli account motore. metrica Money
ctr Percentuale di clic media metrica Number
impr Il numero totale di impressioni. metrica Integer
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
adWordsConversionValue Valore aggregato delle conversioni di Google Ads. metrica Number
adWordsViewThroughConversions Il numero totale di conversioni view-through di Google Ads. metrica Integer
visits Il numero totale di visite in DS. metrica Integer
searchImpressionShare Solo Google Ads e Bing Ads. Il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, nella stringa < 10%. metrica Impression share
searchBudgetLostImpressionShare Solo Google Ads e Bing Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla rete di ricerca a causa di un budget insufficiente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share
searchRankLostImpressionShare Solo Google Ads e Bing Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla rete di ricerca a causa di un ranking dell'annuncio scadente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share
displayImpressionShare Solo Google Ads. Il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, nella stringa < 10%. metrica Impression share
displayBudgetLostImpressionShare Solo Google Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla Rete Display a causa di budget insufficiente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share
displayRankLostImpressionShare Solo Google Ads. Indica la percentuale di volte in cui i tuoi annunci non sono stati mostrati sulla Rete Display a causa di un ranking dell'annuncio scadente. Restituisce un numero compreso tra 0 e 0,9 oppure, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share
qualityScoreAvg Solo Google Ads e Bing Ads. La media ponderata in base alle impressioni del punteggio di qualità (QS) del motore in tutti i giorni e tutte le parole chiave nell'ambito del report. metrica Number
topOfPageBidAvg Solo Google Ads. Offre un valore approssimativo dell'offerta CPC media necessaria durante l'intervallo di tempo del report affinché gli annunci vengano visualizzati regolarmente nelle prime posizioni sopra i risultati di ricerca. metrica Money
absoluteTopImpressionPercentage La percentuale di impressioni dell'annuncio che viene mostrata come primo annuncio sopra i risultati di ricerca organica. metrica Impression share
searchAbsoluteTopImpressionShare Numero di impressioni ricevute nella posizione superiore assoluta (il primo annuncio sopra i risultati di ricerca organica) diviso per il numero stimato di impressioni che l'annuncio era idoneo a ricevere nella posizione superiore. metrica Impression share
topImpressionPercentage La percentuale di impressioni degli annunci che viene visualizzata in qualsiasi punto sopra i risultati di ricerca organica. metrica Impression share
searchTopImpressionShare Impressioni ricevute nella posizione superiore (ovunque sopra i risultati di ricerca organica) rispetto al numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. metrica Impression share
searchBudgetLostAbsoluteTopImpressionShare Indica con quale frequenza il tuo annuncio non è stato mostrato per primo sopra i risultati di ricerca organici a causa di un budget ridotto. metrica Impression share
searchBudgetLostTopImpressionShare Aiuta a capire la frequenza con cui il tuo annuncio non è stato pubblicato in nessuna posizione al di sopra dei risultati di ricerca organica a causa di un budget ridotto. metrica Impression share
searchRankLostAbsoluteTopImpressionShare Indica con quale frequenza il tuo annuncio non è stato mostrato per primo sopra i risultati di ricerca organica a causa di un ranking dell'annuncio scadente. metrica Impression share
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 scadente. metrica Impression share
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
sitelinkDisplayText Segmenta il report in base ai sitelink: ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce il testo visualizzato del sitelink di ogni riga. segmento String
sitelinkDescription1 Segmenta il report in base ai sitelink: ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione 1 del sitelink di ogni riga. segmento String
sitelinkDescription2 Segmenta il report in base ai sitelink: ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione 2 del sitelink di ogni riga. segmento String
sitelinkLandingPageUrl Segmenta il report in base ai sitelink: ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce l'URL pagina di destinazione del sitelink di ogni riga. segmento String
sitelinkClickserverUrl Segmenta il report in base ai sitelink: ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce l'URL clickserver del sitelink di ogni riga. segmento String
locationBusinessName Segmenta il report in base alle estensioni di località sottoposte ad upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni località in cui sono disponibili metriche. Questa colonna restituisce il nome dell'attività della sede per ogni riga. segmento String
locationCategory Segmenta il report in base alle estensioni di località sottoposte ad upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni località in cui sono disponibili metriche. Questa colonna restituisce la categoria della sede per ciascuna riga. segmento String
locationDetails Segmenta il report in base alle estensioni di località sottoposte ad upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni località in cui sono disponibili metriche. Questa colonna restituisce i dettagli di una sede per ciascuna riga. segmento String
locationFilter Segmenta il report in base alle estensioni di località sottoposte ad upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni località in cui sono disponibili metriche. Questa colonna restituisce il filtro della località per ogni riga. segmento String No
callPhoneNumber Segmenta il report in base all'estensione di chiamata; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il numero di telefono di un'estensione di chiamata. segmento String
callCountryCode Segmenta il report in base all'estensione di chiamata; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il codice paese di ogni riga dell'estensione di chiamata. segmento String
callIsTracked Segmenta il report in base all'estensione di chiamata; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce true se le chiamate dell'estensione di chiamata vengono monitorate, altrimenti false. segmento Boolean
callCallOnly Segmenta il report in base all'estensione di chiamata; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce true se l'estensione di chiamata mostra solo un numero di telefono oppure false se nell'estensione sono presenti sia un numero di telefono sia un link. segmento Boolean
callConversionTracker Segmenta il report in base alle estensioni di chiamata; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il nome del tracker conversioni associato all'elemento del feed, se esistente. segmento String
callConversionTrackerId Segmenta il report in base alle estensioni di chiamata; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce l'ID del tracker conversioni associato all'estensione di chiamata, se presente. segmento ID
appId Segmenta il report in base all'estensione per app; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione per app. Questa colonna restituisce l'ID app, se esistente. segmento String
appStore Segmenta il report in base all'estensione per app; ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni estensione per app. Questa colonna restituisce il tipo di store (Apple App Store, Google Play Store), se presente. segmento App store
feedItemId Segmenta il report in base agli elementi del feed: ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni elemento del feed. Questa colonna restituisce l'ID riga dell'elemento del feed di DS per ogni riga. segmento ID
feedId Segmenta il report in base agli elementi del feed: ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni elemento del feed. Questa colonna restituisce l'ID tabella del feed di DS per ogni riga. segmento ID
feedType Segmenta il report in base agli elementi del feed: ogni riga e le metriche aggregate vengono suddivise in più righe, una per ogni elemento del feed. Questa colonna restituisce il tipo di elemento del feed per ogni riga. segmento Feed type