Google 広告の更新ガイド

BigQuery Data Transfer Service for Google Ads は、新しい列をサポートし、また新しい Google Ads API バージョンによる変更に対応するため、定期的に更新されます。BigQuery Data Transfer Service for Google Ads コネクタは、Google 広告コネクタのサポート対象の API バージョンを使用します。このドキュメントでは、Google Ads API の新しいバージョンに更新する際の変更点について説明します。

Google Ads API のリリース スケジュールの詳細については、スケジュールをご覧ください。

BigQuery Data Transfer Service for Google Ads コネクタは、Google Ads API v14 に代わる Google Ads API v16 のリリースに対応するために更新されます。この更新には以下の変更が含まれます。

影響を受けるテーブル 非推奨の列 新しい列
  • 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

Google Ads API v14 では、segments_product_category_level1segments_product_category_level2 などの新しい列が BigQuery テーブル スキーマに追加されましたが、null が入力されていました。Google Ads API v16 へのアップデートにより、これらの新しい列には新しい値が入力されます。非推奨の列(segments_product_bidding_category_level1segments_product_bidding_category_level2 など)には null が入力されますが、テーブル スキーマには引き続き残ります。

列のペアごとに、Google Ads API からの値は一方の列にのみ入力され、もう一方の列には null が入力されます。更新後も既存のクエリが機能するようにするには、クエリを更新して 2 つの列のいずれかを選択します。たとえば、SQL クエリに次のステートメントがあるとします。

segments_product_bidding_category_level1

正しい列を指定する次のステートメントに置き換えます。

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

2024 年 6 月 24 日以降に作成された転送構成では、常に新しい列が使用されます。非推奨の列はテーブル スキーマに残りますが、null が入力されます。