Tipo di rapporto: gruppo di annunci

Metriche sul rendimento e attributi di configurazione per i gruppi di 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": "adGroup".

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

columnNameDescrizioneComportamentoTipoFiltrabile
status Un alias per l'attributo adGroupStatus. attributo Status
engineStatus Stato aggiuntivo del gruppo di annunci nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) includono eligible, campaign ended e così via. attributo String
creationTimestamp Timestamp della creazione del gruppo di annunci, nel formato ISO 8601. attributo Timestamp
lastModifiedTimestamp Timestamp della modifica più recente del gruppo di annunci, nel formato ISO 8601. attributo Timestamp
agency Nome dell'agenzia. attributo String
agencyId ID agenzia DS. attributo ID
advertiser Nome dell'inserzionista. attributo String
advertiserId ID inserzionista DS. attributo ID
account Nome dell'account motore. attributo String
accountId ID account motore 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 che contiene questo elemento. attributo Status
adRotation La rotazione di pubblicazione degli annunci utilizzata dal gruppo di annunci: Optimize o Rotate indefinitely. attributo String No
adGroup Nome gruppo di annunci. attributo String
adGroupId ID gruppo di annunci DS. attributo ID
adGroupStatus Lo stato del gruppo di annunci: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, le parole chiave, gli annunci e i target hanno ciascuno un proprio stato. Visualizza lo stato. attributo Status
adGroupEngineId ID del gruppo di annunci nell'account motore esterno. attributo ID
adGroupStartDate Data di inizio del gruppo di annunci. attributo Date
adGroupEndDate Data di fine del gruppo di annunci. attributo Date
adGroupSearchMaxCpc Offerta predefinita per le parole chiave per la rete di ricerca in questo gruppo di annunci. attributo Money
adGroupBroadMaxCpc Offerta predefinita per le parole chiave a corrispondenza generica per la rete di ricerca in questo gruppo di annunci (solo Bing Ads). attributo Money
adGroupExactMaxCpc Offerta predefinita per le parole chiave con corrispondenza esatta in questo gruppo di annunci (solo Bing Ads). attributo Money
adGroupPhraseMaxCpc Offerta predefinita per le parole chiave di ricerca con corrispondenza a frase in questo gruppo di annunci (solo Bing Ads). attributo Money
adGroupContentMaxCpc Offerta predefinita per le parole chiave dei contenuti in questo gruppo di annunci. attributo Money
adGroupMobileBidAdjustment La percentuale di aggiustamento delle offerte per il mobile. Ad esempio, 0,2 indica un aumento del 20%, quindi le offerte per i dispositivi mobili sono 1,2 volte l'offerta predefinita. L'intervallo di valori validi varia in base al motore esterno. attributo Number
adGroupTabletBidAdjustment La percentuale di aggiustamento delle offerte per il tablet. Ad esempio, 0,2 indica 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
adGroupDesktopBidAdjustment La percentuale di aggiustamento delle offerte per computer. Ad esempio, 0,2 indica 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
adGroupType (Applicabile solo a Google Ads) Indica il tipo di gruppo di annunci: Standard, Dynamic o Showcase. attributo Ad group type
bingAdsLanguage La lingua degli annunci e delle parole chiave in un gruppo di annunci Bing Ads. attributo Microsoft language code
bingAdsAdDistributions Canali di distribuzione degli annunci utilizzati dai gruppi di annunci Bing Ads; una combinazione di Search e Content. attributo String No
adGroupLabels Nomi delle etichette assegnate direttamente a questo gruppo di annunci. Le etichette ereditate non sono incluse. attributo String list
effectiveBidStrategyId ID DS della strategia di offerta assegnata a questa entità o ereditata da questa entità. attributo ID
effectiveBidStrategy Il nome della strategia di offerta assegnata a questa entità o ereditata da questa entità. attributo String
bidStrategyInherited Indica se la strategia di offerta di questa entità è ereditata. attributo Boolean
deviceTargets Target dispositivo a livello di gruppo di annunci; una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
effectiveDeviceTargets Target dispositivo a livello di gruppo di annunci o ereditati dalla campagna; una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
countryTargets I paesi target inclusi nel gruppo di annunci. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
provinceTargets Province target incluse nel gruppo di annunci. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
metroTargets Target di regioni metropolitane inclusi nel gruppo di annunci. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
cityTargets Le città target incluse nel gruppo di annunci. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveCountryTargets I target di paese inclusi nel gruppo di annunci o ereditati dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveProvinceTargets Target delle province inclusi nel gruppo di annunci o ereditati dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveMetroTargets Target metropolitani inclusi nel gruppo di annunci o ereditati dalla campagna. Scarica i modelli di caricamento e i codici geografici/di lingua. attributo String No
effectiveCityTargets Le città target incluse nel gruppo di annunci o ereditate 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 questo gruppo di annunci. attributo String list
engineRemarketingListTargetAll Indica se il gruppo di annunci utilizza solo i target di remarketing per modificare le offerte.

Valori possibili:

  • Sì: il gruppo di annunci utilizza i target di remarketing per modificare le offerte.
  • No: il gruppo di annunci mostra gli annunci solo ai membri dei target di remarketing e può utilizzare i target di remarketing per aggiustare le offerte.
attributo Boolean
clicksWithFeedItemShowing Clic su qualsiasi link nell'annuncio durante la visualizzazione dell'elemento del feed. Questa colonna restituisce un valore solo in un report sugli elementi 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 un valore solo in un report sugli elementi 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 delle azioni di Campaign Manager. metrica Number
dfaActionsCrossEnv Il numero totale di azioni di Campaign Manager cross-environment. metrica Number
dfaRevenueCrossEnv Entrate aggregate generate dalle transazioni di Campaign Manager in più ambienti. metrica Money
dfaTransactionsCrossEnv Il numero totale di transazioni di Campaign Manager cross-environment. metrica Number
dfaWeightedActionsCrossEnv Somma ponderata delle azioni di Campaign Manager in più ambienti. 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 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
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 ai 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 avresti potuto ottenere. Viene restituito come numero compreso tra 0,1 e 1 oppure, se la quota è inferiore a 0,1, la stringa < 10%. metrica Impression share
searchRankLostImpressionShare Solo Google Ads e Bing Ads. La percentuale di tempo durante il quale i tuoi annunci non sono stati mostrati nella rete di ricerca a causa del ranking dell'annuncio scadente. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 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 avresti potuto ottenere. Viene restituito come numero compreso tra 0,1 e 1 oppure, se la quota è inferiore a 0,1, la stringa < 10%. metrica Impression share
displayRankLostImpressionShare Solo Google Ads. La percentuale di tempo durante il quale i tuoi annunci non sono stati mostrati sulla Rete Display a causa del ranking dell'annuncio scadente. Viene restituito come numero compreso tra 0 e 0,9 o, se la quota è superiore a 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à (PG) dell'algoritmo per tutti i giorni e le parole chiave nell'ambito del report. metrica Number
topOfPageBidAvg Solo Google Ads. Approssima l'offerta CPC media necessaria durante l'intervallo di tempo del report per la pubblicazione regolare dei tuoi annunci nelle prime posizioni sopra i risultati di ricerca. metrica Money
absoluteTopImpressionPercentage Percentuale di impressioni degli annunci pubblicate come primo annuncio sopra i risultati di ricerca organica. metrica Impression share
searchAbsoluteTopImpressionShare Impressioni ricevute nella posizione superiore assoluta (il primo annuncio sopra i risultati di ricerca organica) diviso per il numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. metrica Impression share
topImpressionPercentage Percentuale di impressioni degli annunci pubblicate in qualsiasi posizione al di sopra dei risultati di ricerca organica. metrica Impression share
searchTopImpressionShare Impressioni ricevute nella posizione superiore (in qualsiasi punto sopra i risultati di ricerca organica) rispetto al numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. metrica Impression share
searchRankLostAbsoluteTopImpressionShare Indica una stima della frequenza con cui il tuo annuncio non è stato il primo annuncio al di sopra dei risultati di ricerca organica a causa di un ranking dell'annuncio insufficiente. 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 insufficiente. metrica Impression share
date Suddivide il report in base ai 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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
sitelinkDisplayText Suddivide il report per sitelink. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce il testo visualizzato del sitelink di ogni riga. segmento String
sitelinkDescription1 Suddivide il report per sitelink; ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione 1 del sitelink di ogni riga. segmento String
sitelinkDescription2 Suddivide il report per sitelink. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione 2 del sitelink di ogni riga. segmento String
sitelinkLandingPageUrl Suddivide il report per sitelink. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce l'URL pagina di destinazione del sitelink di ogni riga. segmento String
sitelinkClickserverUrl Suddivide il report per sitelink. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce l'URL clickserver del sitelink di ogni riga. segmento String
locationBusinessName Suddivide il report in base alle estensioni di località di cui è stato eseguito l'upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni località per cui sono disponibili metriche. Questa colonna restituisce il nome dell'attività della stazione di ricarica per ogni riga. segmento String
locationCategory Suddivide il report in base alle estensioni di località di cui è stato eseguito l'upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni località per cui sono disponibili le metriche. Questa colonna restituisce la categoria della stazione di ricarica per ogni riga. segmento String
locationDetails Suddivide il report in base alle estensioni di località di cui è stato eseguito l'upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni località per cui sono disponibili le metriche. Questa colonna restituisce i dettagli di una località per ogni riga. segmento String
locationFilter Suddivide il report in base alle estensioni di località di cui è stato eseguito l'upgrade collegate a un account Profilo dell'attività. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni località per cui sono disponibili le metriche. Questa colonna restituisce il filtro della località per ogni riga. segmento String No
callPhoneNumber Suddivide il report per estensione di chiamata. Ogni riga e le relative 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 Suddivide il report per estensione di chiamata. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il codice paese dell'estensione di chiamata di ogni riga. segmento String
callIsTracked Suddivide il report per estensione di chiamata. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce true se le chiamate dell'estensione verranno monitorate, false in caso contrario. segmento Boolean
callCallOnly Suddivide il report per estensione di chiamata. Ogni riga e le relative 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 o false se l'estensione mostra sia un numero di telefono sia un link. segmento Boolean
callConversionTracker Suddivide il report per estensioni di chiamata. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il nome del tracker delle conversioni associato all'elemento del feed, se esistente. segmento String
callConversionTrackerId Suddivide il report per estensioni di chiamata. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce l'ID del tracker delle conversioni associato all'estensione di chiamata, se esistente. segmento ID
appId Suddivide il report in base all'estensione dell'app. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione dell'app. Questa colonna restituisce l'ID app, se esistente. segmento String
appStore Suddivide il report in base all'estensione dell'app. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni estensione dell'app. Questa colonna restituisce il tipo di store (App Store di Apple, Google Play Store), se esistente. segmento App store
feedItemId Suddivide il report in base agli elementi del feed. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni elemento del feed. Questa colonna restituisce l'ID riga dell'elemento del feed DS per ogni riga. segmento ID
feedId Suddivide il report in base agli elementi del feed. Ogni riga e le relative metriche aggregate vengono suddivise in più righe, una per ogni elemento del feed. Questa colonna restituisce l'ID della tabella del feed DS per ogni riga. segmento ID
feedType Suddivide il report in base agli elementi del feed. Ogni riga e le relative 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