Panduan migrasi Search Ads 360

Konektor Search Ads 360 (sebelumnya dikenal sebagai Doubleclick Search) mengandalkan Search Ads 360 reporting API versi baru. Search Ads 360 reporting API lama tidak lagi didukung, sehingga Anda harus memigrasikan alur kerja BigQuery Data Transfer Service agar kompatibel dengan Search Ads 360 Reporting API versi baru. Dokumen ini menunjukkan perubahan Search Ads 360 versi baru dari Search Ads 360 versi lama dan memberikan informasi pemetaan untuk memigrasikan resource yang ada ke Search Ads 360 versi baru.

Yang baru di Search Ads 360

Search Ads 360 Reporting API versi baru menawarkan beberapa perubahan yang dapat memengaruhi alur kerja BigQuery Data Transfer Service yang ada.

Struktur akun

Search Ads 360 Reporting API versi baru mengatur akun ke dalam hierarki akun pengelola, akun sub-pengelola, dan akun klien. Untuk mengetahui informasi selengkapnya, lihat Perbedaan hierarki akun dan Tentang akun pengelola.

Ruang ID

Entity di Search Ads 360 versi baru memiliki pemetaan ruang ID yang berbeda dari versi Search Ads 360 sebelumnya. Untuk informasi tentang pemetaan antara ID sebelumnya dan ID baru, lihat pemetaan ID.

Pelaporan berbasis resource

Model data Search Ads 360 API baru menggunakan model data berbasis resource, berbeda dengan Search Ads 360 API lama yang menggunakan model data berbasis laporan. Konektor Search Ads 360 API versi baru membuat tabel BigQuery dengan membuat kueri resource di Search Ads 360. Untuk informasi selengkapnya tentang struktur resource di Search Ads 360 API versi baru, lihat struktur Search Ads 360 Reporting API.

Memigrasikan konfigurasi transfer

Tidak ada metode otomatis untuk mengonversi konfigurasi transfer Search Ads 360 yang ada ke Search Ads 360 Reporting API versi baru. Anda harus membuat transfer data Search Ads 360 versi baru dengan Search Ads 360 Reporting API versi baru sebagai sumber data.

Meninjau informasi pemetaan

Tinjau informasi pemetaan berikut untuk memetakan resource Search Ads 360 yang ada ke Search Ads 360 Reporting API versi baru.

Pemetaan laporan

Laporan Search Ads 360 versi baru didasarkan pada resource dan memiliki struktur yang berbeda dengan laporan dari Search Ads 360 versi lama. Untuk pemetaan lengkap laporan lama dan baru, lihat Pemetaan laporan untuk Search Ads 360 Reporting API.

Tabel berikut mencantumkan tabel yang didukung oleh BigQuery Data Transfer Service beserta resource yang dikueri untuk menghasilkan tabel.

Laporan Iklan Penelusuran Lama Resource Iklan Penelusuran Baru Nama Tabel BigQuery Baru
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
T/A ad_group_asset p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id
T/A 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
T/A 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
T/A campaign_asset p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id
T/A 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
T/A customer_asset p_sa_CustomerAssetStats_customer_id
p_sa_CustomerConversionActionAndAssetStats_customer_id
T/A 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
kunjungan kunjungan p_sa_Visit_customer_id
adGroupTarget webpage_view p_sa_WebpageDeviceStats_customer_id
p_sa_WebpageConversionActionAndDeviceStats_customer_id

Pemetaan Kolom

BigQuery Data Transfer Service mendukung subset kolom laporan Search Ads 360 seperti yang tercantum dalam transformasi laporan Search Ads 360. BigQuery tidak mendukung . dalam nama kolom, sehingga semua laporan yang ditransfer akan mengganti . dengan _. Misalnya, kolom ad_group_ad.ad.text_ad.description1 di resource Search Ads 360 ditransfer ke BigQuery sebagai ad_group_ad_ad_text_ad_description1.

Pemetaan ID

Entity di Search Ads 360 versi baru, seperti pelanggan, kampanye, dan grup iklan, memiliki ruang ID yang berbeda dari Search Ads 360 versi sebelumnya. Untuk mengetahui informasi selengkapnya tentang tabel pemetaan ID untuk Search Ads 360 versi baru, lihat tabel pemetaan ID.

Contoh kueri yang dimigrasikan

Contoh berikut menunjukkan tampilan kueri BigQuery sebelum dan sesudah dipetakan ke Search Ads 360 Reporting API versi baru.

Pertimbangkan contoh kueri berikut yang menganalisis performa kampanye Iklan Penelusuran dari 30 hari terakhir menggunakan Search Ads 360 Reporting API versi lama.

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

Saat dipetakan agar kompatibel dengan Search Ads 360 reporting API versi baru, kueri yang sama dikonversi menjadi berikut ini:

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

Untuk mengetahui contoh lain terkait kueri yang kompatibel dengan Search Ads 360 versi baru, lihat Contoh kueri.

Langkah berikutnya