แนะนำ API กราฟเวอร์ชั่น 19.0 และ API การตลาดเวอร์ชั่น 19.0 ของ Facebook

23 มกราคม 2024โดยMohamed Amr Abouelhassan

วันนี้เราได้เปิดตัว API กราฟเวอร์ชั่น 19.0 และ API การตลาดเวอร์ชั่น 19.0 ของ Facebook เราจะเน้นถึงการเปลี่ยนแปลงดังต่อไปนี้ที่เราเชื่อว่าเกี่ยวข้องกับชุมชนผู้พัฒนาต่างๆ ของเรา สำหรับการเปิดตัวในครั้งนี้ การเปลี่ยนแปลงในครั้งนี้ประกอบไปด้วยประกาศ การอัพเดตผลิตภัณฑ์ และการแจ้งข้อมูลการเลิกใช้งานการผสานการทำงานระหว่างแอพพลิเคชั่นที่เกี่ยวข้องกับแพลตฟอร์มของเรา

โปรดไปที่บันทึกการเปลี่ยนแปลงของเราเพื่อดูรายการการเปลี่ยนแปลงและรายละเอียดที่เกี่ยวข้องทั้งหมด

การอัพเดตทั่วไป

การเปิดใช้งานการกำหนดเป้าหมายอย่างละเอียดของ Advantage สำหรับวัตถุประสงค์แคมเปญและการปรับให้เหมาะสมทุกประเภท

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

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

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

แคมเปญที่ปรับให้เหมาะสมสำหรับอิมเพรสชั่น การรับชมวิดีโอ การเข้าถึง การมีส่วนร่วม หรือการเพิ่มการจดจำโฆษณา จะมีตัวเลือกให้ใช้งานการกำหนดเป้าหมายอย่างละเอียดของ Advantage
แคมเปญที่ปรับให้เหมาะสมสำหรับข้อมูลลูกค้าจะใช้การกำหนดเป้าหมายอย่างละเอียดของ Advantage โดยอัตโนมัติ โดยมีตัวเลือกให้ยกเลิกการใช้งาน
- โปรดทราบว่า ตัวเลือกใช้งานจะเปิดไว้สำหรับแคมเปญ/ชุดโฆษณาใหม่และที่สร้างซ้ำ และคุณสามารถเลือกไม่ใช้งานได้หากต้องการ
แคมเปญที่ปรับให้เหมาะสมสำหรับการคลิกลิงก์หรือการดูแลนดิ้งเพจจะใช้การกำหนดเป้าหมายอย่างละเอียดของ Advantage โดยอัตโนมัติ โดยไม่มีตัวเลือกให้ยกเลิกการใช้งาน

การเปลี่ยนแปลงเหล่านี้ถือเป็นการเปลี่ยนแปลงที่สำคัญสำหรับผู้ลงโฆษณาและพาร์ทเนอร์ที่ใช้ API การตลาด ตั้งแต่วันที่ 23 มกราคม 2024 เป็นต้นไป ผู้พัฒนาสามารถเริ่มเปลี่ยนแปลงโค้ดได้ และจะมีเวลาอัพเดตจนถึงวันที่ 22 เมษายน 2024 การเปลี่ยนแปลงนี้จะเผยแพร่ในการเปิดตัว API ใหม่ในเวอร์ชั่น 19

<Impacted endpoints>

ประเภทคำขอ	ตำแหน่งข้อมูล	การเปลี่ยนแปลง
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	ช่อง ‘targeting_optimization’ จะไม่สามารถใช้ได้กับแคมเปญที่ปรับให้เหมาะสมสำหรับการคลิกลิงก์หรือการดูแลนดิ้งเพจ การเปลี่ยนแปลงนี้ยังมีผลกับการปรับให้เหมาะสมก่อนหน้าที่มีอยู่ในการกำหนดเป้าหมายอย่างละเอียดของ Advantage ซึ่งไม่มีตัวเลือกให้ยกเลิกการใช้งาน ได้แก่ คอนเวอร์ชั่น ค่า การติดตั้งแอพ เหตุการณ์ในแอพ และการสนทนา ช่อง targeting_as_signal ควรเป็นค่าว่างหรือ 0 สำหรับแคมเปญที่ปรับให้เหมาะสมสำหรับอิมเพรสชั่น การรับชมวิดีโอ การเข้าถึง การมีส่วนร่วม การเพิ่มการจดจำโฆษณา หรือข้อมูลลูกค้า มิฉะนั้นจะเกิดข้อผิดพลาด
POST	/act_{ad_account_id}/{adsets} /{adset-id}	ช่อง ‘targeting_optimization’ จะไม่สามารถใช้ได้กับแคมเปญที่ปรับให้เหมาะสมสำหรับการคลิกลิงก์หรือการดูแลนดิ้งเพจ การเปลี่ยนแปลงนี้ยังมีผลกับการปรับให้เหมาะสมก่อนหน้าที่มีอยู่ในการกำหนดเป้าหมายอย่างละเอียดของ Advantage ซึ่งไม่มีตัวเลือกให้ยกเลิกการใช้งาน ได้แก่ คอนเวอร์ชั่น ค่า การติดตั้งแอพ เหตุการณ์ในแอพ และการสนทนา สำหรับการปรับให้เหมาะสมทั้งหมดที่ถูกเลือกใช้งานในการกำหนดเป้าหมายอย่างละเอียดของ Advantage โดยไม่มีตัวเลือกให้ยกเลิกใช้งาน เราจะตั้งค่าช่อง targeting_as_signal โดยอัตโนมัติให้เป็น 1 หรือ 3 ตามชุดของวัตถุประสงค์ + การปรับให้เหมาะสม

ประเภทคำขอ

ตำแหน่งข้อมูล

การเปลี่ยนแปลง

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

ช่อง ‘targeting_optimization’ จะไม่สามารถใช้ได้กับแคมเปญที่ปรับให้เหมาะสมสำหรับการคลิกลิงก์หรือการดูแลนดิ้งเพจ การเปลี่ยนแปลงนี้ยังมีผลกับการปรับให้เหมาะสมก่อนหน้าที่มีอยู่ในการกำหนดเป้าหมายอย่างละเอียดของ Advantage ซึ่งไม่มีตัวเลือกให้ยกเลิกการใช้งาน ได้แก่ คอนเวอร์ชั่น ค่า การติดตั้งแอพ เหตุการณ์ในแอพ และการสนทนา
ช่อง targeting_as_signal ควรเป็นค่าว่างหรือ 0 สำหรับแคมเปญที่ปรับให้เหมาะสมสำหรับอิมเพรสชั่น การรับชมวิดีโอ การเข้าถึง การมีส่วนร่วม การเพิ่มการจดจำโฆษณา หรือข้อมูลลูกค้า มิฉะนั้นจะเกิดข้อผิดพลาด

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

ช่อง ‘targeting_optimization’ จะไม่สามารถใช้ได้กับแคมเปญที่ปรับให้เหมาะสมสำหรับการคลิกลิงก์หรือการดูแลนดิ้งเพจ การเปลี่ยนแปลงนี้ยังมีผลกับการปรับให้เหมาะสมก่อนหน้าที่มีอยู่ในการกำหนดเป้าหมายอย่างละเอียดของ Advantage ซึ่งไม่มีตัวเลือกให้ยกเลิกการใช้งาน ได้แก่ คอนเวอร์ชั่น ค่า การติดตั้งแอพ เหตุการณ์ในแอพ และการสนทนา
สำหรับการปรับให้เหมาะสมทั้งหมดที่ถูกเลือกใช้งานในการกำหนดเป้าหมายอย่างละเอียดของ Advantage โดยไม่มีตัวเลือกให้ยกเลิกใช้งาน เราจะตั้งค่าช่อง targeting_as_signal โดยอัตโนมัติให้เป็น 1 หรือ 3 ตามชุดของวัตถุประสงค์ + การปรับให้เหมาะสม

API การตลาดสำหรับโฆษณา ชุดโฆษณา และแคมเปญใหม่ที่ใช้วัตถุประสงค์ดั้งเดิม

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

สำหรับ API การตลาดเวอร์ชั่น 20 เป็นต้นไป การสร้างโฆษณาและชุดโฆษณาภายใต้แคมเปญที่ใช้วัตถุประสงค์ดั้งเดิมจะไม่รองรับอีกต่อไป อย่างไรก็ตาม API ในเวอร์ชั่นก่อนหน้าเวอร์ชั่น 20 (เช่น เวอร์ชั่น 19, 18) จะยังคงสามารถใช้ฟังก์ชันการทำงานนี้ได้อยู่ ทั้งนี้ ไม่จำเป็นต้องเร่งดำเนินการกับโฆษณาเดิมที่ใช้วัตถุประสงค์ดั้งเดิมแต่อย่างใด

วัตถุประสงค์ดั้งเดิมที่ได้รับผลกระทบ

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

ตำแหน่งข้อมูล POST ที่ได้รับผลกระทบ

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

สำหรับข้อมูลอ้างอิง โปรดดูโพสต์บล็อกสำหรับผู้พัฒนาที่ผ่านมาเกี่ยวกับการเปลี่ยนแปลง API สำหรับการสร้างแคมเปญด้วยวัตถุประสงค์ดั้งเดิมที่นี่

คำถามที่พบบ่อย

ถาม: การเปลี่ยนแปลงนี้จำเป็นต้องอัพเดตโค้ดหรือไม่

ตอบ: จำเป็น มีการเรียก API สำหรับเวอร์ชั่น 18 ที่ไม่สามารถใช้งานในเวอร์ชั่น 19 อยู่หลายรายการ (เช่น โฆษณา ชุดโฆษณา และแคมเปญใหม่ที่ใช้วัตถุประสงค์ดั้งเดิมจะไม่สามารถสร้างผ่านข้อความโฆษณาได้)

ถาม: สิ่งที่คาดว่าจะเกิดขึ้นก่อนและหลังการเปลี่ยนแปลงคืออะไร

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

ถาม: ระยะเวลาในการใช้การเปลี่ยนแปลงโค้ดเป็นอย่างไร

ตอบ: จนกว่าจะเลิกใช้งานเวอร์ชั่น 18.0 ซึ่งมีกำหนดการคร่าวๆ คือเดือนกันยายน 2024

เอกสารเพิ่มเติมสำหรับผู้พัฒนา

บทความช่วยเหลือ

PPCA (สิทธิ์การเข้าถึงเนื้อหาสาธารณะในเพจ)

กรณีการใช้งานสำหรับข้อมูลที่รวบรวมโดยใช้ PPCA (สิทธิ์การเข้าถึงเนื้อหาสาธารณะในเพจ) มีการเปลี่ยนแปลง โปรดดูรายละเอียดจากลิงก์นี้

แนะนำ API กลุ่มเป้าหมาย Advantage+

เมื่อเดือนตุลาคมปีที่แล้ว เราได้เปิดตัวกลุ่มเป้าหมาย Advantage+ ซึ่งเป็นประสบการณ์การสร้างกลุ่มเป้าหมายแบบใหม่ที่ใช้งานง่ายที่จะช่วยเพิ่มประสิทธิภาพของแคมเปญด้วยการขยายกลุ่มเป้าหมายที่มีแนวโน้มที่จะเห็นโฆษณา ขณะเดียวกันยังแสดงโฆษณาไปยังผู้คนที่ผู้ลงโฆษณาต้องการเข้าถึงมากที่สุดด้วย

เรากำลังเปิดตัวกลุ่มเป้าหมาย Advantage+ ใน API การตลาด

หากต้องการเลือกใช้งาน ให้ตั้งค่าพารามิเตอร์ targeting_automation ภายใน advantage_audience เป็น 1
หากต้องการเลือกไม่ใช้งาน ให้ตั้งค่าพารามิเตอร์ targeting_automation ภายใน advantage_audience เป็น 0

การเลิกใช้งานและการเปลี่ยนแปลงที่มีผลต่อการทำงาน

การเลิกใช้งาน API กลุ่มบน Facebook

เราจะเลิกใช้งาน API กลุ่มบน Facebook ในเวอร์ชั่น 19 และจะถูกลบออกจากทุกเวอร์ชั่นในอีก 90 วัน การเลิกใช้งานนี้รวมไปถึงสิทธิ์การอนุญาต (publish_to_groups, groups_access_member_info) และฟีเจอร์ที่สามารถตรวจสอบได้ (API กลุ่ม) ที่เกี่ยวข้องกับ API กลุ่มบน Facebook ทั้งหมด

กรณีการใช้งานหลักสำหรับ API กลุ่มคือการตอบกลับส่วนตัวในกลุ่ม เรากำลังเปิดตัวการเปลี่ยนแปลงอื่นๆ ในเวอร์ชั่น 19 ซึ่งจะทำให้สามารถใช้กรณีการใช้งานดังกล่าวได้โดยที่ผู้พัฒนาไม่ต้องใช้ API กลุ่ม สำหรับผู้พัฒนาที่ใช้การตอบกลับที่เป็นส่วนตัว จะไม่มีการเปลี่ยนแปลงในเวอร์ชั่น 19 สำหรับผู้พัฒนาที่ต้องอาศัยการเรียกไปยังตำแหน่งข้อมูลโพสต์ในกลุ่มผ่าน API กลุ่ม หลังจาก ได้รับ Webhook การตอบกลับส่วนตัวแล้ว ผู้พัฒนาเหล่านั้นจะต้องแน่ใจว่าตนกำลังใช้โทเค็นการเข้าถึงเพจสำหรับคำขอเหล่านั้น

นักพัฒนาที่ไม่มั่นใจว่าตำแหน่งข้อมูลของตนใช้สิทธิ์การอนุญาตที่เลิกใช้งานไปแล้วอยู่หรือไม่ สามารถตรวจสอบยืนยันได้ด้วยการทดสอบตำแหน่งข้อมูลในเวอร์ชั่น 19.0

การเปลี่ยนแปลงเกี่ยวกับ API ข้อมูลเชิงลึกของเพจ - การเลิกใช้งานเกณฑ์ชี้วัด

เนื่องจากการย้ายจากเพจแบบคลาสสิกไปเป็นประสบการณ์เพจใหม่บน Facebook เราจึงจะเลิกใช้เกณฑ์ชี้วัด API ข้อมูลเชิงลึกของเพจจำนวนหนึ่ง โปรดดูลิงก์นี้สำหรับข้อมูลเพิ่มเติม

การเลิกใช้งาน API เวอร์ชั่นต่างๆ

โปรดทราบว่าเรากำลังจะเลิกใช้งานเวอร์ชั่นต่อไปนี้ โดยถือเป็นส่วนหนึ่งของกำหนดเวลาในการกำหนดเวอร์ชั่น API กราฟและ API การตลาดของ Facebook:

API กราฟ

8 กุมภาพันธ์ 2024: API กราฟเวอร์ชั่น 12.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม
28 พฤษภาคม 2024: API กราฟเวอร์ชั่น 13.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม
17 กันยายน 2024: API กราฟเวอร์ชั่น 14.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม

API การตลาด

6 กุมภาพันธ์ 2024: API การตลาดเวอร์ชั่น 16.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม
14 พฤษภาคม 2024: API การตลาดเวอร์ชั่น 17.0 จะถูกเลิกใช้งานและลบออกจากแพลตฟอร์ม

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

Meta Business SDK

การเปิดตัว Meta Business SDK เวอร์ชั่น 19

การเปิดตัว Meta Business SDK เวอร์ชั่น 19 จะเผยแพร่หลังจากเปิดตัว API กราฟเวอร์ชั่น 19 ไม่นาน การเปิดตัวนี้จะมีข้อมูลเกี่ยวกับการปรับปรุงจุดบกพร่อง การอัพเกรดส่วนเสริม ฟีเจอร์ใหม่ และที่สำคัญที่สุดคืออินเทอร์เฟซ API ที่อัพเดตเพื่อให้ตรงกับ API กราฟเวอร์ชั่น 19 เรามีแผนที่จะเปิดตัว SDK ให้บ่อยขึ้นในอนาคต เพื่อให้สอดคล้องกับรอบการอัพเดต API ซึ่งจะช่วยให้ผู้พัฒนาได้รับ API, ฟังก์ชันการทำงาน และฟีเจอร์ใหม่ล่าสุดอยู่เสมอ

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