封存的版本資訊

本頁提供 Bid Manager API 停用版本的版本資訊。

如要查看所有發布至實際版本的版本，請前往主要版本資訊頁面。

2021 年 4 月 15 日

新功能

發布 Bid Manager API 1.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 方法現在允許以非同步方式執行查詢。

詳情請參閱 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

一對一篩選器與報表欄對應

對應至多個報表資料欄的篩選器現已對應至單一資料欄 欄。

舉例來說，在 v1 中，加入篩選器 FILTER_ADVERTISER 會產生包含「廣告主」和「廣告主 ID」欄的報表。在 1.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 方法中新增分頁功能。

在 1.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 方法 說明文件。

已知問題

無。