Package google.ads.searchads360.v0.common

Indice

AdScheduleInfo

Rappresenta un criterio AdSchedule.

AdSchedule viene specificato il giorno della settimana e l'intervallo di tempo entro il quale verranno pubblicati gli annunci.

Non è possibile aggiungere più di sei pianificazioni annunci per lo stesso giorno.

Campi
start_minute

MinuteOfHour

Minuti dopo l'ora di inizio a cui inizia la programmazione.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

end_minute

MinuteOfHour

Minuti dopo l'ora di fine a cui termina la programmazione. La programmazione non comprende il minuto di fine.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

day_of_week

DayOfWeek

Giorno della settimana a cui si applica la pianificazione.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

start_hour

int32

Ora di inizio in formato 24 ore. Questo campo deve essere compreso tra 0 e 23 inclusi.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

end_hour

int32

Ora di fine nel formato 24 ore; 24 indica la fine della giornata. Questo campo deve essere compreso tra 0 e 24 inclusi.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

AgeRangeInfo

Un criterio di fascia d'età.

Campi
type

AgeRangeType

Tipo di fascia d'età.

AssetInteractionTarget

Un segmento AssetInteractionTarget.

Campi
asset

string

Il nome della risorsa asset.

interaction_on_this_asset

bool

Utilizzato solo con le metriche CustomerAsset, Asset Campaign e GruppoAnnunci. Indica se le metriche di interazione si sono verificate sull'asset stesso, su un asset o un'unità pubblicitaria differente.

AssetUsage

Contiene le informazioni sull'utilizzo della risorsa.

Campi
asset

string

Nome della risorsa.

served_asset_field_type

ServedAssetFieldType

Il tipo di campo pubblicato dell'asset.

AudienceInfo

Un criterio relativo al pubblico.

Campi
audience

string

Il nome della risorsa pubblico.

BusinessProfileLocation

Dati sulla sede del profilo dell'attività sincronizzati dall'account Profilo dell'attività collegato.

Campi
labels[]

string

L'inserzionista ha specificato l'etichetta per la sede nell'account Profilo dell'attività. Questa informazione viene sincronizzata dall'account Profilo dell'attività.

store_code

string

Codice negozio del Profilo dell'attività di questa sede. Questa informazione viene sincronizzata dall'account Profilo dell'attività.

listing_id

int64

ID scheda di questa sede del profilo dell'attività. Questa informazione viene sincronizzata dall'account Profilo dell'attività collegato.

CallToActionAsset

Un asset di invito all'azione.

Campi
call_to_action

CallToActionType

Invito all'azione.

CustomParameter

Una mappatura che può essere utilizzata dai tag di parametri personalizzati in un elemento tracking_url_template, final_urls o mobile_final_urls.

Campi
key

string

La chiave corrispondente al nome del tag del parametro.

value

string

Il valore da sostituire.

DeviceInfo

Un criterio relativo ai dispositivi.

Campi
type

Device

Tipo di dispositivo.

EnhancedCpc

Questo tipo non contiene campi.

Una strategia di offerta automatica che aumenta le offerte per i clic che sembrano avere maggiori probabilità di generare una conversione e le riduce per i clic laddove sembrano meno probabili.

Questa strategia di offerta è stata ritirata e non può più essere creata. Utilizza ManualCpc con CPC_enabled impostato su true per una funzionalità equivalente.

FrequencyCapEntry

Questo tipo non contiene campi.

Una regola che specifica il numero massimo di volte in cui un annuncio (o alcuni annunci) può essere mostrato a un utente in un determinato periodo di tempo.

GenderInfo

Un criterio di genere.

Campi
type

GenderType

Tipo del genere.

ImageAsset

Un asset immagine.

Campi
mime_type

MimeType

Tipo MIME dell'asset immagine.

full_size

ImageDimension

I metadati di questa immagine nelle dimensioni originali.

file_size

int64

Dimensioni del file dell'asset immagine in byte.

ImageDimension

I metadati di un'immagine di una determinata dimensione, originale o ridimensionata.

Campi
height_pixels

int64

Altezza dell'immagine.

width_pixels

int64

Larghezza dell'immagine.

url

string

Un URL che restituisce l'immagine con questa altezza e questa larghezza.

Parola chiave

Un segmento del criterio Parola chiave.

Campi
info

KeywordInfo

Informazioni sulla parola chiave.

ad_group_criterion

string

Il nome della risorsa Gruppo di annunci.

KeywordInfo

Un criterio per le parole chiave.

Campi
match_type

KeywordMatchType

Il tipo di corrispondenza della parola chiave.

text

string

Il testo della parola chiave (massimo 80 caratteri e 10 parole).

LanguageInfo

Un criterio linguistico.

Campi
language_constant

string

Il nome della risorsa della costante di lingua.

ListingGroupInfo

Un criterio del gruppo di schede.

Campi
type

ListingGroupType

Tipo di gruppo di schede.

LocationGroupInfo

Un raggio intorno a un elenco di località specificate tramite un feed.

Campi
geo_target_constants[]

string

Costanti di targeting geografico che limitano l'ambito dell'area geografica all'interno del feed. Attualmente è consentita una sola costante del targeting geografico.

radius_units

LocationGroupRadiusUnits

Unità del raggio. Le miglia e i metri sono supportati per le costanti di targeting geografico. Sono supportati i millisecondi e i metri per gli insiemi di elementi del feed. Questo campo è obbligatorio e deve essere impostato nelle operazioni di CREAZIONE.

feed_item_sets[]

string

FeedItemSet con elementi di feed scelti come target. Se vengono specificati più ID, vengono scelti come target tutti gli elementi presenti in almeno un insieme. Questo campo non può essere utilizzato con geo_target_constants. Questo attributo è facoltativo e può essere impostato solo nelle operazioni di CREAZIONE.

radius

int64

Distanza in unità che specifica il raggio intorno alle località target. Questo campo è obbligatorio e deve essere impostato nelle operazioni di CREAZIONE.

LocationInfo

Un criterio relativo alla località.

Campi
geo_target_constant

string

Il nome della risorsa costante del target geografico.

ManualCpa

Questo tipo non contiene campi.

Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta in base all'azione specificata dall'inserzionista.

ManualCpc

Offerta manuale basata sui clic in cui l'utente paga per ogni clic.

Campi
enhanced_cpc_enabled

bool

Indica se le offerte devono essere ottimizzate in base ai dati dello Strumento per ottimizzare le conversioni.

ManualCpm

Questo tipo non contiene campi.

Offerta manuale basata sulle impressioni in cui l'utente paga per mille impressioni.

MaximizeConversionValue

Una strategia di offerte automatiche per aiutarti a ottenere il massimo valore di conversione per le tue campagne entro i limiti di spesa del budget.

Campi
cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.

cpc_bid_floor_micros

int64

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.

target_roas

double

L'opzione Ritorno sulla spesa pubblicitaria (ROAS) target. Se impostata, la strategia di offerta massimizzerà le entrate con una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non essere in grado di spendere l'intero budget. Se non viene impostato il ROAS target, la strategia di offerta cercherà di raggiungere il ROAS più alto possibile per il budget.

MaximizeConversions

Una strategia di offerta automatica per consentire alle tue campagne di generare il maggior numero possibile di conversioni entro i limiti di spesa del budget.

Campi
cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.

cpc_bid_floor_micros

int64

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.

target_cpa_micros

int64

L'opzione del costo per azione (CPA) target. Indica l'importo medio che vuoi spendere per ogni azione di conversione specificata in micro unità della valuta della strategia di offerta. Se viene impostata, la strategia di offerta riceverà il maggior numero possibile di conversioni a un costo per azione target pari o inferiore. Se non viene impostato il CPA target, la strategia di offerta cercherà di raggiungere il CPA più basso possibile dato il budget.

Metriche

Dati delle metriche.

Campi
all_conversions_value_by_conversion_date

double

Il valore di tutte le conversioni. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli delle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

all_conversions_by_conversion_date

double

Il numero totale di conversioni. Include tutte le conversioni indipendentemente dal valore di include_in_conversions_metric. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli delle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

conversion_custom_metrics[]

Value

Le metriche personalizzate per le conversioni.

conversions_value_by_conversion_date

double

La somma del valore delle conversioni disponibili in base alla data di conversione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione.

conversions_by_conversion_date

double

La somma delle conversioni in base alla data di conversione per i tipi di conversione su cui è possibile fare offerte. Può essere frazionario a causa della definizione del modello di attribuzione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione.

historical_creative_quality_score

QualityScoreBucket

Il punteggio di qualità storico delle creatività.

historical_landing_page_quality_score

QualityScoreBucket

La qualità storica dell'esperienza sulla pagina di destinazione.

historical_search_predicted_ctr

QualityScoreBucket

La percentuale di clic (CTR) prevista della ricerca storica.

interaction_event_types[]

InteractionEventType

I tipi di interazioni a pagamento e senza costi.

raw_event_conversion_metrics[]

Value

Le metriche di conversione degli eventi non elaborate.

absolute_top_impression_percentage

double

La quota impressioni superiore assoluta sulla rete di ricerca è la percentuale di impressioni degli annunci della rete di ricerca pubblicati nella posizione più in evidenza nei risultati di ricerca.

all_conversions_from_interactions_rate

double

Tutte le conversioni generate dalle interazioni (opposte alle conversioni view-through) divise per il numero di interazioni con l'annuncio.

all_conversions_value

double

Il valore di tutte le conversioni.

all_conversions

double

Il numero totale di conversioni. Include tutte le conversioni indipendentemente dal valore di include_in_conversions_metric.

all_conversions_value_per_cost

double

Il valore di tutte le conversioni diviso per il costo totale delle interazioni con l'annuncio (ad es. clic su annunci di testo o visualizzazioni di annunci video).

all_conversions_from_click_to_call

double

Il numero di volte in cui gli utenti hanno fatto clic sul pulsante "Chiama" per chiamare un negozio durante o dopo aver fatto clic su un annuncio. Questo numero non include se le chiamate sono state connesse o la durata di eventuali chiamate.

Questa metrica si applica solo agli elementi del feed.

all_conversions_from_directions

double

Il numero di volte in cui gli utenti hanno fatto clic sul pulsante "Indicazioni stradali" per raggiungere un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

all_conversions_from_interactions_value_per_interaction

double

Il valore di tutte le conversioni generate dalle interazioni diviso per il numero totale di interazioni.

all_conversions_from_menu

double

Il numero di volte in cui gli utenti hanno fatto clic su un link per visualizzare il menu di un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

all_conversions_from_order

double

Il numero di volte in cui gli utenti hanno effettuato un ordine in un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

all_conversions_from_other_engagement

double

Il numero di altre conversioni (ad esempio, la pubblicazione di una recensione o il salvataggio della posizione di un negozio) che si sono verificate dopo che gli utenti hanno fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

all_conversions_from_store_visit

double

Numero stimato di volte in cui gli utenti hanno visitato un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

visits

double

Clic che Search Ads 360 ha registrato correttamente e inoltrato alla pagina di destinazione di un inserzionista.

all_conversions_from_store_website

double

Il numero di volte in cui gli utenti sono stati indirizzati all'URL di un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi del feed.

average_cost

double

L'importo medio pagato per ogni interazione. Questo importo corrisponde al costo totale dei tuoi annunci diviso per il numero totale di interazioni.

average_cpc

double

Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

average_cpm

double

Costo per mille impressioni (CPM) medio Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

int64

Il numero di clic.

content_budget_lost_impression_share

double

La percentuale stimata di volte in cui il tuo annuncio era idoneo alla pubblicazione sulla Rete Display, ma non lo è stato a causa del budget insufficiente. Nota: la quota impressioni perse a livello di budget per i contenuti è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

content_impression_share

double

Indica il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che avresti potuto ricevere. Nota: la quota impressioni sulla rete di contenuti è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

content_rank_lost_impression_share

double

La percentuale stimata di impressioni sulla Rete Display che gli annunci non hanno ricevuto a causa di un ranking dell'annuncio insufficiente. Nota: la quota impressioni perse nel ranking dei contenuti è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

conversions_from_interactions_rate

double

Conversioni disponibili medie (da interazioni) per interazione idonea alla conversione. Mostra la frequenza media con cui un'interazione con l'annuncio genera una conversione su cui è possibile fare offerte.

client_account_conversions_value

double

Il valore delle conversioni dell'account cliente. Sono incluse solo le azioni di conversione per le quali l'attributo metrica_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni.

conversions_value_per_cost

double

Il valore della conversione disponibile diviso per il costo totale delle interazioni idonee per la conversione.

conversions_from_interactions_value_per_interaction

double

Il valore delle conversioni generate dalle interazioni diviso per il numero di interazioni con l'annuncio. Sono incluse solo le azioni di conversione per le quali l'attributo include_in_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni.

client_account_conversions

double

Il numero di conversioni dell'account cliente. Sono incluse solo le azioni di conversione per le quali l'attributo metrica_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni.

cost_micros

int64

La somma dei costi relativi al costo per clic (CPC) e al costo per mille impressioni (CPM) durante questo periodo. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cost_per_all_conversions

double

Il costo delle interazioni con l'annuncio diviso per il numero di tutte le conversioni.

cost_per_conversion

double

Costo medio idoneo per le conversioni per conversione su cui è possibile fare offerte.

cost_per_current_model_attributed_conversion

double

Il costo delle interazioni con l'annuncio diviso per il numero di conversioni attribuite al modello attuale. Sono incluse solo le azioni di conversione per le quali l'attributo include_in_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni.

cross_device_conversions

double

Conversioni generate da quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un dispositivo o browser diverso. Le conversioni cross-device sono già incluse in all_conversions.

cross_device_conversions_value

double

La somma del valore delle conversioni cross-device.

ctr

double

Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).

conversions

double

Il numero di conversioni. Sono incluse solo le azioni di conversione per le quali l'attributo include_in_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni.

conversions_value

double

La somma dei valori delle conversioni incluse nel campo "conversioni". Questa metrica è utile solo se hai inserito un valore per le azioni di conversione.

historical_quality_score

int64

Il punteggio di qualità storico.

impressions

int64

Numero di pubblicazioni dell'annuncio su una pagina dei risultati di ricerca o su un sito web della Rete Google.

interaction_rate

double

Frequenza con cui gli utenti interagiscono con un annuncio dopo averlo visualizzato. Il numero di interazioni diviso per il numero di volte in cui l'annuncio viene pubblicato.

interactions

int64

Il numero di interazioni. Un'interazione è l'azione principale dell'utente associata ai clic su un formato dell'annuncio per gli annunci di testo e Shopping, le visualizzazioni per gli annunci video e così via.

invalid_click_rate

double

La percentuale di clic esclusi dal numero totale di clic (clic filtrati e non filtrati) durante il periodo del report.

invalid_clicks

int64

Numero di clic che Google considera illeciti e per i quali non addebita alcun costo.

mobile_friendly_clicks_percentage

double

La percentuale di clic da dispositivo mobile che indirizzano a una pagina ottimizzata per il mobile.

search_absolute_top_impression_share

double

La percentuale di impressioni degli annunci Shopping o della rete di ricerca del cliente pubblicate nella posizione Shopping più in evidenza. Per maggiori dettagli, visita la pagina https://support.google.com/sa360/answer/9566729. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

search_budget_lost_absolute_top_impression_share

double

Il numero che indica la frequenza con cui il tuo annuncio non è stato il primo annuncio tra i primi risultati di ricerca a causa di un budget ridotto. Nota: la quota impressioni superiore assoluta persa per il budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_budget_lost_impression_share

double

La percentuale stimata di volte in cui il tuo annuncio era idoneo alla pubblicazione sulla rete di ricerca, ma non lo è stato a causa del budget insufficiente. Nota: la quota impressioni perse a livello di budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_budget_lost_top_impression_share

double

Il numero che indica la frequenza con cui il tuo annuncio non è stato pubblicato accanto ai primi risultati di ricerca organica a causa di un budget ridotto. Nota: la quota impressioni superiore persa a causa del budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_click_share

double

Il numero di clic ricevuti sulla rete di ricerca diviso per il numero stimato di clic che avresti potuto ricevere. Nota: la quota clic di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

search_exact_match_impression_share

double

Il numero di impressioni ricevute diviso per il numero stimato di impressioni che avresti potuto ricevere sulla rete di ricerca per i termini di ricerca esattamente corrispondenti alle tue parole chiave (o che erano varianti simili della tua parola chiave), indipendentemente dai tipi di corrispondenza delle parole chiave. Nota: la quota impressioni con corrispondenza esatta sulla rete di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

search_impression_share

double

Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ricevere. Nota: la quota impressioni sulla rete di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

search_rank_lost_absolute_top_impression_share

double

Il numero che indica la frequenza con cui il tuo annuncio non è stato il primo annuncio tra i primi risultati di ricerca a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni superiore assoluta persa nel ranking di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_rank_lost_impression_share

double

La percentuale stimata di impressioni sulla rete di ricerca che gli annunci non hanno ricevuto a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse nel ranking di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_rank_lost_top_impression_share

double

Il numero che indica la frequenza con cui il tuo annuncio non è stato pubblicato accanto ai primi risultati di ricerca organica a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni superiore persa nel ranking di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001.

search_top_impression_share

double

Le impressioni che hai ricevuto tra gli annunci principali rispetto al numero stimato di impressioni che avresti potuto ricevere tra gli annunci principali. Nota: la quota impressioni superiore sulla rete di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

In genere, gli annunci nella parte superiore della pagina si trovano sopra i primi risultati organici, anche se per determinate query possono apparire sotto questi risultati.

top_impression_percentage

double

La percentuale di impressioni dell'annuncio pubblicate accanto ai primi risultati di ricerca organica.

value_per_all_conversions

double

Il valore di tutte le conversioni diviso per il numero di tutte le conversioni.

value_per_all_conversions_by_conversion_date

double

Il valore di tutte le conversioni diviso per il numero di tutte le conversioni. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli delle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

value_per_conversion

double

Il valore della conversione su cui è possibile fare offerte diviso per il numero di conversioni su cui è possibile fare offerte. Mostra il valore medio di ogni conversione disponibile.

value_per_conversions_by_conversion_date

double

Valore delle conversioni disponibili per l'offerta diviso per la data di conversione diviso per il valore delle conversioni disponibili per la data di conversione. Mostra il valore medio di ogni conversione disponibile (in base alla data di conversione). Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione.

client_account_view_through_conversions

int64

Il numero totale di conversioni view-through. che si verificano quando un cliente visualizza un annuncio illustrato o rich media e successivamente completa una conversione sul tuo sito senza interagire con un altro annuncio (ad esempio facendo clic sopra).

client_account_cross_sell_cost_of_goods_sold_micros

int64

Il costo del venduto da cross-sell dell'account cliente (CDV) è il costo totale dei prodotti venduti come risultato della pubblicità di un altro prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Il costo del venduto da cross-sell è il costo totale dei prodotti venduti che non sono stati pubblicizzati. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da cross-sell per questo ordine è pari a 5 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_cost_of_goods_sold_micros

int64

Il costo del venduto da cross-sell (CDV) è il costo totale dei prodotti venduti come risultato della pubblicità di un altro prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Il costo del venduto da cross-sell è il costo totale dei prodotti venduti che non sono stati pubblicizzati. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da cross-sell per questo ordine è pari a 5 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_gross_profit_micros

int64

Il profitto lordo da cross-sell dell'account cliente è il profitto generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso, meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Il profitto lordo da cross-sell è costituito dalle entrate generate dal cross-sell attribuito ai tuoi annunci meno il costo del venduto. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. La camicia ha un prezzo di 20 $ e un valore per il costo del venduto pari a 5 $. Il profitto lordo da cross-sell di questo ordine è di 15 $ (20 $ - 5 $). Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_gross_profit_micros

int64

Il profitto lordo da cross-sell è il profitto generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso, meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Il profitto lordo da cross-sell è costituito dalle entrate generate dal cross-sell attribuito ai tuoi annunci meno il costo del venduto. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. La camicia ha un prezzo di 20 $ e un valore per il costo del venduto pari a 5 $. Il profitto lordo da cross-sell di questo ordine è di 15 $ (20 $ - 5 $). Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_revenue_micros

int64

Le entrate da cross-sell dell'account cliente sono l'importo totale ricavato dai prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Le entrate da cross-sell corrispondono al valore totale generato dal cross-sell attribuito ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da cross-sell di questo ordine sono pari a 20 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cross_sell_revenue_micros

int64

Le entrate da cross-sell corrispondono all'importo totale generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Le entrate da cross-sell corrispondono al valore totale generato dal cross-sell attribuito ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da cross-sell di questo ordine sono pari a 20 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_units_sold

double

Le unità vendute da cross-sell dell'account cliente indicano il numero totale di prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Le unità vendute da cross-sell indicano il numero totale di prodotti venduti da cross-sell di tutti gli ordini attribuiti ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità vendute da cross-sell in questo ordine sono pari a 2. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.

cross_sell_units_sold

double

Le unità vendute da cross-sell indicano il numero totale di prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, il processo è considerato cross-sell. Le unità vendute da cross-sell indicano il numero totale di prodotti venduti da cross-sell di tutti gli ordini attribuiti ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità vendute da cross-sell in questo ordine sono pari a 2. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.

client_account_lead_cost_of_goods_sold_micros

int64

Il costo del venduto (CDV) dell'account cliente è il costo totale dei prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione è associato a un prodotto (vedi Annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il costo di questi prodotti viene conteggiato nel costo del venduto da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da lead per questo ordine è pari a 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_cost_of_goods_sold_micros

int64

Il costo del venduto da lead (CDV) è il costo totale dei prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione è associato a un prodotto (vedi Annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il costo di questi prodotti viene conteggiato nel costo del venduto da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da lead per questo ordine è pari a 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_gross_profit_micros

int64

Il profitto lordo da lead dell'account cliente è il profitto generato dai prodotti venduti come risultato della pubblicità dello stesso prodotto meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il profitto lordo da lead corrisponde alle entrate generate da queste vendite meno il costo del venduto il costo di questi prodotti. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e ha un valore per il costo del venduto pari a 3 €. Il profitto lordo da lead di questo ordine è 7 € = 10 € - 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_gross_profit_micros

int64

Il profitto lordo da lead è il profitto generato dai prodotti venduti come risultato della pubblicità dello stesso prodotto meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il profitto lordo da lead corrisponde alle entrate generate da queste vendite meno il costo del venduto il costo di questi prodotti. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e ha un valore per il costo del venduto pari a 3 €. Il profitto lordo da lead di questo ordine è 7 € = 10 € - 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_revenue_micros

int64

Le entrate da lead dell'account cliente corrispondono all'importo totale ricavato dai prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il valore totale ricavato dalle vendite di questi prodotti viene visualizzato nelle entrate da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da lead di questo ordine sono pari a 10 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

lead_revenue_micros

int64

Le entrate da lead sono l'importo totale ricavato dai prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il valore totale ricavato dalle vendite di questi prodotti viene visualizzato nelle entrate da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da lead di questo ordine sono pari a 10 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario ed è restituito per impostazione predefinita nella valuta del cliente. Consulta il parametro metric_currency alla pagina https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_units_sold

double

Le unità lead account cliente vendute indicano il numero totale di prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il numero totale di questi prodotti viene visualizzato nelle unità lead vendute. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità lead vendute in questo ordine sono pari a 1. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.

lead_units_sold

double

Le unità lead vendute sono il numero totale di prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi gli annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il numero totale di questi prodotti viene visualizzato nelle unità lead vendute. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità lead vendute in questo ordine sono pari a 1. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.

MobileAppAsset

Un asset che rappresenta un'app mobile.

Campi
app_id

string

obbligatorio. Una stringa che identifica in modo univoco un'applicazione mobile. Deve contenere solo l'ID nativo della piattaforma, ad esempio "com.android.ebay" per Android o "12345689" per iOS.

app_store

MobileAppVendor

obbligatorio. Lo store che distribuisce questa app specifica.

PercentCpc

Una strategia di offerta in cui le offerte sono una frazione del prezzo pubblicizzato per un bene o servizio.

Campi
cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Questo è un campo facoltativo inserito dall'inserzionista e specificato in micro locali. Nota: un valore zero viene interpretato come se il valore dell'offerta_max non sia definito.

enhanced_cpc_enabled

bool

Aumenta o diminuisce l'offerta per ogni asta in base alla probabilità che si verifichi una conversione. Le offerte individuali possono superare cpc_bid_until_micros, mentre l'importo di offerta medio per una campagna non dovrebbe.

RealTimeBiddingSetting

Impostazioni per le offerte in tempo reale, una funzione disponibile solo per le campagne destinate alla rete Ad Exchange.

Campi
opt_in

bool

Se per la campagna sono state attivate le offerte in tempo reale.

SearchAds360ExpandedDynamicSearchAdInfo

Un annuncio dinamico della rete di ricerca espanso.

Campi
description1

string

La prima riga della descrizione dell'annuncio.

description2

string

La seconda riga della descrizione dell'annuncio.

ad_tracking_id

int64

L'ID di monitoraggio dell'annuncio.

SearchAds360ExpandedTextAdInfo

Un annuncio di testo espanso di Search Ads 360.

Campi
headline

string

Titolo dell'annuncio.

headline2

string

Il secondo titolo dell'annuncio.

headline3

string

Il terzo titolo dell'annuncio.

description1

string

La prima riga della descrizione dell'annuncio.

description2

string

La seconda riga della descrizione dell'annuncio.

path1

string

Testo aggiunto all'URL visibile generato automaticamente con un delimitatore.

path2

string

Testo aggiunto al percorso 1 con un delimitatore.

ad_tracking_id

int64

L'ID di monitoraggio dell'annuncio.

SearchAds360ProductAdInfo

Questo tipo non contiene campi.

Un annuncio di prodotto di Search Ads 360.

SearchAds360ResponsiveSearchAdInfo

Un annuncio adattabile della rete di ricerca Search Ads 360.

Campi
path1

string

Testo aggiunto all'URL visibile generato automaticamente con un delimitatore.

path2

string

Testo aggiunto al percorso 1 con un delimitatore.

ad_tracking_id

int64

L'ID di monitoraggio dell'annuncio.

SearchAds360TextAdInfo

Un annuncio di testo di Search Ads 360.

Campi
headline

string

Titolo dell'annuncio.

description1

string

La prima riga della descrizione dell'annuncio.

description2

string

La seconda riga della descrizione dell'annuncio.

display_url

string

L'URL visualizzato dell'annuncio.

display_mobile_url

string

L'URL mobile visualizzato dell'annuncio.

ad_tracking_id

int64

L'ID di monitoraggio dell'annuncio.

Segmenti

Soltanto i campi dei segmenti.

Campi
ad_network_type

AdNetworkType

Tipo di rete pubblicitaria.

conversion_action_category

ConversionActionCategory

Categoria dell'azione di conversione.

conversion_custom_dimensions[]

Value

Le dimensioni personalizzate per le conversioni.

day_of_week

DayOfWeek

Giorno della settimana, ad esempio MONDAY.

device

Device

Dispositivo a cui si applicano le metriche.

keyword

Keyword

Criterio parola chiave.

product_channel

ProductChannel

Il canale del prodotto.

product_channel_exclusivity

ProductChannelExclusivity

Esclusività del canale del prodotto.

product_condition

ProductCondition

Condizione del prodotto.

product_sold_condition

ProductCondition

Condizione del prodotto venduto.

raw_event_conversion_dimensions[]

Value

Le dimensioni di conversione degli eventi non elaborate.

conversion_action

string

Nome risorsa dell'azione di conversione.

conversion_action_name

string

Nome dell'azione di conversione.

date

string

Data a cui si applicano le metriche, formato aaaa-MM-gg, ad esempio 2018-04-17.

month

string

Mese rappresentato dalla data del primo giorno di un mese. Con il formato aaaa-MM-gg.

product_bidding_category_level1

string

Categoria di offerta (livello 1) del prodotto.

product_bidding_category_level2

string

Categoria di offerta (livello 2) del prodotto.

product_bidding_category_level3

string

Categoria di offerta (livello 3) del prodotto.

product_bidding_category_level4

string

Categoria di offerta (livello 4) del prodotto.

product_bidding_category_level5

string

Categoria di offerta (livello 5) del prodotto.

product_brand

string

La marca del prodotto.

product_country

string

Nome risorsa della costante di targeting geografico per il paese di vendita del prodotto.

product_custom_attribute0

string

Attributo personalizzato 0 del prodotto.

product_custom_attribute1

string

Attributo personalizzato 1 del prodotto.

product_custom_attribute2

string

Attributo personalizzato 2 del prodotto.

product_custom_attribute3

string

Attributo personalizzato 3 del prodotto.

product_custom_attribute4

string

Attributo personalizzato 4 del prodotto.

product_item_id

string

ID articolo del prodotto.

product_language

string

Nome di risorsa della costante della lingua per la lingua del prodotto.

product_sold_bidding_category_level1

string

Categoria di offerta (livello 1) del prodotto venduto.

product_sold_bidding_category_level2

string

Categoria di offerta (livello 2) del prodotto venduto.

product_sold_bidding_category_level3

string

Categoria di offerta (livello 3) del prodotto venduto.

product_sold_bidding_category_level4

string

Categoria di offerta (livello 4) del prodotto venduto.

product_sold_bidding_category_level5

string

Categoria di offerta (livello 5) del prodotto venduto.

product_sold_brand

string

La marca del prodotto venduto.

product_sold_custom_attribute0

string

Attributo personalizzato 0 del prodotto venduto.

product_sold_custom_attribute1

string

Attributo personalizzato 1 del prodotto venduto.

product_sold_custom_attribute2

string

Attributo personalizzato 2 del prodotto venduto.

product_sold_custom_attribute3

string

Attributo personalizzato 3 del prodotto venduto.

product_sold_custom_attribute4

string

Attributo personalizzato 4 del prodotto venduto.

product_sold_item_id

string

ID articolo del prodotto venduto.

product_sold_title

string

Titolo del prodotto venduto.

product_sold_type_l1

string

Tipo (livello 1) di prodotto venduto.

product_sold_type_l2

string

Tipo (livello 2) di prodotto venduto.

product_sold_type_l3

string

Tipo (livello 3) di prodotto venduto.

product_sold_type_l4

string

Tipo (livello 4) di prodotto venduto.

product_sold_type_l5

string

Tipo (livello 5) del prodotto venduto.

product_store_id

string

ID negozio del prodotto.

product_title

string

Titolo del prodotto.

product_type_l1

string

Tipo (livello 1) del prodotto.

product_type_l2

string

Tipo (livello 2) del prodotto.

product_type_l3

string

Tipo (livello 3) del prodotto.

product_type_l4

string

Tipo (livello 4) del prodotto.

product_type_l5

string

Tipo (livello 5) del prodotto.

quarter

string

Trimestre rappresentato dalla data del primo giorno di un trimestre. Utilizza l'anno di calendario per i trimestri; ad esempio, il secondo trimestre del 2018 inizia il 01-04-2018. Con il formato aaaa-MM-gg.

week

string

Settimana definita da lunedì a domenica e rappresentata dalla data di lunedì. Con il formato aaaa-MM-gg.

year

int32

Anno, formattato come aaaa.

asset_interaction_target

AssetInteractionTarget

Utilizzato solo con le metriche CustomerAsset, Asset Campaign e GruppoAnnunci. Indica se le metriche di interazione si sono verificate sull'asset stesso, su un asset o un'unità pubblicitaria differente. Quando vengono pubblicati insieme, le interazioni (ad esempio i clic) vengono conteggiate in tutte le parti dell'annuncio pubblicato, ad esempio l'annuncio stesso e altri componenti come i sitelink. Se interazioni_on_this_asset è true, significa che le interazioni si verificano su questo asset specifico, e se actions_on_this_asset è falso, significa che le interazioni non sono su questo asset specifico, ma su altre parti dell'annuncio pubblicato con cui viene pubblicato questo asset.

TargetCpa

Una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato.

Campi
target_cpa_micros

int64

CPA target medio Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account.

cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio.

cpc_bid_floor_micros

int64

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio.

TargetCpm

Questo tipo non contiene campi.

Il CPM (costo per mille impressioni) target è una strategia di offerta automatica che imposta le offerte in modo da ottimizzare il rendimento in base al CPM target impostato.

TargetImpressionShare

Una strategia di offerta automatica che imposta le offerte in modo da pubblicare una determinata percentuale di annunci della rete di ricerca nella parte superiore della prima pagina o in un'altra località target.

Campi
location

TargetImpressionShareLocation

La località target nella pagina dei risultati di ricerca.

location_fraction_micros

int64

La frazione scelta di annunci da mostrare nella località target in micro. Ad esempio, 1% equivale a 10.000.

cpc_bid_ceiling_micros

int64

L'offerta CPC più alta che il sistema delle offerte automatiche è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che stabilisce il tetto massimo e specificato in micro locali.

TargetOutrankShare

Una strategia di offerta automatica che imposta le offerte in base alla frazione target delle aste in cui l'inserzionista deve superare un determinato concorrente. Questa strategia è stata ritirata.

Campi
cpc_bid_ceiling_micros

Int64Value

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.

TargetRestriction

L'elenco di impostazioni di targeting per dimensione di targeting.

Campi
targeting_dimension

TargetingDimension

La dimensione di targeting a cui si applicano queste impostazioni.

bid_only

bool

Indica se limitare la pubblicazione degli annunci solo per i criteri selezionati per targeting_dimension o se scegliere come target tutti i valori di targeting_dimension e mostrare gli annunci in base al targeting in altre dimensioni del targeting. Il valore true indica che questi criteri applicano solo i modificatori di offerta e non influiscono sul targeting. Il valore false indica che questi criteri limiteranno il targeting e verranno applicati modificatori di offerta.

TargetRoas

Una strategia di offerta automatica che ti aiuta a massimizzare le entrate con un ritorno sulla spesa pubblicitaria (ROAS) target medio specifico.

Campi
target_roas

double

obbligatorio. Le entrate scelte (in base ai dati sulle conversioni) per unità di spesa. Il valore deve essere compreso tra 0,01 e 1000,0 inclusi.

cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio.

cpc_bid_floor_micros

int64

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio.

TargetSpend

Una strategia di offerta automatica che imposta le offerte in modo da farti ottenere il maggior numero possibile di clic in base al tuo budget.

Campi
target_spend_micros
(deprecated)

int64

Il target di spesa in base al quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere un importo minore tra questo valore o l'importo di spesa naturale per la limitazione. Se non specificato, viene utilizzato il budget come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per informazioni dettagliate, visita la pagina https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.

TargetingSetting

Impostazioni per le funzionalità relative al targeting, a livello di campagna e di gruppo di annunci. Per ulteriori dettagli sull'impostazione di targeting, consulta la pagina https://support.google.com/google-ads/answer/7365594

Campi
target_restrictions[]

TargetRestriction

L'impostazione per dimensione di targeting consente di limitare la copertura della campagna o del gruppo di annunci.

TextAsset

Un asset di testo.

Campi
text

string

Contenuti testuali dell'asset di testo.

TextLabel

Un tipo di etichetta che mostra testo su uno sfondo colorato.

Campi
background_color

string

Colore di sfondo dell'etichetta in formato RGB. Questa stringa deve corrispondere all'espressione regolare "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". Nota: il colore di sfondo potrebbe non essere visibile per gli account amministratore.

description

string

Una breve descrizione dell'etichetta. La lunghezza non deve superare i 200 caratteri.

UnifiedCallAsset

Un asset di chiamata unificato.

Campi
country_code

string

Il codice paese di due lettere del numero di telefono. Esempi: 'IT', 'us'.

phone_number

string

Il numero di telefono non elaborato dell'inserzionista. Esempi: "1234567890", "(123)456-7890"

call_conversion_reporting_state

CallConversionReportingState

Indica se questo asset di chiamata deve utilizzare la propria impostazione di conversione di chiamata, seguire l'impostazione a livello di account o disattivare la conversione di chiamata.

call_conversion_action

string

L'azione di conversione a cui attribuire una conversione di chiamata. Se non viene configurato, viene utilizzata l'azione di conversione predefinita. Questo campo ha effetto solo se call_conversion_reporting_state è impostato su USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

ad_schedule_targets[]

AdScheduleInfo

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. È possibile specificare un massimo di 6 programmazioni al giorno, per un totale di 42.

call_only

bool

Se la chiamata mostra solo il numero di telefono senza un link al sito web. Si applica agli annunci Microsoft.

call_tracking_enabled

bool

Indica se la chiamata deve essere attivata sul monitoraggio delle chiamate. Si applica agli annunci Microsoft.

use_searcher_time_zone

bool

Se mostrare l'estensione di chiamata nel fuso orario dell'utente che effettua la ricerca. Si applica agli annunci Microsoft.

start_date

string

Data di inizio in cui l'asset entrerà in vigore e potrà iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data ultima di entrata in vigore dell'asset e ancora in fase di pubblicazione, nel formato aaaa-MM-gg.

UnifiedCalloutAsset

Un asset callout unificato.

Campi
callout_text

string

Il testo del callout. La lunghezza di questa stringa deve essere compresa tra 1 e 25 inclusi.

start_date

string

Data di inizio in cui l'asset entrerà in vigore e potrà iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data ultima di entrata in vigore dell'asset e ancora in fase di pubblicazione, nel formato aaaa-MM-gg.

ad_schedule_targets[]

AdScheduleInfo

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. È possibile specificare un massimo di 6 programmazioni al giorno, per un totale di 42.

use_searcher_time_zone

bool

Indica se mostrare l'asset nel fuso orario dell'utente della ricerca. Si applica agli annunci Microsoft.

UnifiedLocationAsset

Un asset posizione unificato.

Campi
place_id

string

Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Questo campo è univoco per un determinato ID cliente e tipo di asset. Per saperne di più sull'ID luogo, visita la pagina https://developers.google.com/places/web-service/place-id.

business_profile_locations[]

BusinessProfileLocation

L'elenco delle sedi dell'attività commerciale del cliente. Verrà restituito solo se l'asset posizione viene sincronizzato dall'account Profilo dell'attività. È possibile avere più schede del profilo dell'attività nello stesso account che rimandano allo stesso ID luogo.

location_ownership_type

LocationOwnershipType

Il tipo di proprietà della sede. Se il tipo è BUSINESS_OWNER, verrà pubblicata come estensione di località. Se il tipo è AFFILIATO, verrà pubblicato come sede dell'affiliato.

UnifiedPageFeedAsset

Un asset del feed di pagine unificato.

Campi
page_url

string

La pagina web che gli inserzionisti vogliono scegliere come target.

labels[]

string

Etichette utilizzate per raggruppare gli URL delle pagine.

UnifiedSitelinkAsset

Un asset sitelink unificato.

Campi
description1

string

Prima riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 inclusi ed è necessario impostare anche description2.

description2

string

Seconda riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 inclusi ed è necessario impostare anche descrizione1.

start_date

string

Data di inizio in cui l'asset entrerà in vigore e potrà iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data ultima di entrata in vigore dell'asset e ancora in fase di pubblicazione, nel formato aaaa-MM-gg.

ad_schedule_targets[]

AdScheduleInfo

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. È possibile specificare un massimo di 6 programmazioni al giorno, per un totale di 42.

tracking_id

int64

ID utilizzato per monitorare i clic per l'asset sitelink. Questo è un account motore Yahoo! Japan.

use_searcher_time_zone

bool

Se mostrare l'asset sitelink nel fuso orario dell'utente che effettua la ricerca. Si applica agli annunci Microsoft.

mobile_preferred

bool

Indica se la preferenza riguarda la visualizzazione dell'asset sitelink sui dispositivi mobili. Si applica agli annunci Microsoft.

UserListInfo

Un criterio dell'elenco utenti. Rappresenta un elenco di utenti definito dall'inserzionista da scegliere come target.

Campi
user_list

string

Il nome della risorsa elenco utenti.

Valore

Un contenitore di dati generico.

Campi
Campo di unione value. Un valore. value può essere solo uno dei seguenti:
boolean_value

bool

Un valore booleano.

int64_value

int64

Un file int64.

float_value

float

Un galleggiante.

double_value

double

Un doppio.

string_value

string

Una stringa.

WebpageConditionInfo

Espressione logica per il targeting di pagine web del sito web di un inserzionista.

Campi
operand

WebpageConditionOperand

Operando della condizione di targeting della pagina web.

operator

WebpageConditionOperator

Operatore della condizione di targeting della pagina web.

argument

string

Argomento della condizione di targeting della pagina web.

WebpageInfo

Rappresenta un criterio per il targeting di pagine web del sito web di un inserzionista.

Campi
conditions[]

WebpageConditionInfo

Condizioni, o espressioni logiche, per il targeting di pagine web. L'elenco di condizioni di targeting di pagine web viene combinato durante la valutazione per il targeting. Un elenco di condizioni vuoto indica che tutte le pagine del sito web della campagna sono scelte come target.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

coverage_percentage

double

Percentuale di copertura dei criteri dei siti web. È la percentuale calcolata della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, significa che ha una copertura al 100%. Questo campo è di sola lettura.

criterion_name

string

Il nome del criterio definito da questo parametro. Il valore del nome verrà utilizzato per identificare, ordinare e filtrare i criteri con questo tipo di parametri.

Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.

YoutubeVideoAsset

Una risorsa di YouTube.

Campi
youtube_video_title

string

Titolo del video di YouTube.

youtube_video_id

string

ID video di YouTube. Si tratta del valore di una stringa di 11 caratteri utilizzato nell'URL del video di YouTube.