บันทึกประจำรุ่น

หน้านี้มีบันทึกประจำรุ่นของ Google Bid Manager API

เวอร์ชัน API ล่าสุด: v2

20 พฤศจิกายน 2024

ฟีเจอร์ใหม่

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID เปิดใช้งานแล้ว ซึ่งจะช่วยให้รวมข้อมูลที่มีความเชื่อมั่นต่ำสำหรับเมตริกที่มีคำนำหน้าต่อไปนี้ได้

  • METRIC_UNIQUE_REACH_
  • METRIC_VIRTUAL_PEOPLE_DUPLICATE_
  • METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
  • METRIC_VIRTUAL_PEOPLE_OVERLAP_

ต้องรวมเมตริกที่เกี่ยวข้องอย่างน้อย 1 รายการเมื่อใช้ตัวกรองนี้

เมื่อเปิดตัว ข้อความค้นหาที่ไม่มีตัวกรองนี้จะมีค่าเริ่มต้นเป็นลักษณะการทำงานเริ่มต้นก่อนหน้านี้ซึ่งรวมเฉพาะข้อมูลที่มีความเชื่อมั่นสูงเท่านั้น ตั้งแต่วันที่ 4 กุมภาพันธ์ 2025 เป็นต้นไป การค้นหาที่ไม่มีตัวกรองนี้จะรวมข้อมูลที่มีความน่าเชื่อถือต่ำโดยค่าเริ่มต้น

v2

  • เราได้เพิ่มตัวกรองต่อไปนี้

    ประเภทตัวกรองค่าที่ใช้ได้มีดังนี้
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: รวมข้อมูลที่มีความเชื่อมั่นต่ำ (ค่าเริ่มต้นหลังจาก4 กุมภาพันธ์ 2025)

    1: ใส่เฉพาะข้อมูลที่มีความน่าเชื่อถือสูง (ค่าเริ่มต้นก่อนวันที่ 4 กุมภาพันธ์ 2025)

1 ตุลาคม 2024

ฟีเจอร์ใหม่

ไม่มี

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

v2

การหยุดให้บริการมิติข้อมูลการรายงานการสร้างรูปแบบคลังโฆษณาที่ไม่ระบุชื่อ (AIM)

มิติข้อมูล FILTER_ANONYMOUS_INVENTORY_MODELING คือพระอาทิตย์ตก

การสร้างหรือเรียกใช้ทรัพยากร Query ใช้ค่าการหยุดให้บริการใน params.groupBy จะแสดงข้อผิดพลาด 400

เมตริก DST/ROC (ค่าธรรมเนียมในการดำเนินงานตามกฎระเบียบ) และค่าใช้จ่ายสื่อทั้งหมดใช้ร่วมกับรายงาน YOUTUBE ไม่ได้

ค่าเมตริกต่อไปนี้จะใช้ในรายงาน YOUTUBE ไม่ได้อีกต่อไป

  • METRIC_TOTAL_MEDIACOST_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

การสร้างหรือเรียกใช้ทรัพยากร Query ที่มี params.type เป็น YOUTUBE และค่าเมตริกที่เกี่ยวข้องใน params.metrics จะแสดงข้อผิดพลาด 400

1 พฤษภาคม 2024

ฟีเจอร์ใหม่

ไม่มี

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

v2

การหยุดให้บริการรายงานเส้นทางการระบุแหล่งที่มาและรายงานเส้นทางแบบสมบูรณ์

รายงานเส้นทางการระบุแหล่งที่มาแบบสมบูรณ์และแบบเส้นทางจะหยุดให้บริการ การเรียกข้อมูลหรือสร้างทรัพยากร Query และ Report ประเภทเหล่านี้จะทำให้เกิดข้อผิดพลาด

ค่า ReportType ต่อไปนี้จะเลิกใช้งาน

  • FULL_PATH
  • PATH_ATTRIBUTION

ระบบจะเลิกใช้งานช่อง pathQueryOptions ของออบเจ็กต์ Options ด้วย

28 กุมภาพันธ์ 2024

ฟีเจอร์ใหม่

ไม่มี

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

v2

การหยุดให้บริการมูลค่าเมตริก Conversion จากหลายอุปกรณ์

เมตริก Conversion จากหลายอุปกรณ์จะหยุดให้บริการ เมตริก ค่าของ Bid Manager API ต่อไปนี้จะรวมอยู่ด้วย

  • METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 กรกฎาคม 2022

ฟีเจอร์ใหม่

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

ทำการเปลี่ยนแปลงโครงสร้าง API ซึ่งรวมถึงการอัปเดตปลายทางของบริการ การเปลี่ยนชื่อบริการและเมธอด

อัปเดตแหล่งข้อมูลการค้นหาและรายงานอย่างมีนัยสําคัญด้วยการนําช่องที่ไม่จําเป็นออก จัดระเบียบช่องที่มีอยู่ใหม่ และเปลี่ยนประเภทช่อง ซึ่งรวมถึงการเปลี่ยนประเภทช่องให้ใช้ออบเจ็กต์ที่มีชื่อแทนคำจำกัดความ "ออบเจ็กต์ที่ฝัง" ทั่วไป

จำเป็นต้องเรียกใช้การค้นหาเฉพาะกิจโดยใช้เมธอด queries.run แทนที่จะให้เรียกใช้โดยอัตโนมัติหลังจากสร้าง

แทนที่พารามิเตอร์การค้นหา asynchronous ของ queries.run ด้วย synchronous

การดึงข้อมูลรายงานที่ง่ายขึ้นผ่านการเปลี่ยนแปลงต่อไปนี้

  • การเพิ่มวิธีการ queries.reports.get
  • การเพิ่มพารามิเตอร์การค้นหา orderBy ลงใน queries.reports.list
  • การอัปเดตเนื้อหาคำตอบ queries.run จากออบเจ็กต์ว่างเป็นอินสแตนซ์ของทรัพยากร Report ที่สร้างขึ้น

อัปเดตข้อความแสดงข้อผิดพลาดที่ API แสดงผลให้เฉพาะเจาะจงมากขึ้นและระบุวิธีแก้ปัญหาที่ชัดเจนมากขึ้น

ทําตามวิธีการที่แสดงในคู่มือการย้ายข้อมูล v2 เพื่อย้ายข้อมูลจาก v1.1 ไปยัง v2

v2

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

ไม่มี

รุ่นก่อนหน้า

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