BigQuery Data Transfer Service 数据源更改日志
本页详细介绍了 BigQuery Data Transfer Service 数据源架构和架构映射的更改。如需了解即将对 BigQuery Data Transfer Service 连接器进行的更改，您可以搜索此页面中的数据源（例如 Google Ads API 或 Display & Video 360 API），或搜索特定表名称或值。
Campaign Manager 360
适用于 Campaign Manager 360 的 BigQuery Data Transfer Service 连接器会定期更新，以支持新的列、已弃用的列或已迁移的列。适用于 Campaign Manager 360 的 BigQuery Data Transfer Service 连接器可从 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
适用于 Display & Video 360 的 BigQuery Data Transfer Service 连接器会定期更新以支持新列并适应新版 Display & Video 360 API 引入的变更。适用于 Display & Video 360 的 BigQuery Data Transfer Service 连接器使用支持的 API 版本来检索配置数据。
以下部分概述了更新到新版 Display & Video 360 API 时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 Display & Video 360 接收数据。
2025 年 8 月 26 日
Display & Video 360 连接器计划将用于检索配置数据的 Display & Video 360 API 版本从 v3 更新到 v4。以下部分列出了 API 升级带来的变化。如需了解详情，请参阅 Display & Video 360 API v3 到 v4 迁移指南。
此项针对 Display & Video 360 连接器的更新计划于 2025 年 8 月 26 日开始。
已弃用的表
以下表将停止接收新数据。现有数据将保留，但不会再填充任何更新。
CampaignTargetingInsertionOrderTargeting
包含已重命名列的表
| 受影响的表 | 弃用的列 | 新列 |
|---|---|---|
|
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 API
适用于 Google Ads 的 BigQuery Data Transfer Service 会定期更新以支持新列并适应新版 Google Ads API 引入的变更。适用于 Google Ads 的 BigQuery Data Transfer Service 连接器使用 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
| 受影响的列 | 旧值 (v16) | 新值 (v18) |
|---|---|---|
| campaign_advertising_channel_type | DISCOVERY | DEMAND_GEN |
表：p_ads_Ad_customer_id
| 受影响的列 | 旧值 (v16) | 新值 (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
| 受影响的列 | 旧值 (v16) | 新值 (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 日完成。
| 受影响的表 | 弃用的列 | 新列 |
|---|---|---|
|
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 |
|
|
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 |
|
|
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 v14 中，segments_product_category_level1 和 segments_product_category_level2 等新列已添加到 BigQuery 表架构中，但使用 null 进行填充。更新到 Google Ads API v16 后，这些新列将使用新值进行填充。弃用的列（例如 segments_product_bidding_category_level1 和 segments_product_bidding_category_level2）将使用 null 进行填充，但仍保留在表架构中。
对于每对列，只有一列会使用 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 Data Transfer Service 连接器会定期更新以支持新列并适应新版 Google Analytics Data API 引入的变更。适用于 Google Analytics 的 BigQuery Data Transfer Service 连接器使用最新支持的 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维度。 - 字段重命名和停用：为了与当前的 Google Analytics 术语保持一致，我们已将所有报告中的转化字段重命名为
keyEvents。因此，“转化”报告本身也已弃用。 - 数据类型更改：BigQuery 中的收入字段从
INTEGER更改为FLOAT，以准确表示 API 返回的浮点微值。 - 新表和字段命名惯例：新表中的字段名称使用
camelCase（例如eventCount），以便与 Google Analytics API 保持一致，取代之前的snake_case（例如event_count）。
YouTube Reporting API
适用于 YouTube 内容所有者和 YouTube 频道的 BigQuery Data Transfer Service 连接器会定期更新，以支持 YouTube Reporting API 引入的新报告并弃用旧报告。
以下部分概述了 YouTube Reporting API 推出新报告时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 YouTube 接收数据。
2025 年 9 月 22 日
YouTube 内容所有者连接器和 YouTube 频道连接器计划推出新报告并弃用旧报告，以反映 YouTube 短视频观看次数的变化。以下部分中列出了这些变更。
新报告计划于 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 观看次数统计方式变更。