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.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
|---|---|---|---|---|
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:
|
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ì |