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 Reports.request()).

Richiedi estratto

Invia un normale messaggio di errore Reports.request() corpo della richiesta, ma specifica "reportType": "adGroup". 

{
...
  "reportType": "adGroup",
  "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 Un alias per l'attributo adGroupStatus. attributo Status Sì
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 Sì
creationTimestamp Timestamp della creazione del gruppo di annunci, formattato in ISO 8601. attributo Timestamp Sì
lastModifiedTimestamp Timestamp della modifica più recente del gruppo di annunci, 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ì
adRotation Rotazione della pubblicazione di annunci utilizzata dal gruppo di annunci: Optimize o Rotate indefinitely. attributo String No
adGroup Nome gruppo di annunci. attributo String Sì
adGroupId ID gruppo di annunci DS. attributo ID Sì
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 stato diverso. Visualizza lo stato. attributo Status Sì
adGroupEngineId ID del gruppo di annunci nell'account motore esterno. attributo ID Sì
adGroupStartDate Data di inizio del gruppo di annunci. attributo Date Sì
adGroupEndDate Data di fine del gruppo di annunci. attributo Date Sì
adGroupSearchMaxCpc Offerta predefinita per le parole chiave per la rete di ricerca in questo gruppo di annunci. attributo Money Sì
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 Sì
adGroupExactMaxCpc Offerta predefinita per le parole chiave a corrispondenza esatta in questo gruppo di annunci (solo Bing Ads). attributo Money Sì
adGroupPhraseMaxCpc Offerta predefinita per le parole chiave con corrispondenza a frase in questo gruppo di annunci (solo Bing Ads). attributo Money Sì
adGroupContentMaxCpc Offerta predefinita per le parole chiave dei contenuti in questo gruppo di annunci. attributo Money Sì
adGroupMobileBidAdjustment La percentuale di aggiustamento delle offerte per i 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 Sì
adGroupTabletBidAdjustment La percentuale di aggiustamento delle offerte per i 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 Sì
adGroupDesktopBidAdjustment La percentuale di aggiustamento delle offerte per i computer desktop. Ad esempio, 0,2 significa un aumento del 20%, quindi le offerte per computer desktop sono 1,2 volte l'offerta predefinita. L'intervallo di valori validi varia in base al motore esterno. attributo Number Sì
adGroupType (Applicabile solo a Google Ads) Indica il tipo di gruppo di annunci: Standard, Dynamic o Showcase. attributo Ad group type Sì
bingAdsLanguage La lingua degli annunci e delle parole chiave in un gruppo di annunci Bing Ads. attributo Microsoft language code Sì
bingAdsAdDistributions canali di distribuzione degli annunci utilizzati dai gruppi di annunci di 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 Sì
effectiveBidStrategyId ID DS della strategia di offerta assegnata a questa entità o ereditato da questa entità. attributo ID Sì
effectiveBidStrategy Il nome della strategia di offerta assegnata a questa entità o ereditata da questa entità. attributo String Sì
bidStrategyInherited Indica se la strategia di offerta di questa entità viene ereditata. attributo Boolean Sì
deviceTargets Targeting per dispositivo a livello di gruppo di annunci. una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
effectiveDeviceTargets Targeting per dispositivo a livello di gruppo di annunci o ereditati dalla campagna. una combinazione di Desktop, Mobile, Tablet o Other. attributo String No
countryTargets Paesi target inclusi nel gruppo di annunci. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
provinceTargets Regioni target incluse nel gruppo di annunci. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
metroTargets Area metropolitana target inclusa nel gruppo di annunci. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
cityTargets Città target incluse nel gruppo di annunci. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
effectiveCountryTargets Paesi target inclusi nel gruppo di annunci o ereditati dalla campagna. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
effectiveProvinceTargets Regioni incluse nel gruppo di annunci o ereditate dalla campagna. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
effectiveMetroTargets Target area metropolitana inclusi nel gruppo di annunci o ereditati dalla campagna. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
effectiveCityTargets Città target incluse nel gruppo di annunci o ereditate dalla campagna. Scarica modelli di caricamento e codici geografici/di lingua. attributo String No
effectiveLabels Nomi di tutte le etichette ereditate o direttamente assegnate a questo gruppo di annunci. attributo String list Sì
engineRemarketingListTargetAll Indica se il gruppo di annunci utilizza solo i target di remarketing per aggiustare le offerte.

Valori possibili:

  • Sì: il gruppo di annunci utilizza i target di remarketing per aggiustare 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 Sì
clicksWithFeedItemShowing Clic su qualsiasi link dell'annuncio mentre era visualizzato l'elemento del feed. Questa colonna restituisce solo un valore in un report sugli elementi del feed o in un report segmentato in base a una colonna di elementi del feed. metrica Integer Sì
costWithFeedItemShowing Costo di tutti gli annunci quando l'elemento del feed era visibile. Questa colonna restituisce solo un valore in un report sugli elementi del feed o in un report segmentato in base a una colonna di elementi del feed. metrica Money 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ì
searchImpressionShare Solo Google Ads e Bing Ads. Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, la stringa < 10%. metrica Impression share Sì
searchRankLostImpressionShare Solo Google Ads e Bing Ads. Indica la percentuale di tempo 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 o, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share Sì
displayImpressionShare Solo Google Ads. Indica il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che avresti potuto ricevere. Restituisce un numero compreso tra 0,1 e 1 o, se la quota è inferiore a 0,1, la stringa < 10%. metrica Impression share Sì
displayRankLostImpressionShare Solo Google Ads. Indica la percentuale di tempo 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 o, se la quota è maggiore di 0,9, come stringa > 90%. metrica Impression share Sì
qualityScoreAvg Solo Google Ads e Bing Ads. La media ponderata in base alle impressioni del punteggio di qualità del motore per tutti i giorni e le parole chiave nell'ambito del report. metrica Number Sì
topOfPageBidAvg Solo Google Ads. Offre una stima approssimativa dell'offerta CPC media necessaria durante l'intervallo di tempo del rapporto affinché gli annunci vengano pubblicati regolarmente nelle prime posizioni sopra i risultati di ricerca. metrica Money Sì
absoluteTopImpressionPercentage Percentuale di impressioni dell'annuncio pubblicate come primo annuncio sopra i risultati di ricerca organica. metrica Impression share Sì
searchAbsoluteTopImpressionShare Impressioni ricevute nella posizione superiore assoluta (il primo annuncio sopra i risultati di ricerca organica) divise per il numero stimato di impressioni che avresti potuto ricevere nella posizione superiore. metrica Impression share Sì
topImpressionPercentage Percentuale di impressioni dell'annuncio pubblicate in qualsiasi punto sopra i risultati di ricerca organica. metrica Impression share Sì
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 Sì
searchRankLostAbsoluteTopImpressionShare Indica una stima della frequenza con cui il tuo annuncio non è stato il primo annuncio sopra i risultati di ricerca organica a causa di un ranking dell'annuncio scadente. metrica Impression share Sì
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 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ì
sitelinkDisplayText Segmenta il report per 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 Sì
sitelinkDescription1 Segmenta il report per sitelink; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione del sitelink 1 di ogni riga. segmento String Sì
sitelinkDescription2 Segmenta il report per sitelink; ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni sitelink. Questa colonna restituisce la descrizione del sitelink 2 di ogni riga. segmento String Sì
sitelinkLandingPageUrl Segmenta il report per 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 per ogni riga. segmento String Sì
sitelinkClickserverUrl Segmenta il report per 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 per ogni riga. segmento String Sì
locationBusinessName Segmenta il report in base alle estensioni di località aggiornate 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 Sì
locationCategory Segmenta il report in base alle estensioni di località aggiornate 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 località per ogni riga. segmento String Sì
locationDetails Segmenta il report in base alle estensioni di località aggiornate 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 su una località per ogni riga. segmento String Sì
locationFilter Segmenta il report in base alle estensioni di località aggiornate 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 rapporto in base all'estensione di chiamata. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce il numero di telefono di un'estensione di chiamata. segmento String Sì
callCountryCode Segmenta il rapporto in base all'estensione di chiamata. ogni riga e le relative metriche aggregate sono 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 Sì
callIsTracked Segmenta il rapporto in base all'estensione di chiamata. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione di chiamata. Questa colonna restituisce true se le chiamate dell'estensione di chiamata vengono monitorate, false in caso contrario. segmento Boolean Sì
callCallOnly Segmenta il rapporto in base all'estensione di chiamata. ogni riga e le relative metriche aggregate sono 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 Sì
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 Sì
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 Sì
appId Segmenta il rapporto in base all'estensione per app. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione per app. Questa colonna restituisce l'ID app, se presente. segmento String Sì
appStore Segmenta il rapporto in base all'estensione per app. ogni riga e le relative metriche aggregate sono suddivise in più righe, una per ogni estensione per app. Questa colonna restituisce il tipo di app store (Apple App Store, Google Play Store), se esistente. segmento App store Sì
feedItemId Segmenta il report per elementi del feed. ogni riga e le relative metriche aggregate sono 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 Sì
feedId Segmenta il report per elementi del feed. ogni riga e le relative metriche aggregate sono 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 Sì
feedType Segmenta il report per elementi del feed. ogni riga e le relative metriche aggregate sono 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 Sì