Quay lại phần Tin tức dành cho nhà phát triển

Giới thiệu API Đồ thị v17.0 và API Marketing v17.0 của Facebook

23 tháng 5, 2023Tác giảAyyad Farah

Hôm nay, chúng tôi sẽ phát hành API Đồ thị v17.0 và API Marketing v17.0 của Facebook. 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 thông báo, phần cập nhật về sản phẩm cũng như thông báo về sản phẩm ngừng hoạt động mà chúng tôi cho là có liên quan đến quá trình tích hợp (các) ứ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.

Sản phẩm ngừng hoạt động và những thay đổi quan trọng

Ngừng sử dụng Chiến lược quảng cáo

Sản phẩm Chiến lược quảng cáo (beta) đã ngừng hoạt động kể từ ngày 28/10/2022. Do đó, chúng tôi sẽ ngừng sử dụng các trường ad_strategy_id và ad_strategy_group_id trên điểm cuối chiến dịch khi phát hành API Marketing v17.0.

Ngừng sử dụng API Chuyển đổi offline

Kể từ tháng 02/2023, API Chuyển đổi hỗ trợ đầy đủ sự kiện offline, đảm bảo điểm cuối API Chuyển đổi offline hiện tại cung cấp các tính năng tương đương. Bằng việc hợp nhất các API sự kiện trên web và sự kiện offline thành một API duy nhất, chúng tôi hy vọng sẽ đơn giản hóa và cải thiện cách nhà quảng cáo sử dụng dữ liệu marketing đa kênh của họ để tăng cường khả năng tối ưu hóa quảng cáo, đối tượng tùy chỉnh và đo lường.

Kể từ API Đồ thị phiên bản 17 trở đi (phát hành ngày 23/05/2023), API Chuyển đổi offline sẽ không hỗ trợ sự kiện offline nữa. Các nhà quảng cáo có tiện ích tích hợp API Chuyển đổi offline nên chuyển đổi sang tiện ích tích hợp API Chuyển đổi và không cập nhật API Chuyển đổi offline cho đến khi họ chuyển đổi thành công.

Ngừng sử dụng quy trình tạo mục tiêu cũ

Như thông báo vào tháng 12/2021, chúng tôi đã thiết kế lại trải nghiệm lựa chọn mục tiêu khi tạo chiến dịch mới nhằm hướng dẫn nhà quảng cáo thiết lập chiến dịch một cách hiệu quả, từ đó giúp họ đạt được các mục tiêu marketing tốt hơn. Trải nghiệm mới mang tên Trải nghiệm quảng cáo dựa trên kết quả dẫn đến những thay đổi đối với API Marketing.

Chúng tôi sẽ bắt đầu quá trình ngừng sử dụng trải nghiệm và mục tiêu cũ, khởi đầu bằng việc phát hành API Marketing v17.0. Khi sử dụng API Marketing v17.0, bạn chỉ có thể tạo chiến dịch có mục tiêu là Trải nghiệm quảng cáo dựa trên kết quả và API của các mục tiêu cũ sẽ không dùng được nữa. Chiến dịch cũ hiện tại và bản sao của chiến dịch cũ hiện tại sẽ vẫn được hỗ trợ và không bị ảnh hưởng trong phiên bản này. Bạn có thể xem thêm chi tiết trong bài viết trên blog dành cho nhà phát triển mà chúng tôi đăng gần đây.

Yêu cầu trường điểm cải thiện tiêu chuẩn về nội dung Advantage+

Đầu năm nay, chúng tôi đã phát hành điểm cải thiện tiêu chuẩn về nội dung Advantage+ trên API Marketing. Kể từ ngày 23/05/2023, người dùng API Marketing sẽ phải đăng ký áp dụng các điểm cải thiện tiêu chuẩn về nội dung Advantage+ cho quảng cáo bằng cách nhập "OPT_IN" hoặc "OPT_OUT" trong trường "enroll_status". Nếu trường này để trống, người dùng sẽ gặp lỗi và được đưa đến nơi hoàn thành trường này. Để tìm hiểu thêm về điểm cải thiện tiêu chuẩn liên quan đến nội dung Advantage+ trên API Marketing, vui lòng xem bài viết trên blog dành cho nhà phát triển này.

Các điểm cuối sau đây sẽ bị ảnh hưởng

  • POST /{ad-account-id}/adcreatives
  • POST /{ad-account-id}/ads

Ngừng sử dụng Quảng cáo danh mục Advantage+ cho nội dung phát trực tuyến

Khi phát hành API Marketing v17, chúng tôi sẽ ngừng sử dụng danh mục Quảng cáo danh mục Advantage+ cho nội dung phát trực tuyến (A+CA cho nội dung phát trực tuyến). Quảng cáo Danh mục thương mại là lựa chọn thay thế được đề xuất đối với A+CA cho nội dung phát trực tuyến. Đây là hướng dẫn thiết lập Danh mục thương mại. Các điểm cuối dưới đây sẽ ngừng hoạt động:

  • Tạo danh mục A+CA cho nội dung phát trực tuyến: Cạnh owned_product_catalogs có media_titles dọc
  • Tải lên nguồn cấp dữ liệu tên file phương tiện: Cạnh product_feeds của danh mục A+CA cho nội dung phát trực tuyến
  • Tạo mục tên file phương tiện: Cạnh media_titles của danh mục A+CA cho nội dung phát trực tuyến
  • Tạo chiến dịch bằng danh mục A+CA cho nội dung phát trực tuyến: Cạnh campaigns có danh mục DAS trên L3, L2, hoặc L1

Từ ngày 21/08/2023, những thay đổi trên sẽ áp dụng cho tất cả phiên bản API Marketing, đồng thời chúng tôi sẽ tạm dừng mọi chiến dịch đính kèm danh mục A+CA cho nội dung phát trực tuyến ở cấp độ L3, L2 hoặc L1.

Ngừng sử dụng API Bài viết tức thì

Do sản phẩm Bài viết tức thì đã ngừng hoạt động kể từ ngày 20/04/2023 nên giờ đây, API cho phép nhà phát hành quản lý bài viết tức thì của họ sẽ không dùng được nữa.

Thực thi quyền quản lý doanh nghiệp trên tài khoản người dùng

Trước đây, các trang khác do doanh nghiệp quản lý được trả về mà không cần quyền sử dụng quyền business_management. Kể từ ngày 23/05/2023, nếu muốn tiếp tục nhận được quyền truy cập vào các trang do doanh nghiệp quản lý, bạn sẽ phải có quyền business_management. Bạn có thể tham khảo trang business_management để biết thêm chi tiết liên quan đến quyền này.

Phiên bản API ngừng hoạt động:

Theo lịch lập phiên bản API Đồ thị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ị

  • 08/06/2023: API Đồ thị v10.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • 14/09/2023: API Đồ thị v11.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • 08/02/2024: API Đồ thị v12.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

API Marketing

  • 15/08/2023: API Marketing v14.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • 15/08/2023: API Marketing v15.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.

SDK Nền tảng Facebook

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:

  • 06/2023: SDK Nền tảng Facebook v9.0 trở xuống sẽ ngừng hoạt động
  • 10/2023: SDK Nền tảng Facebook v11.0 trở xuống sẽ ngừng hoạt động
  • 02/2024: SDK Nền tảng Facebook v12.0 trở xuống sẽ ngừng hoạt động