Chúng tôi hiện đang di chuyển một số loại báo cáo từ báo cáo ngoại tuyến sang báo cáo tức thì. Sau khi người dùng được di chuyển, các phản hồi trong queries.list sẽ bao gồm các báo cáo tức thì hiện có. Hãy xem bài đăng trên blog của chúng tôi để biết thêm thông tin.

Trang này được dịch bởi Cloud Translation API.

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

SDF và Line 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_PATH và TYPE_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 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

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 createquery và runquery để 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 thá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_ADVERTISER và FILTER_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.listqueries và Reports.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;
  }
}

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

Vấn đề đã biết

Không có.