Log delle modifiche dell'origine dati di BigQuery Data Transfer Service

Questa pagina fornisce dettagli sulle modifiche agli schemi delle origini dati e ai mapping degli schemi di BigQuery Data Transfer Service. Per informazioni sulle modifiche imminenti ai connettori di BigQuery Data Transfer Service, puoi cercare in questa pagina origini dati, ad esempio Google Ads API o Display & Video 360 API, oppure nomi o valori di tabelle specifici.

Campaign Manager 360

Il connettore BigQuery Data Transfer Service per Campaign Manager 360 viene aggiornato periodicamente per supportare colonne nuove, ritirate o migrate. Il connettore BigQuery Data Transfer Service per Campaign Manager 360 recupera i dati dai file di trasferimento dei dati di Campaign Manager 360.

Le sezioni seguenti descrivono le modifiche. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche che devi apportare per continuare a ricevere dati da Campaign Manager 360.

7 luglio 2025

Campaign Manager 360 ha pubblicato un annuncio per aggiornare gli ID criterio per browser, sistema operativo, marca e modello di dispositivo mobile e dati dell'ISP in modo da allinearsi agli standard di dati multipiattaforma. Dopo la migrazione, Campaign Manager 360 smetterà di compilare i valori per le colonne ritirate e inizierà a compilare le nuove colonne. Le colonne interessate sono le seguenti:

Colonne deprecate Nuove colonne
DBM_Browser_Platform_ID DV360_Browser_Platform_Reportable_ID
DBM_ISP_ID DV360_ISP_Reportable_ID
DBM_Operating_System_ID DV360_Operating_System_Reportable_ID
DBM_Mobile_Make_ID DV360_Mobile_Make_Reportable_ID
DBM_Mobile_Model_ID DV360_Mobile_Model_Reportable_ID

API Display & Video 360

Il connettore BigQuery Data Transfer Service per Display & Video 360 viene aggiornato periodicamente per supportare nuove colonne e adattarsi alle modifiche introdotte dalle nuove versioni dell'API Display & Video 360. Il connettore BigQuery Data Transfer Service per Display & Video 360 utilizza la versione dell'API supportata per recuperare i dati di configurazione.

Le sezioni seguenti descrivono le modifiche apportate durante l'aggiornamento a una nuova versione dell'API Display & Video 360. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche che devi apportare per continuare a ricevere dati da Display & Video 360.

26 agosto 2025

Il connettore Display & Video 360 prevede di aggiornare la versione dell'API Display & Video 360 utilizzata per recuperare i dati di configurazione dalla v3 alla v4. Le modifiche apportate dall'upgrade dell'API sono elencate nella sezione seguente. Per saperne di più, consulta la Guida alla migrazione dall'API Display & Video 360 dalla versione 3 alla 4.

L'inizio di questo aggiornamento per il connettore Display & Video 360 è previsto per il 26 agosto 2025.

Tabelle obsolete

Le seguenti tabelle non riceveranno più nuovi dati. I dati esistenti rimarranno, ma non verranno inseriti ulteriori aggiornamenti.

  • CampaignTargeting
  • InsertionOrderTargeting

Tabelle con colonne rinominate

Tabelle interessate Colonne deprecate Nuove colonne
  • AdGroupTargeting
  • LineItemTargeting
 audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.firstAndThirdPartyAudienceId audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.recency audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.recency
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.firstAndThirdPartyAudienceId audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.recency audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.recency

Tabelle con colonne ritirate

Tabelle interessate Colonne deprecate
Creative reviewStatus.publisherReviewStatuses

BigQuery Data Transfer Service per Google Ads viene aggiornato periodicamente per supportare nuove colonne e adattarsi alle modifiche introdotte dalle nuove versioni dell'API Google Ads. Il connettore BigQuery Data Transfer Service per Google Ads utilizza la versione API supportata nel connettore Google Ads.

Le sezioni seguenti descrivono le modifiche apportate durante l'aggiornamento a una nuova versione dell'API Google Ads. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche che devi apportare per continuare a ricevere dati da Google Ads.

Per ulteriori informazioni sul programma di rilascio dell'API Google Ads, consulta la tabella di marcia.

1° agosto 2025

I trasferimenti Google Ads prevedono di aggiornare la versione dell'API Google Ads dalla v18 alla v20. Dopo l'upgrade dell'API, i valori delle colonne per i dati appena trasferiti nelle tabelle interessate cambieranno. Per maggiori informazioni, consulta la pagina Upgrade dell'API Google Ads.

Tabella: p_ads_Ad_customer_id

Colonne interessate Tipo di dati deprecato
ad_group_type VIDEO_OUTSTREAM
ad_group_ad_ad_type VIDEO_OUTSTREAM

Tabella: p_ads_Campaign_customer_id

Colonne interessate Tipo di dati deprecato
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

Tabella: p_ads_DisplayVideoKeywordStats_customer_id

Colonne interessate Tipo di dati deprecato
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

20 gennaio 2025

Trasferimenti Google Ads prevede di aggiornare la versione dell'API Google Ads da v16 a v18. Dopo l'upgrade dell'API, i valori delle colonne per i dati appena trasferiti nelle tabelle interessate cambieranno. Per maggiori informazioni, consulta la pagina Upgrade dell'API Google Ads.

Questo aggiornamento del connettore Google Ads è iniziato il 20 gennaio 2025 ed è stato completato il 4 febbraio 2025.

Tabella: p_ads_Campaign_customer_id

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

Tabella: p_ads_Ad_customer_id

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
ad_type

DISCOVERY_MULTI_ASSET_AD

DISCOVERY_CAROUSEL_AD

DISCOVERY_VIDEO_RESPONSIVE_AD

DEMAND_GEN_MULTI_ASSET_AD

DEMAND_GEN_CAROUSEL_AD

DEMAND_GEN_VIDEO_RESPONSIVE_AD

Tabella: Asset

Colonne interessate Valore precedente (v16) Nuovo valore (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

Per assicurarti che le query funzionino dopo l'aggiornamento, modificale in modo da selezionare sia i valori precedenti che quelli nuovi. Ad esempio, se nella query SQL hai la seguente condizione WHERE:

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

Sostituisci con la seguente dichiarazione:

WHERE
  asset_type='DISCOVERY_CAROUSEL_CARD'
  OR asset_type='DEMAND_GEN_CAROUSEL_CARD'

24 giugno 2024

Trasferimenti Google Ads prevede di aggiornare la versione dell'API Google Ads dalla v14 alla v16. In questo upgrade dell'API, i nomi delle colonne per i dati appena trasferiti nelle tabelle interessate vengono modificati. Inoltre, alcune colonne sono obsolete. Per maggiori informazioni, consulta la pagina Upgrade dell'API Google Ads.

Questo aggiornamento del connettore Google Ads è iniziato il 17 giugno 2024 ed è stato completato il 23 giugno 2024.

Tabelle interessate Colonne deprecate Nuove colonne
  • ShoppingProductStats
  • ShoppingProductConversionStats
 segments_product_bidding_category_level1 segments_product_category_level1
segments_product_bidding_category_level2 segments_product_category_level2
segments_product_bidding_category_level3 segments_product_category_level3
segments_product_bidding_category_level4 segments_product_category_level4
segments_product_bidding_category_level5 segments_product_category_level5
  • ProductGroupStats
 ad_group_criterion_listing_group_case_value_product_bidding_category_id ad_group_criterion_listing_group_case_value_product_category_category_id
ad_group_criterion_listing_group_case_value_product_bidding_category_level ad_group_criterion_listing_group_case_value_product_category_level
  • AssetGroupListingFilter
 asset_group_listing_group_filter_case_value_product_bidding_category_id asset_group_listing_group_filter_case_value_product_category_category_id
asset_group_listing_group_filter_case_value_product_bidding_category_level asset_group_listing_group_filter_case_value_product_category_level
asset_group_listing_group_filter_vertical asset_group_listing_group_filter_listing_source

Con l'API Google Ads v14, sono state aggiunte nuove colonne, come segments_product_category_level1 e segments_product_category_level2, allo schema della tabella BigQuery, ma sono state compilate con null. Con l'aggiornamento all'API Google Ads v16, queste nuove colonne verranno compilate con nuovi valori. Le colonne deprecate, come segments_product_bidding_category_level1 e segments_product_bidding_category_level2, verranno compilate con null, ma rimarranno comunque nello schema della tabella.

Per ogni coppia di colonne, solo una colonna viene compilata con i valori dell'API Google Ads, mentre l'altra viene compilata con null. Per assicurarti che le query esistenti continuino a funzionare dopo l'aggiornamento, aggiornale in modo che scelgano una delle due colonne. Ad esempio, se nella query SQL è presente la seguente istruzione:

segments_product_bidding_category_level1

Sostituisci con la seguente istruzione che specifica la colonna corretta:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

Le configurazioni di trasferimento create dopo il 24 giugno 2024 utilizzeranno sempre le nuove colonne. Le colonne ritirate rimarranno comunque nello schema della tabella, ma saranno compilate con null.

API Google Analytics

Il connettore BigQuery Data Transfer Service per Google Analytics viene aggiornato periodicamente per supportare nuove colonne e adattarsi alle modifiche introdotte dalle nuove versioni dell'API Data di Google Analytics. Il connettore BigQuery Data Transfer Service per Google Analytics utilizza l'ultima versione dell'API supportata per recuperare i dati dei report.

Le seguenti sezioni descrivono le modifiche apportate durante l'aggiornamento a una nuova versione dell'API di dati di Google Analytics. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche che devi apportare per continuare a ricevere dati da Google Analytics.

22 settembre 2025

Il connettore Google Analytics prevede di ritirare le tabelle e aggiornare gli schemi in modo da riflettere le modifiche apportate all'API di dati di Google Analytics v1. Queste modifiche sono elencate nelle sezioni seguenti.

L'implementazione di questo aggiornamento per il connettore Google Analytics è prevista a partire dal 22 settembre 2025.

Tabelle ritirate

La tabella seguente mostra le tabelle che verranno ritirate e sostituite con nuove tabelle con schemi aggiornati. Tieni presente che le tabelle p_ga4_conversions e p_ga4_inAppPurchases verranno ritirate dopo questo aggiornamento. Le tabelle ritirate e quelle nuove verranno compilate fino al 22 settembre 2025 per consentire la migrazione. Puoi filtrare le tabelle ritirate utilizzando l'opzione Filtro tabelle nella configurazione del trasferimento.

Tabella ritirata Nuova tabella
p_ga4_audiences p_ga4_Audiences
p_ga4_conversions Deprecated
p_ga4_demographicDetails p_ga4_DemographicDetails
p_ga4_ecommercePurchase p_ga4_EcommercePurchase
p_ga4_events p_ga4_Events
p_ga4_inAppPurchases Deprecated
p_ga4_landingPage p_ga4_LandingPage
p_ga4_pagesAndScreens p_ga4_PagesAndScreens
p_ga4_promotions p_ga4_Promotions
p_ga4_techDetails p_ga4_TechDetails
p_ga4_trafficAcquisition p_ga4_TrafficAcquisition
p_ga4_userAcquisition p_ga4_UserAcquisition

Schemi delle tabelle aggiornati

I nuovi schemi delle tabelle sono disponibili nella pagina Trasformazione dei report di Google Analytics.

Riepilogo delle modifiche dello schema:

  • Schemi corretti:gli schemi per i report Acquisizione traffico, Acquisizione utenti e Pagine di destinazione sono corretti. Ad esempio, gli schemi dei report Acquisizione traffico e Acquisizione utenti sono stati scambiati in precedenza e nel report Pagina di destinazione mancava la dimensione landingPage.
  • Ridenominazione e ritiro dei campi:il campo conversioni viene rinominato in keyEvents in tutti i report per essere in linea con la terminologia attuale di Google Analytics. Di conseguenza, il report "Conversioni" stesso non è più disponibile.
  • Modifiche al tipo di dati:i campi relativi alle entrate passano da INTEGER a FLOAT in BigQuery per rappresentare con precisione i microvalori in virgola mobile restituiti dall'API.
  • Nuova convenzione di denominazione di tabelle e campi:i nomi dei campi nelle nuove tabelle utilizzano camelCase (ad esempio, eventCount) per coerenza con l'API Google Analytics, sostituendo il precedente snake_case (ad esempio, event_count).

API di reporting di YouTube

I connettori BigQuery Data Transfer Service per proprietari dei contenuti YouTube e per canali YouTube vengono aggiornati periodicamente per supportare i nuovi report introdotti dall'API YouTube Reporting e ritirare i report precedenti.

Le sezioni seguenti descrivono le modifiche quando vengono introdotti nuovi report dall'API YouTube Reporting. Le modifiche sono organizzate in base alla data di rilascio e ogni voce fornisce informazioni sulle modifiche che devi apportare per continuare a ricevere dati da YouTube.

22 settembre 2025

Il connettore Proprietario dei contenuti YouTube e il connettore Canale YouTube prevedono di introdurre nuovi report e ritirare quelli precedenti per riflettere la modifica del conteggio delle visualizzazioni degli Short di YouTube. Queste modifiche sono elencate nelle sezioni seguenti.

I nuovi report dovrebbero iniziare il 7 luglio 2025. Non è necessario alcun intervento da parte tua per ottenere i nuovi report. Il ritiro dei report precedenti è previsto a partire dal 22 settembre 2025.

Connettore proprietario dei contenuti di YouTube - tabelle ritirate

Per il connettore Proprietario dei contenuti YouTube, la tabella seguente mostra le tabelle BigQuery che verranno ritirate e sostituite con nuove tabelle con schemi aggiornati. Le tabelle obsolete e nuove verranno completate fino al 22 settembre 2025 per consentire la migrazione. Dopo il 22 settembre 2025, verranno compilate solo le nuove tabelle. Il valore di suffix è il suffisso della tabella che hai configurato durante la creazione del trasferimento.

Tabella ritirata Nuova tabella
p_content_owner_asset_basic_a2_suffix p_content_owner_asset_basic_a3_suffix
p_content_owner_asset_combined_a2_suffix p_content_owner_asset_combined_a3_suffix
p_content_owner_asset_device_os_a2_suffix p_content_owner_asset_device_os_a3_suffix
p_content_owner_asset_playback_location_a2_suffix p_content_owner_asset_playback_location_a3_suffix
p_content_owner_asset_province_a2_suffix p_content_owner_asset_province_a3_suffix
p_content_owner_asset_traffic_source_a2_suffix p_content_owner_asset_traffic_source_a3_suffix
p_content_owner_basic_a3_suffix p_content_owner_basic_a4_suffix
p_content_owner_combined_a2_suffix p_content_owner_combined_a3_suffix
p_content_owner_device_os_a2_suffix p_content_owner_device_os_a3_suffix
p_content_owner_playback_location_a2_suffix p_content_owner_playback_location_a3_suffix
p_content_owner_playlist_basic_a1_suffix p_content_owner_playlist_basic_a2_suffix
p_content_owner_playlist_combined_a1_suffix p_content_owner_playlist_combined_a2_suffix
p_content_owner_playlist_device_os_a1_suffix p_content_owner_playlist_device_os_a2_suffix
p_content_owner_playlist_playback_location_a1_suffix p_content_owner_playlist_playback_location_a2_suffix
p_content_owner_playlist_province_a1_suffix p_content_owner_playlist_province_a2_suffix
p_content_owner_playlist_traffic_source_a1_suffix p_content_owner_playlist_traffic_source_a2_suffix
p_content_owner_province_a2_suffix p_content_owner_province_a3_suffix
p_content_owner_subtitles_a2_suffix p_content_owner_subtitles_a3_suffix
p_content_owner_traffic_source_a2_suffix p_content_owner_traffic_source_a3_suffix
p_content_owner_shorts_ad_revenue_summary_a1_suffix p_content_owner_shorts_ad_revenue_summary_a2_suffix
p_content_owner_shorts_country_ad_revenue_summary_a1_suffix p_content_owner_shorts_country_ad_revenue_summary_a2_suffix
p_content_owner_shorts_day_ad_revenue_summary_a1_suffix p_content_owner_shorts_day_ad_revenue_summary_a2_suffix
p_content_owner_shorts_global_ad_revenue_summary_a1_suffix p_content_owner_shorts_global_ad_revenue_summary_a2_suffix

Connettore del canale YouTube - tabelle obsolete

Per il connettore del canale YouTube, la tabella seguente mostra le tabelle BigQuery che verranno ritirate e sostituite con nuove tabelle con schemi aggiornati. Le tabelle obsolete e nuove verranno completate fino al 22 settembre 2025 per consentire la migrazione. Dopo il 22 settembre 2025, verranno compilate solo le nuove tabelle. Il valore di suffix è il suffisso della tabella che hai configurato durante la creazione del trasferimento.

Tabella ritirata Nuova tabella
p_channel_basic_a2_suffix p_channel_basic_a3_suffix
p_channel_combined_a2_suffix p_channel_combined_a3_suffix
p_channel_device_os_a2_suffix p_channel_device_os_a3_suffix
p_channel_playback_location_a2_suffix p_channel_playback_location_a3_suffix
p_channel_province_a2_suffix p_channel_province_a3_suffix
p_channel_subtitles_a2_suffix p_channel_subtitles_a3_suffix
p_channel_traffic_source_a2_suffix p_channel_traffic_source_a3_suffix
p_playlist_basic_a1_suffix p_playlist_basic_a2_suffix
p_playlist_combined_a1_suffix p_playlist_combined_a2_suffix
p_playlist_device_os_a1_suffix p_playlist_device_os_a2_suffix
p_playlist_playback_location_a1_suffix p_playlist_playback_location_a2_suffix
p_playlist_province_a1_suffix p_playlist_province_a2_suffix
p_playlist_traffic_source_a1_suffix p_playlist_traffic_source_a2_suffix

Schemi delle tabelle aggiornati

Le nuove tabelle avranno una nuova colonna denominata engaged_views. Per ulteriori informazioni su questa metrica, consulta Modifiche al conteggio delle visualizzazioni degli Short.