การเลิกใช้งานประกาศ

หน้านี้แสดงวันที่เลิกใช้งานและหยุดให้บริการ API เวอร์ชัน และแต่ละฟีเจอร์ใน ดิสเพลย์และ API ของวิดีโอ 360

และจะประกาศวันที่เลิกใช้งานและวันที่หยุดให้บริการ API ในวันที่ บล็อกนักพัฒนาซอฟต์แวร์ Google Ads

การเลิกใช้งานเวอร์ชัน

ดิสเพลย์และ มีการเผยแพร่ เลิกใช้งาน และหยุดให้บริการเวอร์ชัน Video 360 API เป็นประจำ เหล่านี้ มีขั้นตอนดังนี้

  • รุ่น: เวอร์ชันจะออกจากสถานะอัลฟ่าหรือเบต้าและได้รับการพิจารณา เสถียร อย่างไรก็ตาม อาจยังมีการออกฟีเจอร์เพิ่มขึ้นสำหรับเวอร์ชันนี้
  • การเลิกใช้งาน: เวอร์ชันนี้กำลังจะเลิกใช้และยุติการสนับสนุน (หยุดให้บริการ) วันที่ประกาศ ผู้ใช้ต้องย้ายข้อมูลไปยังเวอร์ชันใหม่ก่อนที่จะหยุดให้บริการ วันที่ ส่วนการเพิ่มฟีเจอร์จะไม่มีให้บริการในเวอร์ชันนี้อีกต่อไป
  • พระอาทิตย์ตก: ระบบไม่รองรับเวอร์ชันนี้อีกต่อไป ส่งคำขอในเวอร์ชันแล้ว แสดงข้อผิดพลาด

ตารางด้านล่างแสดงรายการ Display หลักและ Display หลักที่มีอยู่ทั้งหมด เวอร์ชัน API ของ Video 360 และรุ่น รวมถึงวันที่เลิกใช้งานและหยุดให้บริการ หากมีการประกาศ

เวอร์ชัน API วันที่เผยแพร่ วันที่เลิกใช้งาน วันที่พระอาทิตย์ตก คำแนะนำในการย้ายข้อมูล
v3 31 ตุลาคม 2023
v2 6 ธันวาคม 2022 15 กุมภาพันธ์ 2024 3 กันยายน 2024 ย้ายข้อมูลจากเวอร์ชัน 2 ไปยัง v3
v1 9 มีนาคม 2020 13 มีนาคม 2023 14 กันยายน 2023 ย้ายข้อมูลจาก v1 ไปยัง v2

การเลิกใช้งานฟีเจอร์

ติดตามบล็อกนักพัฒนาซอฟต์แวร์ Google Ads เพื่อดูประกาศเกี่ยวกับ การเลิกใช้งานฟีเจอร์ที่สำคัญที่จะเกิดขึ้น

ตารางด้านล่างนี้แสดงการเลิกใช้งานฟีเจอร์ทั้งหมดที่ประกาศไว้ โดยในเบื้องต้น วันที่มีผลและรายละเอียดของการเลิกใช้งาน พร้อมการดำเนินการที่แนะนำและ ลิงก์ไปยังเอกสารที่เกี่ยวข้อง

ฟีเจอร์ วันที่มีผลเริ่มต้น คำอธิบาย
การขยายการกำหนดเป้าหมาย 25 มีนาคม 2023 การแทนที่ฟีเจอร์การขยายการกําหนดเป้าหมายด้วยการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพ ได้ทยอยเปิดตัวไปตั้งแต่วันที่ 25 มีนาคม 2023 ถึงต้นเดือนพฤษภาคม 2023 การเปลี่ยนแปลงที่เกี่ยวข้องกับดิสเพลย์และ เราได้ประกาศการใช้งาน Video 360 API และไฟล์ข้อมูลที่มีโครงสร้าง รวมถึงการดำเนินการที่แนะนำในบล็อกโพสต์
ทริกเกอร์ด้วยตนเอง 17 พฤษภาคม 2023

ลำดับเวลา:

  • 17 พฤษภาคม 2023: รายการโฆษณาที่ใช้ทริกเกอร์ด้วยตนเองจะหยุดแสดงใน Display และ วิดีโอ 360 หากคุณเปิดใช้งานทริกเกอร์ด้วยตนเองที่ลิงก์กับรายการโฆษณาที่ใช้งานอยู่หลังจากวันที่ดังกล่าว รายการโฆษณาจะไม่แสดงโฆษณา
  • 1 สิงหาคม 2023: บริการ advertisers.manualTriggers ใน DV360 API v1 และ v2, ค่า enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER ใน DV360 API v1 และช่อง LineItemFlight.triggerId ใน DV360 API v1 จะหยุดให้บริการ หลังจากวันที่ดังกล่าว คำขอที่ส่งไปยังบริการเหล่านี้หรือช่องเหล่านี้จะแสดงข้อผิดพลาด

การดำเนินการที่แนะนำ:

  • หยุดใช้ทริกเกอร์ด้วยตนเองเพื่อเริ่มและหยุดการแสดงรายการโฆษณาทันที
  • หยุดส่งคำขอไปยังบริการ advertisers.manualTriggers
  • อัปเดตช่อง flight.flightDateType และ flight.triggerId สำหรับรายการโฆษณาทั้งหมดโดยใช้ทริกเกอร์ด้วยตนเอง
ประเภทแอปที่ติดตั้งและอุปกรณ์เคลื่อนที่ใหม่ GoogleAudience 20 พฤษภาคม 2023

ลำดับเวลา:

  • 20 พฤษภาคม 2023: คุณจะไม่สามารถกำหนด GoogleAudience ทรัพยากรที่มี GoogleAudienceType เป็น GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS หรือ GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES ให้กับการกำหนดกลุ่มเป้าหมายของรายการโฆษณาหรือใบสั่งซื้อการใส่โฆษณาได้อีก คำขอที่กำหนดกลุ่มเป้าหมายเหล่านี้ไปยังการกำหนดกลุ่มเป้าหมายของรายการโฆษณาจะแสดงข้อผิดพลาด ซึ่งรวมถึงคำขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault หากรายการโฆษณาที่สร้างจะรวมกลุ่มเป้าหมายที่เลิกใช้งานแล้วในการกำหนดเป้าหมายตามกลุ่มเป้าหมาย
  • 8 มิถุนายน 2023: เราจะนํากลุ่มเป้าหมายที่ได้รับผลกระทบออกจากการกำหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาทั้งหมด รวมถึงกลุ่มเป้าหมายแบบรวมทั้งหมด หากรายการโฆษณาแสดงโฆษณาไม่ได้เมื่อนำกลุ่มเป้าหมายเหล่านี้ออกแล้ว ระบบจะหยุดชั่วคราว เมื่อถึงวันดังกล่าว กลุ่มเป้าหมายเหล่านี้จะดึงข้อมูลโดยใช้บริการ googleAudiences ไม่ได้อีกต่อไป

งานที่แนะนำ

  • เราขอแนะนำให้คุณหยุดใช้กลุ่มเป้าหมายที่ได้รับผลกระทบทันทีเมื่ออัปเดตการกำหนดเป้าหมายรายการโฆษณาในอนาคต
  • นำกลุ่มเป้าหมายที่ได้รับผลกระทบทั้งหมดออกจากการกำหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาที่มีอยู่ อ่านเกี่ยวกับการอัปเดตการกำหนดกลุ่มเป้าหมายในคำแนะนำเกี่ยวกับกลุ่มเป้าหมาย
ประเภทตามกิจกรรมและความถี่สูงสุด FirstAndThirdPartyAudience ประเภท 20 พฤษภาคม 2023

ลำดับเวลา:

  • 20 พฤษภาคม 2023: คุณจะไม่สามารถกำหนด FirstAndThirdPartyAudience ทรัพยากรที่มี AudienceType เป็น ACTIVITY_BASED หรือ FREQUENCY_CAP ให้กับการกำหนดกลุ่มเป้าหมายของรายการโฆษณาหรือใบสั่งซื้อการใส่โฆษณาได้อีก คำขอที่กำหนดกลุ่มเป้าหมายเหล่านี้ไปยังการกำหนดกลุ่มเป้าหมายของรายการโฆษณาจะแสดงข้อผิดพลาด ซึ่งรวมถึงคำขอ advertisers.lineItems.duplicate และ advertisers.lineItems.generateDefault หากรายการโฆษณาที่สร้างจะรวมกลุ่มเป้าหมายที่เลิกใช้งานแล้วในการกำหนดเป้าหมายตามกลุ่มเป้าหมาย
  • 8 มิถุนายน 2023: เราจะนํากลุ่มเป้าหมายที่ได้รับผลกระทบออกจากการกำหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาทั้งหมด รวมถึงกลุ่มเป้าหมายแบบรวมทั้งหมด หากรายการโฆษณาแสดงโฆษณาไม่ได้เมื่อนำกลุ่มเป้าหมายเหล่านี้ออกแล้ว ระบบจะหยุดชั่วคราว เมื่อถึงวันดังกล่าว กลุ่มเป้าหมายเหล่านี้จะดึงข้อมูลโดยใช้บริการ firstAndThirdPartyAudiences ไม่ได้อีกต่อไป

งานที่แนะนำ

  • เราขอแนะนำให้คุณหยุดใช้กลุ่มเป้าหมายที่ได้รับผลกระทบทันทีเมื่ออัปเดตการกำหนดเป้าหมายรายการโฆษณาในอนาคต
  • นำกลุ่มเป้าหมายที่ได้รับผลกระทบทั้งหมดออกจากการกำหนดเป้าหมายรายการโฆษณาและใบสั่งซื้อการใส่โฆษณาที่มีอยู่ อ่านเกี่ยวกับการอัปเดตการกำหนดกลุ่มเป้าหมายในคำแนะนำเกี่ยวกับกลุ่มเป้าหมาย
ขีดจำกัดโควต้า API ที่มีอยู่ 30 พฤษภาคม 2023

ในวันที่ 30 พฤษภาคม 2023 เราจะแทนที่ขีดจำกัดการใช้งานที่มีอยู่ด้วยโครงสร้างโควต้าแบบผสมซึ่งมีการดำเนินการต่อไปนี้

  1. กำจัดคำขอต่อวันต่อโควต้าโปรเจ็กต์
  2. ส่งคำขอต่อนาทีต่อผู้ลงโฆษณาต่อโควต้าโปรเจ็กต์สำหรับวิธีการที่เข้าเกณฑ์

ขีดจำกัดใหม่เหล่านี้จะช่วยเพิ่มความยืดหยุ่นในการใช้ API และเปิดใช้คำขอหลายรายการพร้อมกันจากผู้ลงโฆษณาต่างๆ รายละเอียดของการเปลี่ยนแปลงนี้อยู่ในเอกสารประกอบเกี่ยวกับขีดจำกัดโควต้าที่มีอยู่ของเรา

การใช้งานโอเปอเรเตอร์ OR ระหว่างข้อจำกัดของช่องที่ต่างกันในตัวกรอง LIST รายการ

21 มิถุนายน 2023

ในวันที่ 21 มิถุนายน 2023 คำขอพารามิเตอร์ filter ของ LIST จะไม่อนุญาตให้ใช้โอเปอเรเตอร์เชิงตรรกะ OR ระหว่างข้อจำกัดของช่องต่างๆ อีกต่อไป

ตัวอย่างเช่น ทรัพยากรที่ระบุด้วยสตริงตัวกรอง lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" จะต้องได้รับการดึงข้อมูลโดยใช้คำขอ LIST 2 รายการที่มีสตริงตัวกรองต่อไปนี้แทน

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อจำกัดของโอเปอเรเตอร์เชิงตรรกะได้ที่คำแนะนำวิธีใช้การกรองคำขอ LIST

ตรวจสอบพารามิเตอร์การค้นหา filter ของการเรียก LIST ที่มีอยู่ทั้งหมด และยืนยันว่ามีการใช้โอเปอเรเตอร์แบบตรรกะ OR อย่างถูกต้องก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก

ความสามารถในการกรองหรือเรียงลำดับคำขอรายการตามช่อง budget.budget_segments.date_range.end_date และ flight.dateRange.endDate

อัปเดตวันที่มีผลเริ่มต้นแล้ว

21 มิถุนายน 2023

ในวันที่ 21 มิถุนายน 2023 ระบบจะไม่ยอมรับช่อง budget.budget_segments.date_range.end_date และ flight.dateRange.endDate ในพารามิเตอร์การค้นหา advertisers.insertionOrders.list และ advertisers.lineItems.list filter และ orderBy ตามลำดับอีกต่อไป หลังจากวันที่ดังกล่าว คำขอที่ใช้ช่องเหล่านี้ในพารามิเตอร์การค้นหาของ filter และ orderBy จะแสดงข้อผิดพลาด

นําตัวกรองและตรรกะคําสั่งซื้อที่ใช้ 2 ช่องนี้ออกก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก

ความสามารถในการกรองคำขอ advertisers.lineItems.list ตามช่องเพิ่มเติม 4 ช่อง 21 มิถุนายน 2023

ในวันที่ 21 มิถุนายน 2023 advertisers.lineItems.list จะไม่รองรับการกรองตามช่องต่อไปนี้อีกต่อไป

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

นำตรรกะของตัวกรองทั้งหมดที่ใช้ 4 ช่องนี้ออกก่อนวันที่ 21 มิถุนายน 2023 เพื่อไม่ให้บริการหยุดชะงัก

การซื้อที่อิงตามผลลัพธ์ 1 สิงหาคม 2023

ในวันที่ 1 สิงหาคม 2023 ระบบจะเก็บใบสั่งซื้อการใส่โฆษณาที่ใช้การซื้อที่อิงตามผลลัพธ์ ซึ่งกําหนดโดยค่าในช่อง billableOutcome เป็น BILLABLE_OUTCOME_PAY_PER_CLICK หรือ BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION และระบบจะเก็บรายการโฆษณาย่อยไว้

การเปลี่ยนแปลงนี้จะส่งผลต่อคำขอต่อไปนี้:

  • การพยายามใช้ advertisers.insertionOrders.create เพื่อสร้างใบสั่งซื้อการใส่โฆษณาโดยใช้การซื้อที่อิงตามผลลัพธ์จะแสดงข้อผิดพลาด 400 รายการ
  • การพยายามใช้ advertisers.lineItems.create, advertisers.lineItems.duplicate หรือ advertisers.lineItems.generateDefault เพื่อสร้างรายการโฆษณาภายใต้ใบสั่งซื้อการใส่โฆษณาโดยใช้การซื้อที่อิงตามผลลัพธ์จะแสดงข้อผิดพลาด 400
  • เนื่องจากทรัพยากรที่เก็บถาวรไม่ได้รวมอยู่ในคำขอ LIST โดยค่าเริ่มต้น ระบบจะไม่แสดงผลทรัพยากรที่ได้รับผลกระทบโดยเมธอด advertisers.insertionOrders.list และ advertisers.lineItems.list อีกต่อไปโดยค่าเริ่มต้น
ช่อง publisherReviewStatuses ในทรัพยากรครีเอทีฟโฆษณา 26 มิถุนายน 2024

ตั้งแต่วันที่ 26 มิถุนายน 2024 เป็นต้นไป ช่อง publisherReviewStatuses จะหยุดให้บริการและจะว่างเปล่าเมื่อเรียกข้อมูลทรัพยากร Creative

การกำหนดเป้าหมายเนื้อหาบางส่วนสำหรับ YouTube และ รายการโฆษณาของพาร์ทเนอร์ 30 กันยายน 2024

ในวันที่ 30 กันยายน 2024 ค่าต่อไปนี้สําหรับแอตทริบิวต์ที่ระบุ ประเภทการกำหนดเป้าหมายจะหยุดให้บริการสำหรับ YouTube และ รายการโฆษณาของพาร์ทเนอร์

ระบบจะนำตัวเลือกการกำหนดเป้าหมายที่หยุดให้บริการออกจากการกำหนดเป้าหมายรายการโฆษณาที่มีอยู่โดยอัตโนมัติ

โปรดนำการกำหนดเป้าหมายนี้ออกจาก YouTube และ รายการโฆษณาของพาร์ทเนอร์ก่อนวันที่หยุดให้บริการ

กลุ่มเป้าหมายบุคคลที่หนึ่งและบุคคลที่สามของ Oracle 30 กันยายน 2024

ในวันที่ 30 กันยายน 2024 แหล่งข้อมูล FirstAndThirdPartyAudience จาก Oracle จะหยุดให้บริการ เมื่อหยุดให้บริการ ระบบจะนำกลุ่มเป้าหมายเหล่านี้ออกจากการกำหนดเป้าหมายทรัพยากรและกลุ่มเป้าหมายแบบรวมที่มีอยู่ หากรายการโฆษณากำหนดเป้าหมายเฉพาะกลุ่มเป้าหมายที่หยุดให้บริการหรือกำหนดเป้าหมายเชิงลบแก่กลุ่มเป้าหมายที่หยุดให้บริการ การอัปเดตนี้จะหยุดรายการโฆษณานั้นชั่วคราวโดยอัตโนมัติ

ระบุและนำกลุ่มเป้าหมาย Oracle ออกจากการกำหนดกลุ่มเป้าหมายของรายการโฆษณาที่มีอยู่และกลุ่มเป้าหมายแบบรวมก่อนวันที่หยุดให้บริการ เพื่อหลีกเลี่ยงการหยุดชะงักของบริการ

การกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพรายการโฆษณาสำหรับกลยุทธ์การเสนอราคาชุดย่อย 30 กันยายน 2024

ในวันที่ 30 กันยายน 2024 แหล่งข้อมูล LineItem ที่ใช้ชุดย่อยของกลยุทธ์การเสนอราคาจะใช้ร่วมกับการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพไม่ได้อีกต่อไป การเปลี่ยนแปลงนี้จะทำให้ระบบตั้งค่าทรัพยากร LineItem ที่ตั้งค่า targetingExpansion.enableOptimizedTargeting เป็น True และ bidStrategy.maximizeSpendAutoBid.performanceGoalType ตั้งค่าเป็น BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN หรือ BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED หรือ bidStrategy.performanceGoalAutoBid.performanceGoalType ที่ตั้งค่าเป็น BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM ให้ตั้งค่าเป็น targetingExpansion.enableOptimizedTargeting เป็น False

โปรดอัปเดตและยืนยันว่ารายการโฆษณาที่ใช้กลยุทธ์การเสนอราคาเหล่านี้ไม่ได้เปิดการกำหนดเป้าหมายแบบเพิ่มประสิทธิภาพไว้เพื่อหลีกเลี่ยงการหยุดชะงักของบริการ

เที่ยวบินโดยเร็วที่สุด Pacing สำหรับใบสั่งซื้อการใส่โฆษณา 5 พฤศจิกายน 2024

ในวันที่ 5 พฤศจิกายน 2024 การตั้งค่าช่องใบสั่งซื้อการใส่โฆษณา pacing จะใช้ร่วมกับ PACING_PERIOD_FLIGHT ไม่ได้อีกต่อไป PACING_TYPE_ASAP ระบบจะอัปเดต pacingType สำหรับใบสั่งซื้อการใส่โฆษณาทั้งหมดที่มีการกำหนดค่านี้เป็น PACING_TYPE_AHEAD

โปรดอัปเดต pacing ของใบสั่งซื้อการใส่โฆษณาที่มีอยู่โดยใช้ PACING_TYPE_ASAP และ PACING_PERIOD_FLIGHT เพื่อป้องกันไม่ให้บริการหยุดชะงัก