Bản ghi chú phát hành được lưu trữ

Trang này cung cấp ghi chú phát hành cho các phiên bản đã ngừng cung cấp của API Trình quản lý giá thầu.

Chuyển đến trang ghi chú phát hành chính để xem tất cả bản phát hành để phiên bản trực tiếp.

Ngày 15 tháng 4 năm 2021

Tính năng mới

Phát hành API Trình quản lý giá thầu phiên bản 1.1.

v1.1

Dịch vụ mục hàng và SDF ngừng hoạt động

SDFLine Item (Mục hàng) các dịch vụ hiện đã ngừng hoạt động.

Người dùng muốn tải Dữ liệu có cấu trúc xuống Tệp hoặc mục hàng quản lý phải thay vào đó, hãy sử dụng Display & Video 360 API.

Vấn đề đã biết

Không có.

Ngày 6 tháng 8 năm 2020

Tính năng mới

v1.1

Đường dẫn và Báo cáo phân bổ đường dẫn

TYPE_PATHTYPE_PATH_ATTRIBUTION report types hiện đang phát trực tiếp.

Điều này bao gồm việc thêm trường mới params.options.pathQueryOptions (chứa các trường pathFilterschannelGrouping) đến queryreport.

Đã thêm Filters mới:

  • FILTER_CHANNEL_GROUPING
  • FILTER_EVENT_TYPE
  • FILTER_PATH_EVENT_INDEX
  • FILTER_PATH_PATTERN_ID

Đã thêm Metrics mới:

  • 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

Vấn đề đã biết

Không có.

Ngày 20 tháng 3 năm 2020

Tính năng mới

v1.1

Chạy truy vấn không đồng bộ

Queries.createquery và Phương thức Queries.runquery ngay bây giờ cho phép chạy truy vấn không đồng bộ.

Xem thông số mới asynchronous trong createqueryrunquery để biết thêm thông tin.

Vấn đề đã biết

Không có.

Ngày 14 tháng 1 năm 2020

Tính năng mới

v1.1

Thời gian bắt đầu lịch biểu truy vấn

Phương thức Queries.createquery ngay bây giờ cho phép chỉ định ngày bắt đầu lịch chạy truy vấn.

Xem trường mới schedule.startTimeMs cho chi tiết hơn.

Vấn đề đã biết

Không có.

Ngày 8 tháng 1 năm 2020

Tính năng mới

v1.1

Bật/tắt dữ liệu danh sách đối tượng được nhắm mục tiêu

Phương thức Queries.createquery ngay bây giờ cho phép chỉ định xem có nên giới hạn dữ liệu danh sách đối tượng ở một số đơn đặt hàng quảng cáo hoặc mục hàng.

Xem trường mới params.options.includeOnlyTargetedUserLists để biết thêm chi tiết.

Vấn đề đã biết

Không có.

Ngày 19 tháng 11 năm 2019

Tính năng mới

v1.1

Bộ lọc một với một để báo cáo việc liên kết cột

Những bộ lọc được liên kết đến nhiều cột báo cáo nay liên kết thành một cột báo cáo duy nhất .

Ví dụ: trong phiên bản 1, việc thêm bộ lọc FILTER_ADVERTISER sẽ tạo ra một báo cáo với cột "Nhà quảng cáo" bên cạnh "Mã nhà quảng cáo". Trong phiên bản 1.1, tất cả các cột báo cáo đều có bộ lọc riêng. Ví dụ: bộ lọc mới FILTER_ADVERTISER_NAME liên kết tới "Nhà quảng cáo". Để nhận cả hai tiêu chí "Nhà quảng cáo mã nhận dạng" và "Nhà quảng cáo" cột trong báo cáo, cả bộ lọc FILTER_ADVERTISERFILTER_ADVERTISER_NAME sẽ phải được đưa vào Queries.createquery yêu cầu.

Cụ thể hơn là yêu cầu createquery:

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

tạo tệp báo cáo có các tiêu đề sau trong phiên bản 1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

và các tiêu đề sau trong v1.1:

Advertiser,Impressions

Mã v1 sau đây dùng để lấy các cột báo cáo:

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);

sẽ phải được sửa đổi tương tự như sau trong v1.1 (lưu ý bộ lọc thứ tự):

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);
Bộ lọc ban đầu Bộ lọc đã thêm
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
Phân trang

v1.1 thêm tính năng phân trang vào các phương thức Queries.listqueriesReports.listreports.

Trong phiên bản 1.1, số lượng kết quả được bằng một thông số mới được thêm vào pageSize (mặc định là 100 nếu không được chỉ định). Trong câu trả lời có chứa một Trường nextPageToken có thể được sử dụng để truy xuất tập hợp kết quả tiếp theo. Trường này trống nếu kết quả đã hết pin.

Mã v1 sau đây để truy xuất tất cả báo cáo thuộc về một truy vấn cụ thể:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

phải được sửa đổi tương tự như trong phiên bản 1.1, để tiếp tục truy xuất tất cả báo cáo:

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;
  }
}

Xem Queries.listqueries và Phương thức Reports.listreports để biết thêm chi tiết.

Vấn đề đã biết

Không có.