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 precedente 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
- 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
- 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
- Tabelle:
-
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id - Visualizzazioni:
-
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id
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
- 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
- Tabelle:
-
p_sa_AdGroupLabel_customer_id
- Visualizzazioni:
-
sa_AdGroupLabel_customer_id
age_range_view
- Tabelle:
-
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id - Visualizzazioni:
-
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id
asset
- Tabelle:
- p_sa_Asset_customer_id
- Visualizzazioni:
- sa_Asset_customer_id
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
- Tabelle:
-
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id - Visualizzazioni:
-
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id
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
- Tabelle:
-
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id - Visualizzazioni:
-
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id
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
- 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
- Tabelle:
-
p_sa_CampaignLabel_customer_id
- Visualizzazioni:
-
sa_CampaignLabel_customer_id
cart_data_sales_view
- Tabelle:
- p_sa_CartDataSalesStats_customer_id
- Visualizzazioni:
- sa_CartDataSalesStats_customer_id
conversione
- Tabelle:
- p_sa_Conversion_customer_id
- Visualizzazioni:
- sa_Conversion_customer_id
conversion_action
- Tabelle:
- p_sa_ConversionAction_customer_id
- Visualizzazioni:
- sa_ConversionAction_customer_id
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
- Tabelle:
- p_sa_AccountAssetStats_customer_id
- Visualizzazioni:
- sa_AccountAssetStats_customer_id
gender_view
- Tabelle:
-
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id - Visualizzazioni:
-
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id
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
- Tabelle:
-
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id - Visualizzazioni:
-
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id
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
- 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
- Tabelle:
- p_sa_Visit_customer_id
- Visualizzazioni:
- sa_Visit_customer_id
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 360 | Descrizione |
|---|---|
| customer_account_level | Il livello dell'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 del 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 dell'amministratore. |
| 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 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 della tabella di Search Ads 360: AccountConversionActionAndAssetStats
Risorsa API Search Ads 360: asset_set_asset
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| asset_set_asset_asset | Immutabile. L'asset a cui è collegato questo asset dell'insieme di asset. |
| asset_set_asset_asset_set | Immutabile. L'insieme di asset a cui è collegato questo asset dell'insieme di asset. |
| 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'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 360 | Descrizione |
|---|---|
| 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: AccountDeviceStats
Risorsa API Search Ads 360: customer
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 alla 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: AccountStats
Risorsa API Search Ads 360: customer
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 sulla rete di ricerca (budget) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato 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 indicata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 per ranking dei contenuti viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato 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 sulla rete di ricerca (budget) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato come 0,9001. |
| metrics_search_impression_share | Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni sulla rete di ricerca viene registrata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 sulla rete di ricerca (ranking) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato 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: Ad
Risorsa API Search Ads 360: ad_group_ad
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 | 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. Il campo del 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 | 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 un'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 | La data e l'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 360 | Descrizione |
|---|---|
| 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 un'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 saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| metrics_cross_device_conversions | Conversioni generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_by_conversion_date | Il numero di conversioni cross-device in base alla data di conversione. Per saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | 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 360 | Descrizione |
|---|---|
| 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 un'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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 alla 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: AdGroup
Risorsa API Search Ads 360: ad_group
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 costo per clic (CPC) 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 | La data in cui il gruppo di annunci interrompe la pubblicazione degli annunci. Per impostazione predefinita, il gruppo di annunci termina nella 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 invece "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 durante la creazione di nuovi gruppi di annunci. Deve contenere meno di 255 caratteri UTF-8 a larghezza intera. Non deve contenere caratteri null (punto di codice 0x0), avanzamento riga 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 l'evento che si verifica per ultimo. 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 360 | Descrizione |
|---|---|
| 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 invece "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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17. |
| segments_device | 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | 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 360 | Descrizione |
|---|---|
| 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 invece "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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2018-04-17 |
Nome della tabella di Search Ads 360: AdGroupConversionActionAndDeviceStats
Risorsa API Search Ads 360: ad_group
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 invece "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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il 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 del target geografico. |
| ad_group_criterion_status | Lo stato del criterio. Questo è lo stato dell'entità del criterio del gruppo di annunci, impostato dal client. Nota: i report della UI possono incorporare informazioni aggiuntive che influiscono sull'idoneità di un criterio per l'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. La UI mostrerà ogni fascia d'età come"attivata", poiché è idonea a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimossa", 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 dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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 durante la creazione di nuovi gruppi di annunci. Deve contenere meno di 255 caratteri UTF-8 a larghezza intera. Non deve contenere caratteri null (punto di codice 0x0), avanzamento riga 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 durante la creazione di nuove campagne. Non deve contenere caratteri null (punto di codice 0x0), avanzamento riga 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 360 | Descrizione |
|---|---|
| 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 invece "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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 alla 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 | 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 360 | Descrizione |
|---|---|
| ad_group_label_ad_group | Il gruppo di annunci a cui è associata 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 seguente 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 360 | Descrizione |
|---|---|
| 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 invece "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 indicata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 per ranking dei contenuti viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato come 0,9001. |
| metrics_historical_quality_score | La cronologia del punteggio di qualità. |
| metrics_search_impression_share | Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni sulla rete di ricerca viene registrata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 sulla rete di ricerca (ranking) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: Asset
Risorsa API Search Ads 360: asset
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| asset_creation_time | Il timestamp di creazione dell'asset. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss". |
| asset_engine_status | Lo stato del motore dell'asset. |
| asset_final_urls | Un elenco di 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 questo asset. 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 | Prima riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 caratteri inclusi e deve essere impostato anche description2. |
| asset_sitelink_asset.description2 | Seconda riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 caratteri inclusi e deve essere impostato 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 dell'asset. |
| 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 360 | Descrizione |
|---|---|
| asset_set_asset_asset | Immutabile. L'asset a cui è collegato questo asset dell'insieme di asset. |
| asset_set_asset_asset_set | Immutabile. L'insieme di asset a cui è collegato questo asset dell'insieme di asset. |
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 360 | Descrizione |
|---|---|
| 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 UTF-8 (tagliati). |
| 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. Questo valore deve essere impostato 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. Questo valore deve essere impostato 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 offerte automatiche può specificare. Questo è un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo ed è specificato in microvaluta locale. |
| 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. Questo valore deve essere impostato 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. Questo valore deve essere impostato 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 | Il target di spesa in base al quale massimizzare i clic. Un gestore delle offerte TargetSpend tenterà di spendere il valore più basso tra questo valore e l'importo di spesa della limitazione naturale. Se non viene specificato, il budget viene utilizzato come target di spesa. Questo campo è deprecato e non deve più essere utilizzato. |
| segments_conversion_action | Nome della risorsa dell'azione di conversione. |
Nome tabella Search Ads 360: BidStrategyStats
Risorsa API Search Ads 360: bidding_strategy
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 saperne di più 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 saperne di più 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e per mille impressioni (CPM) durante questo periodo. |
| metrics_cross_device_conversions | Conversioni generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_by_conversion_date | Il numero di conversioni cross-device in base alla data di conversione. Per saperne di più 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 saperne di più 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 360 | Descrizione |
|---|---|
| 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 UTF-8 (tagliati). |
| campaign_advertising_channel_sub_type | Perfezionamento 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 della campagna. Le opzioni di targeting possono essere perfezionate in network_settings. Questo campo è obbligatorio e non deve essere vuoto durante la creazione di 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. Puoi creare una strategia di offerta 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 frequenza 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 della 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 di pubblicazione nel formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 2037-12-30, 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 invece "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 della 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 durante la creazione di nuove campagne. Non deve contenere caratteri null (punto di codice 0x0), avanzamento riga NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD). |
| campaign_network_settings_target_content_network | Se gli annunci verranno pubblicati in posizionamenti specificati sulla 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 | Indica se gli annunci verranno pubblicati sulla rete di partner di Google. Questa opzione è disponibile solo per alcuni account partner di 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 pubblicazione 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 360 | Descrizione |
|---|---|
| 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 invece "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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 360 | Descrizione |
|---|---|
| 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | 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 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: CampaignConversionActionAndAssetStats
Risorsa API Search Ads 360: campaign_asset
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 invece "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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'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 360 | Descrizione |
|---|---|
| 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 invece "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 saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| metrics_cross_device_conversions | Conversioni generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_by_conversion_date | Il numero di conversioni cross-device in base alla data di conversione. Per saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: CampaignCriterion
Risorsa API Search Ads 360: campaign_criterion
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 targetizzabili 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 del target 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 dell'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 360 | Descrizione |
|---|---|
| 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 invece "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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 alla 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: CampaignLabel
Risorsa API Search Ads 360: campaign_label
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 seguente 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 360 | Descrizione |
|---|---|
| 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 invece "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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| 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 sulla rete di ricerca (budget) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato 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 indicata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene registrato 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 per ranking dei contenuti viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
| metrics_conversions | Il numero di conversioni. Include solo le azioni di conversione per le quali l'attributo include_in_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue 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 | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_historical_quality_score | La cronologia del punteggio di qualità. |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 sulla rete di ricerca (budget) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato come 0,9001. |
| metrics_search_impression_share | Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni sulla rete di ricerca viene registrata nell'intervallo compreso tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 sulla rete di ricerca (ranking) viene indicata nell'intervallo compreso tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene registrato come 0,9001. |
| metrics_visits | Clic che Search Ads 360 ha registrato e inoltrato correttamente alla 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 360 | Descrizione |
|---|---|
| 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 | Il brand del prodotto. |
| segments_product_item_id | ID articolo del prodotto. |
| segments_product_sold_brand | Brand 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) del prodotto venduto. |
| segments_product_sold_type_l2 | Tipo (livello 2) del prodotto venduto. |
| segments_product_sold_type_l3 | Tipo (livello 3) del prodotto venduto. |
| segments_product_sold_type_l4 | Tipo (livello 4) del prodotto venduto. |
| segments_product_sold_type_l5 | Tipo (livello 5) del prodotto venduto. |
| segments_product_title | Il titolo del prodotto. |
| segments_product_type_l1 | Tipo (livello 1) del prodotto. |
| segments_product_type_l2 | Tipo (livello 2) del prodotto. |
| segments_product_type_l3 | Tipo (livello 3) del prodotto. |
| segments_product_type_l4 | Tipo (livello 4) del prodotto. |
| segments_product_type_l5 | Tipo (5° livello) del prodotto. |
Nome tabella Search Ads 360: Conversion
Risorsa API Search Ads 360: conversione
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 di questo tipo, 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 dell'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 elementi registrati dalla conversione, come determinato dal parametro URL qty. L'inserzionista è responsabile della compilazione dinamica 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. Questo valore 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 di 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 di 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 clic sul prodotto. |
| 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, ENABLED o REMOVED. |
| conversion_visit_id | L'ID visita di 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 dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: ConversionAction
Risorsa API Search Ads 360: conversion_action
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 durante la creazione di nuove azioni di conversione. |
| conversion_action_status | Lo stato di questa azione di conversione per la maturazione degli 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: GenderDeviceStats
Risorsa API Search Ads 360: gender_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: Keyword
Risorsa API Search Ads 360: keyword_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 è 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_criterion_engine_status | Lo stato del motore per il criterio del gruppo di annunci. |
| ad_group_criterion_final_url_suffix | Modello di URL per l'aggiunta di 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 (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à del criterio del gruppo di annunci, impostato dal client. Nota: i report della UI possono incorporare informazioni aggiuntive che influiscono sull'idoneità di un criterio per l'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. La UI mostrerà ogni fascia d'età come"attivata", poiché è idonea a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimossa", poiché non è stato aggiunto alcun criterio positivo. |
| ad_group_criterion_tracking_url_template | Il modello di URL per la creazione di 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. Questo valore deve essere impostato 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. Questo valore deve essere impostato 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 offerte automatiche può specificare. Questo è un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo ed è specificato in microvaluta locale. |
| 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. Questo valore deve essere impostato 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. Questo valore deve essere impostato 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 360 | Descrizione |
|---|---|
| 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 saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| metrics_cross_device_conversions | Conversioni generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_by_conversion_date | Il numero di conversioni cross-device in base alla data di conversione. Per saperne di più 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 saperne di più sulle colonne by_conversion_date, consulta Informazioni sulla colonna "Tutte le conversioni". |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: KeywordDeviceStats
Risorsa API Search Ads 360: keyword_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 alla 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 | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: KeywordStats
Risorsa API Search Ads 360: keyword_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 della tabella di Search Ads 360: LocationConversionActionAndDeviceStats
Risorsa API Search Ads 360: location_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: LocationDeviceStats
Risorsa API Search Ads 360: location_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 | Il 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 del target geografico. |
| ad_group_criterion_status | Lo stato del criterio. Questo è lo stato dell'entità del criterio del gruppo di annunci, impostato dal client. Nota: i report della UI possono incorporare informazioni aggiuntive che influiscono sull'idoneità di un criterio per l'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. La UI mostrerà ogni fascia d'età come"attivata", poiché è idonea a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimossa", 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 dell'elenco utenti. |
| ad_group_criterion_webpage_conditions | Condizioni o espressioni logiche per il targeting per pagina web. L'elenco delle condizioni di targeting per le pagine web viene valutato per il targeting con l'operatore AND. Un elenco vuoto di condizioni indica che il target sono tutte le pagine del sito web della campagna. 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 360 | Descrizione |
|---|---|
| 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 (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à del criterio del gruppo di annunci, impostato dal client. Nota: i report della UI possono incorporare informazioni aggiuntive che influiscono sull'idoneità di un criterio per l'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. La UI mostrerà ogni fascia d'età come"attivata", poiché è idonea a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimossa", 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 360 | Descrizione |
|---|---|
| campaign_criterion_age_range_type | Il tipo di fascia d'età. |
| campaign_criterion_criterion_id | L'ID del criterio. |
| campaign_criterion_gender_type | Il 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 del target 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 dell'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 quando viene valutato per il targeting. Un elenco vuoto di condizioni indica che il target sono tutte le pagine del sito web della campagna. 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 360 | Descrizione |
|---|---|
| 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 (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 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 (livello 2) 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 | Il brand del prodotto. |
| segments_product_channel | Canale del prodotto. |
| segments_product_channel_exclusivity | Esclusività del canale del prodotto. |
| segments_product_condition | Condizione 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 | Il titolo del prodotto. |
| segments_product_type_l1 | Tipo (livello 1) del prodotto. |
| segments_product_type_l2 | Tipo (livello 2) del prodotto. |
| segments_product_type_l3 | Tipo (livello 3) del prodotto. |
| segments_product_type_l4 | Tipo (livello 4) del prodotto. |
| segments_product_type_l5 | Tipo (5° livello) del prodotto. |
Nome della tabella di Search Ads 360: ProductAdvertisedConversionActionAndDeviceStats
Risorsa API Search Ads 360: shopping_performance_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments.conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | 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 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | 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 360 | Descrizione |
|---|---|
| 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 | Il tipo di gruppo di schede. |
| ad_group_criterion_status | Lo stato del criterio. Questo è lo stato dell'entità del criterio del gruppo di annunci, impostato dal client. Nota: i report della UI possono incorporare informazioni aggiuntive che influiscono sull'idoneità di un criterio per l'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. La UI mostrerà ogni fascia d'età come"attivata", poiché è idonea a visualizzare gli annunci, ma AdGroupCriterion.status mostrerà "rimossa", poiché non è stato aggiunto alcun criterio positivo. |
| ad_group_criterion_tracking_url_template | Il modello di URL per la creazione di 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 della visualizzazione dei gruppi di prodotti hanno il seguente 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 360 | Descrizione |
|---|---|
| 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e per mille impressioni (CPM) durante questo periodo. |
| metrics_cross_device_conversions | Conversioni generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 360 | Descrizione |
|---|---|
| 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 | 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 dell'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 clic sul prodotto. |
| visit_product_id | L'ID del clic sul prodotto. |
| 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 di 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 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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 generate quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in all_conversions. |
| metrics_cross_device_conversions_value | La somma del valore delle conversioni cross-device. |
| segments_conversion_action_name | Nome dell'azione di conversione. |
| segments_date | Data a cui si applicano le metriche, nel formato aaaa-MM-gg. Ad esempio: 2024-04-17 |
| segments_device | Dispositivo a cui si applicano le metriche. |
Nome tabella Search Ads 360: WebpageDeviceStats
Risorsa API Search Ads 360: webpage_view
| Nome campo Search Ads 360 | Descrizione |
|---|---|
| ad_group_criterion_age_range_type | Il 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 targetizzabili 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 | Il tipo di genere. |
| ad_group_criterion_location_geo_target_constant | Il nome della risorsa costante del target geografico. |
| ad_group_criterion_user_list_user_list | Il nome della risorsa dell'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 il target sono tutte le pagine del sito web della campagna. 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 della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, indica che la 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. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_conversions_value | Il valore delle conversioni dell'account cliente. Include solo le azioni di conversione per cui l'attributo include_in_client_account_conversions_metric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le tue strategie di offerta verranno ottimizzate per queste conversioni. |
| metrics_client_account_view_through_conversions | Il numero totale di conversioni view-through. Queste conversioni si verificano quando un cliente visualizza un annuncio illustrato o rich media e, in un secondo momento, completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
| metrics_cost_micros | La somma dei costi per clic (CPC) e 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 pubblicato (Impressioni). |
| metrics_impressions | Conteggio della frequenza con cui il tuo annuncio è stato visualizzato 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 | 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