BigQuery 資料移轉服務資料來源變更記錄

本頁詳細說明 BigQuery 資料移轉服務資料來源結構定義和結構定義對應的變更。如要瞭解 BigQuery 資料移轉服務連線器即將發生的異動，請在這個頁面搜尋資料來源 (例如 Google Ads API 或 Display & Video 360 API)，或是特定資料表名稱或值。

Campaign Manager 360

Campaign Manager 360 連接器的 BigQuery 資料移轉服務會定期更新，以支援新欄、已淘汰或已遷移的欄。 Campaign Manager 360 連接器的 BigQuery 資料移轉服務會從 Campaign Manager 360 資料移轉檔案擷取資料。

以下各節將說明這些異動。變更會依發布日期排序，每筆項目都會提供相關資訊，說明您需要進行哪些變更，才能繼續接收 Campaign Manager 360 的資料。

2025 年 7 月 7 日

Campaign Manager 360 公告將更新瀏覽器、作業系統、行動裝置廠商和型號，以及 ISP 資料的條件 ID，符合跨平台資料標準。遷移後，Campaign Manager 360 會停止填入已淘汰欄的值，並開始填入新欄的值。受影響的資料欄如下：

已淘汰的資料欄 新的資料欄
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

Display & Video 360 API

BigQuery 資料移轉服務的 Display & Video 360 連接器會定期更新，以支援新資料欄，並配合新版 Display & Video 360 API 導入的異動。Display & Video 360 的 BigQuery 資料移轉服務連接器會使用支援的 API 版本，擷取設定資料。

以下各節說明更新至新版 Display & Video 360 API 時的變更。變更會依發布日期排序，每筆項目都會提供您必須進行的變更資訊，以便繼續接收 Display & Video 360 的資料。

2025 年 8 月 26 日

Display & Video 360 連接器預計將用於從 v3 擷取設定資料的 Display & Video 360 API 版本更新為 v4。API 升級的變更內容列於下節。詳情請參閱 Display & Video 360 API 第 3 版至第 4 版的遷移指南。

這項 Display & Video 360 連接器更新預計於 2025 年 8 月 26 日開始。

已淘汰的資料表

下列資料表將停止接收新資料。現有資料會保留，但不會再更新。

  • CampaignTargeting
  • InsertionOrderTargeting

資料欄已重新命名的資料表

受影響資料表 已淘汰的資料欄 新的資料欄
  • 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

含有已淘汰資料欄的資料表

受影響資料表 已淘汰的資料欄
Creative reviewStatus.publisherReviewStatuses

Google Ads 適用的 BigQuery 資料移轉服務會定期更新，以支援新資料欄，並配合新版 Google Ads API 進行調整。Google Ads 適用的 BigQuery 資料移轉服務連接器會使用 Google Ads 連接器中支援的 API 版本。

下列各節說明更新至新版 Google Ads API 時的變更。變更內容會依發布日期排序，每筆項目都會提供您需要進行的變更資訊，確保能繼續接收 Google Ads 的資料。

如要進一步瞭解 Google Ads API 發布時間表，請參閱時間表。

2025 年 8 月 1 日

Google Ads 轉移 預計將 Google Ads API 版本 從 v18 更新至 v20。 升級 API 後，受影響資料表新轉移的資料欄值會有所變更。詳情請參閱「Google Ads API 升級」。

資料表：p_ads_Ad_customer_id

受影響的資料欄 已淘汰的資料類型
ad_group_type VIDEO_OUTSTREAM
ad_group_ad_ad_type VIDEO_OUTSTREAM

資料表：p_ads_Campaign_customer_id

受影響的資料欄 已淘汰的資料類型
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

資料表：p_ads_DisplayVideoKeywordStats_customer_id

受影響的資料欄 已淘汰的資料類型
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

2025 年 1 月 20 日

Google Ads 轉移預計將 Google Ads API 版本從 v16 更新至 v18。升級 API 後，受影響資料表新轉移的資料欄值會有所變更。詳情請參閱「Google Ads API 升級」。

Google Ads 連接器的這項更新於 2025 年 1 月 20 日開始，並於 2025 年 2 月 4 日完成。

資料表：p_ads_Campaign_customer_id

受影響的資料欄 舊值 (第 16 版) 新值 (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

資料表：p_ads_Ad_customer_id

受影響的資料欄 舊值 (第 16 版) 新值 (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

資料表：Asset

受影響的資料欄 舊值 (第 16 版) 新值 (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

為確保查詢在更新後能正常運作，請變更查詢，同時選取舊值和新值。舉例來說，如果 SQL 查詢中包含下列WHERE條件：

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

換成下列陳述式：

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

2024 年 6 月 24 日

Google Ads 轉移 預計將 Google Ads API 版本 從 v14 更新至 v16。 在此 API 升級中，受影響表格中新轉移資料的資料欄名稱會變更。此外，部分欄位已淘汰。詳情請參閱「Google Ads API 升級」。

Google Ads 連接器的這項更新於 2024 年 6 月 17 日開始，並於 2024 年 6 月 23 日完成。

受影響資料表 已淘汰的資料欄 新的資料欄
  • 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

在 Google Ads API 第 14 版中，BigQuery 資料表結構定義新增了 segments_product_category_level1 和 segments_product_category_level2 等資料欄，但這些資料欄會填入 null。更新至 Google Ads API 第 16 版後，這些新資料欄就會填入新值。系統會以 null 填入已淘汰的資料欄 (例如 segments_product_bidding_category_level1 和 segments_product_bidding_category_level2)，但這些資料欄仍會保留在資料表結構定義中。

在每對資料欄中，只有一個資料欄會填入 Google Ads API 的值，另一個則會填入 null。為確保現有查詢在更新後仍可正常運作，請更新查詢，選擇其中一個資料欄。舉例來說，如果您的 SQL 查詢包含下列陳述式：

segments_product_bidding_category_level1

請替換為下列陳述式，指定正確的資料欄：

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

2024 年 6 月 24 日後建立的轉移設定一律會使用新資料欄。系統仍會在資料表結構定義中保留已淘汰的資料欄，但會填入 null。

Google Analytics API

Google Analytics 適用的 BigQuery 資料移轉服務連接器會定期更新，以支援新資料欄，並配合新版 Google Analytics Data API 的異動。Google Analytics 連接器的 BigQuery 資料移轉服務會使用最新支援的 API 版本，擷取報表資料。

以下各節說明更新至新版 Google Analytics Data API 時的變更。變更會依發布日期排序，每筆項目都會提供相關資訊，說明您需要進行哪些變更，才能繼續接收 Google Analytics 資料。

2025 年 9 月 22 日

Google Analytics 連接器 預計將淘汰表格，並更新結構定義，以反映 Google Analytics Data API v1 的變更。 以下各節將列出這些異動。

Google Analytics 連接器預計於 2025 年 9 月 22 日開始更新。

已淘汰的資料表

下表列出即將淘汰的資料表，以及將取代這些資料表的新資料表 (結構定義已更新)。請注意，更新後 p_ga4_conversions 和 p_ga4_inAppPurchases 表格將停用。為方便您遷移，系統會在 2025 年 9 月 22 日前填入已淘汰和新的資料表。您可以使用移轉設定中的「資料表篩選器」選項，篩除已淘汰的資料表。

已淘汰的資料表 新增表格
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

更新後的資料表結構定義

您可以在「Google Analytics 報表轉換」頁面中找到新的資料表結構。

結構定義變更摘要如下：

  • 修正後的結構定義：修正流量開發、獲取新客和到達網頁報表的結構定義。舉例來說，流量開發和獲取新客報表的結構定義先前已對調，且到達網頁報表缺少 landingPage 維度。
  • 欄位重新命名和停用：所有報表中的「轉換」欄位都會重新命名為 keyEvents，與目前的 Google Analytics 術語保持一致。因此，「轉換」報表本身也將停用。
  • 資料類型異動：BigQuery 中的收益欄位會從 INTEGER 變更為 FLOAT，以準確呈現 API 傳回的浮點微值。
  • 新資料表和欄位命名慣例：新資料表中的欄位名稱會使用 camelCase (例如 eventCount)，與 Google Analytics API 保持一致，取代先前的 snake_case (例如 event_count)。

YouTube Reporting API

YouTube 內容擁有者和 YouTube 頻道專用的 BigQuery 資料移轉服務連接器會定期更新，以支援 YouTube Reporting API 推出的新報表，並淘汰舊報表。

以下各節將說明 YouTube Reporting API 推出新報表時的異動。變更內容會依發布日期排序，每筆項目都會提供相關資訊，說明您需要進行哪些變更，才能繼續接收 YouTube 資料。

2025 年 9 月 22 日

YouTube 內容擁有者連結器和 YouTube 頻道連結器預計會推出新報表並淘汰舊報表，以反映 YouTube Shorts 觀看次數的變更。以下各節將列出這些異動。

新報表預計於 2025 年 7 月 7 日開始提供。您無須採取任何行動，即可取得新報表。舊版報表預計於 2025 年 9 月 22 日開始淘汰。

YouTube 內容擁有者連結器 - 已淘汰的表格

對於 YouTube 內容擁有者連結器，下表列出即將淘汰的 BigQuery 資料表，以及將取代這些資料表的新資料表 (結構定義已更新)。在 2025 年 9 月 22 日前，系統會同時填入已淘汰和新的資料表，讓您有時間進行遷移。2025 年 9 月 22 日後，系統只會填入新資料表。suffix 的值是您在建立移轉時設定的資料表尾碼。

已淘汰的資料表 新增表格
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

YouTube 頻道連結器 - 已淘汰的表格

如果是 YouTube 頻道連結器，下表會列出即將淘汰的 BigQuery 資料表，以及取代這些資料表的新資料表 (結構定義已更新)。在 2025 年 9 月 22 日前，系統會同時填入已淘汰和新的資料表，讓您有時間進行遷移。2025 年 9 月 22 日後，系統只會填入新資料表。suffix 的值是您在建立移轉時設定的資料表尾碼。

已淘汰的資料表 新增表格
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

更新後的資料表結構定義

新資料表會新增名為「engaged_views」的資料欄。如要進一步瞭解這項指標，請參閱「Shorts 觀看次數計算方式異動」。