บันทึกประจำรุ่นที่เก็บถาวร

หน้านี้มีบันทึกประจำรุ่นของ Bid Manager API เวอร์ชันที่หยุดให้บริการ

ไปที่หน้าบันทึกประจำรุ่นหลักเพื่อดูบันทึกประจำรุ่นทั้งหมดของเวอร์ชันที่ใช้งานอยู่

15 เมษายน 2021

ฟีเจอร์ใหม่

เปิดตัว Bid Manager API เวอร์ชัน 1.1

v1.1

การเลิกใช้บริการ SDF และรายการโฆษณา

SDF และรายการโฆษณา หยุดให้บริการแล้ว

ผู้ใช้ที่ต้องการดาวน์โหลดไฟล์ Structured Data หรือจัดการรายการโฆษณาต้องใช้ Display & Video 360 API แทน

ปัญหาที่ทราบ

ไม่มี

6 สิงหาคม 2020

ฟีเจอร์ใหม่

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

ปัญหาที่ทราบ

ไม่มี

20 มีนาคม 2020

ฟีเจอร์ใหม่

v1.1

การเรียกใช้การค้นหาแบบไม่พร้อมกัน

ตอนนี้เมธอด Queries.createquery และ Queries.runquery อนุญาตให้เรียกใช้การค้นหาแบบไม่พร้อมกันแล้ว

ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์ asynchronous ใหม่ใน createquery และ runquery

ปัญหาที่ทราบ

ไม่มี

14 มกราคม 2020

ฟีเจอร์ใหม่

v1.1

เวลาเริ่มต้นของกําหนดการการค้นหา

ตอนนี้เมธอด Queries.createquery อนุญาตให้ระบุวันที่ที่กําหนดเวลาการเรียกใช้การค้นหาจะเริ่มขึ้น

ดูรายละเอียดเพิ่มเติมในช่องใหม่ schedule.startTimeMs

ปัญหาที่ทราบ

ไม่มี

8 มกราคม 2020

ฟีเจอร์ใหม่

v1.1

สลับข้อมูลรายการกลุ่มเป้าหมายที่กำหนดเป้าหมาย

ตอนนี้เมธอด Queries.createquery อนุญาตให้ระบุได้ว่าควรจำกัดข้อมูลรายการกลุ่มเป้าหมายไว้เฉพาะใบสั่งซื้อการใส่โฆษณาหรือรายการโฆษณาที่เฉพาะเจาะจงหรือไม่

ดูฟิลด์ใหม่ params.options.includeOnlyTargetedUserLists เพื่อดูรายละเอียดเพิ่มเติม

ปัญหาที่ทราบ

ไม่มี

19 พฤศจิกายน 2019

ฟีเจอร์ใหม่

v1.1

ตัวกรองแบบหนึ่งต่อหนึ่งในรายงานการแมปคอลัมน์

ตอนนี้ตัวกรองที่แมปกับคอลัมน์รายงานหลายคอลัมน์จะแมปกับคอลัมน์เดียว

ตัวอย่างเช่น ใน v1 การใช้ตัวกรอง FILTER_ADVERTISER จะทำให้ได้รายงาน ที่มีคอลัมน์ "ผู้ลงโฆษณา" นอกเหนือจาก "รหัสผู้ลงโฆษณา" ในเวอร์ชัน 1.1 ทั้งหมด คอลัมน์รายงานจะมีตัวกรองของตัวเอง เช่น ตัวกรองใหม่ FILTER_ADVERTISER_NAME จะแมปกับ "ผู้ลงโฆษณา" เพื่อให้ได้ทั้ง "ผู้ลงโฆษณา" รหัส" และ "ผู้ลงโฆษณา" ในรายงาน ทั้งตัวกรอง 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

ใน v1.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

ปัญหาที่ทราบ

ไม่มี