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

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

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

Điểm cập nhật chung

Bật tính năng nhắm mục tiêu chi tiết Advantage cho tất cả mục tiêu và phương thức tối ưu hóa chiến dịch

Để tiếp tục hỗ trợ các nhà quảng cáo nâng cao hiệu quả, chúng tôi sẽ mở rộng phạm vi cung cấp sản phẩm nhắm mục tiêu chi tiết Advantage đến tất cả các mục tiêu và phương thức tối ưu hóa chiến dịch.

Nhắm mục tiêu chi tiết Advantage là một phần trong bộ sản phẩm Advantage khai thác công nghệ tự động hóa và máy học tiên tiến để cải thiện hiệu quả chiến dịch của nhà quảng cáo. Cụ thể, nhắm mục tiêu chi tiết Advantage có thể cải thiện hiệu quả chiến dịch bằng cách cho phép hệ thống của chúng tôi tiếp cận nhóm người rộng hơn so với những người được xác định trong các lựa chọn nhắm mục tiêu chi tiết ban đầu của nhà quảng cáo, nếu hệ thống dự đoán việc này có khả năng sẽ cải thiện hiệu quả.

Vào ngày 23/01/2024, chúng tôi sẽ triển khai các thay đổi sau đây cho nhà quảng cáo và đối tác sử dụng API Marketing:

• Các chiến dịch được tối ưu hóa cho lượt hiển thị, lượt xem video, số người tiếp cận, lượt tương tác hoặc độ cải thiện khả năng nhớ đến quảng cáo giờ đây sẽ có tùy chọn tham gia nhắm mục tiêu chi tiết Advantage.
• Các chiến dịch được tối ưu hóa cho khách hàng tiềm năng sẽ tự động áp dụng nhắm mục tiêu chi tiết Advantage, nhưng vẫn có tùy chọn không tham gia.
  • Lưu ý: Tùy chọn tham gia sẽ được bật cho các chiến dịch/nhóm quảng cáo mới và được sao chép. Tuy nhiên, bạn có thể sử dụng nút chuyển này để chọn không tham gia nếu muốn.
• Các chiến dịch được tối ưu hóa cho lượt click vào liên kết hoặc lượt xem trang đích sẽ tự động áp dụng nhắm mục tiêu chi tiết Advantage mà không có tùy chọn không tham gia.

Đối với các nhà quảng cáo và đối tác sử dụng API Marketing, những thay đổi này sẽ tạo ra một thay đổi quan trọng. Kể từ ngày 23/01/2024, nhà phát triển có thể bắt đầu triển khai các thay đổi về mã, thời gian thực hiện cập nhật đến ngày 22/04/2024. Thay đổi này sẽ được ra mắt trong bản phát hành API mới - phiên bản 19.

<Impacted endpoints>

Quảng cáo, nhóm quảng cáo và chiến dịch mới với API Marketing sử dụng mục tiêu ban đầu

Bắt đầu từ API Marketing phiên bản 19.0, bạn không còn có thể tạo quảng cáo, nhóm quảng cáo và chiến dịch mới sử dụng mục tiêu ban đầu (liệt kê bên dưới) thông qua bản sao quảng cáo. Mục tiêu quảng cáo cần được cập nhật để phản ánh các mục tiêu tinh giản của chúng tôi.

Bắt đầu từ API Marketing phiên bản 20, việc tạo quảng cáo và nhóm quảng cáo theo các chiến dịch sử dụng mục tiêu ban đầu sẽ không còn được hỗ trợ. Tuy nhiên, mọi phiên bản API trước phiên bản 20 (chẳng hạn như phiên bản 19, phiên bản 18) vẫn sẽ cho phép chức năng này. Không cần thực hiện hành động ngay lập tức đối với những quảng cáo hiện sử dụng mục tiêu ban đầu.

Mục tiêu ban đầu bị ảnh hưởng

• BRAND_AWARENESS
• CONVERSIONS
• EVENT_RESPONSES
• LEAD_GENERATION
• LINK_CLICKS
• LOCAL_AWARENESS
• MESSAGES
• OFFER_CLAIMS
• PAGE_LIKES
• POST_ENGAGEMENT
• REACH
• STORE_VISITS
• VIDEO_VIEWS

Điểm cuối POST bị ảnh hưởng

• /{ad_id}/copies
• /{campaign_id}/copies
• /{adset_id}/copies

Để tham khảo, đây là bài viết trên blog trước đó của nhà phát triển liên quan đến những thay đổi API trong việc tạo chiến dịch bằng cách sử dụng các mục tiêu ban đầu.

Câu hỏi thường gặp

Hỏi: Thay đổi này có yêu cầu cập nhật mã không?

Đáp: Có, có nhiều lệnh gọi API cho phiên bản 18 sẽ không hoạt động trên phiên bản 19 (ví dụ, việc tạo quảng cáo, nhóm quảng cáo và chiến dịch mới sử dụng mục tiêu ban đầu sẽ không còn thực hiện được thông qua bản sao quảng cáo).

Hỏi: Sự khác biệt trước và sau khi thay đổi là gì?

Đáp: Trước đây, bạn có thể dùng lệnh gọi API để sao chép quảng cáo, nhóm quảng cáo hoặc chiến dịch sử dụng mục tiêu ban đầu, nhưng hiện tại bạn không thể thực hiện các yêu cầu bằng lệnh này.

Hỏi: Lịch trình thực hiện các thay đổi về mã như thế nào?

Đáp: Phiên bản 18.0 sẽ ngừng sử dụng dự kiến vào tháng 09/2024.

Tài liệu bổ sung dành cho nhà phát triển

• https://developers.facebook.com/docs/marketing-api/reference/adgroup/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign/copies/
• https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/copies/

Bài viết trợ giúp

• Những thay đổi về mục tiêu trong Trình quản lý quảng cáo trên Meta
• Cách chọn mục tiêu quảng cáo phù hợp trong Trình quản lý quảng cáo trên Meta

PPCA (Quyền truy cập nội dung công khai trên Trang)

Trường hợp sử dụng dữ liệu được thu thập thông qua PPCA (Quyền truy cập nội dung công khai trên Trang) đã thay đổi. Để biết thông tin chi tiết, hãy xem liên kết sau.

Giới thiệu API đối tượng Advantage+

Tháng 10 năm ngoái, chúng tôi đã ra mắt đối tượng Advantage+, một trải nghiệm tạo đối tượng mới và đơn giản hóa giúp tăng hiệu quả chiến dịch bằng cách mở rộng đối tượng mà quảng cáo có khả năng phân phối, đồng thời vẫn đảm bảo phân phối quảng cáo đến những người mà nhà quảng cáo muốn tiếp cận nhất.

Giờ đây, chúng tôi đang triển khai đối tượng Advantage+ trên API Marketing.

• Để chọn tham gia, hãy đặt thông số targeting_automation trong advantage_audience thành 1.
• Để chọn không tham gia, hãy đặt thông số targeting_automation trong advantage_audience thành 0.

Việc ngừng hoạt động và những thay đổi quan trọng

Ngừng hoạt động API Nhóm Facebook

API Nhóm Facebook sẽ ngừng hoạt động trong phiên bản 19 và sau 90 ngày sẽ bị gỡ khỏi tất cả các phiên bản. Việc ngừng hoạt động này bao gồm tất cả các Quyền (publish_to_groups, groups_access_member_info) và Tính năng có thể xét duyệt (API Nhóm) liên kết với API Nhóm Facebook.

Một trường hợp sử dụng chính của API Nhóm là tính năng Trả lời riêng trong nhóm. Chúng tôi đang triển khai một thay đổi khác trong phiên bản 19, cho phép trường hợp sử dụng đó mà không cần nhà phát triển phải sử dụng API Nhóm. Đối với hầu hết các nhà phát triển sử dụng tính năng Trả lời riêng, sẽ không có thay đổi nào được thực hiện trong phiên bản 19. Đối với các nhà phát triển đã dựa vào các lệnh gọi đến điểm cuối Bài viết trong nhóm thông qua API Nhóm sau khi nhận webhook Trả lời riêng, giờ đây những nhà phát triển đó cần đảm bảo sử dụng Mã truy cập Trang cho các yêu cầu đó.

Nhà phát triển nào chưa biết rõ liệu điểm cuối của họ có sử dụng quyền đã ngừng hoạt động hay không thì có thể xác minh việc này bằng cách kiểm tra điểm cuối trong Phiên bản 19.0

Các thay đổi về API Thông tin chi tiết Trang - Ngừng sử dụng số liệu

Khi chuyển từ Trang truyền thống sang trải nghiệm Trang mới trên Facebook, chúng tôi sẽ ngừng sử dụng một vài số liệu trong API Thông tin chi tiết Trang. Để biết thêm thông tin, hãy xem liên kết này.

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

Trong lịch trình lập phiên bản API Đồ thị và API Marketingcủa Facebook, hãy lưu ý các phiên bản sắp ngừng hoạt động sau:

API Đồ thị

• 08/02/2024: API Đồ thị phiên bản 12.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 28/05/2024: API Đồ thị phiên bản 13.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng
• 17/09/2024: API Đồ thị phiên bản 14.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng

API Marketing

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

Meta Business SDK

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

Bản phát hành Meta Business SDK phiên bản 19 sẽ được phát hành ngay sau khi ra mắt Đồ thị API phiên bản 19. 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 Đồ thị API phiên bản 19. Trong tương lai, chúng tôi dự định sẽ phát hành SDK thường xuyên hơn để phù hợp với tần suất cập nhật API. Điều này sẽ hỗ trợ nhà phát triển luôn cập nhật các API, chức năng và tính năng mới nhất.

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 02/2024: SDK Nền tảng Facebook phiên bản 12.0 trở xuống sẽ ngừng hoạt động