Ghi chú phát hành đã lưu trữ

Trang này cung cấp ghi chú phát hành cho các phiên bản ngừng hoạt động của Bid Manager API.

Truy cập vào trang ghi chú phát hành chính của chúng tôi để xem tất cả bản phát hành cho phiên bản chính thức.

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

Tính năng mới

Phát hành Bid Manager API phiên bản 1.1.

Phiên bản 1.1

Ngừng cung cấp dịch vụ SDF và Mục hàng

Các dịch vụ SDF và Mục hàng hiện đã ngừng hoạt động.

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

Vấn đề đã biết

Không có.

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

Tính năng mới

v1.1

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

TYPE_PATH và TYPE_PATH_ATTRIBUTION report types hiện đã hoạt động.

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

Đã 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

phiên bản 1.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 tham số mới asynchronous trong createquery và runquery để biết thêm chi tiết.

Vấn đề đã biết

Không có.

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

Tính năng mới

phiên bản 1.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.

Hãy xem trường mới schedule.startTimeMs để biết thêm thông tin chi tiết.

Vấn đề đã biết

Không có.

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

Tính năng mới

phiên bản 1.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.

Hãy xem trường mới params.options.includeOnlyTargetedUserLists để biết thêm thông tin 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

phiên bản 1.1

Lưu ý: Tất cả thay đổi được giới thiệu trong phiên bản 1.1 chỉ ảnh hưởng đến Queries và Reports.

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

Các bộ lọc được liên kết với nhiều cột báo cáo hiện sẽ liên kết với một cộ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" ngoài "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". Để lấy cả cột "Mã nhận dạng nhà quảng cáo" và "Nhà quảng cáo" trong báo cáo, bạn phải đưa cả bộ lọc FILTER_ADVERTISER và FILTER_ADVERTISER_NAME vào các yêu cầu Queries.createquery.

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 phiên bản 1.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);

Lưu ý: Các phương thức API và truy vấn hiện có khác không chịu ảnh hưởng của thay đổi này. Hãy xem bảng sau để biết các bộ lọc mới được thêm.

Bộ lọc ban đầu	Đã thêm bộ lọc
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.listqueries và Reports.listreports.

Trong phiên bản 1.1, số lượng kết quả do các phương thức này trả về bằng với tham số mới thêm 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 sẽ trống nếu không còn kết quả nào.

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

sẽ phải được sửa đổi tương tự như sau 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ó.