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

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

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

15 เมษายน 2021

ฟีเจอร์ใหม่

Bid Manager API เวอร์ชัน 1.1 ที่เปิดตัวแล้ว

v1.1

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

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

ผู้ใช้ที่ต้องการดาวน์โหลดข้อมูลที่มีโครงสร้าง ไฟล์หรือจัดการรายการโฆษณาจะต้อง ให้ใช้การแสดงผลและ API ของ Video 360

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

ไม่มี

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 เพื่อดูรายละเอียดเพิ่มเติม

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

ไม่มี