归档版本说明

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

若想查看所有版本，请前往我们的主版本说明页面 有效版本。

2021 年 4 月 15 日

新功能

发布了 Bid Manager API v1.1。

v1.1

SDF 和订单项服务即将停用

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

希望下载结构化数据的用户 文件或管理订单项必须 请改用展示广告和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

和以下头文件：

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

已知问题

无。