検索広告 360 移行ガイド

検索広告 360 コネクタ（旧称 Doubleclick Search）は、新しい Search Ads 360 Reporting API に依存しています。以前の Search Ads 360 Reporting API のサポートは終了しているため、新しい Search Ads 360 Reporting API に対応するように BigQuery Data Transfer Service のワークフローを移行する必要があります。このドキュメントでは、検索広告 360 リニューアル版の変更点と、既存のリソースを検索広告 360 リニューアル版に移行するためのマッピング情報について説明します。

検索広告 360 の新機能

新しい Search Ads 360 Reporting API には、既存の BigQuery Data Transfer Service ワークフローに影響する可能性のある変更がいくつか含まれています。

アカウントの構成

新しい Search Ads 360 Reporting API は、クライアント センター（MCC）アカウント、サブマネージャー アカウント、クライアント アカウントの階層でアカウントを編成します。詳しくは、アカウント階層の違いと MCC アカウントについてをご覧ください。

ID スペース

検索広告 360 リニューアル版のエンティティでは、以前のバージョンの検索広告 360 とは ID スペースのマッピングが異なります。以前の ID と新しい ID のマッピングについては、ID のマッピングをご覧ください。

リソースベースのレポート

レポートベースのデータモデルを使用する以前の Search Ads 360 API とは異なり、新しい Search Ads 360 API データモデルはリソースベースのデータモデルを使用します。新しい Search Ads 360 API コネクタは、検索広告 360 のリソースに対してクエリを実行し、BigQuery テーブルを作成します。新しい Search Ads 360 API のリソース構造について詳しくは、Search Ads 360 Reporting API の構造をご覧ください。

転送構成を移行

既存の検索広告 360 の転送構成を自動的に Search Ads 360 Reporting API に変換する方法はありません。新しい Search Ads 360 Reporting API をデータソースとして、検索広告 360 リニューアル版のデータ転送を作成する必要があります。

マッピング情報を確認

次のマッピング情報を確認して、既存の検索広告 360 リソースを新しい Search Ads 360 Reporting API にマッピングします。

レポートのマッピング

検索広告 360 リニューアル版のレポートはリソースに基づいており、検索広告 360 従来版のレポートとは構造が異なります。新旧のレポートの完全なマッピングについては、Search Ads 360 Reporting API のレポートのマッピングをご覧ください。

次の表に、BigQuery Data Transfer Service でサポートされているテーブルと、テーブルを生成するためにクエリされるリソースを示します。

以前の検索広告レポート	新しい検索広告リソース	新しい 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
conversion	conversion	p_sa_Conversion_customer_id
floodlightActivity	conversion_action	p_sa_ConversionAction_customer_id
account	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	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 は、検索広告 360 レポートの変換に記載されている検索広告 360 レポート フィールドのサブセットをサポートしています。BigQuery は列名での . をサポートしていないため、転送されたすべてのレポートで . が _ に置き換えられます。たとえば、検索広告 360 リソースに含まれるフィールド ad_group_ad.ad.text_ad.description1 は、ad_group_ad_ad_text_ad_description1 として BigQuery に転送されます。

ID マッピング

検索広告 360 リニューアル版のエンティティ（顧客、キャンペーン、広告グループなど）の ID 空間は、検索広告 360 従来版では異なります。検索広告 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

検索広告 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

検索広告 360 リニューアル版と互換性のあるクエリの例については、クエリの例をご覧ください。

次のステップ

• 検索広告 360 から定期的に読み込むジョブのスケジュールと管理方法については、検索広告 360 の転送をご覧ください。
• 検索広告 360 レポートの変換方法については、検索広告 360 レポートの変換をご覧ください。