封存的版本資訊

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

前往所有版本的主要版本資訊頁面 即時版本。

2021 年 4 月 15 日

新功能

發布 Bid Manager API 1.1 版。

v1.1

SDF 和委刊項服務即將停用

SDF 和委刊項 已終止服務

要下載結構化資料的使用者 檔案或管理委刊項必須 請改用 Display &Video 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 版中納入 FILTER_ADVERTISER 篩選器會產生報表 資料欄為「Advertiser」。在 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
分頁

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

已知問題

無。