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 in cui verranno mostrati 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 viene avviata questa pianificazione.

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

end_minute

MinuteOfHour

Minuti dopo l'ora di fine della pianificazione. La pianificazione esclude il minuto finale.

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

day_of_week

DayOfWeek

Il giorno della settimana a cui si applica la programmazione.

Questo campo è obbligatorio per le operazioni CREATE e 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 e 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 e 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 fascia d'età.

Campi
type

AgeRangeType

Il tipo di fascia d'età.

AssetInteractionTarget

Un segmento AssetInteractionTarget.

Campi
asset

string

Il nome della risorsa asset.

interaction_on_this_asset

bool

Utilizzato solo con le metriche CustomerAsset, CampaignAsset e AdGroupAsset. Indica se le metriche di interazione si sono verificate sull'asset stesso o su un altro asset o unità pubblicitaria.

AssetUsage

Contiene le informazioni sull'utilizzo dell'asset.

Campi
asset

string

Nome della risorsa dell'asset.

served_asset_field_type

ServedAssetFieldType

Il tipo di campo pubblicato dell'asset.

AudienceInfo

Un criterio per i segmenti di pubblico.

Campi
audience

string

Nome risorsa pubblico.

BusinessProfileLocation

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

Campi
labels[]

string

Etichetta specificata dall'inserzionista per la sede nell'account Profilo dell'attività. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività.

store_code

string

Il codice negozio del profilo dell'attività di questa sede. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività.

listing_id

int64

ID scheda di questa sede del profilo dell'attività. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività collegato.

CallToActionAsset

Un asset di invito all'azione.

Campi
call_to_action

CallToActionType

Invito all'azione.

CustomParameter

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

Campi
key

string

La chiave corrispondente al nome del tag del parametro.

value

string

Il valore da sostituire.

DeviceInfo

Un criterio per 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 diminuisce per i clic che sembrano avere minori probabilità.

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

FinalAppUrl

Un URL per il link diretto a un'app per il sistema operativo specificato.

Campi
os_type

AppUrlOperatingSystemType

Il sistema operativo scelto come target da questo URL. Obbligatorio.

url

string

L'URL link diretto all'app. I link diretti specificano una posizione in un'app che corrisponde ai contenuti che vuoi mostrare e devono avere il formato {scheme}://{host_path}. Lo schema identifica l'app da aprire. Per la tua app, puoi utilizzare uno schema personalizzato che inizia con il nome dell'app. L'host e il percorso specificano la posizione univoca nell'app in cui si trovano i tuoi contenuti. Esempio: "exampleapp://productid_1234". Obbligatorio.

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

Campi
type

GenderType

Tipo di genere.

ImageAsset

Un asset immagine.

Campi
mime_type

MimeType

Tipo MIME dell'asset immagine.

full_size

ImageDimension

Metadati per questa immagine nelle sue dimensioni originali.

file_size

int64

Dimensioni del file dell'asset immagine in byte.

ImageDimension

Metadati per 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 larghezza.

Parola chiave

Un segmento di criteri parola 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 (al 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à specificate tramite un feed.

Campi
geo_target_constants[]

string

Costante o costanti di 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. Per le costanti di targeting geografico sono supportati miglia e metri. Per i set di elementi del feed sono supportati i millimetri e i metri. Questo campo è obbligatorio e deve essere impostato nelle operazioni CREATE.

feed_item_sets[]

string

FeedItemSets i cui FeedItems sono scelti come target. Se vengono specificati più ID, vengono scelti come target tutti gli elementi che compaiono in almeno un insieme. Questo campo non può essere utilizzato con geo_target_constants. Questo campo è facoltativo e può essere impostato 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 di targeting 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 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 che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.

Campi
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

L'opzione Ritorno sulla spesa pubblicitaria target (ROAS target). Se impostata, la strategia di offerta massimizza le entrate mantenendo 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 che ti aiuta 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 azione di conversione specificato in micro unità della valuta della strategia di offerta. Se impostata, la strategia di offerta genererà 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. Quando questa colonna viene 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.

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 viene 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 per cui è possibile fare offerte in base alla data di conversione. Quando questa colonna viene 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 per cui è possibile fare offerte. Può essere frazionario a causa del modello di attribuzione. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione.

historical_creative_quality_score

QualityScoreBucket

Il punteggio di qualità storico della creatività.

historical_landing_page_quality_score

QualityScoreBucket

La qualità della cronologia dell'esperienza sulla pagina di destinazione.

historical_search_predicted_ctr

QualityScoreBucket

La percentuale di clic (CTR) prevista per la ricerca storica.

interaction_event_types[]

InteractionEventType

I tipi di interazioni a pagamento e senza costi.

raw_event_conversion_metrics[]

Value

Le metriche di conversione degli eventi non elaborati.

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 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 esempio i clic per gli annunci di testo o le 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 dei 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 dei feed.

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

Questa metrica si applica solo agli elementi dei 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 dei 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 dei 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 dei feed.

visits

double

Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione dell'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 dei 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 perse a causa del budget dei contenuti viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato 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 viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato 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 a causa del ranking dei contenuti viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.

conversions_from_interactions_rate

double

Media delle conversioni per cui è possibile fare offerte (dall'interazione) per interazione idonea alla conversione. Indica la frequenza media con cui un'interazione con l'annuncio genera una conversione per cui è possibile fare offerte.

client_account_conversions_value

double

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

conversions_value_per_cost

double

Il valore della conversione per cui è possibile fare offerte diviso per il costo totale delle interazioni idonee alla conversione.

conversions_from_interactions_value_per_interaction

double

Il valore delle conversioni generate dalle interazioni diviso per il numero di interazioni con l'annuncio. Include solo le azioni di conversione per cui l'attributo include_in_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le 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 le quali l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.

cost_micros

int64

Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo. 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

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

cost_per_current_model_attributed_conversion

double

Il costo delle interazioni con l'annuncio diviso per le conversioni attribuite al modello corrente. Include solo le azioni di conversione per cui l'attributo include_in_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.

cross_device_conversions

double

Conversioni che si verificano quando un cliente fa clic su un annuncio su un dispositivo e poi esegue una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions.

cross_device_conversions_by_conversion_date

double

Il numero di conversioni cross-device per data di conversione. I dettagli per le 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 per le 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. Include solo le azioni di conversione per cui l'attributo include_in_conversions_metric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.

conversions_value

double

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

La cronologia del punteggio di qualità.

impressions

int64

Conteggio della frequenza con cui il tuo annuncio è stato pubblicato 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 che viene mostrato loro. Il numero di interazioni diviso per il numero di volte in cui l'annuncio viene pubblicato.

interactions

int64

Il numero di interazioni. Un'interazione è l'azione principale dell'utente associata 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 esclusi dal numero totale di clic (clic filtrati + non filtrati) durante il periodo del report.

invalid_clicks

int64

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

general_invalid_click_rate

double

La percentuale di clic che sono stati esclusi dal numero totale di clic (clic filtrati + non filtrati) perché sono 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, consulta 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 di clic non validi 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, consulta 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 conducono 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 pubblicati 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 segnalato 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 insufficiente. Nota: la quota impressioni superiore assoluta persa sulla rete di ricerca (budget) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato 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 (budget) sulla rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato 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 sulla rete di ricerca (budget) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.

search_click_share

double

Il numero di clic ricevuti sulla rete di ricerca diviso per il numero stimato di clic che avresti potuto ricevere. Nota: la quota clic di ricerca viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato 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 da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato 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 riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato 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 a causa del ranking nella rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.

search_rank_lost_impression_share

double

La percentuale stimata di impressioni sulla rete di ricerca che i tuoi annunci non hanno ricevuto a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse a causa del ranking nella rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato 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 sulla rete di ricerca (ranking) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.

search_top_impression_share

double

Le impressioni che hai ricevuto 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 da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato 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. Quando questa colonna viene 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.

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

Valore delle conversioni per cui è possibile fare offerte in base alla data di conversione diviso per le conversioni per cui è possibile fare offerte in base alla data di conversione. Mostra il valore medio di ciascuna conversione per cui è possibile fare offerte (in base alla data di conversione). Quando questa colonna viene 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 illustrato o rich media e poi completa una conversione sul tuo sito senza interagire (ad esempio, fare clic) con un altro annuncio.

client_account_cross_sell_cost_of_goods_sold_micros

int64

Il costo del venduto da cross-sell (CDV) 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, 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

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 sono l'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

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

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 (CDV) dell'account cliente è il costo totale dei prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione è associato a un prodotto (vedi Annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il costo di questi prodotti viene conteggiato nel costo del venduto da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da lead per questo ordine è pari a 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario 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 è 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 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

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 vendute dell'account cliente 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.

unique_users

int64

Il numero di utenti unici che hanno visualizzato il tuo annuncio durante il periodo di tempo richiesto. Questa metrica non può essere aggregata e può essere richiesta solo per intervalli di date di 92 giorni o meno. Questa metrica è disponibile per i seguenti tipi di campagne: display, video, discovery e per app.

average_impression_frequency_per_user

double

Il numero medio di volte in cui un utente unico ha visualizzato il tuo annuncio durante il periodo di tempo richiesto. Questa metrica non può essere aggregata e può essere richiesta solo per intervalli di date di 92 giorni o meno. Questa metrica è disponibile per i seguenti tipi di campagne: display, video, discovery e per app.

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 prodotto o servizio.

Campi
cpc_bid_ceiling_micros

int64

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Questo è un campo facoltativo inserito dall'inserzionista e specificato nei microformati locali. Nota: un valore pari a zero viene interpretato nello stesso modo di bid_ceiling non definito.

enhanced_cpc_enabled

bool

Aumenta o diminuisce l'offerta per ogni asta, a seconda della probabilità di conversione. Le singole offerte possono superare cpc_bid_ceiling_micros, ma l'importo medio dell'offerta per una campagna non deve superarlo.

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

Indica se la campagna è attivata per 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 path1 con un delimitatore.

ad_tracking_id

int64

L'ID monitoraggio dell'annuncio.

SearchAds360ProductAdInfo

Questo tipo non contiene campi.

Un annuncio 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 vengono selezionati da questo elenco.

descriptions[]

AdTextAsset

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

path1

string

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

path2

string

Testo aggiunto a path1 con un delimitatore.

ad_tracking_id

int64

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

Segmenti

Campi solo segmento.

Campi
ad_network_type

AdNetworkType

Tipo di rete pubblicitaria.

conversion_action_category

ConversionActionCategory

Categoria azione di conversione.

conversion_custom_dimensions[]

Value

Le dimensioni personalizzate di conversione.

day_of_week

DayOfWeek

Giorno della settimana, ad esempio LUNEDÌ.

device

Device

Il dispositivo a cui si applicano 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

Condizioni 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 si applicano le metriche. Formato aaaa-MM-gg, ad esempio 2018-04-17.

geo_target_city

string

Nome della risorsa della costante di targeting geografico che rappresenta una città.

geo_target_country

string

Nome risorsa della costante di targeting geografico che rappresenta un paese.

geo_target_metro

string

Nome risorsa della costante di targeting geografico che rappresenta una città.

geo_target_region

string

Nome della risorsa della costante di targeting geografico 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. Formattata come aaaa-MM-gg.

product_bidding_category_level1

string

Categoria di offerta (livello 1) del prodotto.

product_bidding_category_level2

string

Categoria di offerta (2° livello) del prodotto.

product_bidding_category_level3

string

Categoria di offerta (livello 3) del prodotto.

product_bidding_category_level4

string

Categoria di offerta (livello 4) del prodotto.

product_bidding_category_level5

string

Categoria di offerta (livello 5) del prodotto.

product_brand

string

La marca del prodotto.

product_country

string

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

product_custom_attribute0

string

Attributo personalizzato 0 del prodotto.

product_custom_attribute1

string

Attributo personalizzato 1 del prodotto.

product_custom_attribute2

string

Attributo personalizzato 2 del prodotto.

product_custom_attribute3

string

Attributo personalizzato 3 del prodotto.

product_custom_attribute4

string

Attributo personalizzato 4 del prodotto.

product_item_id

string

ID articolo del prodotto.

product_language

string

Nome 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

L'ID articolo del prodotto venduto.

product_sold_title

string

Titolo del prodotto venduto.

product_sold_type_l1

string

Tipo (livello 1) di prodotto venduto.

product_sold_type_l2

string

Tipo (livello 2) del prodotto venduto.

product_sold_type_l3

string

Tipo (livello 3) del prodotto venduto.

product_sold_type_l4

string

Tipo (livello 4) di prodotto venduto.

product_sold_type_l5

string

Tipo (livello 5) del prodotto venduto.

product_store_id

string

ID negozio del prodotto.

product_title

string

Titolo del prodotto.

product_type_l1

string

Tipo (livello 1) di prodotto.

product_type_l2

string

Tipo (2° livello) di prodotto.

product_type_l3

string

Tipo (3° livello) di prodotto.

product_type_l4

string

Tipo (4° livello) di prodotto.

product_type_l5

string

Tipo (livello 5) di prodotto.

quarter

string

Il trimestre rappresentato dalla data del primo giorno di un trimestre. Utilizza l'anno solare per i trimestri, ad esempio il secondo trimestre del 2018 inizia il 1° aprile 2018. Formattata come aaaa-MM-gg.

week

string

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

year

int32

Anno, formattato come aaaa.

asset_interaction_target

AssetInteractionTarget

Utilizzato solo con le metriche CustomerAsset, CampaignAsset e AdGroupAsset. Indica se le metriche di interazione si sono verificate sull'asset stesso o su un altro asset o unità pubblicitaria. 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 insieme. Quando interaction_on_this_asset è true, significa che le interazioni riguardano questo asset specifico. Quando interaction_on_this_asset è false, significa che le interazioni non riguardano questo asset specifico, ma altre parti dell'annuncio pubblicato con cui viene pubblicato questo asset.

TargetCpa

Una strategia che imposta offerte automatiche in modo da generare il maggior numero possibile di conversioni 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. Questa impostazione deve essere configurata 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. Questa impostazione deve essere configurata 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 che hai impostato.

TargetImpressionShare

Una strategia di offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga mostrata nella parte superiore della prima pagina (o in un'altra posizione target).

Campi
location

TargetImpressionShareLocation

La posizione di destinazione nella pagina dei risultati di ricerca.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

L'offerta CPC più alta che il sistema di offerta automatica è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo e specificato nei microformati locali.

TargetOutrankShare

Una strategia di offerta automatica che imposta le offerte in base alla frazione target di aste in cui l'inserzionista deve superare in ranking un concorrente specifico. 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 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 ai criteri selezionati per questa targeting_dimension o se scegliere come target tutti i valori per questa targeting_dimension e mostrare gli annunci in base al targeting in altre TargetingDimensions. Un valore di true indica che questi criteri applicheranno solo i moltiplicatori di offerta e non influiranno sul targeting. Un valore di false indica che questi criteri limiteranno il targeting e applicheranno i modificatori di offerta.

TargetRoas

Una strategia di offerta automatica che ti aiuta a massimizzare le entrate mantenendo una 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. Questa impostazione deve essere configurata 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. Questa impostazione deve essere configurata 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 in base alla quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere il valore inferiore tra questo e l'importo di spesa di limitazione naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per maggiori dettagli, 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 delle funzionalità correlate al targeting, a livello di campagna e gruppo di annunci. Per ulteriori dettagli sull'impostazione di targeting, visita 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

Contenuto testuale 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 impostata, 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 la risorsa può essere pubblicata. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.

call_only

bool

Se la chiamata mostra solo il numero di telefono senza un link al sito web. Valido per Microsoft Ads.

call_tracking_enabled

bool

Indica se la chiamata deve essere attivata nel monitoraggio chiamate. Valido per Microsoft Ads.

use_searcher_time_zone

bool

Se mostrare o meno l'estensione di chiamata nel fuso orario dell'utente della ricerca. Valido per Microsoft Ads.

start_date

string

Data di inizio in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.

end_date

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, 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 in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.

end_date

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, 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. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.

use_searcher_time_zone

bool

Se mostrare l'asset nel fuso orario dell'utente che esegue la ricerca. Valido per 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 per il cliente. Questo valore viene restituito solo se l'asset posizione viene sincronizzato dall'account Profilo dell'attività. È possibile avere più schede del profilo dell'attività nello stesso account che rimandano allo stesso ID luogo.

location_ownership_type

LocationOwnershipType

Il tipo di proprietà della sede. Se il tipo è BUSINESS_OWNER, verrà pubblicato come estensione di località. Se il tipo è AFFILIATE, verrà pubblicata 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

La prima riga della descrizione del sitelink. Se impostata, 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 impostata, la lunghezza deve essere compresa tra 1 e 35 inclusi e deve essere impostata anche description1.

start_date

string

Data di inizio in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.

end_date

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, 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. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.

tracking_id

int64

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

use_searcher_time_zone

bool

Se mostrare l'asset sitelink nel fuso orario dell'utente che esegue la ricerca. Valido per Microsoft Ads.

mobile_preferred

bool

Se la preferenza è che l'asset sitelink venga visualizzato sui dispositivi mobili. Valido per Microsoft Ads.

UserListInfo

Un criterio Elenco utenti. Rappresenta un elenco 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 double.

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 per pagina web.

operator

WebpageConditionOperator

Operatore della condizione di targeting per pagina web.

argument

string

Argomento della condizione di targeting per 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 delle pagine web. L'elenco delle condizioni di targeting delle pagine web viene combinato 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 prese di mira.

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

coverage_percentage

double

Percentuale di copertura dei criteri del sito web. Questa è la percentuale calcolata di 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 viene restituita come 1, indica 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 e 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 della stringa di 11 caratteri utilizzato nell'URL del video di YouTube.