Giới thiệu API Đồ thị phiên bản 25.0 và API Marketing phiên bản 25.0

Sau đây là những điểm thay đổi nổi bật của API Đồ thị (GAPI) và API Marketing (MAPI) trong phiên bản 25.0. Hãy truy cập nhật ký thay đổi của chúng tôi để xem danh sách đầy đủ các thay đổi và thông tin chi tiết.

Điểm cập nhật chung

API Đồ thị: Giới thiệu số liệu người xem Trang

Đến cuối tháng 6/2026, chúng tôi dự định giới thiệu Số liệu người xem Trang trong API Đồ thị. Số liệu số người xem nhằm thay thế số liệu số người tiếp cận cũ và mang đến khả năng đo lường nhất quán trên nhiều nền tảng (Facebook và Instagram) về số người đã xem một nội dung. Các nhà phát triển nên bắt đầu lên kế hoạch chuyển sang số liệu người xem để đảm bảo tiếp tục sử dụng được thông tin chi tiết về đối tượng.

Có gì thay đổi?

Số liệu người xem sẽ có trong phần thông tin chi tiết trang và thông tin chi tiết về tin

Thông tin chi tiết về bài viết/Trang

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

Thông tin chi tiết về tin

• Số liệu mới sẽ được thêm vào
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

Các API Đồ thị nêu trên sẽ dùng được sau khi phiên bản 25.0 ra mắt. Các nhà phát triển nên xem Nhật ký thay đổi của API Đồ thị để biết thông tin mới nhất.

Điểm cập nhật về chứng chỉ mTLS Webhooks

Kể từ ngày 31/03/2026, Meta sẽ bắt đầu ký chứng chỉ mTLS Webhooks thông qua một Tổ chức chứng thực (CA) khác thuộc sở hữu của Meta.

Điều này có ý nghĩa gì đối với nhà phát triển?

Nếu đặt cấu hình máy chủ để yêu cầu và xác minh chứng chỉ mTLS Webhooks, bạn phải tin cậy CA mới của Meta. Nếu bạn không cập nhật kho lưu trữ tin cậy trước thời hạn, hệ thống sẽ không thiết lập được kết nối TLS và máy chủ của bạn sẽ dừng nhận tất cả sự kiện webhooks.

Cần hành động: Cập nhật kho lưu trữ tin cậy

Để đảm bảo nhận Webhooks không gián đoạn, bạn phải

1. Tải xuống chứng chỉ CA gốc của Meta: Đi đến phần Bắt đầu với webhook và tải xuống file có tên meta-outbound-api-ca-2025-12.pem.
   CA gốc sẽ ký chứng chỉ cuối được hiển thị trong yêu cầu Webhooks.
2. Thêm vào kho lưu trữ tin cậy: Thêm chứng chỉ này vào kho lưu trữ tin cậy của bất kỳ máy chủ nào nhận Webhooks.
3. Duy trì chứng chỉ hiện tại: Bạn nên thêm chứng chỉ mới của Meta vào kho lưu trữ tin cậy khi chứng chỉ hiện tại vẫn chưa hết hạn.

Quan trọng: Đừng đợi đến hạn chót mới thực hiện. Bạn nên thêm chứng chỉ mới vào kho lưu trữ tin cậy ngay để đảm bảo quá trình chuyển đổi diễn ra liền mạch vào ngày 31/03.

Thời hạn: Trước ngày 31/03/2026.

Lý do có sự thay đổi này

Chứng chỉ mTLS Webhooks hiện tại do CA gốc DigiCert ký. Vì DigiCert đang ngừng sử dụng EKU Xác thực máy khách nên chứng chỉ không thể được gia hạn với CA gốc này. CA gốc sẽ hết hạn vào ngày 15/04/2025.

Do đó, chứng chỉ mTLS Webhooks mới sẽ do một CA gốc nội bộ của Meta ký. Chứng chỉ mới sẽ duy trì cùng tên chung (client.webhooks.fbclientcerts.com) với chứng chỉ hiện tại.

Chúng tôi đã cập nhật tài liệu công khai về mTLS Webhooks kèm theo thông báo liên quan đến thay đổi này. Thông tin kỹ thuật đầy đủ trong tài liệu sẽ được cập nhật chính thức vào tháng 4/2026 sau khi quá trình chuyển đổi hoàn tất.

Phiên bản ngừng hoạt động và những thay đổi quan trọng

Cải thiện thông báo lỗi cho API Không đồng bộ của thông tin chi tiết về quảng cáo

Chúng tôi đang nỗ lực không ngừng để cải thiện trải nghiệm cho nhà phát triển với API của mình. Để tăng tính minh bạch và hỗ trợ nhà phát triển xây dựng các ứng dụng có khả năng phục hồi cao hơn, chúng tôi đang cải thiện báo cáo lỗi cho điểm cuối GET {AD_REPORT_RUN_ID} API Không đồng bộ của thông tin chi tiết về quảng cáo.

Kể từ phiên bản API Đồ thị 25.0 tiếp theo (sẽ được phát hành vào ngày 18/02/2026), các nhà phát triển sẽ có quyền truy cập thông tin chi tiết về lỗi khi báo cáo không đồng bộ không thành công, qua đó giúp họ chẩn đoán lỗi dễ dàng hơn và cải thiện hiệu quả của tiện ích tích hợp API. Đối với bất kỳ nhà phát triển nào hiện có quyền truy cập trường error_code, loại sẽ đổi từ uint thành int.

Có gì thay đổi?

Chúng tôi sẽ giới thiệu các trường mặc định mới sau đây cho phản hồi của điểm cuối GET {AD_REPORT_RUN_ID} API Không đồng bộ của thông tin chi tiết về quảng cáo cho tất cả ứng dụng:

• error_code: Mã lỗi. Lưu ý: Trường sẽ đổi từ uint thành int cho bất kỳ nhà phát triển nào hiện có quyền truy cập vào trường đó
• error_message: Thông báo tương ứng với error_code.
• error_subcode: Mã phụ cụ thể của lỗi.
• error_user_title: Tên dễ hiểu của mã phụ lỗi.
• error_user_msg: Thông báo dễ hiểu nêu chi tiết mã phụ của lỗi.

Những trường này sẽ được điền khi quá trình chạy báo cáo không thành công. Bạn nên xem lại tiện ích tích hợp API của mình để đảm bảo tính tương thích với các trường mặc định mới trong phản hồi.

Bản cập nhật này dự kiến sẽ được phát hành cùng với phiên bản API Đồ thị tiếp theo. Các nhà phát triển nên xem Nhật ký thay đổi của API Đồ thị để biết thông tin mới nhất. Chúng tôi cũng đã cập nhật tài liệu dành cho nhà phát triển để phản ánh những thay đổi này.

API Đồ thị: Thông số truy vấn siêu dữ liệu đã ngừng hoạt động

Kể từ API Đồ thị phiên bản 25.0, chúng tôi sẽ ngừng sử dụng thông số truy vấn metadata=1. Thông số này từng được dùng để trả về siêu dữ liệu về trường và kết nối của nút trong phản hồi API. Tính năng ít được sử dụng và sẽ không được dùng nữa để đơn giản hóa nền tảng. Sau khi ngừng hoạt động, thông số metadata sẽ bị bỏ qua trong yêu cầu API.

Các nhà phát triển hiện đang dựa vào metadata=1 nên chuyển sang sử dụng tài liệu API chính thức của chúng tôi để khám phá các trường và kết nối có sẵn cho từng loại nút.

Có gì thay đổi?

Trước (phiên bản 24 và các phiên bản trước đó):

Khi thêm ?metadata=1 vào yêu cầu API Đồ thị, hệ thống sẽ trả về thêm siêu dữ liệu liên quan đến nút, bao gồm cả các trường và kết nối có sẵn.

Sau (phiên bản 25.0 trở lên):

Thông số metadata=1 sẽ bị bỏ qua. Các yêu cầu chứa thông số này sẽ tiếp tục trả về phản hồi tiêu chuẩn không có siêu dữ liệu. Sẽ không có lỗi hoặc thay đổi quan trọng nào xảy ra - yêu cầu của bạn sẽ không bị lỗi hoặc bị ngắt nếu chứa metadata=1; thông số này sẽ chỉ không có tác động gì.

API Đồ thị: Số liệu lượt hiển thị/số người Trang tiếp cận sẽ ngừng hoạt động

Vào tháng 6/2026, chúng tôi dự định ngừng sử dụng các số liệu Số người bài viết tiếp cận/Số người Trang tiếp cận, Lượt hiển thị video và Lượt hiển thị tin trong API Đồ thị. Cho đến nay, những số liệu cũ này không còn hiển thị trong các công cụ Thông tin chi tiết của chúng tôi, nhưng vẫn dùng được thông qua API.

Để điều chỉnh sản phẩm và API theo khuôn khổ số liệu nhất quán, cũng như để cải thiện độ tin cậy tổng thể của hệ thống, chúng tôi sẽ ngừng sử dụng các số liệu cũ này. Sau khi chúng tôi ngừng sử dụng, nhà phát triển nên chuyển sang dùng số liệu Lượt xem file phương tiện và Số người xem file phương tiện mới. Những số liệu này thay thế cho các khái niệm cũ về lượt hiển thị, số người tiếp cận và số người xem video.

Có gì thay đổi?

Các số liệu sau sẽ ngừng hoạt động vào tháng 6/2026 đối với tất cả phiên bản API. Các nhà phát triển nên xem Nhật ký thay đổi của API Đồ thị để biết thông tin mới nhất:

Số người bài viết tiếp cận/Số người Trang tiếp cận

• 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*

Lượt hiển thị video

• 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

Lượt hiển thị tin

• Hai số liệu sẽ được thay thế
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

Thay vào đó, bạn nên sử dụng các số liệu sau:

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

Cụ thể là đối với số liệu chia nhỏ về số người tiếp cận trả phí và số người tiếp cận tự nhiên, bạn nên sử dụng các số liệu sau đây (cung cấp thông tin chi tiết tương tự):

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

API Đồ thị: Số liệu số người xem trong tối thiểu 3 giây sẽ ngừng hoạt động

Vào tháng 6/2026, chúng tôi dự định sẽ ngừng sử dụng số liệu số người xem trong tối thiểu 3 giây. Cho đến nay, những số liệu cũ này không còn hiển thị trong các công cụ Thông tin chi tiết của chúng tôi, nhưng vẫn dùng được thông qua API Đồ thị.

Để điều chỉnh sản phẩm và API theo khuôn khổ số liệu nhất quán, cũng như để cải thiện độ tin cậy tổng thể của hệ thống, chúng tôi sẽ ngừng sử dụng các số liệu cũ này. Sau khi chúng tôi ngừng sử dụng, nhà phát triển nên chuyển sang dùng số liệu Lượt xem file phương tiện và Số người xem file phương tiện mới. Những số liệu này thay thế cho các khái niệm cũ về lượt hiển thị, số người tiếp cận và số người xem video.

Có gì thay đổi?

Các số liệu sau sẽ ngừng hoạt động vào tháng 6/2026 đối với tất cả phiên bản API. Các nhà phát triển nên xem Nhật ký thay đổi của API Đồ thị để biết thông tin mới nhất:

• 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

Thay vào đó, bạn nên sử dụng các số liệu sau:

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

Cụ thể là đối với số liệu chia nhỏ về số người xem trong tối thiểu 3 giây trả phí và tự nhiên, bạn nên sử dụng các số liệu sau đây để nhận thông tin chi tiết tương tự:

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

API Marketing: ASC và AAC ngừng hoạt động

Quá trình hợp nhất quy trình tự động hóa thúc đẩy chiến dịch Ứng dụng, Doanh số và Tìm kiếm khách hàng tiềm năng mặc định áp dụng cách thiết lập Advantage+ tối ưu, ưu tiên tự động hóa, đồng thời hỗ trợ nhà quảng cáo và đối tác đơn giản hóa quyền truy cập vào các sản phẩm tự động hóa mới nhất và hiệu quả nhất của Meta. Chúng tôi đang tiến hành quá trình ngừng sử dụng API cũ theo giai đoạn và chuyển sang cách thiết lập Advantage+, Hợp nhất quy trình tự động hóa mới dành cho nhà phát triển API Marketing.

Từ phiên bản 25.0 (ngày 18/02/2026), bạn không thể tạo hoặc cập nhật chiến dịch ASC và AAC bằng API Marketing nữa. Quá trình này sẽ mở rộng sang tất cả các phiên bản MAPI sau 90 ngày (đến ngày 19/05/2026).

Trong phiên bản 26.0 (ước tính ra mắt vào tháng 9/2026), tất cả các chiến dịch ASC và AAC còn lại sẽ tạm dừng.

Chiến dịch ASC hoặc AAC sử dụng Giới hạn ngân sách cho khách hàng hiện có (ECBC) sẽ vẫn chỉnh sửa được cho đến phiên bản 26.0. Tính năng này không dùng được với chiến dịch Advantage+. Nhà phát triển có chiến dịch ECBC nên hành động theo một trong các phương pháp bên dưới để sao chép chiến dịch ECBC trước khi phiên bản 26.0 ra mắt:

• Nhân bản thủ công: Mở chiến dịch ASC/AAC hiện có với ECBC trong Trình quản lý quảng cáo, bạn sẽ thấy lời nhắc "Nhân bản chiến dịch". Bước 1 lần nhấp này sẽ tạo chiến dịch mới, sao chép cách thiết lập của chiến dịch hiện có.
• Sao chép chiến dịch ECBC bằng cách sử dụng API: sử dụng hướng dẫn trong tài liệu dành cho nhà phát triển tại đây để sao chép chiến dịch bằng cách sử dụng API.
• Yêu cầu chuyển hàng loạt ở cấp độ tài khoản quảng cáo: đối với đối tác được quản lý, chúng tôi có thể cung cấp hành động một lần để sao chép tất cả chiến dịch ECBC vào ngày đã thỏa thuận. Vui lòng liên hệ với người liên hệ tại Meta của bạn và cung cấp ID tài khoản cũng như ngày bạn muốn chuyển.

Lưu ý: Lưu ý rằng tất cả bản sao chiến dịch ECBC đều sẽ có ID chiến dịch mới.

Thay đổi này ảnh hưởng đến những điểm cuối sau:

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

Vui lòng xem tài liệu dành cho nhà phát triển và câu hỏi thường gặp đã cập nhật để biết tất cả chi tiết về thay đổi này.

Liên kết đến tài liệu dành cho nhà phát triển

• Tài liệu dành cho nhà phát triển - Trải nghiệm chiến dịch Advantage+ cho Doanh số, Ứng dụng và Tìm kiếm khách hàng tiềm năng

Liên kết đến bài viết trợ giúp về tính năng

• Trung tâm trợ giúp - Chiến dịch Advantage+
• Trung tâm trợ giúp - Hạng mục quảng cáo đặc biệt

Các phiên bản API ngừng hoạt động:

Theo lịch trình phiên bản API Đồ thị và API Marketing của Facebook, vui lòng lưu ý các phiên bản sắp ngừng hoạt động sau đây:

API Đồ thị

• Ngày 21/05/2026: API Đồ thị phiên bản 19.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.
• Ngày 24/09/2026: API Đồ thị phiên bản 20.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.

Để tránh bị gián đoạn hoạt động kinh doanh, bạn nên chuyển tất cả lệnh gọi sang phiên bản API mới nhất ra mắt hôm nay.