Trasformazione dei rapporti di Search Ads 360

Questo documento descrive come trasformare i report per Search Ads 360.

Per visualizzare la trasformazione dei report di Search Ads 360 che utilizza la vecchia API Search Ads 360 Reporting, consulta Trasformazione dei report di Search Ads 360 (ritirata).

Mappatura delle tabelle per i report di Search Ads 360

Quando i report di Search Ads 360 vengono trasferiti a BigQuery, vengono trasformati nelle seguenti tabelle e viste BigQuery. Quando visualizzi le tabelle e le viste in BigQuery, il valore di customer_id è il tuo ID cliente Search Ads 360.

ad_group

ad_group

Tabelle:
p_sa_AdGroup_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupStats_customer_id
Visualizzazioni:
sa_AdGroup_customer_id
sa_AdGroupConversionActionAndDeviceStats_customer_id
sa_AdGroupDeviceStats_customer_id
sa_AdGroupStats_customer_id

ad_group_ad

ad_group_ad

Tabelle:
p_sa_Ad_customer_id
p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
Visualizzazioni:
a_Ad_customer_id
sa_AdConversionActionAndDeviceStats_customer_id
sa_AdDeviceStats_customer_id

ad_group_asset

ad_group_asset

Tabelle:
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
Visualizzazioni:
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id

ad_group_audience_view

ad_group_audience_view

Tabelle:
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
p_sa_AdGroupAudienceDeviceStats_customer_id
Visualizzazioni:
sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
sa_AdGroupAudienceDeviceStats_customer_id

ad_group_criterion

ad_group_criterion

Tabelle:
p_sa_AdGroupCriterion_customer_id
p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
Visualizzazioni:
sa_AdGroupCriterion_customer_id
sa_NegativeAdGroupCriterion_customer_id
sa_NegativeAdGroupKeyword_customer_id

ad_group_label

ad_group_label

Tabelle:
p_sa_AdGroupLabel_customer_id
Visualizzazioni:
sa_AdGroupLabel_customer_id

age_range_view

age_range_view

Tabelle:
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id
Visualizzazioni:
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id

asset

asset

Tabelle:
p_sa_Asset_customer_id
Visualizzazioni:
sa_Asset_customer_id

asset_set_asset

asset_set_asset

Tabelle:
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id
Visualizzazioni:
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id

bidding_strategy

bidding_strategy

Tabelle:
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
Visualizzazioni:
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id

campagna

campagna

Tabelle:
p_sa_Campaign_customer_id
p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id
Visualizzazioni:
sa_Campaign_customer_id
sa_CampaignConversionActionAndDeviceStats_customer_id
sa_CampaignDeviceStats_customer_id
sa_CampaignStats_customer_id

campaign_asset

campaign_asset

Tabelle:
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
Visualizzazioni:
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id

campaign_audience_view

campaign_audience_view

Tabelle:
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
Visualizzazioni:
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id

campaign_criterion

campaign_criterion

Tabelle:
p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id
Visualizzazioni:
sa_CampaignCriterion_customer_id
sa_NegativeCampaignCriterion_customer_id
sa_NegativeCampaignKeyword_customer_id

campaign_label

campaign_label

Tabelle:
p_sa_CampaignLabel_customer_id
Visualizzazioni:
sa_CampaignLabel_customer_id

cart_data_sales_view

cart_data_sales_view

Tabelle:
p_sa_CartDataSalesStats_customer_id
Visualizzazioni:
sa_CartDataSalesStats_customer_id

conversione

conversione

Tabelle:
p_sa_Conversion_customer_id
Visualizzazioni:
sa_Conversion_customer_id

conversion_action

conversion_action

Tabelle:
p_sa_ConversionAction_customer_id
Visualizzazioni:
sa_ConversionAction_customer_id

cliente

cliente

Tabelle:
p_sa_Account_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountStats_customer_id
Visualizzazioni:
sa_Account_customer_id
sa_AccountConversionActionAndDeviceStats_customer_id
sa_AccountDeviceStats_customer_id
sa_AccountStats_customer_id

customer_asset

customer_asset

Tabelle:
p_sa_AccountAssetStats_customer_id
Visualizzazioni:
sa_AccountAssetStats_customer_id

gender_view

gender_view

Tabelle:
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id
Visualizzazioni:
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id

keyword_view

keyword_view

Tabelle:
p_sa_Keyword_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id
Visualizzazioni:
sa_Keyword_customer_id
sa_KeywordConversionActionAndDeviceStats_customer_id
sa_KeywordDeviceStats_customer_id
sa_KeywordStats_customer_id

location_view

location_view

Tabelle:
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id
Visualizzazioni:
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id

product_group_view

product_group_view

Tabelle:
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id
Visualizzazioni:
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id

shopping_performance_view

shopping_performance_view

Tabelle:
p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id
Visualizzazioni:
sa_ProductAdvertised_customer_id
sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
sa_ProductAdvertisedDeviceStats_customer_id

visita

visita

Tabelle:
p_sa_Visit_customer_id
Visualizzazioni:
sa_Visit_customer_id

webpage_view

webpage_view

Tabelle:
p_sa_WebpageConversionActionAndDeviceStats_customer_id
p_sa_WebpageDeviceStats_customer_id
Visualizzazioni:
sa_WebpageConversionActionAndDeviceStats_customer_id
sa_WebpageDeviceStats_customer_id

Dettagli delle colonne per i report di Search Ads 360

Le tabelle BigQuery create da un trasferimento di Search Ads 360 sono costituite dalle seguenti colonne (campi):

Nome tabella Search Ads 360: Account

Risorsa API Search Ads 360: customer

Nome campo Search Ads 360Descrizione
customer_account_level Il livello di account del cliente: amministratore, amministratore secondario, amministratore associato o service account.
customer_account_type Tipo di account motore. Ad esempio: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_creation_time Il timestamp di creazione di questo cliente. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
customer_currency_code La valuta in cui opera l'account. È supportato un sottoinsieme dei codici valuta dello standard ISO 4217.
customer_descriptive_name Nome descrittivo facoltativo e non univoco del cliente.
customer_manager_descriptive_name Il nome descrittivo del gestore.
customer_sub_manager_descriptive_name Il nome descrittivo dell'amministratore secondario.
customer_associate_manager_descriptive_name Il nome descrittivo dell'amministratore associato.
customer_engine_id ID dell'account nell'account motore esterno.
customer_id L'ID del cliente.
customer_manager_id L'ID cliente dell'amministratore.
customer_sub_manager_id L'ID cliente dell'amministratore secondario.
customer_associate_manager_id L'ID cliente dell'amministratore associato.
customer_last_modified_time La data e l'ora dell'ultima modifica di questo cliente. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
customer_status Lo stato del cliente.
customer_time_zone L'ID del fuso orario locale del cliente.

Nome tabella Search Ads 360: AccountAssetStats

Risorsa API Search Ads 360: customer_asset

Nome campo Search Ads 360Descrizione
customer_asset_asset Obbligatorio. Immutabile. L'asset collegato al cliente.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: AccountConversionActionAndAssetStats

Risorsa API Search Ads 360: asset_set_asset

Nome campo Search Ads 360Descrizione
asset_set_asset_asset Immutabile. L'asset a cui è collegato questo asset dell'insieme.
asset_set_asset_asset_set Immutabile. L'insieme di asset a cui è collegato questo asset dell'insieme.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: AccountConversionActionAndDeviceStats

Risorsa API Search Ads 360: customer

Nome campo Search Ads 360Descrizione
customer_engine_id ID dell'account nell'account motore esterno.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AccountDeviceStats

Risorsa API Search Ads 360: customer

Nome campo Search Ads 360Descrizione
customer_engine_id ID dell'account nell'account motore esterno.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AccountStats

Risorsa API Search Ads 360: customer

Nome campo Search Ads 360Descrizione
customer_engine_id ID dell'account nell'account motore esterno.
customer_id L'ID del cliente.
metrics_content_budget_lost_impression_share 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 a causa del 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.
metrics_content_impression_share 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.
metrics_content_rank_lost_impression_share 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.
metrics_historical_quality_score La cronologia del punteggio di qualità.
metrics_search_budget_lost_impression_share 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 a causa del 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.
metrics_search_impression_share 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.
metrics_search_rank_lost_impression_share 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: annuncio

Risorsa API Search Ads 360: ad_group_ad

Nome campo Search Ads 360Descrizione
ad_group_ad_ad_display_url L'URL visualizzato nella descrizione dell'annuncio per alcuni formati degli annunci.
ad_group_ad_ad_expanded_dynamic_search_ad_description1 La prima riga della descrizione dell'annuncio.
ad_group_ad_ad_expanded_dynamic_search_ad_description2 La seconda riga della descrizione dell'annuncio.
ad_group_ad_ad_expanded_text_ad_description1 La prima riga della descrizione dell'annuncio.
ad_group_ad_ad_expanded_text_ad_description2 La seconda riga della descrizione dell'annuncio.
ad_group_ad_ad_expanded_text_ad_headline Il titolo dell'annuncio.
ad_group_ad_ad_expanded_text_ad_headline2 Il secondo titolo dell'annuncio.
ad_group_ad_ad_expanded_text_ad_headline3 Il terzo titolo dell'annuncio.
ad_group_ad_ad_final_urls L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.
ad_group_ad_ad_id L'ID dell'annuncio.
ad_group_ad_ad_name Il nome dell'annuncio. Viene utilizzato solo per identificare l'annuncio. Non deve essere univoco e non influisce sull'annuncio pubblicato. Al momento, il campo Nome è supportato solo per DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd.
ad_group_ad_ad_text_ad_description1 La prima riga della descrizione dell'annuncio.
ad_group_ad_ad_text_ad_description2 La seconda riga della descrizione dell'annuncio.
ad_group_ad_ad_text_ad_headline Il titolo dell'annuncio.
ad_group_ad_ad_type Il tipo di annuncio.
ad_group_ad_creation_time Il timestamp di creazione dell'annuncio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_ad_engine_id ID dell'annuncio nell'account motore esterno. Questo campo è riservato solo all'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_ad.ad.id".
ad_group_ad_engine_status Stato aggiuntivo dell'annuncio nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) includono attivo, idoneo, in attesa di revisione.
ad_group_ad_labels I nomi delle risorse delle etichette associate a questo annuncio del gruppo di annunci.
ad_group_ad_last_modified_time Data e ora dell'ultima modifica di questo annuncio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_ad_status Lo stato dell'annuncio.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: AdConversionActionAndDeviceStats

Risorsa API Search Ads 360: ad_group_ad

Nome campo Search Ads 360Descrizione
ad_group_ad_ad_id L'ID dell'annuncio.
ad_group_ad_engine_id ID dell'annuncio nell'account motore esterno. Questo campo è riservato solo all'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_ad.ad.id".
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_all_conversions_value_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_by_conversion_date Il numero di conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
metrics_cross_device_conversions_value_by_conversion_date La somma del valore delle conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdDeviceStats

Risorsa API Search Ads 360: ad_group_ad

Nome campo Search Ads 360Descrizione
ad_group_ad_ad_id L'ID dell'annuncio.
ad_group_ad_engine_id ID dell'annuncio nell'account motore esterno. Questo campo è riservato solo all'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_ad.ad.id".
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdGroup

Risorsa API Search Ads 360: ad_group

Nome campo Search Ads 360Descrizione
ad_group_bid_modifier_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. L'intervallo è 1.0 - 6.0 per PreferredContent. Utilizza 0 per disattivare un tipo di dispositivo.
ad_group_bid_modifier_device_type Tipo di dispositivo.
ad_group_cpc_bid_micros L'offerta CPC (costo per clic) massimo.
ad_group_creation_time Il timestamp di creazione di questo gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_end_date Data in cui il gruppo di annunci smette di pubblicare annunci. Per impostazione predefinita, il gruppo di annunci termina alla data di fine del gruppo di annunci. Se questo campo è impostato, il gruppo di annunci termina alla fine della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway Microsoft Advertising e Facebook. Formato: AAAA-MM-GG Esempio: 2019-03-14
ad_group_engine_id ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_engine_status Lo stato del motore per il gruppo di annunci.
ad_group_id L'ID del gruppo di annunci.
ad_group_labels I nomi delle risorse delle etichette associate a questo gruppo di annunci.
ad_group_language_code La lingua degli annunci e delle parole chiave in un gruppo di annunci. Questo campo è disponibile solo per gli account Microsoft Advertising.
ad_group_last_modified_time La data e l'ora dell'ultima modifica di questo gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_name Il nome del gruppo di annunci. Questo campo è obbligatorio e non deve essere vuoto quando crei nuovi gruppi di annunci. Deve contenere meno di 255 caratteri UTF-8 a larghezza intera. Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
ad_group_start_date Data in cui questo gruppo di annunci inizia a pubblicare annunci. Per impostazione predefinita, il gruppo di annunci inizia ora o alla data di inizio del gruppo di annunci, a seconda di quale sia la data successiva. Se questo campo è impostato, il gruppo di annunci inizia all'inizio della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway Microsoft Advertising e Facebook. Formato: AAAA-MM-GG Esempio: 2019-03-14
ad_group_status Lo stato del gruppo di annunci.
ad_group_targeting_setting_target_restrictions L'impostazione per dimensione di targeting per limitare la copertura della campagna o del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: AdGroupAssetStats

Risorsa API Search Ads 360: ad_group_asset

Nome campo Search Ads 360Descrizione
ad_group_asset_ad_group Obbligatorio. Immutabile. Il gruppo di annunci a cui è collegato l'asset.
ad_group_asset_asset Obbligatorio. Immutabile. L'asset collegato al gruppo di annunci.
ad_group_engine_id ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: AdGroupAudienceConversionActionAndDeviceStats

Risorsa API Search Ads 360: ad_group_audience_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17.
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdGroupAudienceDeviceStats

Risorsa API Search Ads 360: ad_group_audience_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdGroupConversionActionAndAssetStats

Risorsa API Search Ads 360: ad_group_asset

Nome campo Search Ads 360Descrizione
ad_group_asset_ad_group Obbligatorio. Immutabile. Il gruppo di annunci a cui è collegato l'asset.
ad_group_asset_asset Obbligatorio. Immutabile. L'asset collegato al gruppo di annunci.
ad_group_engine_id ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2018-04-17

Nome tabella Search Ads 360: AdGroupConversionActionAndDeviceStats

Risorsa API Search Ads 360: ad_group

Nome campo Search Ads 360Descrizione
ad_group_engine_id Solo output. ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_id Solo output. L'ID del gruppo di annunci.
bidding_strategy_id Solo output. L'ID della strategia di offerta.
campaign_id Solo output. L'ID della campagna.
customer_id Solo output. L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdGroupCriterion

Risorsa API Search Ads 360: ad_group_criterion

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_creation_time Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_status Lo stato del criterio. Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti sono idonei a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
ad_group_criterion_type Il tipo di criterio.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
ad_group_name Il nome del gruppo di annunci. Questo campo è obbligatorio e non deve essere vuoto quando crei nuovi gruppi di annunci. Deve contenere meno di 255 caratteri UTF-8 a larghezza intera. Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
ad_group_status Lo stato del gruppo di annunci.
campaign_id L'ID della campagna.
campaign_name Il nome della campagna. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne. Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
campaign_status Lo stato della campagna.
customer_account_type Tipo di account motore. Ad esempio: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_name Nome descrittivo facoltativo e non univoco del cliente.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: AdGroupDeviceStats

Risorsa API Search Ads 360: ad_group

Nome campo Search Ads 360Descrizione
ad_group_engine_id ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AdGroupLabel

Risorsa API Search Ads 360: ad_group_label

Nome campo Search Ads 360Descrizione
ad_group_label_ad_group Il gruppo di annunci a cui è allegata l'etichetta.
ad_group_label_label L'etichetta assegnata al gruppo di annunci.
ad_group_label_owner_customer_id L'ID del cliente proprietario dell'etichetta.
ad_group_label_resource_name Il nome della risorsa dell'etichetta del gruppo di annunci. I nomi delle risorse delle etichette dei gruppi di annunci hanno il formato: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: AdGroupStats

Risorsa API Search Ads 360: ad_group

Nome campo Search Ads 360Descrizione
ad_group_engine_id ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "ad_group.id".
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_content_impression_share 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.
metrics_content_rank_lost_impression_share 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.
metrics_historical_quality_score La cronologia del punteggio di qualità.
metrics_search_impression_share 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.
metrics_search_rank_lost_impression_share 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17.

Nome tabella Search Ads 360: AgeRangeConversionActionAndDeviceStats

Risorsa API Search Ads 360: age_range_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: AgeRangeDeviceStats

Risorsa API Search Ads 360: age_range_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: Asset

Risorsa API Search Ads 360: asset

Nome campo Search Ads 360Descrizione
asset_creation_time Il timestamp della creazione di questa risorsa. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
asset_engine_status Lo stato motore dell'asset.
asset_final_urls Un elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio.
asset_id L'ID dell'asset.
asset_last_modified_time La data e l'ora dell'ultima modifica di questa risorsa. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
asset_sitelink_asset.description1 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.
asset_sitelink_asset.description2 Seconda riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 inclusi e deve essere impostata anche description1.
asset_sitelink_asset_link_text Testo visualizzato dell'URL per il sitelink. La lunghezza di questa stringa deve essere compresa tra 1 e 25 caratteri inclusi.
asset_status Lo stato della risorsa.
asset_tracking_url_template Modello di URL per la creazione di un URL di monitoraggio.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: AssetSetStats

Risorsa API Search Ads 360: asset_set_asset

Nome campo Search Ads 360Descrizione
asset_set_asset_asset Immutabile. L'asset a cui è collegato questo asset dell'insieme.
asset_set_asset_asset_set Immutabile. L'insieme di asset a cui è collegato questo asset dell'insieme.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: BidStrategy

Risorsa API Search Ads 360: bidding_strategy

Nome campo Search Ads 360Descrizione
bidding_strategy_id L'ID della strategia di offerta.
bidding_strategy_name Il nome della strategia di offerta. Tutte le strategie di offerta all'interno di un account devono avere un nome distinto. La lunghezza di questa stringa deve essere compresa tra 1 e 255 byte inclusi in UTF-8 (tagliata).
bidding_strategy_status Lo stato della strategia di offerta.
bidding_strategy_target_cpa_cpc_bid_ceiling_micros 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.
bidding_strategy_target_cpa_cpc_bid_floor_micros 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.
bidding_strategy_target_cpa_target_cpa_micros CPA target medio. Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account.
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros 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.
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.
bidding_strategy_target_roas_cpc_bid_ceiling_micros 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.
bidding_strategy_target_roas_cpc_bid_floor_micros 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.
bidding_strategy_target_roas_target_roas 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.
bidding_strategy_target_spend_cpc_bid_ceiling_micros Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.
bidding_strategy_target_spend_target_spend_micros 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 è deprecato e non deve più essere utilizzato.
segments_conversion_action Nome risorsa dell'azione di conversione.

Nome tabella Search Ads 360: BidStrategyStats

Risorsa API Search Ads 360: bidding_strategy

Nome campo Search Ads 360Descrizione
bidding_strategy_id L'ID della strategia di offerta.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_all_conversions_value_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_by_conversion_date Il numero di conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
metrics_cross_device_conversions_value_by_conversion_date La somma del valore delle conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: Campaign

Risorsa API Search Ads 360: campaign

Nome campo Search Ads 360Descrizione
accessible_bidding_strategy_id L'ID della strategia di offerta.
accessible_bidding_strategy_name Il nome della strategia di offerta.
bidding_strategy_id L'ID della strategia di offerta.
bidding_strategy_name Il nome della strategia di offerta. Tutte le strategie di offerta all'interno di un account devono avere un nome distinto. La lunghezza di questa stringa deve essere compresa tra 1 e 255 byte inclusi in UTF-8 (tagliata).
campaign_advertising_channel_sub_type Raffinamento facoltativo di advertising_channel_type. Deve essere un sottotipo valido del tipo di canale principale. Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
campaign_advertising_channel_type Il target di pubblicazione principale per gli annunci all'interno della campagna. Le opzioni di targeting possono essere perfezionate in network_settings. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne. Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
campaign_bidding_strategy_type Il tipo di strategia di offerta. Una strategia di offerta può essere creata impostando lo schema di offerta per creare una strategia di offerta standard o il campo bidding_strategy per creare una strategia di offerta di portafoglio. Questo campo è di sola lettura.
campaign_budget_amount_micros L'importo del budget, nella valuta locale dell'account. L'importo è specificato in micro, dove un milione equivale a un'unità di valuta. La spesa mensile è limitata a 30,4 volte questo importo.
campaign_budget_delivery_method Il metodo di pubblicazione che determina la velocità con cui viene speso il budget della campagna. Se non specificato in un'operazione di creazione, il valore predefinito è STANDARD.
campaign_budget_period Periodo durante il quale spendere il budget. Se non specificato, il valore predefinito è DAILY.
campaign_creation_time Il timestamp di creazione di questa campagna. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
campaign_end_date L'ultimo giorno della campagna nel fuso orario del cliente nel formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 30/12/2037, il che significa che la campagna verrà pubblicata a tempo indeterminato. Per impostare una campagna esistente in modo che venga pubblicata a tempo indeterminato, imposta questo campo su 2037-12-30.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
campaign_labels I nomi delle risorse delle etichette associate a questa campagna.
campaign_last_modified_time La data e l'ora dell'ultima modifica di questa campagna. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
campaign_name Il nome della campagna. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne. Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
campaign_network_settings_target_content_network Se gli annunci verranno pubblicati nei posizionamenti specificati nella Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.
campaign_network_settings_target_google_search Se gli annunci verranno pubblicati con i risultati di ricerca di google.com.
campaign_network_settings_target_partner_search_network Se gli annunci verranno pubblicati sulla rete dei partner di Google. Questa opzione è disponibile solo per alcuni account partner Google selezionati.
campaign_network_settings_target_search_network Indica se gli annunci verranno pubblicati sui siti partner della rete di ricerca di Google (richiede che anche target_google_search sia impostato su true).
campaign_start_date La data di inizio della campagna nel fuso orario del cliente nel formato AAAA-MM-GG.
campaign_status Lo stato della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: CampaignAssetStats

Risorsa API Search Ads 360: campaign_asset

Nome campo Search Ads 360Descrizione
campaign_asset_asset Immutabile. L'asset collegato alla campagna.
campaign_asset_campaign Immutabile. La campagna a cui è collegato l'asset.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: CampaignAudienceConversionActionAndDeviceStats

Risorsa API Search Ads 360: campaign_audience_view

Nome campo Search Ads 360Descrizione
campaign_criterion_criterion_id L'ID del criterio.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: CampaignAudienceDeviceStats

Risorsa API Search Ads 360: campaign_audience_view

Nome campo Search Ads 360Descrizione
campaign_criterion_criterion_id L'ID del criterio.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: CampaignConversionActionAndAssetStats

Risorsa API Search Ads 360: campaign_asset

Nome campo Search Ads 360Descrizione
ad_group_id L'ID del gruppo di annunci.
campaign_asset_campaign Immutabile. La campagna a cui è collegato l'asset.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
campain_asset_asset Immutabile. L'asset collegato alla campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: CampaignConversionActionAndDeviceStats

Risorsa API Search Ads 360: campaign

Nome campo Search Ads 360Descrizione
bidding_strategy_id L'ID della strategia di offerta.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_all_conversions_value_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_by_conversion_date Il numero di conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
metrics_cross_device_conversions_value_by_conversion_date La somma del valore delle conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: CampaignCriterion

Risorsa API Search Ads 360: campaign_criterion

Nome campo Search Ads 360Descrizione
campaign_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
campaign_criterion_criterion_id L'ID del criterio.
campaign_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio della campagna. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
campaign_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
campaign_criterion_status Lo stato del criterio.
campaign_criterion_type Il tipo di criterio.
campaign_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: CampaignDeviceStats

Risorsa API Search Ads 360: campaign

Nome campo Search Ads 360Descrizione
bidding_strategy_id L'ID della strategia di offerta.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: CampaignLabel

Risorsa API Search Ads 360: campaign_label

Nome campo Search Ads 360Descrizione
campaign_id L'ID della campagna.
campaign_label_campaign La campagna a cui è associata l'etichetta.
campaign_label_label L'etichetta assegnata alla campagna.
campaign_label_owner_customer_id L'ID del cliente proprietario dell'etichetta.
campaign_label_resource_name Nome della risorsa. I nomi delle risorse delle etichette delle campagne hanno il formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}
customer_id L'ID del cliente.

Nome tabella Search Ads 360: CampaignStats

Risorsa API Search Ads 360: campaign

Nome campo Search Ads 360Descrizione
bidding_strategy_id L'ID della strategia di offerta.
campaign_engine_id ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per l'entità Google Ads, utilizza "campaign.id".
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_content_budget_lost_impression_share 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 a causa del 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.
metrics_content_impression_share 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.
metrics_content_rank_lost_impression_share 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.
metrics_conversions 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.
metrics_conversions_value 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_historical_quality_score La cronologia del punteggio di qualità.
metrics_impressions 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.
metrics_search_budget_lost_impression_share 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 a causa del 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.
metrics_search_impression_share 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.
metrics_search_rank_lost_impression_share 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: CartDataSalesStats

Risorsa API Search Ads 360: cart_data_sales_view

Nome campo Search Ads 360Descrizione
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_client_account_cross_sell_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_gross_profit_micros
metrics_client_account_cross_sell_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_revenue_micros
metrics_client_account_cross_sell_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_units_sold
metrics_client_account_lead_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_gross_profit_micros
metrics_client_account_lead_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_revenue_micros
metrics_client_account_lead_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_units_sold
metrics_cross_sell_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_gross_profit_micros
metrics_cross_sell_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_revenue_micros
metrics_cross_sell_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_units_sold
metrics_lead_gross_profit_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_gross_profit_micros
metrics_lead_revenue_micros https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_revenue_micros
metrics_lead_units_sold https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_units_sold
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_product_brand La marca del prodotto.
segments_product_item_id ID articolo del prodotto.
segments_product_sold_brand Marca del prodotto venduto.
segments_product_sold_item_id L'ID articolo del prodotto venduto.
segments_product_sold_title Titolo del prodotto venduto.
segments_product_sold_type_l1 Tipo (livello 1) di prodotto venduto.
segments_product_sold_type_l2 Tipo (livello 2) di prodotto venduto.
segments_product_sold_type_l3 Tipo (livello 3) del prodotto venduto.
segments_product_sold_type_l4 Tipo (livello 4) di prodotto venduto.
segments_product_sold_type_l5 Tipo (livello 5) di prodotto venduto.
segments_product_title Titolo del prodotto.
segments_product_type_l1 Tipo (livello 1) di prodotto.
segments_product_type_l2 Tipo (2° livello) di prodotto.
segments_product_type_l3 Tipo (3° livello) di prodotto.
segments_product_type_l4 Tipo (4° livello) di prodotto.
segments_product_type_l5 Tipo (livello 5) di prodotto.

Nome tabella Search Ads 360: conversione

Risorsa API Search Ads 360: conversione

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
conversion_ad_id ID annuncio. Un valore pari a 0 indica che l'annuncio non è attribuito.
conversion_advertiser_conversion_id Per le conversioni offline, si tratta di un ID fornito dagli inserzionisti. Se un inserzionista non specifica un ID, Search Ads 360 ne genera uno. Per le conversioni online, questo valore è uguale alla colonna id o alla colonna floodlight_order_id, a seconda delle istruzioni Floodlight dell'inserzionista.
conversion_attribution_type A cosa è attribuita la conversione: visita o parola chiave + annuncio.
conversion_click_id Una stringa univoca, per la visita a cui è attribuita la conversione, che viene trasmessa alla pagina di destinazione come parametro URL ID clic.
conversion_conversion_date_time Il timestamp dell'evento di conversione.
conversion_conversion_last_modified_date_time Il timestamp dell'ultima modifica della conversione.
conversion_conversion_quantity La quantità di articoli registrati dalla conversione, determinata dal parametro URL qty. L'inserzionista è responsabile del riempimento dinamico del parametro (ad esempio il numero di articoli venduti nella conversione), altrimenti il valore predefinito è 1.
conversion_conversion_revenue_micros Le entrate aggiustate in micro per l'evento di conversione. Sarà sempre nella valuta dell'account di pubblicazione.
conversion_conversion_visit_date_time Il timestamp della visita a cui è attribuita la conversione.
conversion_criterion_id ID criterio Search Ads 360. Un valore pari a 0 indica che il criterio non è attribuito.
conversion_floodlight_order_id L'ID ordine Floodlight fornito dall'inserzionista per la conversione.
conversion_floodlight_original_revenue Le entrate originali e invariate associate all'evento Floodlight (nella valuta del report corrente), prima delle modifiche alle istruzioni sulla valuta Floodlight.
conversion_id L'ID della conversione
conversion_merchant_id L'ID account inventario Search Ads 360 contenente il prodotto su cui è stato fatto clic. Search Ads 360 genera questo ID quando colleghi un account inventario in Search Ads 360.
conversion_product_channel Il canale di vendita del prodotto su cui è stato fatto clic: online o locale.
conversion_product_country_code Il paese (formato ISO 3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic.
conversion_product_id L'ID del prodotto su cui è stato fatto clic.
conversion_product_language_code La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto.
conversion_product_store_id Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.
conversion_status Lo stato della conversione, ovvero ENABLED o REMOVED.
conversion_visit_id L'ID visita Search Ads 360 a cui è attribuita la conversione.
customer_account_type Tipo di account motore. Ad esempio: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_name Nome descrittivo facoltativo e non univoco del cliente.
customer_id L'ID del cliente.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: ConversionAction

Risorsa API Search Ads 360: conversion_action

Nome campo Search Ads 360Descrizione
conversion_action_creation_time Timestamp della creazione dell'attività Floodlight, formattato in ISO 8601.
conversion_action_floodlight_settings_activity_group_tag Stringa utilizzata per identificare un gruppo attività Floodlight durante la generazione di report sulle conversioni.
conversion_action_floodlight_settings_activity_id ID dell'attività Floodlight in DoubleClick Campaign Manager (DCM).
conversion_action_floodlight_settings_activity_tag Stringa utilizzata per identificare un'attività Floodlight durante la generazione di report sulle conversioni.
conversion_action_name Il nome dell'azione di conversione. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove azioni di conversione.
conversion_action_status Lo stato di questa azione di conversione per l'accumulo di eventi di conversione.
conversion_action_type Il tipo di questa azione di conversione.

Nome tabella Search Ads 360: GenderConversionActionAndDeviceStats

Risorsa API Search Ads 360: gender_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: GenderDeviceStats

Risorsa API Search Ads 360: gender_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: parola chiave

Risorsa API Search Ads 360: keyword_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_creation_time Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_effective_cpc_bid_micros L'offerta CPC (costo per clic) effettivo.
ad_group_criterion_engine_id ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è solo per l'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_criterion.criterion_id".
ad_group_criterion_engine_status Lo stato del motore per il criterio del gruppo di annunci.
ad_group_criterion_final_url_suffix Modello di URL per aggiungere parametri all'URL finale.
ad_group_criterion_final_urls L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.
ad_group_criterion_keyword_match_type Il tipo di corrispondenza della parola chiave.
ad_group_criterion_keyword_text Il testo della parola chiave (al massimo 80 caratteri e 10 parole).
ad_group_criterion_labels I nomi delle risorse delle etichette associate a questo criterio del gruppo di annunci.
ad_group_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_criterion_quality_info_quality_score Il punteggio di qualità. Questo campo potrebbe non essere compilato se Google non dispone di informazioni sufficienti per determinare un valore.
ad_group_criterion_status Lo stato del criterio. Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti sono idonei a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
ad_group_criterion_tracking_url_template Il modello di URL per creare un URL di monitoraggio.
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
bidding_strategy_target_cpa_cpc_bid_ceiling_micros 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.
bidding_strategy_target_cpa_cpc_bid_floor_micros 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.
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros 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.
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.
bidding_strategy_target_roas_cpc_bid_ceiling_micros 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.
bidding_strategy_target_roas_cpc_bid_floor_micros 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.
bidding_strategy_target_spend_cpc_bid_ceiling_micros Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: KeywordConversionActionAndDeviceStats

Risorsa API Search Ads 360: keyword_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_engine_id ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo all'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_criterion.criterion_id".
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_all_conversions_value_by_conversion_date 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. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_by_conversion_date Il numero di conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
metrics_cross_device_conversions_value_by_conversion_date La somma del valore delle conversioni cross-device per data di conversione. Per ulteriori informazioni sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni".
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: KeywordDeviceStats

Risorsa API Search Ads 360: keyword_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_engine_id ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo all'account Search Ads 360. Ad esempio: Yahoo Japan, Microsoft, Baidu. Per le entità non Search Ads 360, utilizza "ad_group_criterion.criterion_id".
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
metrics_visits Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione di un inserzionista.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: KeywordStats

Risorsa API Search Ads 360: keyword_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_id L'ID del gruppo di annunci.
bidding_strategy_id L'ID della strategia di offerta.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_historical_quality_score La cronologia del punteggio di qualità.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: LocationConversionActionAndDeviceStats

Risorsa API Search Ads 360: location_view

Nome campo Search Ads 360Descrizione
campaign_criterion_criterion_id L'ID del criterio.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: LocationDeviceStats

Risorsa API Search Ads 360: location_view

Nome campo Search Ads 360Descrizione
campaign_criterion_criterion_id L'ID del criterio.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: NegativeAdGroupCriterion

Risorsa API Search Ads 360: ad_group_criterion

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_creation_time Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_status Lo stato del criterio. Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti sono idonei a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
ad_group_criterion_type Il tipo di criterio.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 ed è vietato per le operazioni UPDATE.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: NegativeAdGroupKeyword

Risorsa API Search Ads 360: ad_group_criterion

Nome campo Search Ads 360Descrizione
ad_group_criterion_creation_time Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_keyword_match_type Il tipo di corrispondenza della parola chiave.
ad_group_criterion_keyword_text Il testo della parola chiave (al massimo 80 caratteri e 10 parole).
ad_group_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_criterion_status Lo stato del criterio. Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti sono idonei a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: NegativeCampaignCriterion

Risorsa API Search Ads 360: campaign_criterion

Nome campo Search Ads 360Descrizione
campaign_criterion_age_range_type Tipo di fascia d'età.
campaign_criterion_criterion_id L'ID del criterio.
campaign_criterion_gender_type Tipo di genere.
campaign_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio della campagna. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
campaign_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
campaign_criterion_status Lo stato del criterio.
campaign_criterion_type Il tipo di criterio.
campaign_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
campaign_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: NegativeCampaignKeyword

Risorsa API Search Ads 360: campaign_criterion

Nome campo Search Ads 360Descrizione
campaign_criterion_criterion_id L'ID del criterio.
campaign_criterion_keyword_match_type Il tipo di corrispondenza della parola chiave.
campaign_criterion_keyword_text Il testo della parola chiave (al massimo 80 caratteri e 10 parole).
campaign_criterion_last_modified_time La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
campaign_criterion_status Lo stato del criterio.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.

Nome tabella Search Ads 360: ProductAdvertised

Risorsa API Search Ads 360: shopping_performance_view

Nome campo Search Ads 360Descrizione
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_product_bidding_category_level1 Categoria di offerta (livello 1) del prodotto.
segments_product_bidding_category_level2 Categoria di offerta (2° livello) del prodotto.
segments_product_bidding_category_level3 Categoria di offerta (livello 3) del prodotto.
segments_product_bidding_category_level4 Categoria di offerta (livello 4) del prodotto.
segments_product_bidding_category_level5 Categoria di offerta (livello 5) del prodotto.
segments_product_brand La marca del prodotto.
segments_product_channel Canale del prodotto.
segments_product_channel_exclusivity Esclusività del canale del prodotto.
segments_product_condition Condizioni del prodotto.
segments_product_country Nome della risorsa della costante di targeting geografico per il paese di vendita del prodotto.
segments_product_custom_attribute0 Attributo personalizzato 0 del prodotto.
segments_product_custom_attribute1 Attributo personalizzato 1 del prodotto.
segments_product_custom_attribute2 Attributo personalizzato 2 del prodotto.
segments_product_custom_attribute3 Attributo personalizzato 3 del prodotto.
segments_product_custom_attribute4 Attributo personalizzato 4 del prodotto.
segments_product_item_id ID articolo del prodotto.
segments_product_language Nome della risorsa della costante di lingua per la lingua del prodotto.
segments_product_store_id ID negozio del prodotto.
segments_product_title Titolo del prodotto.
segments_product_type_l1 Tipo (livello 1) di prodotto.
segments_product_type_l2 Tipo (2° livello) di prodotto.
segments_product_type_l3 Tipo (3° livello) di prodotto.
segments_product_type_l4 Tipo (4° livello) di prodotto.
segments_product_type_l5 Tipo (livello 5) di prodotto.

Nome tabella Search Ads 360: ProductAdvertisedConversionActionAndDeviceStats

Risorsa API Search Ads 360: shopping_performance_view

Nome campo Search Ads 360Descrizione
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments.conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.
segments_product_item_id ID articolo del prodotto.

Nome tabella Search Ads 360: ProductAdvertisedDeviceStats

Risorsa API Search Ads 360: shopping_performance_view

Nome campo Search Ads 360Descrizione
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.
segments_product_item_id ID articolo del prodotto.

Nome tabella Search Ads 360: ProductGroup

Risorsa API Search Ads 360: product_group_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_creation_time Solo output. Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
ad_group_criterion_criterion_id Solo output. L'ID del criterio.
ad_group_criterion_effective_cpc_bid_micros Solo output. L'offerta CPC (costo per clic) effettivo.
ad_group_criterion_engine_status Solo output. Lo stato del motore per il criterio del gruppo di annunci.
ad_group_criterion_final_urls L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.
ad_group_criterion_last_modified_time Solo output. La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
ad_group_criterion_listing_group_type Tipo di gruppo di schede.
ad_group_criterion_status Lo stato del criterio. Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti sono idonei a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
ad_group_criterion_tracking_url_template Il modello di URL per creare un URL di monitoraggio.
ad_group_id Solo output. L'ID del gruppo di annunci.
campaign_id Solo output. L'ID della campagna.
customer_id L'ID del cliente.
product_group_view_resource_name Solo output. Il nome della risorsa della visualizzazione del gruppo di prodotti. I nomi delle risorse di visualizzazione dei gruppi di prodotti hanno il formato: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

Nome tabella Search Ads 360: ProductGroupStats

Risorsa API Search Ads 360: product_group_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id Solo output. L'ID del criterio.
ad_group_id Solo output. L'ID del gruppo di annunci.
campaign_id Solo output. L'ID della campagna.
customer_id L'ID del cliente.
metrics_all_conversions Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di include_in_conversions_metric.
metrics_all_conversions_value Il valore di tutte le conversioni.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17

Nome tabella Search Ads 360: Visit

Risorsa API Search Ads 360: visita

Nome campo Search Ads 360Descrizione
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_account_type Tipo di account motore. Ad esempio: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track.
customer_descriptive_name Nome descrittivo facoltativo e non univoco del cliente.
customer_id L'ID del cliente.
segments_ad_network_type Tipo di rete pubblicitaria.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.
visit_ad_id ID annuncio. Un valore pari a 0 indica che l'annuncio non è attribuito.
visit_click_id Una stringa univoca per ogni visita che viene trasmessa alla pagina di destinazione come parametro URL ID clic.
visit_criterion_id ID parola chiave di Search Ads 360. Un valore pari a 0 indica che la parola chiave non è attribuita.
visit_id L'ID della visita.
visit_merchant_id L'ID account inventario Search Ads 360 contenente il prodotto su cui è stato fatto clic. Search Ads 360 genera questo ID quando colleghi un account inventario in Search Ads 360.
visit_product_channel Il canale di vendita del prodotto su cui è stato fatto clic: online o locale.
visit_product_country_code Il paese (formato ISO-3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic.
visit_product_id L'ID del prodotto su cui è stato fatto clic.
visit_product_language_code La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto.
visit_product_store_id Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.
visit_visit_date_time Il timestamp dell'evento visita. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".

Nome tabella Search Ads 360: WebpageConversionActionAndDeviceStats

Risorsa API Search Ads 360: webpage_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_cross_device_conversions 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.
metrics_cross_device_conversions_value La somma del valore delle conversioni cross-device.
segments_conversion_action_name Nome azione di conversione.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Nome tabella Search Ads 360: WebpageDeviceStats

Risorsa API Search Ads 360: webpage_view

Nome campo Search Ads 360Descrizione
ad_group_criterion_age_range_type Tipo di fascia d'età.
ad_group_criterion_bid_modifier Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri a cui è possibile applicare il targeting supporta i modificatori.
ad_group_criterion_cpc_bid_micros L'offerta CPC (costo per clic).
ad_group_criterion_criterion_id L'ID del criterio.
ad_group_criterion_gender_type Tipo di genere.
ad_group_criterion_location_geo_target_constant Il nome della risorsa costante di targeting geografico.
ad_group_criterion_user_list_user_list Il nome della risorsa Elenco utenti.
ad_group_criterion_webpage_conditions 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 durante la valutazione 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 ed è vietato per le operazioni UPDATE.
ad_group_criterion_webpage_coverage_percentage 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%.
ad_group_id L'ID del gruppo di annunci.
campaign_id L'ID della campagna.
customer_id L'ID del cliente.
metrics_average_cpc Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti.
metrics_average_cpm Costo per mille impressioni (CPM) medio.
metrics_clicks Il numero di clic.
metrics_client_account_conversions 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_conversions_value 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 strategie di offerta verranno ottimizzate per queste conversioni.
metrics_client_account_view_through_conversions 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.
metrics_cost_micros Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo.
metrics_ctr Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
metrics_impressions 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.
segments_date Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17
segments_device Il dispositivo a cui si applicano le metriche.

Tabelle di corrispondenza di Search Ads 360

Le tabelle di corrispondenza di Search Ads 360 sono tabelle che contengono solo campi Attributo (campi contenenti impostazioni o altri dati fissi) e sono definite per consentire agli utenti di eseguire query sulle informazioni sulla struttura dell'account. Se utilizzi la finestra di aggiornamento o pianifichi un backfill, gli snapshot della tabella di corrispondenza non vengono aggiornati.

Di seguito è riportato un elenco delle tabelle di corrispondenza nel trasferimento di Search Ads 360:

  • Account
  • Annuncio
  • AdGroup
  • AdGroupCriterion
  • Qualsiasi tabella di mappatura degli ID
  • Asset
  • BidStrategy
  • Campagna
  • CampaignCriterion
  • ConversionAction
  • Parola chiave
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup