归档版本说明

本页提供了 Bid Manager API 弃用版本的版本说明。

如需查看所有正式版的版本说明，请前往我们的主要版本说明页面。

2021 年 4 月 15 日

新功能

发布了 Bid Manager API v1.1。

v1.1

SDF 和订单项服务即将停用

SDF 和订单项 服务现已弃用。

如需下载结构化数据文件或管理订单项，用户必须改用 Display & 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

报告的一对一过滤条件的列映射

映射到多个报告列的过滤器现在映射到单个 列。

例如，在 v1 中，添加过滤条件 FILTER_ADVERTISER 会生成一个报告，其中除了“广告客户 ID”之外，还包含“广告客户”列。在 v1.1 中，所有报告列都有自己的过滤条件。例如，一个新的过滤器 FILTER_ADVERTISER_NAME 映射到“广告客户”。若要同时获取“广告客户” 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();
  }
}

要在 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 方法文档。

已知问题

无。