Search Ads 360 遷移指南

Search Ads 360 連接器 (舊稱 DoubleClick Search) 會使用新的 Search Ads 360 reporting API。舊版 Search Ads 360 報表 API 已不再支援，因此您應遷移 BigQuery 資料移轉服務工作流程，以便與新版 Search Ads 360 報表 API 相容。本文將說明新版 Search Ads 360 與舊版 Search Ads 360 的差異，並提供對應資訊，協助您將現有資源遷移至新版 Search Ads 360。

Search Ads 360 的新功能

新版 Search Ads 360 Reporting API 提供多項變更，可能會影響您現有的 BigQuery 資料移轉服務工作流程。

帳戶結構

新版 Search Ads 360 報表 API 採用階層式架構，將帳戶區分為管理員帳戶、副管理員帳戶和客戶帳戶。詳情請參閱「帳戶階層差異」和「關於管理員帳戶」。

ID 空間

新版 Search Ads 360 中的實體與舊版 Search Ads 360 的ID 空間對應方式不同。如要瞭解舊 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 資料移轉，並使用新版 Search Ads 360 報表 API 做為資料來源。

查看對應資訊

請參閱下列對應資訊，將現有的 Search Ads 360 資源對應至新版 Search Ads 360 Reporting API。

報表對應

新版 Search Ads 360 報表以資源為依據，其結構與舊版 Search Ads 360 的報表不同。如需舊報表和新報表的完整對應項目，請參閱「Search Ads 360 Reporting API 的報表對應項目」。

下表列出 BigQuery 資料移轉服務支援的資料表，以及用於產生資料表的查詢資源。

舊版 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
不適用 asset 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
轉換 轉換 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
訪問 訪問 p_sa_Visit_customer_id
adGroupTarget webpage_view p_sa_WebpageDeviceStats_customer_id
p_sa_WebpageConversionActionAndDeviceStats_customer_id

欄位對應

BigQuery 資料移轉服務支援部分 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 報表 API 前後的樣貌。

請參考以下查詢範例，瞭解如何使用舊版 Search Ads 360 報表 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 報表 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 相容的查詢示例，請參閱「查詢示例」。

後續步驟