このページでは、Google Bid Manager API のリリースノートについて説明します。
最新の API バージョン: v2
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
に置き換えました。
以下の変更により、レポートの取得を簡素化しました。
queries.reports.get
メソッドの追加。queries.reports.list
にorderBy
クエリ パラメータを追加しました。queries.run
レスポンス本文を空のオブジェクトから、生成されたReport
リソースのインスタンスに更新します。
API から返されるエラー メッセージを更新し、より具体的なエラー メッセージを返すようにしました。また、より具体的な解決策を提示するようにしました。
v2 移行ガイドの手順に沿って、v1.1 から v2 に移行します。
v2
サービス エンドポイントが変更されました。
v1 サービス エンドポイント v2 サービス エンドポイント https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
サービスの名前は次のように変更されました。
v1 サービス v2 サービス クエリ クエリ レポート queries.reports メソッドの名前は次のように変更されました。
次のメソッドが追加されました。
サービス メソッド queries.reports get 次のメソッドには新しいレスポンスの本文があります。
メソッド 新しいレスポンス本文オブジェクト queries.run 報告 次のフィールドが削除されました。
リソース フィールド queries.list
レスポンスの本文kind
queries.reports.list
レスポンスの本文kind
クエリ kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
次のフィールドのオブジェクト タイプが次のように変更されました。
リソース フィールド オブジェクトタイプ クエリ 報告 RunQueryRequest 次のメソッドのクエリ パラメータが追加されました。
メソッド クエリ パラメータ queries.list orderBy queries.reports.list orderBy queries.run 同期型 次のメソッドのクエリ パラメータが削除されました。
メソッド クエリ パラメータ queries.create アシンクロナス queries.run アシンクロナス 次の Filter 値が追加されました。
フィルタ値 FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION 次のフィルタ値は削除されました。
フィルタ値 FILTER_TRUEVIEW_IAR_REGION 次の指標値が追加されました。
指標値 METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
既知の問題
なし。
以前のリリース
廃止されたバージョンの Bid Manager API の以前のリリースについては、アーカイブされたリリースノートをご覧ください。