Search Ads 360 迁移指南

Search Ads 360 连接器（以前称为 Doubleclick Search）依赖于新版 Search Ads 360 Reporting API。旧版 Search Ads 360 Reporting API 不再受支持，因此您应迁移 BigQuery Data Transfer Service 工作流以与新版 Search Ads 360 Reporting API 兼容。 本文档介绍了从旧版 Search Ads 360 到新版 Search Ads 360 的更改，并提供了映射信息以将现有资源迁移到新版 Search Ads 360。

Search Ads 360 的新变化

新版 Search Ads 360 Reporting API 提供了多种可能会影响现有 BigQuery Data Transfer Service 工作流的更改。

账号结构

新版 Search Ads 360 Reporting API 会将账号划分为经理账号、子级经理账号和客户账号的层次结构。如需了解详情，请参阅账号层次结构差异和经理账号简介。

ID 空间

新版 Search Ads 360 中的实体的 ID 空间映射与旧版 Search Ads 360 不同。如需了解旧 ID 和新 ID 之间的映射，请参阅 ID 映射。

基于资源的报告

与使用基于报告的数据模型的旧版 Search Ads 360 API 不同，新版 Search Ads 360 API 数据模型使用基于资源的数据模型。新版 Search Ads 360 API 连接器通过查询 Search Ads 360 中的资源来创建 BigQuery 表。如需详细了解新版 Search Ads 360 API 中的资源结构，请参阅 Search Ads 360 Reporting API 结构。

迁移转移作业配置

没有自动方法可将现有 Search Ads 360 转移作业配置转换为新版 Search Ads 360 Reporting API。您必须将新版 Search Ads 360 Reporting API 作为数据源来创建新版 Search Ads 360 数据转移作业。

查看映射信息

查看以下映射信息，以将现有的 Search Ads 360 资源映射到新版 Search Ads 360 Reporting API。

报告映射

新版 Search Ads 360 报告基于资源，其结构与旧版 Search Ads 360 中的报告不同。如需查看旧报告和新报告的完整映射，请参阅 Search Ads 360 Reporting API 的报告映射。

下表列出了 BigQuery Data Transfer Service 支持的表，以及为生成这些表所查询的资源。

旧版 Search Ads 报告 新版 Search Ads 资源 新的 BigQuery 表名称
adGroup ad_group p_sa_AdGroupStats_customer_id
p_sa_AdGroup_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
ad ad_group_ad p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id
p_sa_Ad_customer_id
不适用 ad_group_asset p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
不适用 ad_group_asset_set p_sa_AdGroupAssetSet_customer_id
adGroupTarget ad_group_audience_view p_sa_AdGroupAudienceDeviceStats_customer_id
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
adGroupTarget ad_group_criterion p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id
p_sa_AdGroupCriterion_customer_id
adGroupTarget age_range_view p_sa_AgeRangeDeviceStats_customer_id
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
不适用 资产 p_sa_Asset_customer_id
bidStrategy bidding_strategy p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id
campaign campaign p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_Campaign_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id
不适用 campaign_asset p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
不适用 campaign_asset_set p_sa_CampaignAssetSet_customer_id
campaignTarget campaign_audience_view p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id
campaignTarget campaign_criterion p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id
p_sa_NegativeCampaignCriterion_customer_id
productLeadAndCrossSell cart_data_sales_view p_sa_CartDataSalesStats_customer_id
conversion conversion p_sa_Conversion_customer_id
floodlightActivity conversion_action p_sa_ConversionAction_customer_id
账号 customer p_sa_Account_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountStats_customer_id
不适用 customer_asset p_sa_CustomerAssetStats_customer_id
p_sa_CustomerConversionActionAndAssetStats_customer_id
不适用 customer_asset_set p_sa_CustomerAssetSet_customer_id
adGroupTarget gender_view p_sa_GenderDeviceStats_customer_id
p_sa_GenderConversionActionAndDeviceStats_customer_id
关键字 keyword_view p_sa_Keyword_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
adGroupTarget location_view p_sa_LocationDeviceStats_customer_id
p_sa_LocationConversionActionAndDeviceStats_customer_id
productAdvertised shopping_performance_view p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id
productGroup product_group_view p_sa_ProductGroupStats_customer_id
p_sa_ProductGroup_customer_id
visit visit p_sa_Visit_customer_id
adGroupTarget webpage_view p_sa_WebpageDeviceStats_customer_id
p_sa_WebpageConversionActionAndDeviceStats_customer_id

字段映射

BigQuery Data Transfer Service 支持部分 Search Ads 360 报告字段，如 Search Ads 360 报告转换中所列出。BigQuery 不支持列名称中使用 .，因此所有转移的报告都会将 . 替换为 _。例如，Search Ads 360 资源中的字段 ad_group_ad.ad.text_ad.description1 会作为 ad_group_ad_ad_text_ad_description1 转移到 BigQuery。

ID 映射

新版 Search Ads 360 中的实体（例如客户、广告系列和广告组）的 ID 空间与旧版 Search Ads 360 不同。如需详细了解新版 Search Ads 360 的 ID 映射表，请参阅 ID 映射表。

已迁移查询的示例

以下示例演示了 BigQuery 查询在映射到新版 Search Ads 360 Reporting API 之前和之后可能的情况。

请考虑使用以下示例查询，该查询使用旧版 Search Ads 360 Reporting API 分析过去 30 天内的 Search Ads 广告系列效果。

SELECT
  c.accountId,
  c.campaign,
  C.status,
  SUM(cs.impr) AS Impressions,
  SUM(cs.clicks) AS Clicks,
  (SUM(cs.cost) / 1000000) AS Cost
FROM
  `previous_dataset.Campaign_advertiser_id` c
LEFT JOIN
  `previous_dataset.CampaignStats_advertiser_id` cs
ON
  (c.campaignId = cs.campaignId
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

在查询映射以与新版 Search Ads 360 Reporting API 兼容后，同一查询会转换为以下内容：

SELECT
  c.customer_id,
  c.campaign_name,
  C.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `new_dataset.sa_Campaign_customer_id` c
LEFT JOIN
  `new_dataset.sa_CampaignStats_customer_id` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

如需查看与新版 Search Ads 360 兼容的查询的更多示例，请参阅示例查询。

后续步骤