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

วันนี้เราได้เปิดตัว 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>

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

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

• https://developers.facebook.com/docs/marketing-api/reference/adgroup/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/copies/

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

• การเปลี่ยนแปลงเกี่ยวกับวัตถุประสงค์ในตัวจัดการโฆษณา Meta
• วิธีเลือกวัตถุประสงค์ของโฆษณาที่เหมาะสมในตัวจัดการโฆษณา Meta

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 ปีของเรา

• กุมภาพันธ์ 2024: เลิกใช้งาน SDK แพลตฟอร์ม Facebook เวอร์ชั่น 12.0 หรือเวอร์ชั่นที่เก่ากว่า