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

ด้านล่างนี้เป็นการเปลี่ยนแปลงสำคัญของ GAPI/MAPI ใหม่สำหรับเวอร์ชั่น 25 โปรดไปที่บันทึกการเปลี่ยนแปลงของเราเพื่อดูรายการการเปลี่ยนแปลงและรายละเอียดทั้งหมด

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

API กราฟ: เปิดตัวเกณฑ์ชี้วัดผู้ชมเพจ

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

สิ่งที่จะเปลี่ยนไป

เกณฑ์ชี้วัดผู้ชมจะใช้งานได้ในข้อมูลเชิงลึกของเพจและข้อมูลเชิงลึกของสตอรี่

ข้อมูลเชิงลึกของโพสต์/เพจ

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

ข้อมูลเชิงลึกของสตอรี่

• จะมีการเพิ่มเกณฑ์ชี้วัดใหม่
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

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

การอัพเดตใบรับรอง mTLS สำหรับ Webhooks

ตั้งแต่วันที่ 31 มีนาคม 2026 เป็นต้นไป Meta จะเริ่มลงนามใบรับรอง mTLS สำหรับ Webhooks โดยใช้หน่วยงานออกใบรับรอง (CA) แห่งอื่นที่เป็นของ Meta

สิ่งนี้มีความสำคัญต่อผู้พัฒนาอย่างไร

หากเซิร์ฟเวอร์ของคุณได้รับการกำหนดค่าให้ต้องใช้และตรวจสอบยืนยันใบรับรอง mTLS สำหรับ Webhooks คุณจะต้องดำเนินการสร้างความน่าเชื่อถือให้กับใบรับรองจาก CA ของ Meta ฉบับใหม่ หากไม่อัพเดตที่เก็บใบรับรองที่เชื่อถือได้ภายในวันครบกำหนด จะทำให้แฮนด์เชค TLS ล้มเหลว และเซิร์ฟเวอร์ของคุณจะหยุดรับเหตุการณ์ Webhooks ทั้งหมด

สิ่งที่ต้องดำเนินการ: อัพเดต Trust Store ของคุณ

เพื่อให้แน่ใจว่าการรับ Webhooks จะไม่ถูกขัดจังหวะ คุณต้อง

1. ดาวน์โหลดใบรับรอง CA ต้นทางของ Meta: ไปที่ "เริ่มต้นใช้งาน Webhooks" แล้วดาวน์โหลดไฟล์ชื่อ meta-outbound-api-ca-2025-12.pem
   โดย CA ต้นทางจะลงนามในใบรับรองปลายทางซึ่งจะแสดงในคำขอ Webhooks
2. เพิ่มในคลัง Trust Store ของคุณ: เพิ่มใบรับรองนี้ใน Trust Store ของเซิร์ฟเวอร์ที่ได้รับ Webhooks
3. ใช้ใบรับรองปัจจุบันต่อไป: คุณควรเพิ่มใบรับรองใหม่ลงใน Trust Store ของคุณโดยที่ใบรับรองปัจจุบันยังคงใช้งานได้อยู่

สำคัญ: อย่ารอจนถึงวันครบกำหนด คุณควรเพิ่มใบรับรองใหม่ลงในคลังความน่าเชื่อถือของคุณทันทีเพื่อให้แน่ใจว่าการเปลี่ยนผ่านจะราบรื่นในวันที่ 31 มีนาคม

กำหนดเวลา: ก่อนวันที่ 31 มีนาคม 2026

เหตุใดจึงเปลี่ยนแปลง

ใบรับรอง mTLS สำหรับ Webhooks ปัจจุบันได้รับการลงนามโดย CA ต้นทาง DigiCert เนื่องจาก DigiCert กำลังจะเลิกใช้ EKU การยืนยันตัวตนไคลเอ็นต์ ใบอนุญาตจึงไม่สามารถต่ออายุได้เมื่อ CA ต้นทางนี้หมดอายุในวันที่ 15 เมษายน 2025

ด้วยเหตุนี้ ใบรับรอง Webhooks mTLS ใหม่จึงได้รับการลงนามโดย CA ต้นทางภายในของ Meta ใบรับรองใหม่นี้จะยังคงมีชื่อสามัญ (client.webhooks.fbclientcerts.com) เดียวกันกับใบรับรองปัจจุบัน

เราได้อัพเดตเอกสารสำหรับสาธารณะเกี่ยวกับ Webhooks mTLS โดยมีการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงนี้ รายละเอียดทางเทคนิคฉบับเต็มในเอกสารประกอบจะได้รับการอัพเดตอย่างถาวรในเดือนเมษายน 2026 เมื่อการเปลี่ยนผ่านเสร็จสมบูรณ์แล้ว

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

ข้อความแสดงข้อผิดพลาดที่ปรับปรุงให้ดีขึ้นสำหรับ API ข้อมูลเชิงลึกของโฆษณาแบบไม่ซิงค์

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

ตั้งแต่ API กราฟเวอร์ชั่น V25.0 ซึ่งจะเปิดตัวในวันที่ 18 กุมภาพันธ์ 2026 เป็นต้นไป ผู้พัฒนาจะสามารถเข้าถึงข้อมูลข้อผิดพลาดโดยละเอียดเมื่อรายงานแบบไม่ซิงค์ไม่สำเร็จ ช่วยให้สามารถวินิจฉัยข้อผิดพลาดได้ง่ายขึ้น และช่วยปรับปรุงประสิทธิภาพการผสานการทำงาน API ของตน สำหรับผู้พัฒนาที่ขณะนี้มีสิทธิ์เข้าถึงช่อง error_code ประเภทจะเปลี่ยนจาก uint เป็น int

มีอะไรเปลี่ยนแปลงบ้าง

เราขอแนะนำช่องตามค่าเริ่มต้นใหม่ต่อไปนี้ในการตอบกลับของตำแหน่งข้อมูล GET {AD_REPORT_RUN_ID} ของ API ข้อมูลเชิงลึกของโฆษณาแบบไม่ซิงค์สำหรับแอพพลิเคชั่นทั้งหมด

• error_code: รหัสข้อผิดพลาด หมายเหตุ: ช่องจะเปลี่ยนจาก uint เป็น int สำหรับผู้พัฒนาที่มีสิทธิ์เข้าถึงช่องนั้นอยู่ในปัจจุบัน
• error_message: ข้อความที่สอดคล้องกับ error_code
• error_subcode: รหัสย่อยที่เฉพาะเจาะจงสำหรับข้อผิดพลาด
• error_user_title: ชื่อข้อผิดพลาดที่ผู้ใช้เห็นสำหรับรหัสย่อยของข้อผิดพลาด
• error_user_msg: ข้อความที่แสดงรายละเอียดโค้ดย่อยของข้อผิดพลาดในรูปแบบที่ผู้ใช้สามารถเข้าใจได้

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

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

API กราฟ: เลิกใช้พารามิเตอร์การสืบค้นเมตาดาต้า

ตั้งแต่ API กราฟเวอร์ชั่น 25 เป็นต้นไป เราจะยกเลิกพารามิเตอร์การสืบค้น metadata=1 พารามิเตอร์นี้เคยใช้เพื่อส่งคืนเมตาดาต้าเกี่ยวกับช่องและการเชื่อมต่อของโหนดภายในการตอบกลับ API ฟีเจอร์นี้มีการใช้งานไม่มากและกำลังจะถูกเลิกใช้งานเพื่อลดความซับซ้อนของแพลตฟอร์ม หลังจากเลิกใช้งาน ระบบจะละเว้นพารามิเตอร์ metadata ในคำขอ API

ผู้พัฒนาที่ใช้ metadata=1 อยู่ในปัจจุบันควรเปลี่ยนไปใช้เอกสาร API อย่างเป็นทางการของเราเพื่อสำรวจช่องและการเชื่อมต่อที่ใช้งานได้สำหรับโหนดแต่ละประเภท

มีอะไรเปลี่ยนแปลงบ้าง

ก่อน (เวอร์ชั่น 24 และเก่ากว่า):

การเพิ่ม ?metadata=1 ในคำขอ API กราฟจะส่งคืนเมตาดาต้าเพิ่มเติมเกี่ยวกับโหนด ซึ่งรวมถึงช่องและการเชื่อมต่อที่พร้อมใช้งาน

หลัง (เวอร์ชั่น 25 ขึ้นไป):

ระบบจะละเว้นพารามิเตอร์ metadata=1 คำขอที่มีพารามิเตอร์นี้จะยังคงส่งคืนการตอบกลับแบบมาตรฐานต่อไปโดยไม่มีเมตาดาต้า จะไม่มีการขัดข้องหรือการเปลี่ยนแปลงที่สำคัญเกิดขึ้น คำขอของคุณจะไม่เกิดข้อผิดพลาดหรือขัดข้องหากมี metadata=1 โดยพารามิเตอร์นี้จะไม่ส่งผลกระทบใดๆ

API กราฟ: การเลิกใช้งานเกณฑ์ชี้วัดการเข้าถึง/อิมเพรสชั่นของเพจ

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

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

สิ่งที่จะเปลี่ยนไป

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

การเข้าถึงโพสต์/เพจ

• GET {page-id}/insights/page_impressions_unique*
• GET {page-id}/insights/page_impressions_paid_unique*
• GET {page-id}/insights/page_impressions_viral_unique*
• GET {page-id}/insights/page_impressions_nonviral_unique*
• GET {page-id}/insights/page_posts_impressions*
• GET {page-id}/insights/page_posts_impressions_unique*
• GET {page-id}/insights/page_posts_impressions_paid*
• GET {page-id}/insights/page_posts_impressions_paid_unique*
• GET {page-id}/insights/page_posts_impressions_organic_unique*
• GET {page-id}/insights/page_posts_served_impressions_organic_unique*
• GET {page-id}/insights/page_posts_impressions_viral*
• GET {page-id}/insights/page_posts_impressions_viral_unique*
• GET {page-id}/insights/page_posts_impressions_nonviral*
• GET {page-id}/insights/page_posts_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_unique*
• GET {post-id}/insights/post_impressions_paid_unique*
• GET {post-id}/insights/post_impressions_fan_unique*
• GET {post-id}/insights/post_impressions_organic_unique*
• GET {post-id}/insights/post_impressions_viral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*

อิมเพรสชั่นวิดีโอ

• GET {video-id}/video_insights/post_impressions_unique
• GET {video-id}/video_insights/total_video_impressions
• GET {video-id}/video_insights/total_video_impressions_unique
• GET {video-id}/video_insights/total_video_impressions_paid_unique
• GET {video-id}/video_insights/total_video_impressions_paid
• GET {video-id}/video_insights/total_video_impressions_organic_unique
• GET {video-id}/video_insights/total_video_impressions_organic
• GET {video-id}/video_insights/total_video_impressions_viral_unique
• GET {video-id}/video_insights/total_video_impressions_viral
• GET {video-id}/video_insights/total_video_impressions_fan_unique
• GET {video-id}/video_insights/total_video_impressions_fan
• GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
• GET {video-id}/video_insights/total_video_impressions_fan_paid

อิมเพรสชั่นสตอรี่

• เราจะแทนที่เกณฑ์ชี้วัด 2 รายการ
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

เราขอแนะนำให้ใช้เกณฑ์ชี้วัดต่อไปนี้แทน

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

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

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

API กราฟ: เลิกใช้งานเกณฑ์ชี้วัดผู้ชม 3 วินาที

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

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

สิ่งที่จะเปลี่ยนไป

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

• GET {page-id}/insights/page_video_views_unique
• GET {post-id}/insights/post_video_views_organic_unique
• GET {post-id}/insights/post_video_views_paid_unique
• GET {post-id}/insights/post_video_views_unique
• GET {video-id}/video_insights/total_video_views_organic_unique
• GET {video-id}/video_insights/total_video_views_paid_unique
• GET {video-id}/video_insights/total_video_views_unique

เราขอแนะนำให้ใช้เกณฑ์ชี้วัดต่อไปนี้แทน

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

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

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

API การตลาด: การหยุดให้บริการ ASC และ AAC

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

ตั้งแต่เวอร์ชั่น 25.0 (18 กุมภาพันธ์ 2026) คุณจะสร้างหรืออัพเดตแคมเปญ ASC และ AAC โดยใช้ API การตลาดไม่ได้อีกต่อไป การเปลี่ยนแปลงนี้จะขยายไปยัง MAPI ทุกเวอร์ชั่นหลังจากผ่านไป 90 วัน (ภายในวันที่ 19 พฤษภาคม 2026)

ในเวอร์ชั่น 26.0 (ประมาณเดือนกันยายน 2026) แคมเปญ ASC และ AAC ที่เหลือทั้งหมดจะหยุดชั่วคราว

แคมเปญ ASC หรือ AAC ที่ใช้ขีดจำกัดของงบประมาณของลูกค้าที่มีอยู่ (ECBC) จะยังคงแก้ไขได้จนถึงเวอร์ชั่น 26.0 โดยฟีเจอร์นี้ใช้งานกับแคมเปญ Advantage+ ไม่ได้ ผู้พัฒนาที่ใช้แคมเปญ ECBC ควรใช้วิธีใดวิธีหนึ่งด้านล่างเพื่อสร้างแคมเปญ ECBC ซ้ำก่อนเวอร์ชั่น 26.0

• การสร้างซ้ำด้วยตนเอง: เปิดแคมเปญ ASC/AAC ที่มีอยู่ด้วย ECBC ในตัวจัดการโฆษณา แล้วคุณจะได้รับข้อความแจ้งให้ "สร้างแคมเปญซ้ำ" ขั้นตอนแบบคลิกเดียวนี้จะสร้างแคมเปญใหม่ที่มีการตั้งค่าแบบเดียวกับแคมเปญที่มีอยู่
• สร้างแคมเปญ ECBC ซ้ำโดยใช้ API ใช้คำแนะนำที่ให้ไว้ในเอกสารสำหรับผู้พัฒนาเพื่อสร้างแคมเปญซ้ำโดยใช้ API ที่นี่
• ส่งคำขอย้ายครั้งละหลายรายการในระดับบัญชีโฆษณา เราสามารถดำเนินการแบบครั้งเดียวให้กับพาร์ทเนอร์ภายใต้สัญญาเพื่อทำซ้ำแคมเปญ ECBC ทั้งหมดในวันที่ตกลงไว้ได้ โปรดติดต่อผู้ติดต่อหลัก (POC) ของ Meta พร้อมระบุ ID บัญชีและวันที่ที่ต้องการย้าย

หมายเหตุ: โปรดทราบว่าการสร้างแคมเปญ ECBC ซ้ำทั้งหมดจะส่งผลให้ได้รับ ID แคมเปญใหม่

การเปลี่ยนแปลงนี้จะส่งผลกระทบต่อตำแหน่งข้อมูลต่อไปนี้

• POST /{campaign-id}
• POST /{campaign-id}/copies

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

ลิงก์ไปยังเอกสารประกอบสำหรับผู้พัฒนา

• เอกสารสำหรับผู้พัฒนา - ประสบการณ์แคมเปญ Advantage+ สำหรับยอดขาย แอพ และข้อมูลลูกค้า

ลิงก์ไปยังบทความช่วยเหลือเกี่ยวกับฟีเจอร์

• ศูนย์ช่วยเหลือ - แคมเปญ Advantage+
• ศูนย์ช่วยเหลือ - หมวดหมู่โฆษณาพิเศษ

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

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

API กราฟ

• 21 พฤษภาคม 2026: เลิกใช้งานและลบ API กราฟเวอร์ชั่น 19 ออกจากแพลตฟอร์ม
• 24 กันยายน 2026: เลิกใช้งานและลบ API กราฟเวอร์ชั่น 20 ออกจากแพลตฟอร์ม

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