Introducing Graph API v20.0 and Marketing API v20.0

Hôm nay, chúng tôi sẽ ra mắt API Đồ thị v20.0 và API Marketing v20.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.

Để 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

Tính năng tự động nâng cấp phiên bản API Marketing

Để nâng cao trải nghiệm chung khi sử dụng API bằng cách tăng tính liền mạch và hiệu quả, chúng tôi rất vui được thông báo về việc sắp ra mắt tính năng tự động nâng cấp phiên bản API Marketing (MAPI). Kể từ hôm nay, chúng tôi sẽ bật tính năng tự động nâng cấp phiên bản cho những điểm cuối API Marketing không bị ảnh hưởng khi chuyển đổi phiên bản. Tức là nếu một điểm cuối không bị ảnh hưởng khi chuyển tiếp từ phiên bản không dùng nữa lên phiên bản có sẵn tiếp theo, nền tảng sẽ tự động nâng cấp lệnh gọi lên phiên bản có sẵn tiếp theo thay vì trực tiếp từ chối yêu cầu.

Để tìm hiểu thêm về hành vi này, hãy tham khảo Lập phiên bản API Marketing và blog về đợt ra mắt.

Để xem các điểm cuối bị ảnh hưởng ở mỗi phiên bản, vui lòng tham khảo nhật ký thay đổi.

Để biết thêm thông tin cập nhật về v20.0 cụ thể, vui lòng đọc tiếp.

Quảng cáo lời nhắc cho API Marketing

Trước ngày 13/05/2024, nhà phát triển không thể hỗ trợ tạo quảng cáo lời nhắc trên Instagram thông qua API Marketing trên Instagram, đồng thời khách hàng của họ chỉ có thể tạo quảng cáo lời nhắc trong Trình quản lý quảng cáo trên Meta. Sự thiếu tương thích này đã tạo ra những trở ngại không mong muốn đối với các đối tác của chúng tôi và những khách hàng muốn chạy quảng cáo lời nhắc của họ.

Sau khi liên tục nhận được phản hồi về sự không tương thích này, chúng tôi hiện đang hỗ trợ quy trình tạo quảng cáo lời nhắc thông qua API Marketing trên Instagram kể từ ngày 13/05/2024.

Chúng tôi hoan nghênh phản hồi nhận được từ cộng đồng nhà phát triển và khách hàng của họ, đồng thời hy vọng sẽ tiếp tục cải thiện trải nghiệm quảng cáo lời nhắc có sẵn thông qua API Marketing.

Giới thiệu về quảng cáo lời nhắc trên Instagram

Với quảng cáo lời nhắc trên Instagram, nhà quảng cáo có thể thu hẹp khoảng cách giữa thời gian quảng cáo và thời điểm ra mắt bằng cách khuyến khích những người quan tâm đặt lời nhắc. Những người chọn tham gia sẽ nhận được lời nhắc vào thời điểm quan trọng nhất trước sự kiện.

Giới thiệu về cách tạo và chỉnh sửa sự kiện

Quảng cáo lời nhắc trên Instagram sử dụng ngày và giờ bắt đầu sự kiện để xác định thời điểm gửi lời nhắc. Thông qua sự thay đổi này, nhà phát triển có thể tạo và chỉnh sửa sự kiện trong API Đồ thị trên Instagram. Bạn có thể tạo quảng cáo lời nhắc thông qua API Marketing trên Instagram sau khi đính kèm sự kiện vào nội dung quảng cáo.

API mới trên Nút tài khoản quảng cáo

Bản cập nhật Nút tài khoản quảng cáo mới không phải là một thay đổi đột phá; đó là sự bổ sung API. Gọi nó là liệt kê tất cả các chiến dịch trong tài khoản quảng cáo đó có đề xuất hướng dẫn, cùng với hướng dẫn và mức cải thiện dự kiến ​​về Chi phí trên mỗi hành động (CPA).

Với API mới, nhà quảng cáo có thể xem hướng dẫn của Meta về chiến dịch của họ. Dữ liệu này đã có trên Trung tâm đối tác dành cho tất cả đối tác. Tuy nhiên, dữ liệu này có sẵn thông qua giao diện người dùng yêu cầu chọn thủ công một tài khoản quảng cáo để xem hướng dẫn.

Bằng cách tự động hóa quyền truy cập dữ liệu này thông qua API CPA_GUIDANCE, chúng tôi hy vọng sẽ loại bỏ công việc thủ công cần thiết để kiểm tra hướng dẫn cho mỗi tài khoản quảng cáo. Đối với các đối tác của chúng tôi, quyền truy cập vào API này sẽ cho phép họ xây dựng chế độ xem tùy chỉnh trong nội bộ và xem xu hướng theo thời gian.

Nếu doanh nghiệp của bạn quản lý hàng trăm hoặc hàng nghìn tài khoản thì thật khó để kiểm tra từng số liệu trên từng tài khoản, đặc biệt là khi nhạy cảm về thời gian (đề xuất RSS cập nhật hàng ngày và xem xét các chiến dịch đang hoạt động trong 28 ngày qua). Với API này, các agency sẽ có thể xác định các chiến dịch hứa hẹn nhất có thể được tối ưu hóa bằng cách sử dụng các đề xuất được cung cấp, sau đó sẽ được tích hợp vào hệ thống của họ.

API CPA_GUIDANCE đặc biệt cho phép các agency cung cấp hướng dẫn cho đối tác thương hiệu của họ về sản phẩm hoặc hạng mục nào có chi phí trên mỗi lượt chinh phục (CPA) cao nhất. Bằng cách chia sẻ thông tin này, agency có thể hỗ trợ các đối tác thương hiệu của họ tối ưu hóa chi tiêu quảng cáo và cải thiện hiệu quả tổng thể của các chiến dịch cộng tác của họ.

Agency cũng sẽ có thể theo dõi xem đề xuất hướng dẫn có được thực hiện hay không bằng cách quan sát xu hướng cải thiện của CPA.

Quảng cáo đa bên

Hôm nay, chúng tôi sẽ giới thiệu khả năng cho nhà quảng cáo chọn tham gia quảng cáo đa bên thông qua API Marketing. Trước bản cập nhật này, nhà phát triển không thể hỗ trợ tạo quảng cáo đa bên thông qua API và khách hàng của họ chỉ có thể chọn tham gia quảng cáo đa bên trong Trình quản lý quảng cáo trên Meta.

Giới thiệu về quảng cáo đa bên

Quảng cáo đa bên tạo điều kiện cho mọi người khám phá sản phẩm và dịch vụ từ nhiều doanh nghiệp. Đối với một số ít vị trí quảng cáo trên Facebook và Instagram, quảng cáo có thể hiển thị cùng với quảng cáo khác trong cùng một đơn vị quảng cáo để hỗ trợ mọi người khám phá sản phẩm và dịch vụ từ các doanh nghiệp được cá nhân hóa cho họ. Đơn vị quảng cáo là vùng chứa hiển thị nhiều quảng cáo, thường trên cùng một trang. Tìm hiểu thêm trong Trung tâm trợ giúp doanh nghiệp.

Sự thay đổi này có ý nghĩa gì đối với nhà phát triển

Tại thời điểm ra mắt, tính năng phân phối cho quảng cáo đa bên được tạo thông qua API Marketing bị tắt theo mặc định, nghĩa là nhà phát triển sẽ cần triển khai các thay đổi về mã để quảng cáo của khách hàng họ đủ điều kiện phân phối trong trải nghiệm. Tất cả phiên bản API Marketing đều hỗ trợ quy trình tạo quảng cáo đa bên. Tuy nhiên, mọi yêu cầu tạo quảng cáo đủ điều kiện sử dụng quảng cáo đa bên đều phải chỉ định rõ liệu quảng cáo có chọn sử dụng quảng cáo này hay không. Vào ngày 19/08/2024, quảng cáo đa bên sẽ chuyển sang chế độ bật mặc định và các nhà phát triển chưa triển khai các thay đổi về mã sẽ cần phải thực hiện việc này để cung cấp cho khách hàng khả năng chọn không tham gia trải nghiệm.

Các tính năng nội dung liên quan đến AI tạo sinh sắp có trong API Marketing: Tạo văn bản, Mở rộng hình ảnh và Tạo phông nền

Trong tháng 10/2023, chúng tôi đã công bố đợt ra mắt tính năng quảng cáo nội dung có AI tạo sinh hỗ trợ đầu tiên - Tạo văn bản, Mở rộng hình ảnh và Tạo phông nền - cho các doanh nghiệp trong Trình quản lý quảng cáo. Hôm nay, chúng tôi muốn thông báo rằng chúng tôi đang cung cấp các tính năng về nội dung liên quan đến AI tạo sinh này cho các nhà quảng cáo thông qua API Marketing (MAPI) để các đối tác, agency và nhà quảng cáo cũng có thể tận dụng các dịch vụ GenAI của Meta thông qua MAPI.

Những tính năng này cho phép tạo ra các phiên bản nội dung một cách nhanh chóng và tự động, mở ra một kỷ nguyên sáng tạo mới giúp tối đa hóa năng suất, khả năng tùy chỉnh và hiệu quả cho tất cả các nhà quảng cáo:

• Tạo phông nền: Tạo lên đến 4 phông nền để bổ sung cho hình ảnh sản phẩm, tạo điều kiện đa dạng hóa nội dung cho đối tượng của bạn. Phông nền được tạo sẽ dựa trên hình ảnh sản phẩm gốc của bạn và thường là phông nền đơn giản với màu sắc và hoa văn.

• Mở rộng hình ảnh: Điều chỉnh liền mạch tài sản nội dung hình ảnh để phù hợp với các tỷ lệ khung hình khác nhau trên các giao diện, bắt đầu bằng Bảng feed và sắp mở rộng sang Reels, để bạn tiết kiệm thời gian và nguồn lực khi tái sử dụng tài sản nội dung.

• Tạo văn bản: Tạo nhiều phiên bản văn bản quảng cáo dựa trên bản gốc của bạn, làm nổi bật lợi điểm bán sản phẩm/dịch vụ và tạo nhiều lựa chọn văn bản để đa dạng hóa quảng cáo cho đối tượng.

Hôm nay, chúng tôi sẽ mang những tính năng này đến với nhiều nhà quảng cáo hơn. Chúng tôi rất vui được cung cấp sức mạnh của AI tạo sinh của mình cho nhiều đối tượng hơn.

Do phương pháp thử nghiệm sản phẩm mới của chúng tôi có thể phải chịu sự giám sát chặt chẽ hơn nên một số ngành dọc nhất định như Dịch vụ tài chính và Dược phẩm/Sức khỏe cũng như quảng cáo về Nhà ở, Việc làm hoặc Dịch vụ tài chính/Tín dụng (HEC), Vấn đề xã hội, Bầu cử hoặc Chính trị (SIEP) có thể không sử dụng được ngay lập tức tất cả các tính năng của AI tạo sinh.

Tính năng này hoạt động như thế nào?

Hôm nay, chúng tôi sẽ ra mắt dịch vụ hỗ trợ cho các tính năng này như một phần của API Marketing, cụ thể hơn là API Nội dung quảng cáo. Các nhà quảng cáo sẽ có khả năng chọn sử dụng các tính năng này từ API cũng như xem trước nội dung AI tạo sinh từ API.

Ví dụ sau đây cho biết cách chọn sử dụng nội dung quảng cáo đối với các tính năng AI tạo sinh trên API Marketing.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Lưu ý: Ví dụ ở trên hiển thị Chọn cho tính năng Tạo phông nền. Tương tự, để Mở rộng hình ảnh, hãy sử dụng khóa image_uncrop và đối với Tạo văn bản, hãy sử dụng khóa text_generation trong creative_features_spec.

Nhà quảng cáo cũng sẽ có thể xem trước các nội dung được chuyển đổi bằng AI tạo sinh thông qua API. Vui lòng làm theo liên kết tài liệu dành cho nhà phát triển để tìm hiểu thêm về cách tạo, cung cấp nội dung quảng cáo và xem trước nội dung được tạo cho từng tính năng GenAI của chúng tôi.

API Video trên Instagram: Tải lên nối tiếp cho API Video trên Instagram

Bắt đầu từ ngày 15/05/2024, "Giao thức tải lên nối tiếp" mới sẽ hỗ trợ quá trình đăng video trên Instagram (tức là Reels, Tin về video và Thẻ quay vòng video) từ cả video cục bộ và video URL được lưu trữ công khai. Giao thức mới này cho phép tải lên file cục bộ, tải lên video dài hơn chỉ dành cho Reels (tức là lên đến 15 phút) và tiếp tục thao tác tải lên sau khi mạng bị gián đoạn hoặc lỗi truyền khác.

Trước đây để tạo video trên Instagram, các file video phải được tải lên dịch vụ lưu trữ có thể truy cập công khai, nơi sẽ lấy và cung cấp URL có thể chia sẻ cho Meta để đăng video.

Bạn có thể tìm thấy chi tiết về quy trình đăng nội dung được cải tiến trong tài liệu dành cho nhà phát triển đăng nội dung cùng với các chi tiết bổ sung liên quan đến file phương tiện trên Instagram tại đây.

API Đồ thị trên Instagram: Giới thiệu các số liệu mới

Hôm nay, 6 số liệu bổ sung cho File phương tiện vùng chứa thẻ quay vòng sẽ được cung cấp cho API Đồ thị. Các số liệu này là Lượt thích, Lượt bình luận, Lượt chia sẻ, Lượt theo dõi, Hoạt động trên trang cá nhân (tức là số hành động được thực hiện khi người dùng truy cập trang cá nhân của bạn), Lượt truy cập trang cá nhân (tức là số lần trang cá nhân của bạn được truy cập). Các số liệu này đã có sẵn trên Trang thông tin chi tiết của Instagram nhưng giờ đây các số liệu đó cũng có sẵn thông qua API Đồ thị.

Bằng cách thêm Lượt thích, Lượt bình luận, Lượt chia sẻ, Lượt theo dõi, Hoạt động trên trang cá nhân, Lượt truy cập trang cá nhân vào điểm cuối API Đồ thị cho Bài viết quay vòng, bạn sẽ có thể đọc các số liệu này trực tiếp từ Lệnh gọi API.

Vui lòng tham khảo danh sách đầy đủ các số liệu này tại đây để thêm các số liệu có liên quan vào Lệnh gọi API GET cho các bài viết trong vùng chứa thẻ quay vòng ngay hôm nay.

Cập nhật dòng thời gian ngừng sử dụng: API Chuyển đổi offline của Meta (OCAPI)

Năm ngoái, chúng tôi đã thông báo rằng API Chuyển đổi offline phiên bản 17 sẽ không còn hỗ trợ các sự kiện offline nữa và chúng tôi dự kiến rằng API Chuyển đổi offline sẽ ngừng hoạt động vào quý 3/2024. Kể từ đó, chúng tôi đã cập nhật tiến trình ngừng sử dụng dự kiến ​​này và chúng tôi nay xác nhận rằng API Chuyển đổi offline (OCAPI) sẽ ngừng hoạt động vào tháng 5/2025. Mặc dù việc ngừng sử dụng OCAPI đã được gia hạn từ quý 3/2024 đến tháng 5/2025, chúng tôi vẫn khuyến khích các nhà quảng cáo hiện đang gửi sự kiện offline qua API Chuyển đổi offline (OCAPI) tiếp tục lên kế hoạch chuyển thiết lập hiện có của họ để bắt đầu gửi sự kiện offline thông qua API Chuyển đổi (CAPI cho Offline).

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

Ngừng sử dụng nút đặt lịch trong API Messenger

Với hiệu lực ngay lập tức, nút Đặt lịch sẽ không còn được hỗ trợ trong lệnh gọi API Messenger nữa. Thay đổi này không ảnh hưởng đến các mẫu và nút khác. Ngoài ra, các doanh nghiệp vẫn có thể quản lý việc đặt lịch bằng Meta Business Suite.

Ngừng quy trình tạo loại quảng cáo Tin nhắn được tài trợ trong API Marketing

Kể từ hôm nay, quy trình tạo loại quảng cáo Tin nhắn được tài trợ sẽ không còn có thể sử dụng được trong API Marketing v20.0 nữa và dịch vụ hỗ trợ quy trình tạo quảng cáo cho loại quảng cáo này từ các phiên bản API trước đó sẽ kết thúc sau 90 ngày. Thay đổi này sẽ không ảnh hưởng đến các loại quảng cáo nhắn tin khác.

Bạn nên xem xét các tích hợp hiện tại và điều chỉnh các ứng dụng nếu cần để đảm bảo quá trình chuyển đổi suôn sẻ cho người dùng.

Loại bỏ khung thời gian không quan trọng đối với các số liệu nhân khẩu học thông tin chi tiết (thông qua API Đồ thị trên Instagram bên ngoài)

Vào ngày 21/05/2024, chúng tôi đã ra mắt Phiên bản 20 của API Đồ thị trên Instagram.

Sau 90 ngày kể từ ngày ra mắt này (tức là ngày 19/08/2024), API Đồ thị sẽ không còn chia sẻ các số liệu nhân khẩu học về thành phần đối tượng đã tương tác và tiếp cận trong các khung thời gian không quan trọng đối với API Đồ thị trên Instagram (ví dụ: thông tin phân bổ theo quốc gia, thành phố, độ tuổi và giới tính trong 14 và 90 ngày qua).

API Đồ thị trên Instagram sẽ vẫn trả về thông tin nhân khẩu học trong tháng qua (tức là "this_month") và tuần trước (tức là "this_week"), tương tự như thông tin của ứng dụng Instagram để đảm bảo tính nhất quán trên các nền tảng.

Bản nâng cấp mới này sẽ giảm mọi sự nhầm lẫn, cũng như tăng độ tin cậy và chất lượng của báo cáo.

Vui lòng xem lại tài liệu dành cho nhà phát triển để tìm hiểu thêm.

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ị

• Ngày 28/05/2024: API Đồ thị v13.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.

• Ngày 17/09/2024: API Đồ thị v14.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.

• Ngày 20/11/2024: API Đồ thị v15.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.

API Marketing

• Ngày 13/08/2024: API Marketing v18.0 sẽ ngừng hoạt động và bị gỡ khỏi nền tảng.

• Ngày 04/02/2025: API Marketing v19.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.

Meta Business SDK

Bản phát hành Meta Business SDK v20

Bản phát hành Meta Business SDK v20 sẽ được phát hành ngay sau khi ra mắt Đồ thị API v20. 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 v20.

Trong bản phát hành này, chúng tôi cũng giới thiệu tính năng hỗ trợ bổ sung cho API Instagram. Trong đó bao gồm IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI và IGAccessTokenForIGOnlyAPI. Các tính năng này cho phép nhiều phương thức hơn ngoài các API Instagram hiện có để bạn có thể tìm nạp file phương tiện trực tiếp. Chúng tôi mong muốn giới thiệu nhiều API hơn có thể hỗ trợ các sản phẩm khác của Meta để làm phong phú thêm hệ sinh thái của Business SDK.

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/2024: SDK Nền tảng Facebook v13.0 trở xuống sẽ ngừng hoạt động.