リリースノート

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-07）

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

追加された指標

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 日）

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

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 月 9 日）

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

アセット グループ

asset_group リソースの詳細を確認します。

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

asset_group_asset リソースの詳細を参照してください。

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

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

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

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

アセット グループの上位の組み合わせビュー

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

カートデータの販売ビュー

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

コンバージョン

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

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

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

アクセス

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

v0（2023-08-15）

今回の更新には、次のリソースと、指標の通貨換算を構成するための新しいパラメータが含まれています。

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

広告グループのアセット

ad_group_asset リソースの詳細を参照してください。

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

ad_group_asset_set リソースの詳細を参照してください。

アセット

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

アセットセット

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 リソースの詳細をご覧ください。

ラベル

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

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 を使用すると、日付フィールドなどのフィールドでセグメンテーションできます。詳細