リリースノートのアーカイブ

このページには、Bid Manager API の廃止バージョンのリリースノートを掲載しています。

メインのリリースノートのページに移動すると、 公開されています。

2021 年 4 月 15 日

新機能

Bid Manager API v1.1 をリリースしました。

v1.1

SDF と広告申込情報のサービスの終了

SDF と広告申込情報 サービスを廃止します

構造化データをダウンロードしようとするユーザー ファイルまたは広告申込情報を管理するには、 代わりにディスプレイ &ビデオ 360 のVideo 360 API。

既知の問題

なし。

2020 年 8 月 6 日

新機能

v1.1

経路と経路アトリビューション レポート

TYPE_PATH と TYPE_PATH_ATTRIBUTION（report types）が公開されました。

これには、新しいフィールド params.options.pathQueryOptions の追加が含まれます。 （フィールド pathFilters と channelGrouping を含む）から query、 report のリソース。

新たに追加された Filters:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

新たに追加された Metrics:

  • METRIC_ACTIVITY_REVENUE
  • METRIC_CONVERTING_PATHS
  • METRIC_EXPOSURE_CONVERSION_RATE
  • METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
  • METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
  • METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
  • METRIC_PATH_CONVERSION_RATE
  • METRIC_PROVISIONAL_IMPRESSIONS
  • METRIC_TOTAL_EXPOSURES
  • METRIC_TOTAL_PATHS

既知の問題

なし。

2020 年 3 月 20 日

新機能

v1.1

非同期クエリの実行

Queries.createquery、 Queries.runquery メソッドを使用中 非同期でクエリを実行できます

新しいパラメータ asynchronous を表示: createquery および runquery。

既知の問題

なし。

2020 年 1 月 14 日

新機能

v1.1

クエリ スケジュールの開始時間

Queries.createquery メソッドを今すぐ作成 クエリ実行スケジュールを開始する日付を指定できます。

新しいフィールドを表示 schedule.startTimeMs: 詳しく見ていきます

既知の問題

なし。

2020 年 1 月 8 日

新機能

v1.1

ターゲット オーディエンス リストのデータを切り替える

Queries.createquery メソッドを今すぐ作成 オーディエンス リストのデータを特定の 追加することをおすすめします

新しいフィールドを表示 params.options.includeOnlyTargetedUserLists をご覧ください。

既知の問題

なし。

2019 年 11 月 19 日

新機能

v1.1

レポートの列マッピングに対する 1 対 1 のフィルタ

複数のレポート列にマッピングされているフィルタが、単一の列にマッピングされるようになりました できます。

たとえば、v1 で FILTER_ADVERTISER フィルタを含めると、レポートが生成されます。 列が「広告主」[広告主 ID]のほか「広告主 ID」も表示されますv1.1 では、 レポートの列には独自のフィルタがあります。たとえば 新しいフィルタを追加して FILTER_ADVERTISER_NAME は「Advertiser」にマッピングされます。「新規顧客のみ」と ID」[広告主]を選択しますレポートで FILTER_ADVERTISER と それぞれの FILTER_ADVERTISER_NAME を Queries.createquery できます。

より具体的には、createquery リクエストは次のようになります。

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

は、v1 で次のヘッダーを持つレポート ファイルを生成します。

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

v1.1 では、次のヘッダーが使用されます。

Advertiser,Impressions

次の v1 コードを使用して、レポートの列を取得します。

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);

v1.1 では、次のように変更する必要があります（メモ フィルタ 順序付け）があります。

List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
    new com.google.api.services.doubleclickbidmanager.model.Parameters()
        .setGroupBys(groupBys)
        .setMetrics(metrics);
元のフィルタ 追加されたフィルタ
FILTER_ADVERTISER FILTER_ADVERTISER_NAME
FILTER_ADVERTISER_INTEGRATION_CODE
FILTER_ADVERTISER_INTEGRATION_STATUS
FILTER_AD_POSITION FILTER_AD_POSITION_NAME
FILTER_CARRIER FILTER_CARRIER_NAME
FILTER_CHANNEL_ID FILTER_CHANNEL_NAME
FILTER_CITY FILTER_CITY_NAME
FILTER_COMPANION_CREATIVE_ID FILTER_COMPANION_CREATIVE_NAME
FILTER_DMA FILTER_DMA_NAME
FILTER_INSERTION_ORDER FILTER_INSERTION_ORDER_NAME
FILTER_PARTNER FILTER_PARTNER_NAME
FILTER_PARTNER_STATUS
FILTER_REGION FILTER_REGION_NAME
FILTER_TRUEVIEW_DMA FILTER_TRUEVIEW_DMA_NAME
FILTER_TRUEVIEW_IAR_REGION FILTER_TRUEVIEW_IAR_REGION_NAME
FILTER_USER_LIST_FIRST_PARTY FILTER_USER_LIST_FIRST_PARTY_NAME
FILTER_USER_LIST_THIRD_PARTY FILTER_USER_LIST_THIRD_PARTY_NAME
ページネーション

v1.1 ではメソッドにページ分割を追加 Queries.listqueries、 Reports.listreports。

v1.1 では、これらのオブジェクトによって メソッドが新しく追加されたパラメータと等しい pageSize（デフォルトは 指定しない場合は 100）。レスポンスには、新しく追加された nextPageToken フィールドが 次の結果セットを取得できます。結果が生成される場合、このフィールドは空白になります。 すべて揃っています

次の v1 コードは、特定のクエリに属するすべてのレポートを取得します。

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

バージョン 1.1 では、次のように変更する必要があります。 すべてのレポートの取得を続行します。

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    List<Report> reports = new ArrayList<>(reportListResponse.getReports());
    while (reportListResponse.getNextPageToken() != null
        && reportListResponse.getNextPageToken().length() > 0) {
      // Get next set, or page, of results.
      reportListResponse =
          service
              .reports()
              .listreports(queryId)
              .setPageToken(reportListResponse.getNextPageToken())
              .execute();
      reports.addAll(reportListResponse.getReports());
    }

    return reports;
  }
}

Queries.listqueries と Reports.listreports メソッド ドキュメントをご覧ください

既知の問題

なし。