Package google.ads.searchads360.v0.common

Indice

AdScheduleInfo

Rappresenta un criterio di pianificazione degli annunci.

AdSchedule è specificato come giorno della settimana e intervallo di tempo entro il quale verranno pubblicati gli annunci.

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

Campi
start_minute

MinuteOfHour

Minuti dopo l'ora di inizio in cui inizia questa pianificazione.

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 questa pianificazione. La pianificazione 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 del giorno. 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 di fascia d'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 CustomerAsset, CampaignAsset e AdGroupAsset. Indica se le metriche di interazione si sono verificate nell'asset stesso o in un asset o unità pubblicitaria diversa.

AssetUsage

Contiene le informazioni sull'utilizzo della risorsa.

Campi
asset

string

Nome della risorsa dell'asset.

served_asset_field_type

ServedAssetFieldType

Il tipo di campo pubblicato della risorsa.

AudienceInfo

Un criterio del segmento di pubblico.

Campi
audience

string

Il nome della risorsa pubblico.

BusinessProfileLocation

Dati sulla posizione 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à. Viene sincronizzato dall'account Profilo dell'attività.

store_code

string

Il codice negozio del profilo dell'attività di questa sede. Viene sincronizzato dall'account Profilo dell'attività.

listing_id

int64

L'ID scheda di questa sede del Profilo dell'attività. Viene sincronizzato 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 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 del 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 sembrano avere maggiori probabilità di generare una conversione e le riduce per i clic in cui sembrano avere meno probabilità.

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

Metadati di questa immagine nelle sue dimensioni originali.

file_size

int64

Dimensioni del file dell'asset immagine in byte.

ImageDimension

Metadati di un'immagine con dimensioni specifiche, originali o ridimensionate.

Campi
height_pixels

int64

Altezza dell'immagine.

width_pixels

int64

Larghezza dell'immagine.

url

string

Un URL che restituisce l'immagine con queste dimensioni.

Parola chiave

Un segmento di criteri per parole chiave.

Campi
info

KeywordInfo

Informazioni sulle parole chiave.

ad_group_criterion

string

Il nome della risorsa AdGroupCriterion.

KeywordInfo

Un criterio 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 costante della 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à specificato 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 di target geografico.

radius_units

LocationGroupRadiusUnits

Unità del raggio. Le unità di misura supportate per le costanti di destinazione geografica sono miglia e metri. Per i set di elementi del feed sono supportati i millisecondi e i metri. Questo valore è obbligatorio e deve essere impostato nelle operazioni CREATE.

feed_item_sets[]

string

FeedItemSet di cui sono scelti come target gli elementi FeedItem. 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 valore è 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 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 migliorate in base ai dati dello Strumento per l'ottimizzazione delle conversioni.

ManualCpm

Questo tipo non contiene campi.

Offerte manuali basate sulle impressioni in cui l'utente paga per mille impressioni.

MaximizeConversionValue

Una strategia di offerta automatica che ti consente di ottenere il valore di conversione più alto possibile per le tue campagne rispettando il 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 essere in grado di 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 genera il maggior numero possibile di conversioni a un costo per azione target pari o inferiore a quello impostato. Se il CPA target non è impostato, la strategia di offerta cercherà di raggiungere 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. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric. Quando questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di 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 di conversione.

conversions_value_by_conversion_date

double

La somma del valore delle conversioni disponibili per l'asta in base alla data di conversione. Quando 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 per data di conversione per i tipi di conversione disponibili per le offerte. 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 a pagamento e senza costi.

raw_event_conversion_metrics[]

Value

Le metriche non elaborate sulle conversioni 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. Sono incluse 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 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 sul pulsante "Chiama" per chiamare un negozio durante o dopo aver fatto clic su un annuncio. Questo numero non indica se le chiamate sono andate a buon fine né la relativa 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 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 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 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 e inoltrato correttamente 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 che paghi 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 restituita 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 restituita 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 alla pubblicazione sulla Rete Display, ma non è stato pubblicato perché il budget era troppo basso. Nota: la quota impressioni persa a causa del budget dei contenuti è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 ottenere. Nota: la quota impressioni dei contenuti è riportata nell'intervallo da 0,1 a 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 i tuoi annunci non hanno ricevuto 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 indicato 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 per le offerte.

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 le offerte basate sulle conversioni, le tue strategie di offerta verranno ottimizzate per 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 cui l'attributo include_in_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le tue strategie di offerta verranno ottimizzate per 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 le offerte basate sulle conversioni, le tue strategie di offerta verranno ottimizzate per 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 idoneo per conversione medio per conversione disponibile per l'asta.

cost_per_current_model_attributed_conversion

double

Il costo delle interazioni con l'annuncio diviso per le conversioni attribuite dal modello corrente. Sono incluse solo le azioni di conversione per cui 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 quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in tutte le conversioni.

cross_device_conversions_by_conversion_date

double

Il numero di conversioni cross-device per data di conversione. I dettagli relativi alle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

cross_device_conversions_value

double

La somma del valore delle conversioni cross-device.

cross_device_conversions_value_by_conversion_date

double

La somma del valore delle conversioni cross-device per data di conversione. I dettagli relativi alle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

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_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni.

conversions_value

double

La somma dei valori di conversione per le conversioni incluse nel campo "conversions". 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

La frequenza con cui gli utenti interagiscono con il tuo annuncio dopo averlo visualizzato. Si tratta del 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 a un formato dell'annuncio, come i clic per gli annunci di testo e Shopping, le visualizzazioni per gli 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 ti addebita alcun costo.

general_invalid_click_rate

double

La percentuale di clic filtrati ed esclusi dal numero totale di clic (clic filtrati + non filtrati) in quanto clic non validi generici. Si tratta di clic che Google considera illegali e che vengono rilevati tramite metodi di filtro di routine (ad es. traffico non valido noto dei data center, bot e spider o altri crawler, pattern irregolari e così via). Non ti viene addebitato alcun costo per questi clic, che non influiscono sulle statistiche dell'account. Per informazioni dettagliate, visita la pagina di assistenza all'indirizzo https://support.google.com/campaignmanager/answer/6076504.

general_invalid_clicks

int64

Numero di clic non validi generici. Si tratta di un sottoinsieme dei clic non validi rilevati tramite metodi di filtraggio di routine (come traffico da data center non valido noto, bot e spider o altri crawler, pattern irregolari e così via). Non ti viene addebitato alcun costo per questi clic, che non influiscono sulle statistiche dell'account. Per informazioni dettagliate, visita la pagina di assistenza all'indirizzo https://support.google.com/campaignmanager/answer/6076504.

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 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 indicato come 0,0999.

search_budget_lost_absolute_top_impression_share

double

Il numero che stima 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 budget ridotto. Nota: la quota impressioni superiore assoluta persa del budget della rete di ricerca è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 è stato pubblicato perché il budget era troppo basso. Nota: la quota impressioni perse del budget della rete di ricerca è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 per il budget della rete di ricerca è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 indicato come 0,0999.

search_exact_match_impression_share

double

Le impressioni ricevute divise per il numero stimato di impressioni che avresti potuto ricevere sulla rete di ricerca per termini di ricerca esattamente corrispondenti alle tue parole chiave (o varianti simili delle tue parole chiave), indipendentemente dai tipi di corrispondenza delle parole chiave. Nota: la quota impressioni con corrispondenza esatta sulla rete di ricerca viene riportata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999.

search_impression_share

double

Mostra il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni sulla rete di ricerca viene registrata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene indicato come 0,0999.

search_rank_lost_absolute_top_impression_share

double

Il numero che stima 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 basso. Nota: la quota impressioni superiore assoluta persa in base al ranking della rete di ricerca è riportata nell'intervallo da 0 a 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 persa a causa del ranking sulla rete di ricerca è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 è riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene indicato 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 viene riportata nell'intervallo compreso 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 adiacenti 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. Quando questa colonna è selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli relativi alle colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.

value_per_conversion

double

Il valore della conversione disponibile diviso per il numero di conversioni disponibili. Mostra il valore medio di ciascuna conversione disponibile.

value_per_conversions_by_conversion_date

double

Valore delle conversioni disponibili per l'asta per data di conversione diviso per le conversioni disponibili per l'asta per data di conversione. Mostra il valore medio di ciascuna conversione disponibile per le offerte (in base alla data di conversione). Quando 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. Si verificano quando un cliente visualizza un annuncio illustrativo o rich media e poi completa una conversione sul tuo sito senza interagire con un altro annuncio (ad esempio facendoci clic sopra).

client_account_cross_sell_cost_of_goods_sold_micros

int64

Il costo del venduto da cross-sell dell'account cliente è 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 è 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 restituita 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 restituita 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 restituita 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 restituita 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 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 restituita 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 è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di 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 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 e viene restituita 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 restituita 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 è 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 restituita 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 restituita 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 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 Annunci Shopping), questo prodotto è 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 restituita 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 è 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 restituita 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 dell'account cliente 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 è 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 è 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 determinato bene 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 nei micro annunci locali. Nota: un valore pari a zero viene interpretato nello stesso modo in cui viene definito bid_ceiling.

enhanced_cpc_enabled

bool

Modifica l'offerta per ogni asta verso l'alto o verso il basso, a seconda della probabilità di una conversione. Le singole offerte possono superare il valore cpc_bid_ceiling_micros, ma l'importo medio dell'offerta per una campagna non deve farlo.

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 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 a percorso1 con un delimitatore.

ad_tracking_id

int64

L'ID monitoraggio dell'annuncio.

SearchAds360ProductAdInfo

Questo tipo non contiene campi.

Un annuncio di prodotto Search Ads 360.

SearchAds360ResponsiveSearchAdInfo

Un annuncio adattabile della rete di ricerca di Search Ads 360.

Campi
headlines[]

AdTextAsset

Elenco degli asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco.

descriptions[]

AdTextAsset

Elenco degli asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco.

path1

string

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

path2

string

Testo aggiunto a percorso1 con un delimitatore.

ad_tracking_id

int64

L'ID 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 monitoraggio dell'annuncio.

Segmenti

Campi solo per i 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 di conversione.

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

Canale del prodotto.

product_channel_exclusivity

ProductChannelExclusivity

L'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 non elaborate delle conversioni evento.

conversion_action

string

Nome della 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.

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 una metropolitana.

geo_target_region

string

Nome della risorsa della costante di destinazione geografica che rappresenta una regione.

hour

int32

L'ora del giorno come numero compreso tra 0 e 23 (inclusi).

month

string

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

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

Il titolo del prodotto venduto.

product_sold_type_l1

string

Tipo (livello 1) del prodotto venduto.

product_sold_type_l2

string

Tipo (livello 2) del prodotto venduto.

product_sold_type_l3

string

Tipo (livello 3) del prodotto venduto.

product_sold_type_l4

string

Tipo (livello 4) del 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. Formattato come aaaa-MM-gg.

week

string

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

year

int32

Anno, nel 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 nell'asset stesso o in un asset o unità pubblicitaria diversa. 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 che hai definito.

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. Questo valore deve essere impostato solo per le strategie di offerta di portafoglio.

TargetCpm

Questo tipo non contiene campi.

Il CPM target (costo per mille impressioni) è 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 offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga visualizzata nella parte superiore della prima pagina (o in un'altra posizione target).

Campi
location

TargetImpressionShareLocation

La località scelta come target nella pagina dei risultati di ricerca.

location_fraction_micros

int64

La frazione scelta di annunci da mostrare nella località scelta 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 limite massimo e specificato nelle microlocali.

TargetOutrankShare

Una strategia di offerte automatiche che imposta le offerte in base alla frazione target delle aste in cui l'inserzionista deve superare un concorrente specifico. Questa strategia è deprecata.

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 delle 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 questa dimensione targeting_dimension o scegliere come target tutti i valori di questa dimensione e mostrare gli annunci in base al targeting in altre dimensioni TargetingDimensions. Un valore true indica che questi criteri applicheranno solo i modificatori di offerta e non influiranno sul targeting. Un 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 mantenendo un ritorno sulla spesa pubblicitaria (ROAS) target medio.

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. Questo valore 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

Ritirato: la spesa target al di sotto della quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere il valore più basso tra questo valore o l'importo della spesa per il throttling naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è deprecato 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 informazioni 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 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 il 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 superare i 200 caratteri.

UnifiedCallAsset

Un asset di chiamata unificato.

Campi
country_code

string

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 non viene impostato, 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 avere un massimo di 6 pianificazioni al giorno, per un totale di 42.

call_only

bool

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

call_tracking_enabled

bool

Indica se la chiamata deve essere attivata nel monitoraggio delle chiamate. Si applica a Microsoft Advertising.

use_searcher_time_zone

bool

Indica se mostrare l'estensione di chiamata nel fuso orario dell'utente che esegue la ricerca. Si applica a Microsoft Advertising.

start_date

string

Data di inizio dell'efficacia di questa risorsa e di inizio della pubblicazione, nel formato AAAA-MM-GG.

end_date

string

Ultima data di validità e pubblicazione dell'asset, 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 caratteri, inclusi.

start_date

string

Data di inizio dell'efficacia di questa risorsa e di inizio della pubblicazione, nel formato AAAA-MM-GG.

end_date

string

Ultima data di validità e pubblicazione dell'asset, nel formato aaaa-MM-gg.

ad_schedule_targets[]

AdScheduleInfo

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali la risorsa può essere pubblicata. È possibile avere un massimo di 6 pianificazioni al giorno, per un totale di 42.

use_searcher_time_zone

bool

Indica se mostrare l'asset nel fuso orario dell'utente che esegue la ricerca. Si applica a Microsoft Advertising.

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 risorsa. Per saperne di più su Place ID, visita la pagina https://developers.google.com/places/web-service/place-id.

business_profile_locations[]

BusinessProfileLocation

L'elenco di sedi dell'attività commerciale del cliente. Verrà visualizzato 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à pubblicato come estensione di località. Se il tipo è AFFILIATE, verrà pubblicato come sede della società consociata.

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 impostato, la lunghezza deve essere compresa tra 1 e 35 caratteri, inclusi, e deve essere impostata anche description2.

description2

string

Seconda riga della descrizione del sitelink. Se impostato, la lunghezza deve essere compresa tra 1 e 35 caratteri, inclusi, e deve essere impostata anche description1.

start_date

string

Data di inizio dell'efficacia di questa risorsa e di inizio della pubblicazione, nel formato AAAA-MM-GG.

end_date

string

Ultima data di validità e pubblicazione dell'asset, nel formato aaaa-MM-gg.

ad_schedule_targets[]

AdScheduleInfo

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali la risorsa può essere pubblicata. È possibile avere un massimo di 6 pianificazioni al giorno, per un totale di 42.

tracking_id

int64

ID utilizzato per monitorare i clic per l'asset sitelink. Questo è un account Yahoo! Campo solo per il Giappone.

use_searcher_time_zone

bool

Indica se mostrare l'asset sitelink nel fuso orario dell'utente che esegue la ricerca. Si applica a Microsoft Advertising.

mobile_preferred

bool

Indica se la preferenza è che l'asset sitelink venga visualizzato sui dispositivi mobili. Si applica a Microsoft Advertising.

UserListInfo

Un criterio dell'elenco utenti. Rappresenta un elenco di utenti definito dall'inserzionista come 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 delle 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 delle pagine web del sito web di un inserzionista.

Campi
conditions[]

WebpageConditionInfo

Condizioni o espressioni logiche per il targeting per pagina web. L'elenco delle condizioni di targeting delle pagine web viene unito con l'operatore AND quando viene valutato per il targeting. Un elenco vuoto di condizioni indica che tutte le pagine del sito web della campagna sono 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, quando la copertura restituisce 1, indica 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.