リリースノート

v0（2025 年 11 月 10 日）

新しい URL フィールド

このたび、

UserLocationView の新しい指標

user_location_view リソースのクエリを実行するときに、次の指標を使用できるようになりました。

リソース名の修正

次の有効なラベルリソースのリソース名パターンが、ラベルを所有する顧客 ID を確実に含むように owner_customer_id を使用するように修正されました。

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • （AdGroupCriterionEffectiveLabel にある）CriterionEffectiveLabel
  • AdGroupAdEffectiveLabel

例: CampaignEffectiveLabel のパターンが customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} から customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} に変更されました。

v0（2025 年 6 月 12 日）

このアップデートには、顧客リソースの新しいフィールドが含まれています。これらの変更をすべて活用するには、必ずクライアント ライブラリを更新してください。

新しいフィールド

このたび、

検索広告 360 アカウントの階層を移動するのに役立ちます。

v0（2025-01-21）

今回の更新では、MCC の拡大を構成するための新しいパラメータが追加されています。

MCC の拡大

bidding_strategy をクエリするときに、PARAMETERS セクションでブール値（enable_mcc_expansion）を設定できるようになりました。

このパラメータを有効にすると、customer_id をルートとするアカウント階層内のすべてのアカウントのデータがレスポンスで返されます。

v0（2024 年 11 月 8 日）

今回のアップデートには、新しいフィールドと新しいリソースが含まれています。これらの変更をすべて活用するには、クライアント ライブラリを必ず更新してください。

新しいフィールド

ad_group_ad.effective_labels と ad_group_criterion.effective_labels を追加します。

有効なラベルは、継承または直接割り当てられたラベルです。

新しいリソース

ユーザーの現在地ビュー

地域セグメントと組み合わせて使用すると、地域、大都市圏、都市に関連する指標を取得できます。

user_location_view リソースの詳細をご覧ください。

新しい effective_labels フィールドに関連して、有効なラベルと ad_group_ad（ad_group_ad_effective_label）または ad_group_criterion（ad_group_criterion_effective_label）の関連付けのメタデータを保持する 2 つの新しいリソースがあります。

v0（2024 年 10 月 7 日）

このアップデートには、新しい指標、リソース、フィールド、新しいマッピング定義が含まれています。これらの変更をすべて活用するには、クライアント ライブラリを必ず更新してください。

指標が追加されました

cross_device_conversions_by_conversion_date と cross_device_conversions_value_by_conversion_date は、ad_group_ad、ad_group_audience_view、ad_group、bidding_strategy、campaign、customer、campaign_audience_view、keyword_view、shopping_performance_view の各リソースと互換性があります。

フィールド マッピングの再定義

一部の以前のレポートで、dfaActions、dfaActionsCrossEnv、dfaRevenue、dfaRevenueCrossEnv、dfaTransactions、dfaTransactionsCrossEnv のフィールド マッピングが変更されました。

フィールド 以前 新しい定義
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

フィールド マッピングが変更された以前のレポートのリスト

新しいフィールド

campaign.effective_labels と ad_group.effective_labels を追加します。

有効なラベルは、継承または直接割り当てられたラベルです。

新しいリソース

新しい effective_labels フィールドに関連して、新しいリソースは有効なラベルとキャンペーン（campaign_effective_label）または広告グループ（ad_group_effective_label）の関連付けのメタデータを保持します。

v0（2024-08-23）

この更新では、カスタム列のメタデータに renderType フィールドが追加されます。

CustomColumnRenderType の詳細をご覧ください。

campaign_label、ad_group_label、ad_group_ad_label、ad_group_criterion_label の各リソースに新しい owner_customer_id フィールドが追加されました。

これらの新しいフィールドを利用するには、クライアント ライブラリを必ず更新してください。

v0（2024 年 8 月 1 日）

この更新には、時間単位のセグメンテーションといくつかの新しいフィールドが含まれています。

時間単位のセグメント化

クエリで時間単位のセグメンテーションを指定できるようになりました。詳しくは、segments.hour をご覧ください。

詳しくは、customer_manager_link.start_time をご覧ください。

ad_group_ad.ad.type に MULTIMEDIA_AD を追加しました

MULTIMEDIA_AD タイプで指標とセグメントを選択できるようになりました。このバージョンでは、マルチメディア固有の属性のクエリはサポートされていません。

campaign.advertising_channel_type に SOCIAL キャンペーン タイプを追加し、campaign.advertising_channel_sub_type に SOCIAL_FACEBOOK_TRACKING_ONLY サブタイプを追加しました

指標とセグメントを、キャンペーン タイプが SOCIAL でサブタイプが SOCIAL_FACEBOOK_TRACKING_ONLY の場合に選択できるようになりました。このバージョンでは、SOCIAL または SOCIAL_FACEBOOK_TRACKING_ONLY の特定の属性のクエリはサポートされていません。

average_quality_score のサポートを追加しました

詳しくは、指標をご覧ください。

v0（2024-04-18）

この更新には、アクセス可能な入札戦略リソースが含まれます

利用可能な入札戦略

お客様が所有し、共有している入札戦略のビューを表します。BiddingStrategy とは対照的に、このリソースには、このお客様が所有する戦略に加えて、お客様の管理者が所有し、このお客様と共有している戦略も含まれます。このリソースは指標を提供せず、BiddingStrategy 属性の限定されたサブセットのみを公開します。

accessible_bidding_strategy リソースの詳細をご覧ください。

v0（2024-02-12）

このアップデートには、カスタム列とカスタム Floodlight 変数へのアクセスが含まれています

カスタム列

カスタム コンバージョン列とカスタム数式列をクエリで指定できるようになりました。詳しくは、カスタム列のドキュメントをご覧ください。

カスタム Floodlight 変数

2024 年 1 月 30 日以降の統計情報について、クエリでカスタム Floodlight 変数を指定できるようになりました。詳しくは、カスタム Floodlight 変数のドキュメントをご覧ください。

v0（2023-11-09）

このアップデートには、次のリソースが含まれています。リンクにアクセスして、これらのリソースに対してクエリできるフィールドと、それらで使用できる指標とセグメンテーションを確認してください。

アセット グループ

asset_group リソースの詳細をご覧ください。

アセット グループのアセット

asset_group_asset リソースの詳細をご覧ください。

アセット グループのリスティング グループのフィルタ

asset_group_listing_group_filter リソースの詳細をご覧ください。

アセット グループのシグナル

asset_group_signal リソースの詳細をご覧ください。

アセット グループのパフォーマンスの高い組み合わせのビュー

asset_group_top_combination_view リソースの詳細をご覧ください。

カートデータ販売ビュー

cart_data_sales_view リソースの詳細をご覧ください。

コンバージョン

コンバージョン リソースの詳細をご覧ください。

ショッピングの掲載結果ビュー

shopping_performance_view リソースの詳細をご覧ください。

アクセス

訪問リソースの詳細をご覧ください。

v0（2023-08-15）

このアップデートには、次のリソースと、指標の通貨換算を設定するための新しいパラメータが含まれています。

リンクにアクセスして、これらのリソースに対してクエリできるフィールドと、それらで使用できる指標とセグメンテーションを確認してください。

広告グループのアセット

ad_group_asset リソースの詳細をご覧ください。

広告グループのアセット セット

ad_group_asset_set リソースの詳細をご覧ください。

アセット

アセット リソースの詳細をご覧ください。

アセットセット

asset_set リソースの詳細をご覧ください。

アセット セットのアセット

asset_set_asset リソースの詳細をご覧ください。

キャンペーンのアセット

campaign_asset リソースの詳細をご覧ください。

キャンペーン アセットセット

campaign_asset_set リソースの詳細をご覧ください。

顧客のアセット

customer_asset リソースの詳細をご覧ください。

顧客のアセットセット

customer_asset_set リソースの詳細をご覧ください。

通貨換算

PARAMETERS セクションの metrics_currency を使用して、指標の計算に使用する通貨を指定できます。

アクセス可能な顧客をリストアップする

ListAccessibleCustomers メソッドを使用して、アクセス可能なすべてのアカウントを一覧表示します。

v0（2023-05-15）

このアップデートには、次のリソースが含まれています。リンクにアクセスして、このリソースでクエリできるフィールドと、使用できる指標とセグメンテーションを確認してください。

広告グループ広告

ad_group_ad リソースの詳細をご覧ください。

v0（2023-04-06）

このアップデートには、次のリソースが含まれています。リンクにアクセスすると、各リソースでクエリできるフィールドと、そのリソースで使用できる指標とセグメンテーションを確認できます。

広告グループのオーディエンス ビュー

ad_group_audience_view リソースの詳細をご覧ください。

広告グループの条件ラベル

ad_group_criterion_label リソースの詳細をご覧ください。

広告グループのラベル

ad_group_label リソースの詳細をご覧ください。

年齢層ビュー

age_range_view リソースの詳細をご覧ください。

キャンペーン条件

campaign_criterion リソースの詳細をご覧ください。

キャンペーン ラベル

campaign_label リソースの詳細をご覧ください

動的検索広告の検索語句ビュー

dynamic_search_ads_search_term_view リソースの詳細をご覧ください。

ウェブページ ビュー

webpage_view リソースの詳細をご覧ください。

ラベル

ラベル リソースの詳細をご覧ください。

v0（2022-12-05）

v0 バージョンには、次のリソースとサービスが含まれています。リンクにアクセスすると、各リソースでクエリできるフィールドと、そのリソースで使用できる指標とセグメンテーションを確認できます。

広告グループ

ad_group リソースの詳細をご覧ください。

入札

bidding_strategy リソースの詳細をご覧ください。

キャンペーン

キャンペーン リソースの詳細をご覧ください。

コンバージョン アクション

conversion_action リソースの詳細をご覧ください。

お客様

お客様リソースの詳細をご覧ください。

キーワード

keyword_view リソースの詳細をご覧ください。

商品グループ

product_group_view リソースの詳細をご覧ください。

SearchAds360FieldService

  • SearchAds360FieldService は、すべてのクエリ可能フィールドのカタログを提供します。これらのフィールドのメタデータには、説明、タイプ、他のフィールドとの互換性などが含まれます。詳細

SearchAds360Service

  • SearchAds360Service は、1 回のクエリで複数のリソースを取得するためのものです。クエリ可能なリソースには次のものがあります。

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • 次のリソースのSearchAds360Service を使用して、インプレッション数やクリック数などの指標を取得することもできます。

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service を使用すると、日付フィールドなどのフィールドでセグメント化できます。詳細