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

Hôm nay, chúng tôi sẽ ra mắt API Đồ thị phiên bản 22.0 và API Marketing phiên bản 22.0 Trong đợt phát hành này, chúng tôi sẽ nêu bật những thay đổi dưới đây mà chúng tôi cho là có liên quan đến cộng đồng nhà phát triển. Những thay đổi này bao gồm các công bố, bản cập nhật sản phẩm và thông báo về việc ngừng hoạt động của các tiện ích tích hợp ứng dụng liên quan với nền tảng của chúng tôi.

Để biết danh sách đầy đủ tất cả thay đổi và thông tin chi tiết về những thay đổi đó, vui lòng xem nhật ký thay đổi của chúng tôi.

Điểm cập nhật chung

Những thay đổi của API Marketing phiên bản 22 đối với việc sử dụng đối tượng tùy chỉnh từ danh sách khách hàng trong các chiến dịch về nhà ở, việc làm, sản phẩm và dịch vụ tài chính (bao gồm tín dụng)

Áp dụng cho "phiên bản 22.0 trở lên" và sẽ triển khai cho tất cả các phiên bản vào tháng 3/2025

Một số đối tượng tùy chỉnh từ danh sách khách hàng sẽ không đủ điều kiện để sử dụng trong các chiến dịch về nhà ở, việc làm, sản phẩm và dịch vụ tài chính (bao gồm cả tín dụng). Tìm hiểu thêm về điểm cập nhật này tại đây và xem bạn có bị áp dụng các hạn chế này hay không. Ngoài ra, trường is_sac_cfca_terms_certified sẽ được thêm vào cấp độ nhóm quảng cáo, hãy xem ví dụ. Bạn sẽ phải dùng trường này để xác nhận rằng tất cả đối tượng tùy chỉnh từ danh sách khách hàng được sử dụng trong chiến dịch có Nhóm quảng cáo về nhà ở, việc làm, sản phẩm và dịch vụ tài chính (bao gồm cả tín dụng) đều tuân thủ chứng nhận CLCA của Meta. Kể từ đầu tháng 04/2025, nếu sử dụng đối tượng tùy chỉnh từ danh sách khách hàng mà không tuân thủ yêu cầu, các chiến dịch/nhóm quảng cáo hiện tại có thể bị tạm dừng. Trong trường hợp này, bạn sẽ thấy lỗi trong Trình quản lý quảng cáo và API Marketing kèm hướng dẫn.

Dưới đây là những điểm cuối sẽ bị ảnh hưởng:

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

API Đối tượng tùy chỉnh phiên bản 22

Từ ngày 06/01/2025, bạn có thể sử dùng trường is_eligible_for_sac_campaigns mới để xác định xem có thể sử dụng đối tượng tùy chỉnh trong nhóm quảng cáo của chiến dịch Hạng mục quảng cáo đặc biệt không. Bạn phải cung cấp special_ad_categories và special_ad_category_countries dự kiến của chiến dịch Hạng mục quảng cáo đặc biệt sẽ dùng đối tượng này, cũng như ad_account_id sẽ sử dụng đối tượng này để tạo hoặc chỉnh sửa nhóm quảng cáo.

Dưới đây là những điểm cuối sẽ bị ảnh hưởng:

• GET /custom_audience_id

Tiếp cận những người quan tâm đến các thành phố và khu vực bạn đã chọn

Chúng tôi rất vui mừng được chia sẻ về việc ra mắt một tính năng mới để nhắm mục tiêu theo vị trí, giúp các nhà quảng cáo tăng hiệu quả bằng cách mở rộng ra ngoài các thành phố hoặc khu vực mục tiêu của bạn, mang lại cho hệ thống quảng cáo của chúng tôi sự linh hoạt để phân phối quảng cáo đến những người đã thể hiện sự quan tâm đến một vị trí.

Tính năng này mở rộng dựa trên tính năng nhắm mục tiêu theo vị trí hiện có của chúng tôi, bằng cách hỗ trợ bạn tiếp cận những người có ý định đi du lịch, mua hàng hoặc quan tâm chung đến các thành phố và khu vực bạn đang nhắm mục tiêu, trong cùng một quốc gia.

Trong quá trình thử nghiệm, những khách hàng sử dụng tính năng nhắm mục tiêu theo vị trí m���i nhận thấy chi phí trên mỗi kết quả giảm 6,7%.

Để biết thêm thông tin, vui lòng nhấp vào đây.

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

Thay thế các điểm cuối Người dùng Instagram, File phương tiện trên Instagram, Bài viết quay vòng trên Instagram và Bình luận trên Instagram bằng các điểm cuối Người dùng IG, File phương tiện trên IG và Bình luận trên IG

Chúng tôi đang thực hiện các thay đổi đối với API Đồ thị trên Instagram và API Marketing để giúp các nhà phát triển dễ dàng xây dựng giải pháp cho doanh nghiệp hơn. Với những thay đổi này, chúng tôi sẽ ngừng sử dụng các đối tượng Người dùng Instagram, File phương tiện trên Instagram, Bài viết quay vòng trên Instagram và Bình luận trên Instagram trong API Đồ thị phiên bản 22 mà thay vào đó là Người dùng IG, File phương tiện trên IG hiện có bao gồm các đối tượng bài viết quay vòng và Bình luận trên IG. Chúng tôi cũng đã thêm chức năng vào các đối tượng mới hơn này để mang đến sự tương đồng cho hầu hết các trường hợp sử dụng.

Các nhà phát triển sẽ có thời gian đến ngày 21/01/2026 để cập nhật việc sử dụng các điểm cuối API Marketing bị ảnh hưởng và đến ngày 21/04/2025 để cập nhật việc sử dụng các điểm cuối API Đồ thị bị ảnh hưởng. Nếu đang tự động cập nhật phiên bản API Đồ thị trong các lệnh gọi API của mình, bạn nên xem xét những thay đổi này vì sẽ được áp dụng ngay cho các nhà phát triển sử dụng API Đồ thị phiên bản 22.

Xem blog nhà phát triển để biết thêm chi tiết về thay đổi này, bao gồm các điểm cuối nào sẽ thay đổi, các trường hợp sử dụng nào không còn được hỗ trợ và thời gian áp dụng.

Gỡ các lựa chọn loại trừ Nhắm mục tiêu chi tiết

Là một phần trong nỗ lực không ngừng nhằm giúp nhà quảng cáo thúc đẩy hiệu quả, chúng tôi sẽ gỡ các lựa chọn loại trừ Nhắm mục tiêu chi tiết. Trong quá trình này, chúng tôi sẽ tiếp tục hỗ trợ khả năng loại trừ công ty của bạn trong phần Kiểm soát đối tượng ở cấp độ tài khoản. Để biết thêm thông tin về quyền kiểm soát tài khoản, vui lòng xem tại đây.

Chúng tôi cho rằng thay đổi này sẽ góp phần cải thiện hiệu quả chiến dịch. Một thử nghiệm nhà quảng cáo cho thấy Chi phí trung bình trên mỗi lượt chuyển đổi giảm 22,6% khi không dùng lựa chọn Loại trừ nhắm mục tiêu chi tiết, so với khi có dùng các lựa chọn này.

Do thay đổi này, các đối tượng tùy chỉnh sẽ không còn dùng được trong trường loại trừ. Bạn vẫn có thể tiếp tục sử dụng các lựa chọn loại trừ đối tượng tùy chỉnh bằng cách sử dụng trường excluded_custom_audiences.

Kể từ ngày 21/01/2025, nhà phát triển có thể bắt đầu triển khai các thay đổi về mã và sẽ có thời gian đến ngày 21/04/2025 để thực hiện các cập nhật này. Thay đổi này sẽ được phát hành trong phiên bản 22. Vui lòng tham khảo blog nhà phát triển để biết danh sách các điểm cuối bị ảnh hưởng liên quan đến thay đổi này.

Ngừng hỗ trợ Gói điểm cải thiện tiêu chuẩn từ API Marketing

Tác động của API Marketing phiên bản 22.0 đến điểm cải thiện nội dung Advantage+

Trong phiên bản API Marketing mới này, chúng tôi sẽ ngừng sử dụng gói Điểm cải thiện tiêu chuẩn về nội dung Advantage+ và thay bằng lựa chọn sử dụng các điểm cải thiện nội dung riêng lẻ. Bạn có thể tìm hiểu thêm về Nội dung Advantage+ tại đây.

Tại đây, bạn có thể tìm hiểu thêm thông tin liên quan đến cộng đồng nhà phát triển và các chi tiết bổ sung có thể được tìm thấy trong tài liệu dành cho nhà phát triển của chúng tôi tại đây.

Điểm cải thiện tiêu chuẩn sẽ không còn được hỗ trợ với các điểm cuối này:

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

Giới thiệu số liệu về lượt xem trên Instagram và ngừng sử dụng số liệu về lượt hiển thị và lượt phát

Để tiếp tục điều chỉnh chức năng của API Instagram cho phù hợp với chức năng của ứng dụng Instagram, chúng tôi giới thiệu số liệu về lượt xem trên tất cả các phiên bản API cho cả thông tin chi tiết về file phương tiện lẫn người dùng. Đối với thông tin chi tiết về file phương tiện, đối tượng Bảng feed, Tin và Reels sẽ trả về lượt xem. Đối với thông tin chi tiết về người dùng, API sẽ hỗ trợ số liệu về lượt xem với số liệu chia nhỏ đa chiều về loại người theo dõi và loại sản phẩm file phương tiện.

Ngoài ra, các số liệu sau sẽ không được dùng nữa kể từ phiên bản 22:

• lượt phát (thông tin chi tiết về file phương tiện): Số lần thước phim bắt đầu phát sau khi hệ thống đã tính lượt hiển thị.
• clips_replays_count (thông tin chi tiết về file phương tiện): Số lần thước phim bắt đầu phát lại sau lần phát đầu tiên. Hệ thống xác định đây là những lượt phát lại trong tối thiểu 1 mili giây thuộc cùng một phiên phát thước phim.
• ig_reels_aggregated_all_plays_count (thông tin chi tiết về file phương tiện): Số lần thước phim bắt đầu phát hoặc phát lại sau khi hệ thống đã tính lượt hiển thị.
• lượt hiển thị (thông tin chi tiết về file phương tiện & người dùng): Tổng số lượt xem đối tượng File phương tiện trên Instagram.

Số liệu về lượt hiển thị trong thông tin chi tiết về file phương tiện sẽ chỉ dừng hoạt động đối với file phương tiện được tạo vào hoặc sau ngày 02/07/2024. Đối với file phương tiện được tạo trước ngày này, API sẽ tiếp tục trả về các giá trị như bình thường trên tất cả các phiên bản.

Bạn có thể tìm thêm thông tin trong tài liệu dành cho nhà phát triển về Thông tin chi tiết về người dùng Instagram và Thông tin chi tiết về file phương tiện trên Instagram. Vui lòng khuyến khích nhà phát triển của bạn cập nhật chậm nhất vào ngày 21/04/2025 để tránh xảy ra sự cố.

Meta Business SDK

Bản phát hành Meta Business SDK phiên bản 22

Bản phát hành Meta Business SDK phiên bản 22 sẽ được phát hành ngay sau khi ra mắt Đồ thị API phiên bản 22. Bản phát hành này sẽ bao gồm các bản sửa lỗi, nâng cấp phần phụ thuộc, tính năng mới và quan trọng nhất là giao diện API được cập nhật để phù hợp với API Đồ thị phiên bản 22.

Theo lịch ngừng hoạt động sau 2 năm của SDK Nền tảng, vui lòng lưu ý các SDK sắp ngừng hoạt động và ngừng cung cấp sau đây:

• Tháng 5/2025: SDK Nền tảng Facebook phiên bản 17.0 trở xuống sẽ ngừng hoạt động.

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

Theo lịch lập 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ị

• 14/05/2025: API Đồ thị phiên bản 16 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 12/09/2025: API Đồ thị phiên bản 17 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

API Marketing

• 04/02/2025: API Marketing phiên bản 19.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 06/05/2025: API Marketing 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.