Search Ads 360 遷移指南

Search Ads 360 連接器 (舊稱 DoubleClick Search) 仰賴新的 Search Ads 360 Reporting API。舊版 Search Ads 360 Reporting API 已停止支援,因此請遷移 BigQuery 資料移轉服務工作流程,確保與新版 Search Ads 360 Reporting API 相容。本文說明新版 Search Ads 360 與舊版 Search Ads 360 的差異,並提供對應資訊,協助您將現有資源遷移至新版 Search Ads 360。

Search Ads 360 新功能

新版 Search Ads 360 Reporting API 有多項異動,可能會影響現有的 BigQuery 資料移轉服務工作流程。

帳戶結構

新版 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 資料移轉作業,並以新版 Search Ads 360 Reporting API 做為資料來源。

查看對應資訊

請查看下列對應資訊,將現有的 Search Ads 360 資源對應至新版 Search Ads 360 Reporting API。

報表對應

新版 Search Ads 360 報表是以資源為依據,結構與舊版 Search Ads 360 報表不同。如需新舊報表的完整對應關係,請參閱「Search Ads 360 Reporting API 的報表對應關係」。

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

舊版搜尋廣告報表 新版搜尋廣告資源 新 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
帳戶 客戶 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 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 欄位會轉移至 BigQuery,並顯示為 ad_group_ad_ad_text_ad_description1。

ID 對應

新版 Search Ads 360 中的實體 (例如客戶、廣告活動和廣告群組) 具有與舊版 Search Ads 360 不同的ID 空間。如要進一步瞭解新版 Search Ads 360 的 ID 對應表,請參閱「ID 對應表」。

遷移查詢範例

以下範例說明 BigQuery 查詢在對應至新版 Search Ads 360 Reporting API 前後的可能樣貌。

請參考以下範例查詢,瞭解如何使用舊版 Search Ads 360 Reporting API 分析過去 30 天的搜尋廣告活動成效。

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 相容的查詢範例,請參閱「查詢範例」。

後續步驟