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

Giới thiệu API Đồ thị phiên bản 15.0 và API Marketing phiên bản 15.0 của Facebook

15 tháng 9, 2022Tác giảAchyuth Venkatesh

Hôm nay, chúng tôi sẽ phát hành API Đồ thị phiên bản 15.0 và API Marketing phiên bản 15.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, nội dung 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.

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

Thông báo và cập nhật chung

Đơn giản hóa tiêu chí tạo chuyển đổi tùy chỉnh

Khi phát hành API Đồ thị phiên bản 15.0, để đơn giản hóa quy trình tạo chiến dịch cho nhà quảng cáo, các chuyển đổi tùy chỉnh mới tạo sẽ yêu cầu ít nhất một quy tắc được liên kết. Những chuyển đổi tùy chỉnh không yêu cầu quy tắc sẽ sử dụng tùy chọn tối ưu hóa sự kiện tùy chỉnh, nhờ đó có thể tối ưu hóa chiến dịch quảng cáo ngay trên sự kiện tùy chỉnh. Chúng tôi đang nỗ lực hết mình để chuyển tiếp các chuyển đổi tùy chỉnh hiện có từ một sản phẩm tổng hợp thành nhiều sản phẩm có giá trị cụ thể để đáp ứng tốt hơn các nhu cầu và trường hợp sử dụng của nhà quảng cáo. Thay đổi này sẽ thúc đẩy nhà quảng cáo chuyển tiếp từ chuyển đổi tùy chỉnh dựa trên sự kiện tùy chỉnh sang tối ưu hóa sự kiện tùy chỉnh.

Nội dung cập nhật Điều khoản về nền tảng

Chúng tôi sẽ cập nhập Điều khoản về nền tảng liên quan đến thời điểm có thể gỡ quyền truy cập của một ứng dụng vào bất kỳ API Nền tảng, quyền hoặc tính năng nào mà ứng dụng của bạn không dùng/truy cập trong một khoảng thời gian nhất định. Kể từ ngày 15/12/2022, theo Điều khoản về nền tảng, ứng dụng của bạn phải hoạt động trong khoảng thời gian 28 ngày thì mới được xem là tồn tại.

Nếu bạn nhận được thông báo rằng ứng dụng không còn hoạt động và bạn muốn khôi phục ứng dụng đó, hãy đăng nhập bằng vai trò quản trị viên ứng dụng rồi khôi phục.

Bạn có thể truy cập trang Điều khoản về nền tảng tại đây để xem trước toàn bộ những thay đổi này.

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

Giới thiệu đối tượng tùy chỉnh Advantage

Kể từ ngày 19/09/2022, chúng tôi sẽ bắt đầu triển khai đối tượng tùy chỉnh Advantage. Đối tượng tùy chỉnh Advantage sử dụng đối tượng tùy chỉnh của nhà quảng cáo để định hướng phân phối và góp phần tìm thêm những người có khả năng đạt được mục tiêu tối ưu hóa mà họ đặt ra. Tức là chúng tôi sẽ phân phối quảng cáo ngoài Đối tượng tùy chỉnh nếu có khả năng cải thiện hiệu quả. Đối tượng tùy chỉnh Advantage nằm trong bộ sản phẩm Nhắm mục tiêu Advantage, bao gồm nhắm mục tiêu chi tiết Advantage và Đối tượng tương tự Advantage. Sản phẩm Nhắm mục tiêu Advantage của chúng tôi tận dụng hệ thống tự động hóa nâng cao và công nghệ máy học, nhờ đó góp phần cải thiện hiệu quả chiến dịch của nhà quảng cáo mà tốn ít công sức thủ công hơn.

Đối với nhà quảng cáo tận dụng Đối tượng tùy chỉnh, họ sẽ có thể chọn đối tượng tùy chỉnh Advantage. Với đối tượng tùy chỉnh Advantage, nhà quảng cáo sẽ tiếp tục tạo Đối tượng tùy chỉnh (trang web, hoạt động trong ứng dụng, danh sách khách hàng hoặc mức độ tương tác) và áp dụng trường hợp bao gồm/loại trừ phù hợp, đồng thời được hưởng lợi từ hệ thống tự động hóa nâng cao và công nghệ máy học của chúng tôi. Công nghệ này sử dụng đối tượng tùy chỉnh làm nguồn để định hướng phân phối nhằm tiếp cận thêm những người dùng có khả năng đạt được mục tiêu tối ưu hóa mà bạn đặt ra.

Đối tượng tùy chỉnh Advantage sẽ tự động được bật khi bạn tạo chiến dịch mới sử dụng đối tượng tùy chỉnh từ trang web, di động hoặc dựa trên tương tác. Bạn có thể chọn không sử dụng sản phẩm này bằng cách bỏ chọn ô để đánh dấu "Đối tượng tùy chỉnh Advantage" trong phần Đối tượng tùy chỉnh trên công cụ tạo quảng cáo của chúng tôi.

Đối tượng quảng cáo đặc biệt ngừng hoạt động

Theo thỏa thuận của chúng tôi với Bộ Gia cư và Phát triển Đô thị Hoa Kỳ (HUD), chúng tôi sẽ ngừng cung cấp Đối tượng quảng cáo đặc biệt - một công cụ hỗ trợ nhà quảng cáo mở rộng đối tượng cho các nhóm quảng cáo liên quan đến nhà ở, việc làm và tín dụng. Chúng tôi sẽ gỡ khả năng tạo Đối tượng quảng cáo đặc biệt thông qua API Marketing kể từ ngày 15/09/2022.

Đối với nhà quảng cáo và đối tác, việc chặn khả năng tạo Đối tượng quảng cáo đặc biệt mới kể từ thời điểm nêu trên sẽ tạo ra thay đổi quan trọng, vì thay đổi không lập phiên bản này sẽ khiến các giá trị trước không dùng được nữa. Trong năm 2019, ngoài loại bỏ một số tùy chọn nhắm mục tiêu cho quảng cáo nhà ở, việc làm và tín dụng, chúng tôi đã giới thiệu Đối tượng quảng cáo đặc biệt để thay thế cho Đối tượng tương tự. Tuy nhiên, tính công bằng trong công nghệ máy học là một lĩnh vực động và không ngừng thay đổi. Trước đây, Đối tượng quảng cáo đặc biệt chính là cách giải quyết mối lo ngại. Bây giờ, chúng tôi sẽ chú trọng vào các phương pháp mới giúp tăng tính công bằng, bao gồm cả phương pháp đã thông báo trước đây.

Hãy tham khảo danh sách điểm cuối bị ảnh hưởng liên quan đến sản phẩm ngừng hoạt động này ở bên dưới:

Để đọc đối tượng:

  • điểm cuối gr:get:AdAccount/customaudiences
  • trường operation_status

Để tạo nhóm quảng cáo:

  • điểm cuối gr:post:AdAccount/adsets
  • trường subtype

Để chỉnh sửa nhóm quảng cáo:

  • điểm cuối gr:post:AdCampaign
  • trường subtype

Để tạo đối tượng tùy chỉnh:

  • điểm cuối gr:post:AdAccount/customaudiences
  • trường subtype

Để chỉnh sửa đối tượng tùy chỉnh:

  • điểm cuối gr:post:CustomAudience

Vui lòng tham khảo bài viết trước đó trên blogtài liệu dành cho nhà phát triển để biết thêm chi tiết về quy trình hỗ trợ triển khai mã.

Sự tương đương cho tùy chọn nhắm mục tiêu chi tiết Advantage/đối tượng tương tự Advantage

Dự án này mang đến sự tương đương cho tùy chọn Nhắm mục tiêu chi tiết làm Tín hiệu (nhắm mục tiêu chi tiết Advantage) đối với người dùng API sử dụng các nhóm quảng cáo có mục tiêu là Tin nhắn/Lượt cài đặt ứng dụng (sau khi phát hành Trình quản lý quảng cáo). Trước đây, chúng tôi đã ra mắt tùy chọn nhắm mục tiêu chi tiết Advantage cho API đối với nhóm quảng cáo có mục tiêu là Lượt chuyển đổi và mục tiêu tối ưu hóa là Lượt chuyển đổi/Giá trị (nhóm quảng cáo VO/OC).

Hiện tại, khi tạo nhóm quảng cáo thông qua API với mục tiêu là tin nhắn hoặc lượt cài đặt ứng dụng, nhà quảng cáo sẽ chuyển 2 nội dung trong tiêu chí nhắm mục tiêu (L2). Họ chuyển một danh sách dữ liệu đầu vào nhắm mục tiêu chi tiết (ví dụ: cricket, bóng đá, chó, v.v.) và một cờ cho biết liệu họ có muốn mở rộng ra ngoài những dữ liệu đầu vào này không (gọi là nhắm mục tiêu chi tiết Advantage). Nếu cờ này được bật, hệ thống của chúng tôi sẽ phân phối ra ngoài các lựa chọn nhắm mục tiêu chi tiết nếu có khả năng cải thiện hiệu quả. Nếu cờ này bị tắt, hệ thống của chúng tôi sẽ hạn chế phân phối đến danh sách lựa chọn mà nhà quảng cáo cung cấp.

Trong tương lai (sau khi phát hành Trình quản lý quảng cáo), khi nhà quảng cáo tạo chiến dịch mới với mục tiêu là tin nhắn hoặc lượt cài đặt ứng dụng di động, các trường hợp bao gồm nhắm mục tiêu chi tiết sẽ được dùng làm dữ liệu đầu vào (không ràng buộc) để định hướng phân phối quảng cáo. Do đó, chúng tôi sẽ ngừng sử dụng cờ DTE cho các mục tiêu này, đồng thời tùy chọn mở rộng nhắm mục tiêu sẽ trở thành hành vi mặc định của lựa chọn nhắm mục tiêu chi tiết. Khi đó, chúng tôi có thể mở rộng ra ngoài các trường hợp bao gồm nhắm mục tiêu chi tiết nếu có khả năng cải thiện hiệu quả. Mọi lựa chọn nhắm mục tiêu và trường hợp loại trừ khác sẽ không bị ảnh hưởng. Thay đổi này sẽ không áp dụng cho các hạng mục đặc biệt.

Cách thức hoạt động:

Trước đây, nhà quảng cáo sẽ chuyển cờ targeting_optimization cùng với giá trị expansion_all hoặc none để bật/tắt tùy chọn Mở rộng nhắm mục tiêu chi tiết. Khi có thay đổi về mặt ngữ nghĩa đối với cách tùy chọn nhắm mục tiêu chi tiết sẽ hoạt động cho các nhóm quảng cáo này, nhà quảng cáo không cần chuyển cờ này khi tạo nhóm quảng cáo có mục tiêu là tin nhắn hoặc lượt cài đặt ứng dụng, vì thay đổi này sẽ không ảnh hưởng đến nhóm quảng cáo mà họ mới tạo. Tất cả nhóm quảng cáo mới tạo này sẽ luôn sử dụng các trường hợp bao gồm nhắm mục tiêu chi tiết làm tín hiệu đến hệ thống phụ trợ của chúng tôi. Hệ thống này có thể quyết định phân phối quảng cáo ra ngoài những lựa chọn nêu trên nếu có khả năng cải thiệu hiệu quả cho nhà quảng cáo.

Do cờ targeting_optimization sẽ không ảnh hưởng đến các nhóm quảng cáo mới tạo, chúng tôi định ngừng sử dụng trường này cho các chiến dịch mới có mục tiêu là tin nhắn và/hoặc lượt cài đặt ứng dụng trong tương lai.

  • Vì vậy, nếu nhà quảng cáo chuyển cờ targeting_optimization khi tạo nhóm quảng cáo mới có mục tiêu là lượt cài đặt ứng dụng di động/tin nhắn hoặc khi truy vấn thông tin phân phối ước tính của các nhóm quảng cáo mới tạo này, chúng tôi sẽ trả về thông báo lỗi yêu cầu họ không gửi thông số này nữa.
  • Một trường mới có tên targeting_as_signal sẽ được đặt trong hệ thống phụ trợ trong quá trình tạo nhóm quảng mới có mục tiêu là lượt cài đặt ứng dụng/tin nhắn. Trường này chỉ có sẵn trên lệnh GET để giúp nhà quảng cáo xác minh xem nhóm quảng cáo của họ có vượt ra ngoài trường hợp bao gồm nhắm mục tiêu chi tiết không.

LƯU Ý: Những thay đổi nêu trên đối với tùy chọn Nhắm mục tiêu chi tiết làm tín hiệu sẽ chỉ áp dụng cho nhóm quảng cáo mới tạo có mục tiêu là tin nhắn và/hoặc lượt cài đặt ứng dụng.

Điểm cuối API trong phạm vi:

  • gr:post:/act_XXXX/ adsets
  • gr:get:/<adset_id>/delivery_estimate

Tab trên Trang ngừng hoạt động

Chúng tôi xin thông báo rằng tính năng API Tab tùy chỉnh trên Trang sẽ không còn hoạt động thông qua API Đồ thị. Trong quá trình chúng tôi triển khai trải nghiệm Trang mới, một số tính năng API Trang sẽ ngừng hoạt động khi chúng tôi phát triển. Tính năng Tab tùy chỉnh trên Trang sẽ không hoạt động trên trải nghiệm Trang mới. Vì vậy, chúng tôi sẽ ngừng hỗ trợ API cho những tính năng này. Chúng tôi chia sẻ các nội dung cập nhật nêu trên nhằm hỗ trợ nhà phát triển và khách hàng có đủ thời gian thông báo về việc ngừng sử dụng những tính năng này trên (các) trang của họ, đồng thời thực hiện các thay đổi cần thiết đối với trang. Tính năng này sẽ hoàn toàn ngừng hoạt động muộn nhất vào ngày 14/12/2022.

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ị

  • 01/11/2022: API Đồ thị phiên bản 8.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • 23/02/2023: API Đồ thị phiên bản 9.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
  • 08/06/2023: API Đồ thị 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 mới nhất được 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:

  • 01/2023: SDK Nền tảng Facebook phiên bản 8.0 trở xuống sẽ bị ngừng cung cấp
  • 06/2023: SDK Nền tảng Facebook phiên bản 9.0 trở xuống sẽ bị ngừng cung cấp
  • 10/2023: SDK Nền tảng Facebook phiên bản 11.0 trở xuống sẽ bị ngừng cung cấp