Package google.ads.searchads360.v0.common

Indice

AdScheduleInfo

Rappresenta un criterio AdSchedule.

La pianificazione annunci viene indicata come il giorno della settimana e l'intervallo di tempo entro il quale verranno pubblicati gli annunci.

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

Campi
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

Minuti dopo l'ora di fine in cui termina la pianificazione. Il programma non include il minuto di fine.

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

day_of_week

DayOfWeek

Giorno della settimana a cui si applica la pianificazione.

Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni 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 CREATE ed è vietato per le operazioni UPDATE.

end_hour

int32

Ora di fine in 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 CREATE ed è vietato per le operazioni UPDATE.

AdTextAsset

Un asset di testo utilizzato all'interno di un annuncio.

Campi
text

string

Testo dell'asset.

AgeRangeInfo

Un criterio della fascia di età.

Campi
type

AgeRangeType

Tipo di fascia d'età.

AssetInteractionTarget

Un segmento AssetInteractionTarget.

Campi
asset

string

Il nome della risorsa dell'asset.

interaction_on_this_asset

bool

Utilizzato solo con le metriche AssetClient, Asset Campagna e Asset gruppo di annunci. Indica se le metriche di interazione si sono verificate sull'asset stesso oppure su un altro asset o un'unità pubblicitaria diverso.

AssetUsage

Contiene le informazioni di utilizzo della risorsa.

Campi
asset

string

Nome risorsa dell'asset.

served_asset_field_type

ServedAssetFieldType

Il tipo di campo pubblicato dell'asset.

AudienceInfo

Un criterio del segmento di pubblico.

Campi
audience

string

Il nome della risorsa Audience.

BusinessProfileLocation

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

Campi
labels[]

string

Etichetta specificata dall'inserzionista per la sede nell'account Profilo dell'attività. Questo valore viene sincronizzato dall'account Profilo dell'attività.

store_code

string

Codice negozio del profilo dell'attività di questa sede. Questo valore viene sincronizzato dall'account Profilo dell'attività.

listing_id

int64

ID scheda di questa sede del profilo dell'attività. Questa azione viene sincronizzata dall'account del 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 dei parametri personalizzati in tracking_url_template, final_urls o mobile_final_urls.

Campi
key

string

La chiave corrispondente al nome del tag parametro.

value

string

Il valore da sostituire.

DeviceInfo

Un criterio dispositivo.

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 hanno maggiori probabilità di generare una conversione e le riduce per i clic dove sembrano meno probabili.

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

FrequencyCapEntry

Questo tipo non contiene campi.

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

GenderInfo

Un criterio relativo al genere.

Campi
type

GenderType

Tipo di genere.

ImageAsset

Un asset immagine.

Campi
mime_type

MimeType

Tipo MIME dell'asset immagine.

full_size

ImageDimension

I metadati per questa immagine nelle loro dimensioni originali.

file_size

int64

Dimensioni del file dell'asset immagine in byte.

ImageDimension

Metadati relativi a 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 Criterio parola chiave.

Campi
info

KeywordInfo

Informazioni sulla parola chiave.

ad_group_criterion

string

Il nome della risorsa Criteri di gruppo di annunci.

KeywordInfo

Un criterio di parola 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 di gruppo di elenchi.

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

Costante o più costanti del targeting geografico che limitano l'ambito dell'area geografica all'interno del feed. Al momento è consentita una sola costante di targeting geografico.

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

FeedItemSet i cui FeedItems sono 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. Questa opzione è facoltativa e può essere impostata solo nelle operazioni CREATE.

radius

int64

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

LocationInfo

Un criterio di 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 per 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 migliorate 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 offerta automatica 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 del ritorno sulla spesa pubblicitaria (ROAS) target. Se impostata, la strategia di offerta massimizzerà le entrate calcolando una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non riuscire a spendere l'intero budget. Se il ROAS target non è impostato, la strategia di offerta cercherà di raggiungere il ROAS più alto possibile per il budget.

MaximizeConversions

Una strategia di offerta automatica per aiutarti a ottenere il maggior numero possibile di conversioni 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_cpa_micros

int64

L'opzione costo per azione (CPA) target. L'importo medio che vuoi spendere per ogni azione di conversione specificato in micro unità della valuta della strategia di offerta. Se impostata, la strategia di offerta otterrà il maggior numero possibile di conversioni nei limiti del costo per azione target. Se il CPA target non è impostato, la strategia di offerta cercherà di ottenere il CPA più basso possibile in base al 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 della conversione. I dettagli per le 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. Ciò 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 della conversione. I dettagli per le 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 dei valori delle conversioni disponibili per data di conversione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione.

conversions_by_conversion_date

double

La somma delle conversioni in base alla data di conversione per i tipi di conversione disponibili. Può essere frazionario a causa della creazione di modelli di attribuzione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione.

historical_creative_quality_score

QualityScoreBucket

Il punteggio di qualità storico della creatività.

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

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

interaction_event_types[]

InteractionEventType

I tipi di interazioni senza costi e a pagamento.

raw_event_conversion_metrics[]

Value

Le metriche non elaborate di conversione degli eventi.

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 (anziché le 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. Ciò 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 esempio clic per gli annunci di testo o visualizzazioni per gli annunci video.

all_conversions_from_click_to_call

double

Il numero di volte in cui gli utenti hanno fatto clic su "Chiama" per chiamare un negozio durante o dopo aver fatto clic su un annuncio. Questo numero non indica se le chiamate sono state connesse o meno, né la loro durata.

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 su "Indicazioni stradali" per accedere a 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 da 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 es. 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 registrati correttamente da Search Ads 360 che sono stati inoltrati 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 per essere pubblicato sulla Rete Display, ma non è stato pubblicato a causa del budget troppo basso. Nota: la quota impressioni perse nel budget dei 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 che gli annunci non hanno ricevuto sulla Rete Display a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse per il 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

Media delle conversioni disponibili (dall'interazione) per interazione idonea alla conversione. Mostra la frequenza media con cui un'interazione con un annuncio genera una conversione disponibile.

client_account_conversions_value

double

Il valore delle conversioni dell'account cliente. Sono incluse solo le azioni di conversione per cui l'attributo include_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 da interazioni diviso per il numero di interazioni con l'annuncio. Sono incluse solo le azioni di conversione per cui l'attributo include_in_conversioni_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 cui l'attributo include_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 del costo per clic (CPC) e del costo per mille impressioni (CPM) durante questo periodo. Questa metrica è un valore monetario e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 tutte le conversioni.

cost_per_conversion

double

Costo medio idoneo alla conversione per conversione disponibile.

cost_per_current_model_attributed_conversion

double

Il costo delle interazioni con l'annuncio diviso per il numero di conversioni attribuite al modello corrente. Sono incluse solo le azioni di conversione per cui l'attributo include_in_conversioni_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 tutte le conversioni.

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 cui l'attributo include_in_conversioni_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 nelle "conversioni" . Questa metrica è utile solo se hai inserito un valore per le azioni di conversione.

average_quality_score

double

Il punteggio di qualità medio.

historical_quality_score

int64

Il punteggio di qualità storico.

impressions

int64

Conteggio della frequenza di pubblicazione 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. L'interazione è l'azione principale dell'utente associata a un formato dell'annuncio: clic per annunci di testo e Shopping, visualizzazioni per annunci video e così via.

invalid_click_rate

double

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

invalid_clicks

int64

Numero di clic che Google considera illegali 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 mostrati nella posizione più in evidenza di Shopping. Per informazioni dettagliate, 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 gli annunci nella parte superiore della pagina nei risultati di ricerca a causa di un budget ridotto. Nota: la quota impressioni superiore assoluta persa del 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 per essere pubblicato sulla rete di ricerca, ma non è stato pubblicato a causa del budget troppo basso. Nota: la quota impressioni perse del 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 stima la frequenza con cui il tuo annuncio non è stato pubblicato in una posizione adiacente ai primi risultati di ricerca organica a causa di un budget ridotto. Nota: la quota impressioni superiore persa 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 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 varianti simili della 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 tra gli annunci nella parte superiore della pagina nei risultati di ricerca a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni superiore assoluta persa per il ranking sulla rete 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 che gli annunci non hanno ricevuto sulla rete di ricerca a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse per il ranking sulla rete 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 stima la frequenza con cui il tuo annuncio non è stato pubblicato in una posizione adiacente ai primi risultati di ricerca organica a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni superiore persa per il ranking sulla rete 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 ricevute tra gli annunci nella parte superiore della pagina rispetto al numero stimato di impressioni che avresti potuto ricevere tra gli annunci nella parte superiore della pagina. 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 degli annunci pubblicate in una posizione adiacente 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 della conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

Valore delle conversioni disponibili per la data di conversione diviso per le conversioni disponibili per la data di conversione. Mostra il valore medio di ciascuna conversione disponibile (per data di conversione). Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione.

client_account_view_through_conversions

int64

Il numero totale di conversioni view-through. Questi casi 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 su di esso.

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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 da lead per account cliente (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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 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 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo 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 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 e viene restituito nella valuta del cliente per impostazione predefinita. Consulta il parametro Metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_units_sold

double

Le unità lead vendute per l'account cliente 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 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 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 l'app specifica.

PercentCpc

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

Campi
cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Si tratta di un campo facoltativo inserito dall'inserzionista e specificato in micro locali. Nota: un valore pari a zero viene interpretato come se avessi un valore bid_headline indefinito.

enhanced_cpc_enabled

bool

Aumenta o diminuisce l'offerta per ogni asta a seconda della probabilità di conversione. Le singole offerte possono superare il valore di cpc_bid_height_micros, al contrario dell'importo medio dell'offerta per una campagna.

RealTimeBiddingSetting

Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la 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 Search Ads 360.

SearchAds360ResponsiveSearchAdInfo

Un annuncio adattabile della rete di ricerca Search Ads 360.

Campi
headlines[]

AdTextAsset

Elenco degli asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati dall'elenco.

descriptions[]

AdTextAsset

Elenco degli asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate dall'elenco.

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 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

Campi Solo 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 della conversione.

day_of_week

DayOfWeek

Giorno della settimana, ad esempio LONDAY.

device

Device

Dispositivo a cui vengono applicate le metriche.

keyword

Keyword

Criterio parola chiave.

product_channel

ProductChannel

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 elaborati.

conversion_action

string

Nome della risorsa dell'azione di conversione.

conversion_action_name

string

Nome azione di conversione.

date

string

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

geo_target_city

string

Nome della risorsa della costante del target geografico che rappresenta una città.

geo_target_country

string

Nome della risorsa della costante del target geografico che rappresenta un paese.

geo_target_metro

string

Nome della risorsa della costante del target geografico che rappresenta un'area metropolitana.

geo_target_region

string

Nome della risorsa della costante del target geografico che rappresenta una regione.

hour

int32

Ora del giorno espressa con un numero compreso tra 0 e 23 inclusi.

month

string

Mese come rappresentato dalla data del primo giorno di un mese. Formattato come 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

Brand del prodotto.

product_country

string

Nome della risorsa della costante del target 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 della risorsa della costante linguistica 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

Brand 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

Il titolo del prodotto venduto.

product_sold_type_l1

string

Tipo (livello 1) del 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) di 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 come rappresentato dalla data del primo giorno di un trimestre. Utilizza l'anno solare per i trimestri; ad esempio, il secondo trimestre del 2018 inizia l'1/04/2018. Formattato come aaaa-MM-gg.

week

string

Settimana come definita da lunedì a domenica ed è rappresentata dalla data di lunedì. Formattato come aaaa-MM-gg.

year

int32

Anno, con formato aaaa.

asset_interaction_target

AssetInteractionTarget

Utilizzato solo con le metriche AssetClient, Asset Campagna e Asset gruppo di annunci. Indica se le metriche di interazione si sono verificate sull'asset stesso oppure su un altro asset o un'unità pubblicitaria diverso. 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) quando vengono pubblicati contemporaneamente. Se l'interazione_on_this_asset è vera, significa che le interazioni avvengono su questo asset specifico, mentre quando l'interazione è falsa, significa che le interazioni non avvengono 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 mostrare una determinata percentuale di annunci della rete di ricerca nella parte superiore della prima pagina (o in un'altra posizione target).

Campi
location

TargetImpressionShareLocation

La località target nella pagina dei risultati di ricerca.

location_fraction_micros

int64

La frazione di annunci scelta 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 imposta il tetto massimo e viene 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 in base ai criteri selezionati per questa dimensione targeting o se scegliere come target tutti i valori per questa dimensione targeting e mostrare gli annunci in base al targeting in altre dimensioni di 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 l'applicazione dei modificatori di offerta.

TargetRoas

Una strategia di offerta automatica che ti aiuta a massimizzare le entrate calcolando la media di un ritorno sulla spesa pubblicitaria (ROAS) target 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 ottenere il maggior numero possibile di clic in base al tuo budget.

Campi
target_spend_micros
(deprecated)

int64

Obsoleto: il target di spesa in base al quale massimizzare i clic. Un offerente di spesa target cercherà di spendere il minor valore tra questo valore o l'importo della spesa limitata naturale. Se non specificato, il budget viene utilizzato 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à correlate al targeting, a livello di campagna e di gruppo di annunci. Per ulteriori informazioni sull'impostazione di targeting, consulta la pagina https://support.google.com/google-ads/answer/7365594

Campi
target_restrictions[]

TargetRestriction

L'impostazione della dimensione per targeting per 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 esadecimale. 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 essere superiore a 200 caratteri.

UnifiedCallAsset

Un asset di chiamata unificato.

Campi
country_code

string

Il codice paese di due lettere del numero di telefono. Esempi: "US", "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 il criterio 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. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale.

call_only

bool

Indica se nella chiamata viene mostrato solo il numero di telefono senza un link al sito web. Si applica a Microsoft Ads.

call_tracking_enabled

bool

Indica se la chiamata deve essere abilitata per il monitoraggio delle chiamate. Si applica a Microsoft Ads.

use_searcher_time_zone

bool

Indica se mostrare l'estensione di chiamata nel fuso orario dell'utente della rete di ricerca. Si applica a Microsoft Ads.

start_date

string

Data di inizio della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data dell'ultima data di validità dell'asset e ancora in 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 della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data dell'ultima data di validità dell'asset e ancora in 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. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale.

use_searcher_time_zone

bool

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

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à visualizzato solo se l'asset posizione viene sincronizzato dall'account Profilo dell'attività. È possibile avere più schede di Profilo dell'attività nello stesso account che puntano allo stesso ID luogo.

location_ownership_type

LocationOwnershipType

Il tipo di proprietà della sede. Se il tipo è BUSINESS_OWNER, verrà pubblicato come estensione di località. Se il tipo è AFFILIATE, verrà pubblicato come sede della società consociata.

UnifiedPageFeedAsset

Un asset di un 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 impostato, la lunghezza deve essere compresa tra 1 e 35 (incluso) e deve essere impostata anche la descrizione2.

description2

string

Seconda riga della descrizione del sitelink. Se impostato, la lunghezza deve essere compresa tra 1 e 35 (incluso) e deve essere impostata anche la descrizione1.

start_date

string

Data di inizio della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg.

end_date

string

Data dell'ultima data di validità dell'asset e ancora in 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. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale.

tracking_id

int64

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

use_searcher_time_zone

bool

Indica se mostrare l'asset sitelink nel fuso orario dell'utente della ricerca. Si applica a Microsoft Ads.

mobile_preferred

bool

Se la preferenza è che l'asset sitelink venga visualizzato sui dispositivi mobili. Si applica a Microsoft Ads.

UserListInfo

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

Campi
user_list

string

Il nome della risorsa Elenco utenti.

Valore

Un contenitore di dati generico.

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

bool

Un valore booleano.

int64_value

int64

Un 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 unito insieme quando viene valutato per il targeting. Un elenco di condizioni vuoto indica che tutte le pagine del sito web della campagna sono state scelte come target.

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

coverage_percentage

double

Percentuale di copertura dei criteri del sito 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, se la copertura restituisce 1, significa che ha una copertura del 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 CREATE ed è vietato per le operazioni 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 stringa di 11 caratteri utilizzato nell'URL del video di YouTube.