Introducing Facebook Graph API v11.0 and Marketing API v11.0

Hôm nay, chúng tôi sẽ phát hành API Đồ thị phiên bản 11.0 và API Marketing phiên bản 11.0 của Facebook. Trong lần phát hành này, chúng tôi đã tạo bài viết trên blog để nêu bật các thay đổi trên phạm vi rộng sẽ tác động đến một phần cộng đồng nhà phát triển của chúng tôi. Những thay đổi này bao gồm thông báo và cập nhật về sản phẩm, lời nhắc từ các đợt ra mắt sản phẩm trước, cũng như thông báo về việc ngừng hoạt động trên quy mô lớn có thể tác động đến quá trình tích hợp ứng dụng của bạn 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.

Thông báo chung và thông tin mới

Mở rộng mô hình cấp độ truy cập API Đồ thị ra các ứng dụng dành cho người tiêu dùng

Vào ngày 06/05/2021, Facebook đã bắt đầu mở rộng chức năng cấp độ truy cập ứng dụng được giới thiệu trong API Đồ thị phiên bản 8.0 ra các ứng dụng dành cho người tiêu dùng. Đợt triển khai này sẽ kết thúc vào cuối tháng 6/đầu tháng 7. Mô hình này giúp đơn giản hóa quá trình thử nghiệm quyền và tính năng mới, vì bất kỳ ai có vai trò trên ứng dụng đều có thể cấp cho ứng dụng các quyền hoặc tính năng chưa được phê duyệt mà không cần phải chuyển sang chế độ Phát triển hoặc không phải sử dụng ứng dụng thử nghiệm.

Chức năng này sẽ có trên tất cả các ứng dụng dành cho người tiêu dùng mới tạo trong những tuần sắp tới. Lưu ý rằng trong quá trình thay đổi này, bạn phải đặt các ứng dụng mới dành cho người tiêu dùng thành Chế độ chính thức và quyền public_profile thành Quyền truy cập nâng cao trước khi những người dùng không có vai trò trên ứng dụng có thể xác thực thông qua phương thức Đăng nhập bằng Facebook. Các quyền public_profile và email tự động được phê duyệt cho Quyền truy cập nâng cao nhưng được đặt thành Quyền truy cập tiêu chuẩn theo mặc định.

Vui lòng tham khảo tài liệu về cấp độ truy cập dành cho nhà phát triển của chúng tôi để tìm hiểu thêm về mức tác động của cấp độ truy cập đến các ứng dụng dành cho người tiêu dùng.

Bổ sung ASID Instagram và Lập phiên bản nền tảng

Kể từ ngày 08/06/2021, API Instagram Basic Display sẽ hỗ trợ quy trình lập phiên bản. Giờ đây, bạn có thể thực hiện các lệnh gọi được lập phiên bản trên tất cả điểm cuối "graph.instagram.com" sử dụng giao thức yêu cầu được lập phiên bản giống với API Đồ thị của Facebook.

Ngoài ra, trong đợt phát hành này, Instagram sẽ giới thiệu ID người dùng trong ứng dụng (ASID). Đây là ID người dùng dành riêng cho mỗi cặp ứng dụng và người dùng.

Tính năng Đọc oEmbed mới và Xét duyệt ứng dụng

Kể từ ngày 08/06/2021, chúng tôi đã thay thế sản phẩm oEmbed bằng tính năng Đọc oEmbed mới. Các nhà phát triển đã triển khai Facebook oEmbed hoặc Instagram oEmbed phải được phê duyệt thông qua quy trình Xét duyệt ứng dụng cho tính năng Đọc oEmbed mới trước ngày 07/09/2021, nếu không tiện ích tích hợp oEmbed của họ sẽ bị thu hồi. Các ứng dụng mới cần quyền truy cập có thể gửi đi xét duyệt trong quá trình tạo ứng dụng hoặc bất kỳ thời điểm nào sau đó.

Xóa đối tượng

Các thay đổi đối với API Xóa đối tượng

Trong nỗ lực không ngừng của Facebook nhằm cải thiện cách nhà quảng cáo tạo và quản lý đối tượng của họ, Đối tượng tùy chỉnh (ngoại trừ Đối tượng tùy chỉnh từ danh sách khách hàng), Đối tượng tương tự hoặc đối tượng đã lưu không được sử dụng trong các nhóm quảng cáo đang hoạt động trong hơn 2 năm sẽ tự động bị xóa.

Đối với Đối tượng tùy chỉnh từ danh sách khách hàng, Facebook sẽ tiếp tục lưu trữ và xóa những đối tượng này theo hướng dẫn của nhà quảng cáo. Nếu nhà quảng cáo chọn không sử dụng một đối tượng được gắn thẻ là “Đối tượng hết hạn” trong khung thời gian đã phân bổ, Facebook sẽ xem đây là hướng dẫn xóa đối tượng.

Ngoài ra, từ giờ trở đi, mọi Đối tượng tùy chỉnh (ngoại trừ Đối tượng tùy chỉnh từ danh sách khách hàng), Đối tượng tương tự hoặc đối tượng đã lưu không được sử dụng trong nhóm quảng cáo đang hoạt động trong hơn 2 năm sẽ tự động được gắn thẻ là “Đối tượng hết hạn”, đồng thời sẽ tự động bị xóa sau 90 ngày kể từ khi xác định là đối tượng hết hạn.

Thay đổi sau sẽ được triển khai:

• Kể từ ngày 08/06/2021, đối với các nhà quảng cáo sử dụng API Marketing (bao gồm những nhà quảng cáo sử dụng cả API Marketing và giao diện người dùng Facebook để quản lý quảng cáo). Thay đổi này sẽ tác động đến tất cả các phiên bản API hiện có. Kể từ ngày 06/09/2021, các đối tượng bị ảnh hưởng sẽ tự động bị xóa trừ khi nhà quảng cáo thực hiện hành động để sử dụng đối tượng bị gắn cờ.
• Bắt đầu vào ngày 13/05/2021, đối với nhà quảng cáo KHÔNG sử dụng API Marketing để quản lý quảng cáo. Kể từ ngày 27/06/2021, các đối tượng bị ảnh hưởng sẽ tự động bị xóa trừ khi nhà quảng cáo thực hiện hành động để sử dụng đối tượng bị gắn cờ.

Xóa đối tượng dựa trên Trang Facebook đã bị xóa

Trong nỗ lực không ngừng nhằm cải thiện cách nhà quảng cáo tạo và quản lý các đối tượng của họ, chúng tôi đang tiến hành cập nhật. Điểm cập nhật này sẽ ảnh hưởng đến Đối tượng tùy chỉnh tương tác, Đối tượng tương tự được liên kết và đối tượng đã lưu được tạo từ trang Facebook đã bị xóa. Theo dự kiến, hầu hết các nhà quảng cáo sẽ chỉ bị ảnh hưởng ở mức tối thiểu.

Kể từ ngày 08/09/2021, đối với nhà quảng cáo sử dụng API Marketing: Đối tượng tùy chỉnh tương tác (trang, video, mẫu tìm kiếm khách hàng tiềm năng, sự kiện, trải nghiệm tức thì, mua sắm), Đối tượng tương tự được liên kết và đối tượng đã lưu được tạo thông qua một trang Facebook đã bị xóa sẽ được đánh dấu bằng “trạng thái cảnh báo” với khoảng thời gian ân hạn là 30 ngày trước khi tự động bị xóa. Các chiến dịch mới có thể tiếp tục được tạo và lên lịch cho đến ngày chấm dứt này.

Ngoài ra, từ giờ trở đi, sau ngày 08/09/2021, các nhà quảng cáo sẽ không thể tạo những loại Đối tượng tùy chỉnh tương tác này hoặc Đối tượng tương tự từ trang Facebook đã bị xóa.

Phát hành SDK Nền tảng Facebook phiên bản 11.0

Kể từ ngày 08/06/2021, Facebook sẽ phát hành SDK Nền tảng phiên bản 11.0. Với bản phát hành này, chúng tôi sẽ ngừng sử dụng phiên bản 9.0 và giới thiệu một số điểm cập nhật tính năng. Vui lòng xem Nhật ký thay đổi iOS SDK, Nhật ký thay đổi Android SDK và Nhật ký thay đổi Unity SDK để tìm hiểu về các thay đổi quan trọng sắp tới đối với những SDK này. Ngoài ra, Facebook đã đăng một bài viết riêng để nêu bật những điểm cập nhật này.

Thông báo và điểm cập nhật dành cho điểm cuối

Chỉ định các trường hợp sử dụng được phép đối với user_likes và user_posts

Kể từ ngày 08/06/2021, trong nỗ lực nhằm giảm rủi ro đối với nền tảng, chúng tôi sẽ chỉ định thêm các trường hợp sử dụng được phép cho cả user_likes và user_posts. Nếu ứng dụng hiện có quyền truy cập vào user_likes và/hoặc user_posts và trường hợp sử dụng của bạn không phù hợp với (các) trường hợp sử dụng được phép đã cập nhật, bạn sẽ phải thực hiện mọi thay đổi cần thiết đối với ứng dụng trước ngày 06/09/2021, vì ứng dụng không đủ điều kiện sử dụng một hoặc nhiều quyền đó nữa. Kể từ ngày 06/09/2021, các ứng dụng có quyền sử dụng những quyền không thuộc trường hợp sử dụng được phép mới sẽ phải chịu hành động thực thi.

Nếu bạn không biết chắc trường hợp sử dụng của mình có phù hợp với những điểm cập nhật này hay không, vui lòng chủ động gửi đi Xét duyệt ứng dụng trước ngày 06/09/2021. Những ứng dụng có trường hợp sử dụng phù hợp với (các) trường hợp sử dụng được phép đã cập nhật sẽ không bị ảnh hưởng bởi thay đổi này.

Các sửa đổi đối với điểm cuối danh mục và nhóm sản phẩm

Kể từ ngày 08/06/2021, đối với API phiên bản 11.0 trở lên, Facebook sẽ triển khai một số thay đổi về cách bạn tương tác với danh mục và nhóm sản phẩm:

• Xóa nhóm sản phẩm mặc định sẽ không cho phép xóa các nhóm sản phẩm không trống theo mặc định. Các nhóm sản phẩm không trống có thể bị xóa bằng cách áp dụng deletion_method=delete_items cho yêu cầu xóa. Thao tác này sẽ xóa cả nhóm sản phẩm và các mặt hàng trong nhóm đó.
• Thay đổi đối với hoạt động xóa danh mục mặc định sẽ không hỗ trợ xóa danh mục sản phẩm theo mặc định nếu danh mục đó có các nhóm sản phẩm chính thức. Nhóm sản phẩm chính thức được phân loại là được sử dụng tích cực (ví dụ: chiến dịch quảng cáo, khuyến mãi và Cửa hàng đã đăng).
• Thêm điểm cuối chẩn đoán danh mục được dùng để truy xuất dữ liệu chẩn đoán cho một danh mục sản phẩm cụ thể. Điểm cuối này có thể giúp xác định các sự cố như sản phẩm không hiển thị trong kênh hoặc không hiển thị những cơ hội có thể cải thiện khả năng khám phá sản phẩm.

Thay đổi đối với trường danh sách cung ứng

Kể từ ngày 08/06/2021, đối với API phiên bản 11.0 trở lên, để giảm thiểu sự không nhất quán giữa các giao diện và tránh gây nhầm lẫn về tình trạng còn hàng và danh mục cung ứng, Facebook sẽ thêm trường quantity_to_sell_on_facebook thay cho trường danh sách cung ứng.

Số lượng được hiển thị theo trường mới này sẽ không giảm theo danh sách cung ứng đặt trước, được định nghĩa là danh sách cung ứng đặt trước tạm thời khi người mua thêm một mặt hàng vào giỏ hàng. Chúng tôi sẽ tiếp tục hỗ trợ trường "danh sách cung ứng" trong thời gian trước mắt. Tuy nhiên, bạn nên sử dụng trường "quantity_to_sell_on_facebook" mới.

Lời nhắc Không cần thực hiện hành động nào

Trải nghiệm Trang mới

Vào ngày 02/10/2020, Facebook công bố trải nghiệm Trang mới là cách để người của công chúng, doanh nghiệp và những ai muốn xây dựng và kết nối với đối tượng có thể quản lý sự hiện diện của mình trên Facebook vì mục đích công việc. Tất cả các Trang truyền thống đang được chuyển sang trải nghiệm Trang mới trong quá trình triển khai dần. Chúng tôi sẽ hoàn thành việc triển khai trong vòng vài tháng tới và Trang truyền thống sẽ ngừng hoạt động.

Vui lòng xem tài liệu dành cho nhà phát triển để tìm hiểu cách xác định xem Trang đã được chuyển đổi chưa và truy cập Trung tâm trợ giúp nếu có câu hỏi.

Cập nhật tính năng trạng thái trực tiếp của nền tảng

Vào ngày 01/06/2021, Facebook đã cho ra mắt trang Trạng thái trực tiếp của nền tảng để nâng cao tính minh bạch và tăng cường chủ động giao tiếp với nhà phát triển bên ngoài bằng các sản phẩm nền tảng của Facebook. Trang Trạng thái Facebook for Business mới này sẽ đóng vai trò là một vị trí để kiểm tra tình trạng máy chủ cho các sản phẩm nền tảng và sản phẩm kinh doanh do Facebook cung cấp, bao gồm Quảng cáo, API WhatsApp Business, Nền tảng dành cho nhà phát triển của Facebook, v.v.

Ngừng hoạt động

Công cụ Phân tích trên Facebook ngừng hoạt động

Theo như thông báo ban đầu vào ngày 30/03/2021, Facebook đang trong quá trình ngừng cung cấp công cụ Phân tích trên Facebook (FBA). Sau ngày 30/06/2021, công cụ Phân tích trên Facebook sẽ không hoạt động nữa. Ngoài ra, chúng tôi sẽ ngừng cung cấp Plugin Bảng điều khiển cho API Marketing.

Mặc dù công cụ Phân tích trên Facebook riêng lẻ sắp ngừng hoạt động, nhưng các giải pháp thay thế sau vẫn hoạt động:

• Trình quản lý sự kiện
• Trình quản lý quảng cáo
• Thông tin chi tiết Trang
• Thông tin chi tiết trên Instagram
• Thông tin chi tiết trên Facebook Business Suite

Nền tảng Messenger - Mẫu dành cho hàng không ngừng hoạt động

Kể từ ngày 08/06/2021, API Đồ thị phiên bản 11.0 trở lên sẽ không hỗ trợ tính năng gửi Mẫu dành cho hàng không của doanh nghiệp nữa. Các phiên bản trước của API Đồ thị (phiên bản 10.0 trở xuống) sẽ ngừng hoạt động sau 6 tháng kể từ khi có thông báo về thay đổi này vào ngày 06/12/2021.

Các doanh nghiệp nên gửi thẻ lên máy bay và mẫu làm thủ tục dưới dạng hình ảnh, phù hợp với cách các công ty thường gửi những thông báo này trên các kênh khác.

Điểm cuối ưu đãi trong quảng cáo tự nhiên ngừng hoạt động

Kể từ ngày 08/06/2021, nếu đang sử dụng API Quảng cáo ưu đãi, bạn nên sử dụng Quảng cáo trên Facebook để xây dựng chương trình khuyến mãi và chiết khấu. Các điểm cuối API Quảng cáo ưu đãi sẽ ngừng hoạt động sau khi chúng tôi phát hành API Đồ thị và API Marketing phiên bản 12.0 vào mùa thu. Mặc dù không chính thức ngừng cung cấp điểm cuối khi ra mắt phiên bản 11.0, nhưng chúng tôi sẽ bắt đầu chuyển đổi dịch vụ hỗ trợ và có thể dẫn đến trải nghiệm dưới mức tối ưu nếu bạn tiếp tục sử dụng điểm cuối này.

Quyền truy cập nội dung công khai trên Trang - Nút bình luận ngừng hoạt động

Kể từ ngày 08/06/2021, đối với API Đồ thị phiên bản 11.0 trở lên, trường “id” cho tất cả các bình luận được trả về trong yêu cầu bằng tính năng Quyền truy cập nội dung công khai trên Trang sẽ bị gỡ. Lưu ý: các yêu cầu lồng ghép vẫn sẽ được hỗ trợ cho những đối tượng này.

Thay đổi này sẽ áp dụng cho tất cả các phiên bản API khác đang hoạt động (phiên bản 10.0 trở xuống) vào ngày 06/09/2021.

Quyền truy cập nội dung công khai trên Trang - Nút bình luận ngừng hoạt động

Kể từ ngày 08/06/2021, quyền truy cập vào các điểm cuối sau sẽ tạm thời bị giới hạn ở những ứng dụng đã truy vấn điểm cuối trong vòng 30 ngày qua:

• gr:post:Business/client_adaccounts
• gr:post:AdAccount/agencies
• gr:post:BusinessRequest

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

Trong khuôn khổ API Đồ thị và API Marketing của Facebook, hãy lưu ý các phiên bản sắp ngừng hoạt động sau:

• Ngày 03/08/2021: API Đồ thị phiên bản 3.3 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 25/08/2021: API Marketing phiên bản 9.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 04/10/2021: API Marketing phiên bản 10.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 02/11/2021: API Đồ thị phiên bản 4.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 03/02/2022: API Đồ thị phiên bản 5.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 được ra mắt hiện nay.

Lịch biểu mục hành động

Thông báo chung và thông tin mới

• Ngày 12/05/2021: Các thay đổi đối với giao diện người dùng Thu hồi đối tượng (Nhà quảng cáo KHÔNG sử dụng API Marketing)
• Triển khai:
  • Mở rộng cấp độ truy cập API Đồ thị ra các ứng dụng dành cho người tiêu dùng dự kiến hoàn thành vào cuối tháng 6/đầu tháng 7
• Ngày 08/06/2021:
  • Bổ sung ASID Instagram và Lập phiên bản nền tảng
  • Bổ sung tính năng oEmbed có thể xét duyệt trong quy trình Xét duyệt ứng dụng
  • Các thay đổi đối với API Thu hồi đối tượng
  • Phát hành SDK Nền tảng Facebook phiên bản 11.0
• Ngày 02/11/2021: Hạn chót yêu cầu xóa dữ liệu

Thông báo và điểm cập nhật dành cho điểm cuối

• Ngày 08/06/2021:
  • Thông số bổ sung về trường hợp sử dụng được phép đối với user_likes và user_posts
  • Ra mắt các sửa đổi đối với điểm cuối danh mục và nhóm sản phẩm
    • Xóa nhóm sản phẩm mặc định sẽ không cho phép xóa các nhóm sản phẩm không trống theo mặc định
    • Thay đổi đối với việc xóa danh mục mặc định sẽ không hỗ trợ xóa danh mục sản phẩm theo mặc định nếu danh mục đó có các nhóm sản phẩm chính thức
    • Thêm điểm cuối chẩn đoán danh mục được dùng để truy xuất dữ liệu chẩn đoán cho một danh mục cụ thể
  • Thay thế "Inventory Field" bằng trường "quantity_to_sell_on_facebook" cho API phiên bản 11.0 trở lên
• Ngày 10/11/2022: Hạn chót yêu cầu xóa dữ liệu

Lời nhắc, Không cần thực hiện hành động nào

• Triển khai:
  • Bắt đầu từ ngày 02/10/2020: Trải nghiệm Trang mới được công bố là cách để người của công chúng, doanh nghiệp và những ai muốn xây dựng và kết nối với đối tượng có thể quản lý sự hiện diện của mình trên Facebook vì mục đích công việc.
• Ngày 01/06/2021: Ra mắt điểm cập nhật tính năng Trạng thái trực tiếp của nền tảng

Các tính năng chung ngừng hoạt động

• Ngày 08/06/2021:
  • Facebook Platform SDK phiên bản 11.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • Nền tảng Messenger - Mẫu dành cho hàng không sẽ ngừng hoạt động và bị gỡ khỏi nền tảng đối với phiên bản 11.0 trở lên
  • Quyền truy cập nội dung công khai trên Trang - Nút bình luận sẽ ngừng hoạt động và bị gỡ khỏi nền tảng đối với phiên bản 11.0 trở lên
  • Các hạn chế tạm thời đối với điểm cuối kinh doanh sẽ có hiệu lực
• Ngày 30/06/2021: Công cụ Phân tích trên Facebook sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 06/09/2021: Quyền truy cập nội dung công khai trên Trang - Nút bình luận sẽ ngừng hoạt động và bị gỡ khỏi nền tảng đối với phiên bản 10.0 trở xuống
• Ngày 08/06/2021: Điểm cuối ưu đãi trong quảng cáo tự nhiên ngừng hoạt động
• Mùa thu năm 2021: Điểm cuối ưu đãi trong quảng cáo tự nhiên ngừng hoạt động
• Ngày 06/12/2021: Nền tảng Messenger - Mẫu dành cho hàng không sẽ ngừng hoạt động và bị gỡ khỏi nền tảng đối với phiên bản 10.0 trở xuống

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

Trong khuôn khổ lịch biểu lập phiên bản API Marketing của chúng tôi, hãy lưu ý những phiên bản API Marketing sắp ngừng hoạt động sau:

• Ngày 25/08/2021: API Marketing phiên bản 9.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 04/10/2021: API Marketing phiên bản 10.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 Marketing mới nhất được ra mắt hiện nay. (Hãy xem nhật ký thay đổi để biết thêm thông tin chi tiết).

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

Trong khuôn khổ lịch biểu lập phiên bản API Đồ thị của chúng tôi, hãy lưu ý những phiên bản API Đồ thị sắp ngừng hoạt động trong danh sách bên dưới:

• Ngày 03/08/2021: API Đồ thị phiên bản 3.3 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 02/11/2021: API Đồ thị phiên bản 4.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• Ngày 03/02/2022: API Đồ thị phiên bản 5.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng