リリースノート

このページでは、Google Bid Manager API のリリースノートを提供しています。

最新の API バージョン: v2

2025 年 3 月 1 日

新機能

既知の問題

ディスプレイ＆ビデオ 360 ヘルプセンターで以前お知らせしたとおり、YouTube TrueView の広告枠の在庫状況レポートと関連ディメンションが廃止されます。

v2

  • 次の列挙値は非推奨になりました。

    列挙型値
    ReportType INVENTORY_AVAILABILITY

  • 次のフィルタは非推奨になりました。

    値をフィルタ

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • 次の指標のサポートを終了しました。

    指標値

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

2024 年 11 月 20 日

新機能

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID が起動します。これにより、次の接頭辞を持つ指標の信頼度が低いデータを含めることができます。

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

このフィルタを使用する場合は、関連する指標のいずれかを含める必要があります。

リリース時に、このフィルタを含まないクエリは、高信頼度のデータのみを含む以前のデフォルトの動作に戻ります。2025 年 2 月 4 日以降、このフィルタを含まないクエリには、デフォルトで信頼度が低いデータが含まれます。

v2

  • 次のフィルタが追加されました。

    フィルタの種類使用可能な値
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: 信頼度が低いデータを含めます。（2025 年 2 月 4 日以降のデフォルト）

    1: 信頼性の高いデータのみを含めます。（2025 年 2 月 4 日より前のデフォルト）

2024 年 10 月 1 日

新機能

なし。

既知の問題

v2

匿名広告枠モデリング（AIM）レポート ディメンションのサポート終了

FILTER_ANONYMOUS_INVENTORY_MODELING ディメンションは廃止されました。

params.groupBy の廃止日値を使用して Query リソースを作成または実行すると、400 エラーが返されます。

DST（デジタル サービス税）/ ROC（規制実施事業費）と合計メディア費用の指標が YOUTUBE レポートに非対応になりました。

次の指標値は、YOUTUBE レポートで使用できなくなりました。

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

params.type が YOUTUBE で、params.metrics に関連する指標値が設定された Query リソースを作成または実行すると、400 エラーが返されます。

2024 年 5 月 1 日

新機能

なし。

既知の問題

v2

経路全体レポートと経路アトリビューション レポートのサポート終了

経路全体レポートと経路アトリビューション レポートのサポートは終了しました。これらのタイプの Query リソースと Report リソースを取得または作成すると、エラーが発生します。

次の ReportType 値は廃止されます。

  • FULL_PATH
  • PATH_ATTRIBUTION

Options オブジェクトの pathQueryOptions フィールドもサポートが終了します。

2024 年 2 月 28 日

新機能

なし。

既知の問題

v2

クロスデバイス コンバージョン指標の値のサポート終了

クロスデバイス コンバージョン指標のサポートが終了しました。次の Bid Manager API の指標値が含まれます。

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

2022 年 7 月 6 日

新機能

Bid Manager API v2 をリリースしました。

サービス エンドポイントの更新、サービスとメソッドの名前変更など、API の構造を変更しました。

不要なフィールドの削除、既存のフィールドの再編成、フィールドタイプの変更により、クエリリソースとレポートリソースを大幅に更新しました。これには、一般的な「ネストされたオブジェクト」定義ではなく、名前付きオブジェクトを使用するようにフィールドタイプを変更することも含まれます。

作成後に自動的に実行されるのではなく、queries.run メソッドを使用してアドホック クエリを実行する必要がありました。

queries.run クエリ パラメータ asynchronous を synchronous に置き換えました。

以下の変更により、レポートの取得を簡素化しました。

API から返されるエラー メッセージを更新し、より具体的なエラー メッセージを返して、より具体的な解決策を提供できるようにしました。

v2 移行ガイドの手順に沿って、v1.1 から v2 に移行します。

v2

既知の問題

なし。

以前のリリース

廃止されたバージョンの Bid Manager API の以前のリリースについては、アーカイブされたリリースノートをご覧ください。