Metriche sul rendimento e attributi di configurazione per i target di prodotto. I target di prodotto sono stati utilizzati dalle campagne ASP di Google Ads per specificare quali prodotti in un account Google Merchant Center devono attivare la pubblicazione di annunci con scheda di prodotto (annunci Shopping) in ricerche correlate su Google. Le campagne ASP e i target di prodotto sono stati sostituiti dalle campagne Shopping. In DS puoi ancora richiedere report per le metriche storiche attribuite alle tue campagne ASP prima dell'upgrade alle campagne Shopping.
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": "productTarget".
{
...
"reportType": "productTarget",
"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.
columnName | Descrizione | Comportamento | Tipo | Filtrabile |
|---|---|---|---|---|
status |
Lo stato del target di prodotto: Active, Paused o Removed. Tieni presente che le campagne, i gruppi di annunci, i target di prodotto e gli annunci hanno ciascuno un proprio stato. Vedi lo stato. |
attributo | Status |
Sì |
engineStatus |
Stato aggiuntivo del target di prodotto nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) sono review, campaign paused e così via. |
attributo | String |
Sì |
creationTimestamp |
Timestamp della creazione del target di prodotto, in formato ISO 8601. | attributo | Timestamp |
Sì |
lastModifiedTimestamp |
Timestamp della modifica più recente del target di prodotto, formattato in ISO 8601. | attributo | Timestamp |
Sì |
agency |
Nome agenzia. | attributo | String |
Sì |
agencyId |
ID agenzia DS. | attributo | ID |
Sì |
advertiser |
Nome inserzionista. | attributo | String |
Sì |
advertiserId |
ID inserzionista DS. | attributo | ID |
Sì |
account |
Nome account motore. | attributo | String |
Sì |
accountId |
ID account motore di DS. | attributo | ID |
Sì |
accountEngineId |
ID dell'account nell'account motore esterno. | attributo | String |
Sì |
accountType |
Tipo di account motore: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu o Comparison Shopping. |
attributo | Engine type |
Sì |
campaign |
Nome campagna. | attributo | String |
Sì |
campaignId |
ID campagna DS. | attributo | ID |
Sì |
campaignStatus |
Lo stato della campagna che contiene questo elemento. | attributo | Status |
Sì |
adGroup |
Nome gruppo di annunci. | attributo | String |
Sì |
adGroupId |
ID gruppo di annunci DS. | attributo | ID |
Sì |
adGroupStatus |
Lo stato del gruppo di annunci che contiene questo elemento. | attributo | Status |
Sì |
productTargetId |
ID target di prodotto di DS. | attributo | ID |
Sì |
productTargetFilter |
Filtra i prodotti in un account Google Merchant Center con questo target di prodotto. Puoi specificare i criteri di corrispondenza utilizzando attributi come ID prodotto, brand e così via. | attributo | String |
No |
productTargetEngineId |
ID del target di prodotto nell'account motore esterno. | attributo | ID |
Sì |
productTargetLandingPage |
Il valore che indica l'URL finale che un utente deve visitare dopo aver fatto clic sul tuo annuncio Shopping. Consulta le pagine di destinazione degli annunci Shopping. | attributo | String |
Sì |
productTargetClickserverUrl |
L'URL utilizzato da DS per monitorare l'attività. Un utente che fa clic su un annuncio Shopping visita prima l'URL clickserver, quindi viene reindirizzato alla pagina di destinazione finale. Consulta le pagine di destinazione degli annunci Shopping. | attributo | String |
Sì |
productTargetLabels |
Nomi delle etichette assegnate direttamente a questo target di prodotto. Le etichette ereditate non sono incluse. | attributo | String list |
Sì |
productTargetMaxCpc |
Consente di ignorare il CPC max del gruppo di annunci e di impostare l'importo massimo che intendi pagare se un utente fa clic su un annuncio di prodotto per lo specifico target di prodotto. Se questo campo è vuoto, il target di prodotto utilizzerà il CPC max del gruppo di annunci. | attributo | Money |
Sì |
effectiveProductTargetMaxCpc |
Il CPC max (costo per clic massimo) attivo per questo target di prodotto. Può essere lo stesso valore del CPC max del gruppo di annunci o, se il target di prodotto sostituisce l'impostazione del gruppo di annunci, il CPC max del target di prodotto. | attributo | Money |
Sì |
productTargetMaxBid |
Se il target di prodotto è gestito da una strategia di offerta di DS, quest'ultima non aumenterà mai le offerte oltre questo limite. Vedi Applicare una strategia di offerta ai target di prodotto. | attributo | Money |
Sì |
productTargetMinBid |
Se questo target di prodotto è gestito da una strategia di offerta di DS, quest'ultima non ridurrà mai le offerte al di sotto di questo limite. Vedi Applicare una strategia di offerta ai target di prodotto. | attributo | Money |
Sì |
effectiveBidStrategyId |
ID DS della strategia di offerta assegnata a questa entità oppure ereditata da questa entità. | attributo | ID |
Sì |
effectiveBidStrategy |
Il nome della strategia di offerta assegnata a questa entità oppure ereditata da questa entità. | attributo | String |
Sì |
bidStrategyInherited |
Indica se la strategia di offerta di questa entità è ereditata. | attributo | Boolean |
Sì |
effectiveLabels |
Nomi di tutte le etichette ereditate o assegnate direttamente a questo target di prodotto. | attributo | String list |
Sì |
dfaActions |
Il numero totale di azioni di Campaign Manager. | metrica | Integer |
Sì |
dfaRevenue |
Entrate aggregate generate dalle transazioni di Campaign Manager. | metrica | Money |
Sì |
dfaTransactions |
Il numero totale di transazioni di Campaign Manager. | metrica | Integer |
Sì |
dfaWeightedActions |
Somma ponderata di azioni di Campaign Manager. | metrica | Number |
Sì |
dfaActionsCrossEnv |
Il numero totale di azioni Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaRevenueCrossEnv |
Entrate aggregate generate dalle transazioni cross-environment di Campaign Manager. | metrica | Money |
Sì |
dfaTransactionsCrossEnv |
Il numero totale di transazioni Campaign Manager cross-environment. | metrica | Number |
Sì |
dfaWeightedActionsCrossEnv |
Somma ponderata di azioni 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 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 |
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 in DS. | metrica | Integer |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |
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 |
Sì |