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

このページでは、Bid Manager API のサポート終了バージョンのリリースノートについて説明します。

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

2021 年 4 月 15 日

新機能

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

v1.1

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

SDF サービスと広告申込情報サービスが廃止されました。

構造化データファイルをダウンロードしたり、広告申込情報を管理したりするには、ディスプレイ＆ビデオ 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 メソッドで、クエリを非同期で実行できるようになりました。

詳しくは、createquery と runquery の新しいパラメータ asynchronous をご覧ください。

既知の問題

なし。

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」列に加えて「広告主」列を含むレポートが生成されます。v1.1 では、すべてのレポート列に独自のフィルタがあります。たとえば、新しいフィルタ FILTER_ADVERTISER_NAME は「広告主」にマッピングされます。レポートに「広告主 ID」列と「広告主」列の両方を取得するには、Queries.createquery リクエストにフィルタ FILTER_ADVERTISER と FILTER_ADVERTISER_NAME の両方を指定する必要があります。

具体的には、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();
  }
}

すべてのレポートを引き続き取得するには、v1.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 メソッド ドキュメントをご覧ください

既知の問題

なし。