Log perubahan sumber data BigQuery Data Transfer Service

Halaman ini memberikan detail tentang perubahan pada skema sumber data dan pemetaan skema BigQuery Data Transfer Service. Untuk mengetahui informasi tentang perubahan mendatang pada konektor BigQuery Data Transfer Service, Anda dapat menelusuri halaman ini untuk menemukan sumber data, seperti Google Ads API atau Facebook Ads API, atau untuk menemukan nama atau nilai tabel tertentu.

BigQuery Data Transfer Service untuk Google Ads diperbarui secara berkala untuk mendukung kolom baru dan beradaptasi dengan perubahan yang diperkenalkan oleh versi Google Ads API baru. Konektor BigQuery Data Transfer Service untuk Google Ads menggunakan versi API yang didukung di konektor Google Ads.

Bagian berikut menguraikan perubahan saat mengupdate ke versi Google Ads API yang baru. Perubahan diatur berdasarkan tanggal rilis, dan setiap entri memberikan informasi tentang perubahan yang perlu Anda lakukan agar dapat terus menerima data dari Google Ads.

Untuk informasi selengkapnya tentang jadwal rilis Google Ads API, lihat Jadwal.

20 Januari 2025

Transfer Google Ads berencana mengupdate versi Google Ads API dari v16 menjadi v18. Setelah upgrade API, nilai kolom untuk data yang baru ditransfer di tabel yang terpengaruh akan berubah. Untuk mengetahui informasi selengkapnya, lihat Upgrade Google Ads API.

  • Tanggal mulai target: 20 Januari 2025
  • Tanggal pengiriman: Tertunda

Table: p_ads_Campaign_customer_id

Kolom yang terpengaruh Nilai lama (v16) Nilai baru (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

Table: p_ads_Ad_customer_id

Kolom yang terpengaruh Nilai lama (v16) Nilai baru (v18)
ad_type

DISCOVERY_MULTI_ASSET_AD

DISCOVERY_CAROUSEL_AD

DISCOVERY_VIDEO_RESPONSIVE_AD

DEMAND_GEN_MULTI_ASSET_AD

DEMAND_GEN_CAROUSEL_AD

DEMAND_GEN_VIDEO_RESPONSIVE_AD

Table: Asset

Kolom yang terpengaruh Nilai lama (v16) Nilai baru (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

Untuk memastikan kueri berfungsi setelah update, ubah kueri untuk memilih nilai lama dan baru. Misalnya, jika Anda memiliki kondisi WHERE berikut dalam kueri SQL:

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

Ganti dengan pernyataan berikut:

WHERE
  asset_type='DISCOVERY_CAROUSEL_CARD'
  OR asset_type='DEMAND_GEN_CAROUSEL_CARD'

24 Juni 2024

Transfer Google Ads berencana untuk mengupdate versi Google Ads API dari v14 ke v16. Dalam upgrade API ini, nama kolom untuk data yang baru ditransfer di tabel yang terpengaruh akan diubah. Selain itu, beberapa kolom tidak digunakan lagi. Untuk mengetahui informasi selengkapnya, lihat Upgrade Google Ads API.

  • Target tanggal mulai: 17 Juni 2024
  • Tanggal pengiriman: 23 Juni 2024
Tabel yang terpengaruh Kolom yang tidak digunakan lagi Kolom baru
  • ShoppingProductStats
  • ShoppingProductConversionStats
segments_product_bidding_category_level1 segments_product_category_level1
segments_product_bidding_category_level2 segments_product_category_level2
segments_product_bidding_category_level3 segments_product_category_level3
segments_product_bidding_category_level4 segments_product_category_level4
segments_product_bidding_category_level5 segments_product_category_level5
  • ProductGroupStats
ad_group_criterion_listing_group_case_value_product_bidding_category_id ad_group_criterion_listing_group_case_value_product_category_category_id
ad_group_criterion_listing_group_case_value_product_bidding_category_level ad_group_criterion_listing_group_case_value_product_category_level
  • AssetGroupListingFilter
asset_group_listing_group_filter_case_value_product_bidding_category_id asset_group_listing_group_filter_case_value_product_category_category_id
asset_group_listing_group_filter_case_value_product_bidding_category_level asset_group_listing_group_filter_case_value_product_category_level
asset_group_listing_group_filter_vertical asset_group_listing_group_filter_listing_source

Dengan Google Ads API v14, kolom baru, seperti segments_product_category_level1 dan segments_product_category_level2, ditambahkan ke skema tabel BigQuery, tetapi diisi dengan null. Dengan update ke Google Ads API v16, kolom baru ini akan diisi dengan nilai baru. Kolom yang tidak digunakan lagi, seperti segments_product_bidding_category_level1 dan segments_product_bidding_category_level2, akan diisi dengan null, tetapi akan tetap ada dalam skema tabel.

Untuk setiap pasangan kolom, hanya satu kolom yang diisi dengan nilai dari Google Ads API, sedangkan kolom lainnya akan diisi dengan null. Untuk memastikan kueri yang ada terus berfungsi setelah update, perbarui kueri untuk memilih salah satu dari dua kolom. Misalnya, jika Anda memiliki pernyataan berikut dalam kueri SQL:

segments_product_bidding_category_level1

Ganti dengan pernyataan berikut yang menentukan kolom yang benar:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

Konfigurasi transfer yang dibuat setelah 24 Juni 2024 akan selalu menggunakan kolom baru. Kolom yang tidak digunakan lagi akan tetap ada dalam skema tabel, tetapi diisi dengan null.