BigQuery Data Transfer Service のデータソースの変更ログ
このページでは、BigQuery Data Transfer Service のデータソース スキーマとスキーマ マッピングの変更について詳しく説明します。BigQuery Data Transfer Service コネクタに関して近く予定されている変更については、このページでデータソース(Google Ads API
や Display & Video 360 API
など)または特定のテーブル名や値を検索してください。
キャンペーン マネージャー 360
キャンペーン マネージャー 360 用 BigQuery Data Transfer Service コネクタは、新しい列、非推奨の列、移行された列をサポートするために定期的に更新されます。キャンペーン マネージャー 360 用 BigQuery Data Transfer Service コネクタは、キャンペーン マネージャー 360 のデータ転送ファイルからデータを取得します。
以降のセクションでは、変更の概要について説明します。変更点はリリース日ごとにまとめられています。各エントリには、キャンペーン マネージャー 360 から引き続きデータを受信するために行う必要のある変更についての情報が記載されています。
2025 年 7 月 7 日
キャンペーン マネージャー 360 は、クロスプラットフォームのデータ標準に合わせてブラウザ、オペレーティング システム、モバイル メーカーとモデル、ISP データの条件 ID を更新することを発表しました。移行後は、キャンペーン マネージャー 360 で非推奨の列への値の入力が停止し、新しい列への値の入力が開始されます。影響を受ける列は次のとおりです。
非推奨の列 | 新しい列 |
---|---|
DBM_Browser_Platform_ID
|
DV360_Browser_Platform_Reportable_ID |
DBM_ISP_ID
|
DV360_ISP_Reportable_ID |
DBM_Operating_System_ID
|
DV360_Operating_System_Reportable_ID |
DBM_Mobile_Make_ID
|
DV360_Mobile_Make_Reportable_ID |
DBM_Mobile_Model_ID
|
DV360_Mobile_Model_Reportable_ID |
Display & Video 360 API
ディスプレイ&ビデオ 360 用 BigQuery Data Transfer Service コネクタは、新しい列をサポートし、新しいディスプレイ&ビデオ 360 API バージョンによる変更に対応するため、定期的に更新されます。ディスプレイ&ビデオ 360 用 BigQuery Data Transfer Service コネクタは、サポートされている API バージョンを使用して構成データを取得します。
次のセクションでは、Display & Video 360 API の新しいバージョンに更新する際の変更点について説明します。変更点はリリース日ごとにまとめられています。各エントリには、ディスプレイ&ビデオ 360 から引き続きデータを受信するために行う必要のある変更についての情報が記載されています。
2025 年 8 月 26 日
ディスプレイ&ビデオ 360 用のコネクタは、構成データの取得に使用する Display & Video 360 API のバージョンを v3 から v4 に更新する予定です。API のアップグレードによる変更については、次のセクションをご覧ください。詳しくは、Display & Video 360 API v3 から v4 への移行ガイドをご覧ください。
このディスプレイ&ビデオ 360 用のコネクタの更新は、2025 年 8 月 26 日に開始される予定です。
非推奨のテーブル
次のテーブルは、新しいデータの受信を停止します。既存のデータは残りますが、それ以降の更新は行われません。
CampaignTargeting
InsertionOrderTargeting
列の名前が変更されたテーブル
影響を受けるテーブル | 非推奨の列 | 新しい列 |
---|---|---|
|
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups |
audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups |
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings |
audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings |
|
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.firstAndThirdPartyAudienceId |
audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.firstPartyAndPartnerAudienceId |
|
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.recency |
audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.recency |
|
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup |
audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup |
|
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings |
audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings |
|
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.firstAndThirdPartyAudienceId |
audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.firstPartyAndPartnerAudienceId |
|
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.recency |
audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.recency |
非推奨の列を含むテーブル
影響を受けるテーブル | 非推奨の列 |
---|---|
Creative
|
reviewStatus.publisherReviewStatuses |
Google Ads API
Google 広告用 BigQuery Data Transfer Service では、新しい列をサポートし、新しい Google Ads API バージョンによる変更に対応するための定期的な更新が行われます。Google 広告用 BigQuery Data Transfer Service コネクタでは、Google 広告コネクタでサポートされている API バージョンが使用されます。
次のセクションでは、Google Ads API の新しいバージョンに更新する際の変更点について説明します。変更点はリリース日ごとにまとめられています。各エントリには、Google 広告から引き続きデータを受信するために行う必要のある変更についての情報が記載されています。
Google Ads API のリリース スケジュールの詳細については、スケジュールをご覧ください。
2025 年 8 月 1 日
Google 広告の転送では、Google Ads API のバージョンを v18 から v20 に更新する予定です。API のアップグレード後、影響を受けるテーブル内の新しく転送されたデータの列値が変更されます。詳しくは、Google Ads API のアップグレードをご覧ください。
テーブル: p_ads_Ad_customer_id
影響を受ける列 | 非推奨のデータ型 |
---|---|
ad_group_type | VIDEO_OUTSTREAM |
ad_group_ad_ad_type | VIDEO_OUTSTREAM |
テーブル: p_ads_Campaign_customer_id
影響を受ける列 | 非推奨のデータ型 |
---|---|
campaign_advertising_channel_sub_type | VIDEO_OUTSTREAM |
テーブル: p_ads_DisplayVideoKeywordStats_customer_id
影響を受ける列 | 非推奨のデータ型 |
---|---|
campaign_advertising_channel_sub_type | VIDEO_OUTSTREAM |
2025 年 1 月 20 日
Google 広告の転送では、Google Ads API のバージョンを v16 から v18 に更新する予定です。API のアップグレード後、影響を受けるテーブル内の新しく転送されたデータの列値が変更されます。詳しくは、Google Ads API のアップグレードをご覧ください。
Google 広告用のこのコネクタのアップデートは 2025 年 1 月 20 日に開始され、2025 年 2 月 4 日に完了しました。
テーブル: p_ads_Campaign_customer_id
影響を受ける列 | 古い値(v16) | 新しい値(v18) |
---|---|---|
campaign_advertising_channel_type | DISCOVERY | DEMAND_GEN |
テーブル: p_ads_Ad_customer_id
影響を受ける列 | 古い値(v16) | 新しい値(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 |
テーブル: Asset
影響を受ける列 | 古い値(v16) | 新しい値(v18) |
---|---|---|
asset_type | DISCOVERY_CAROUSEL_CARD | DEMAND_GEN_CAROUSEL_CARD |
更新後もクエリが機能するように、クエリを変更して古い値と新しい値の両方を選択します。たとえば、SQL クエリに次の WHERE
条件がある場合、
WHERE asset_type='DISCOVERY_CAROUSEL_CARD'
次のステートメントに置き換えます。
WHERE asset_type='DISCOVERY_CAROUSEL_CARD' OR asset_type='DEMAND_GEN_CAROUSEL_CARD'
2024 年 6 月 24 日
Google 広告の転送では、Google Ads API のバージョンを v14 から v16 に更新する予定です。この API のアップグレードでは、影響を受けるテーブル内の新しく転送されたデータの列名が変更されます。また、一部の列は非推奨となります。詳しくは、Google Ads API のアップグレードをご覧ください。
Google 広告用のこのコネクタのアップデートは 2024 年 6 月 17 日に開始され、2024 年 6 月 23 日に完了しました。
影響を受けるテーブル | 非推奨の列 | 新しい列 |
---|---|---|
|
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 |
|
|
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 |
|
|
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_level1
や segments_product_category_level2
などの新しい列が BigQuery テーブル スキーマに追加されましたが、null
が入力されていました。Google Ads API v16 へのアップデートにより、これらの新しい列には新しい値が入力されます。非推奨の列(segments_product_bidding_category_level1
や segments_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
が入力されます。
Google Analytics API
Google アナリティクス用の BigQuery Data Transfer Service コネクタは、新しい列をサポートし、新しい Google Analytics Data API バージョンによる変更に対応するため、定期的に更新されます。Google アナリティクス用の BigQuery Data Transfer Service コネクタは、サポートされている最新の API バージョンを使用してレポートデータを取得します。
以降のセクションでは、Google Analytics Data API の新しいバージョンに更新する際の変更点について説明します。変更点はリリース日ごとにまとめられています。各エントリには、Google アナリティクスから引き続きデータを受信するために行う必要のある変更についての情報が記載されています。
2025 年 9 月 22 日
Google アナリティクス用のコネクタでは、テーブルの非推奨化とスキーマの更新を予定しており、Google Analytics Data API v1 の変更を反映します。これらの変更点は、次のセクションで説明します。
この Google アナリティクス用のコネクタの更新は、2025 年 9 月 22 日に開始される予定です。
非推奨のテーブル
次の表に、非推奨となり、スキーマが更新された新しいテーブルに置き換えられるテーブルを示します。この更新後、p_ga4_conversions
テーブルと p_ga4_inAppPurchases
テーブルは廃止されます。移行期間を確保するため、非推奨のテーブルと新しいテーブルの両方に 2025 年 9 月 22 日までデータが入力されます。移行構成の [テーブルのフィルタ] オプションを使用すると、非推奨のテーブルを除外できます。
非推奨のテーブル | 新しいテーブル |
---|---|
p_ga4_audiences
|
p_ga4_Audiences |
p_ga4_conversions
|
Deprecated |
p_ga4_demographicDetails
|
p_ga4_DemographicDetails |
p_ga4_ecommercePurchase
|
p_ga4_EcommercePurchase |
p_ga4_events
|
p_ga4_Events |
p_ga4_inAppPurchases
|
Deprecated |
p_ga4_landingPage
|
p_ga4_LandingPage |
p_ga4_pagesAndScreens
|
p_ga4_PagesAndScreens |
p_ga4_promotions
|
p_ga4_Promotions |
p_ga4_techDetails
|
p_ga4_TechDetails |
p_ga4_trafficAcquisition
|
p_ga4_TrafficAcquisition |
p_ga4_userAcquisition
|
p_ga4_UserAcquisition |
更新されたテーブル スキーマ
新しいテーブル スキーマについては、Google アナリティクス レポートの変換ページをご覧ください。
スキーマ変更の概要:
- スキーマの修正: トラフィック獲得レポート、ユーザー獲得レポート、ランディング ページ レポートのスキーマが修正されました。たとえば、トラフィック獲得レポートとユーザー獲得レポートのスキーマが以前とは入れ替わっており、ランディング ページ レポートに
landingPage
ディメンションがありませんでした。 - フィールドの名称変更と廃止: 現在の Google アナリティクスの用語に合わせて、すべてのレポートでコンバージョン フィールドが
keyEvents
に名称変更されます。そのため、「コンバージョン」レポート自体は廃止されます。 - データ型の変更: BigQuery の収益フィールドが
INTEGER
からFLOAT
に変更され、API から返された浮動小数点マイクロ値を正確に表すようになりました。 - 新しいテーブルとフィールドの命名規則: 新しいテーブルのフィールド名では、Google アナリティクス API との整合性を保つため、以前の
snake_case
(event_count
など)に代わってcamelCase
(eventCount
など)が使用されます。
YouTube Reporting API
YouTube コンテンツ所有者用および YouTube チャンネル用の BigQuery Data Transfer Service コネクタは、YouTube Reporting API で導入された新しいレポートをサポートしたり、古いレポートを非推奨にしたりするため、定期的に更新されます。
次のセクションでは、YouTube Reporting API で新しいレポートが導入された際の変更点について説明します。変更点はリリース日ごとにまとめられています。各エントリには、YouTube から引き続きデータを受信するために行う必要のある変更についての情報が記載されています。
2025 年 9 月 22 日
YouTube コンテンツ所有者用のコネクタと YouTube チャンネル用のコネクタは、YouTube のショート動画の視聴回数の変更を反映するため、新しいレポートを導入し、古いレポートを非推奨にする予定です。これらの変更点は、次のセクションで説明します。
新しいレポートの提供は 2025 年 7 月 7 日を予定しています。新しいレポートを取得するために、お客様側で必要な操作はございません。従来のレポートのサポートは、2025 年 9 月 22 日より廃止される予定です。
YouTube コンテンツ所有者用のコネクタ - 非推奨のテーブル
YouTube コンテンツ所有者用のコネクタに関し、非推奨となり、更新されたスキーマを持つ新しいテーブルに置き換えられる BigQuery テーブルを次の表に示します。移行期間を確保するため、非推奨のテーブルと新しいテーブルの両方に 2025 年 9 月 22 日までデータが入力されます。2025 年 9 月 22 日以降は、新しいテーブルのみにデータが入力されます。suffix の値は、転送の作成時に構成したテーブル サフィックスです。
非推奨のテーブル | 新しいテーブル |
---|---|
p_content_owner_asset_basic_a2_suffix
|
p_content_owner_asset_basic_a3_suffix |
p_content_owner_asset_combined_a2_suffix
|
p_content_owner_asset_combined_a3_suffix |
p_content_owner_asset_device_os_a2_suffix
|
p_content_owner_asset_device_os_a3_suffix |
p_content_owner_asset_playback_location_a2_suffix
|
p_content_owner_asset_playback_location_a3_suffix |
p_content_owner_asset_province_a2_suffix
|
p_content_owner_asset_province_a3_suffix |
p_content_owner_asset_traffic_source_a2_suffix
|
p_content_owner_asset_traffic_source_a3_suffix |
p_content_owner_basic_a3_suffix
|
p_content_owner_basic_a4_suffix |
p_content_owner_combined_a2_suffix
|
p_content_owner_combined_a3_suffix |
p_content_owner_device_os_a2_suffix
|
p_content_owner_device_os_a3_suffix |
p_content_owner_playback_location_a2_suffix
|
p_content_owner_playback_location_a3_suffix |
p_content_owner_playlist_basic_a1_suffix
|
p_content_owner_playlist_basic_a2_suffix |
p_content_owner_playlist_combined_a1_suffix
|
p_content_owner_playlist_combined_a2_suffix |
p_content_owner_playlist_device_os_a1_suffix
|
p_content_owner_playlist_device_os_a2_suffix |
p_content_owner_playlist_playback_location_a1_suffix
|
p_content_owner_playlist_playback_location_a2_suffix |
p_content_owner_playlist_province_a1_suffix
|
p_content_owner_playlist_province_a2_suffix |
p_content_owner_playlist_traffic_source_a1_suffix
|
p_content_owner_playlist_traffic_source_a2_suffix |
p_content_owner_province_a2_suffix
|
p_content_owner_province_a3_suffix |
p_content_owner_subtitles_a2_suffix
|
p_content_owner_subtitles_a3_suffix |
p_content_owner_traffic_source_a2_suffix
|
p_content_owner_traffic_source_a3_suffix |
p_content_owner_shorts_ad_revenue_summary_a1_suffix
|
p_content_owner_shorts_ad_revenue_summary_a2_suffix |
p_content_owner_shorts_country_ad_revenue_summary_a1_suffix
|
p_content_owner_shorts_country_ad_revenue_summary_a2_suffix |
p_content_owner_shorts_day_ad_revenue_summary_a1_suffix
|
p_content_owner_shorts_day_ad_revenue_summary_a2_suffix |
p_content_owner_shorts_global_ad_revenue_summary_a1_suffix
|
p_content_owner_shorts_global_ad_revenue_summary_a2_suffix |
YouTube チャンネル用のコネクタ - 非推奨のテーブル
YouTube チャンネル用のコネクタに関し、非推奨となり、更新されたスキーマを持つ新しいテーブルに置き換えられる BigQuery テーブルを次の表に示します。移行期間を確保するため、非推奨のテーブルと新しいテーブルの両方に 2025 年 9 月 22 日までデータが入力されます。2025 年 9 月 22 日以降は、新しいテーブルのみにデータが入力されます。suffix の値は、転送の作成時に構成したテーブル サフィックスです。
非推奨のテーブル | 新しいテーブル |
---|---|
p_channel_basic_a2_suffix
|
p_channel_basic_a3_suffix |
p_channel_combined_a2_suffix
|
p_channel_combined_a3_suffix |
p_channel_device_os_a2_suffix
|
p_channel_device_os_a3_suffix |
p_channel_playback_location_a2_suffix
|
p_channel_playback_location_a3_suffix |
p_channel_province_a2_suffix
|
p_channel_province_a3_suffix |
p_channel_subtitles_a2_suffix
|
p_channel_subtitles_a3_suffix |
p_channel_traffic_source_a2_suffix
|
p_channel_traffic_source_a3_suffix |
p_playlist_basic_a1_suffix
|
p_playlist_basic_a2_suffix |
p_playlist_combined_a1_suffix
|
p_playlist_combined_a2_suffix |
p_playlist_device_os_a1_suffix
|
p_playlist_device_os_a2_suffix |
p_playlist_playback_location_a1_suffix
|
p_playlist_playback_location_a2_suffix |
p_playlist_province_a1_suffix
|
p_playlist_province_a2_suffix |
p_playlist_traffic_source_a1_suffix
|
p_playlist_traffic_source_a2_suffix |
更新されたテーブル スキーマ
新しいテーブルには、engaged_views
という名前の新しい列が追加されます。この指標の詳細については、ショート動画の視聴回数の変更をご覧ください。