Introducing Graph API v22.0 and Marketing API v22.0

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

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

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

API การตลาดเวอร์ชั่น 22 มีการเปลี่ยนแปลงการใช้กลุ่มเป้าหมายที่กําหนดเองของรายชื่อลูกค้าในแคมเปญด้านที่อยู่อาศัย การจ้างงาน และผลิตภัณฑ์และบริการทางการเงิน (รวมถึงเครดิต)

มีผลกับ "เวอร์ชั่น 22.0 ขึ้นไป" และจะเปิดใช้งานสำหรับทุกเวอร์ชั่นในเดือนมีนาคม 2025

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

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

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

API กลุ่มเป้าหมายที่กำหนดเองเวอร์ชั่น 22

ตั้งแต่วันที่ 6 มกราคม 2025 เป็นต้นไป คุณสามารถใช้ช่องis_eligible_for_sac_campaignsที่เพิ่มมาใหม่เพื่อระบุว่าสามารถใช้กลุ่มเป้าหมายที่กําหนดเองในชุดโฆษณาของแคมเปญหมวดหมู่โฆษณาพิเศษได้หรือไม่ คุณต้องระบุ special_ad_categoriesและ special_ad_category_countries ที่ตั้งใจไว้ของแคมเปญหมวดหมู่โฆษณาพิเศษที่กำลังจะใช้กลุ่มเป้าหมาย รวมถึง ad_account_id ซึ่งจะใช้กลุ่มเป้าหมายเพื่อสร้างหรือแก้ไขชุดโฆษณา

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

• GET /custom_audience_id

เข้าถึงผู้คนที่สนใจในเมืองและภูมิภาคที่คุณเลือก

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

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

ระหว่างการทดสอบ ลูกค้าที่ใช้ฟีเจอร์การกำหนดเป้าหมายตามตำแหน่งแบบใหม่นี้มีต้นทุนต่อผลลัพธ์ลดลง 6.7%

สำหรับข้อมูลเพิ่มเติม คลิกที่นี่

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

แทนที่ตำแหน่งข้อมูลผู้ใช้ Instagram, สื่อ Instagram, ภาพสไลด์ Instagram และความคิดเห็นบน Instagram ด้วยตำแหน่งข้อมูลผู้ใช้ IG, สื่อ IG และความคิดเห็นบน IG

เราเปลี่ยนแปลง API กราฟและ API การตลาดของ Instagram เพื่อให้นักพัฒนาสร้างโซลูชั่นสำหรับธุรกิจได้ง่ายยิ่งขึ้น ในการเปลี่ยนแปลงเหล่านี้ เราจะยกเลิกการใช้งานอ็อบเจ็กต์ผู้ใช้ Instagram, สื่อ Instagram, ภาพสไลด์ Instagram และความคิดเห็นบน Instagram ใน API กราฟ เวอร์ชั่น 22 เพื่อสนับสนุนอ็อบเจ็กต์ที่มีอยู่แล้วอย่าง ผู้ใช้ IG, สื่อ IG ซึ่งรวมถึง ภาพสไลด์, และความคิดเห็นบน IG นอกจากนี้เรายังได้เพิ่มฟังก์ชั่นการทำงานให้กับอ็อบเจ็กต์ใหม่เหล่านี้เพื่อให้มีความเท่าเทียมกันสำหรับกรณีการใช้งานส่วนใหญ่

ผู้พัฒนาจะมีเวลาจนถึงวันที่ 21 มกราคม 2026 ในการอัพเดตการใช้งานตำแหน่งข้อมูล API การตลาดที่ได้รับผลกระทบ และจนถึงวันที่ 21 เมษายน 2025 ในการอัพเดตการใช้งานตำแหน่งข้อมูล API กราฟที่ได้รับผลกระทบ หากคุณกำลังอัพเดตเวอร์ชัน Graph API ของคุณโดยอัตโนมัติในการเรียก API เราขอแนะนำให้คุณตรวจสอบการเปลี่ยนแปลงเหล่านี้เนื่องจากการเปลี่ยนแปลงเหล่านี้จะส่งผลทันทีกับผู้พัฒนาที่ใช้ API กราฟ เวอร์ชั่น 22

อ่านบล็อกของผู้พัฒนาเพื่อดูรายละเ��ียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ รวมถึงตำแหน่งข้อมูลใดที่กำลังเปลี่ยนแปลง กรณีการใช้งานใดที่ไม่รองรับอีกต่อไป และช่วงเวลาที่มีผล

ถอดการยกเว้นการกำหนดเป้าหมายอย่างละเอียด

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

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

การเปลี่ยนแปลงนี้จะส่งผลให้กลุ่มเป้าหมายที่กำหนดเองจะถูกถอดออกจากช่องการยกเว้น คุณยังใช้งานการยกเว้นกลุ่มเป้าหมายที่กำหนดเองต่อไปได้โดยใช้ช่อง excluded_custom_audiences แทน

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

ยกเลิกชุดการเพิ่มประสิทธิภาพมาตรฐานจาก API การตลาด

ผลกระทบของ API การตลาดเวอร์ชั่น 22.0 ที่มีต่อการเพิ่มประสิทธิภาพชิ้นงานโฆษณา Advantage+

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

ที่นี่คุณสามารถเรียนรู้ข้อมูลเพิ่มเติมที่เกี่ยวข้องกับชุมชนผู้พัฒนา และดูรายละเอียดเพิ่มเติมได้ในเอกสารสำหรับผู้พัฒนาของเราที่นี่

การเพิ่มประสิทธิภาพมาตรฐานจะไม่ได้รับการรองรับอีกต่อไปกับตำแหน่งข้อมูลเหล่านี้:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• GET /{ad_id}/previews

ขอแนะนำเกณฑ์ชี้วัดยอดดูบน Instagram และยกเลิกเกณฑ์ชี้วัดอิมเพรสชั่นและการเล่น

เพื่อปรับฟังก์ชันการทำงานของ Instagram API ให้สอดคล้องกับแอพ Instagram ต่อไป เราจึงเปิดตัวเกณฑ์ชี้วัด "ยอดดู" บน API ทุกเวอร์ชันสำหรับทั้งข้อมูลเชิงลึกของสื่อและผู้ใช้ อ็อบเจ็กต์ “ฟีด”, “สตอรี่” และ “Reels” จะแสดงยอดดูสำหรับข้อมูลเชิงลึกของสื่อ สำหรับข้อมูลเชิงลึกของผู้ใช้ API จะรองรับเกณฑ์ชี้วัด "ยอดดู" โดยมีข้อมูลแยกย่อยแบบหลายมิติสำหรับประเภทผู้ติดตามและประเภทผลิตภัณฑ์สื่อ

นอกจากนี้ เกณฑ์ชี้วัดต่อไปนี้อีกต่อไปนี้จะถูกเลิกใช้ โดยเริ่มตั้งแต่เวอร์ชั่น 22 เป็นต้นไป:

• plays (media insights): จำนวนครั้งที่คลิป Reels เริ่มเล่นหลังจากที่มี��ารนับอิมเพรสชั่นแล้ว
• clips_replays_count (media insights): จำนวนครั้งที่คลิป Reels ของคุณเริ่มเล่นอีกครั้งหลังจากการเล่นครั้งแรก เกณฑ์ชี้วัดนี้หมายถึงการเล่นซ้ำ 1 มิลลิวินาทีหรือมากกว่าในเซสชั่น Reels เดียวกัน
• ig_reels_aggregated_all_plays_count (media insights): จำนวนครั้งที่คลิป Reels ของคุณเริ่มเล่นหรือเริ่มเล่นซ้ำหลังจากที่มีการนับอิมเพรสชั่นแล้ว
• impressions (media & user insights): จำนวนครั้งทั้งหมดที่มีการดูอ็อบเจ็กต์ สื่อบนInstagram

เราจะเลิกใช้เกณฑ์ชี้วัด 'impressions' ในข้อมูลเชิงลึกของสื่อสำหรับสื่อที่สร้างในวันที่ 2 กรกฎาคม 2024 เป็นต้นไปเท่านั้น สำหรับสื่อที่สร้างก่อนวันที่ดังกล่าว API จะยังคงส่งคืนค่าตามปกติในทุกเวอร์ชัน

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

Meta Business SDK

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

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

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

• พฤษภาคม 2025: ยกเลิก SDK แพลตฟอร์ม Facebook เวอร์ชั่น 17.0 หรือเก่ากว่า

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

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

API กราฟ

• 14 พฤษภาคม 2025: API กราฟ เวอร์ชั่น 16 จะถูกยกเลิกใช้งานและลบออกจากแพลตฟอร์ม
• 12 กันยายน 2025: API กราฟ เวอร์ชั่น 17 จะถูกยกเลิกใช้งานและถูกลบออกจากแพลตฟอร์ม

API การตลาด

• 4 ก.พ. 2025: API การตลาดเวอร์ชั่น 19.0 จะถูกยกเลิกและลบออกจากแพลตฟอร์ม
• 6 พฤษภาคม 2025: API การตลาดเวอร์ชั่น 20.0 จะถูกยกเลิกและลบออกจากแพลตฟอร์ม

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