Phiên bản 11.0

API Đồ thị

Ngày phát hành 08/06/2021 | Ngày hết hạn 14/09/2023 | Bài viết trên blog

Ứng dụng dành cho người tiêu dùng

Cấp độ truy cập

Áp dụng cho mọi phiên bản.

Trong những tuần sắp tới, cấp độ truy cập sẽ được áp dụng cho tất cả ứng dụng hiện có dành cho Người tiêu dùng. Đối với những ứng dụng này, các quyền và tính năng đã được phê duyệt qua quy trình Xét duyệt ứng dụng sẽ tự động được phê duyệt Quyền truy cập nâng cao. Tất cả các quyền và tính năng khác sẽ tự động được phê duyệt Quyền truy cập tiêu chuẩn.

Cấp độ truy cập cũng sẽ được áp dụng cho tất cả ứng dụng mới tạo trong những tuần sắp tới. Ứng dụng mới tạo sẽ tự động được phê duyệt Quyền truy cập nâng cao đối với các quyền email và public_profile. Tuy nhiên, cả hai quyền này đều sẽ được đặt thành Quyền truy cập tiêu chuẩn theo mặc định. Bạn phải đặt thành Quyền truy cập nâng cao theo cách thủ công thì những người dùng không có vai trò trên ứng dụng mới có thể yêu cầu các quyền đó.

Hỗ trợ nhà phát triển

Chúng tôi đã phát hành công cụ Trạng thái Facebook for Business để giám sát tình trạng của nền tảng và các sản phẩm kinh doanh như Trình quản lý quảng cáo, WhatsApp Business và Nền tảng dành cho nhà phát triển của Facebook.

Phân tích trên Facebook

Ngừng sử dụng

Áp dụng cho mọi phiên bản.

Sau ngày 30/06/2021, công cụ Phân tích trên Facebook sẽ không còn sử dụng được nữa. Ngoài ra, chúng tôi sẽ ngừng sử dụng Plugin Bảng điều khiển ứng dụng dành cho API Marketing. Để biết thêm thông tin, hãy truy cập vào Trung tâm trợ giúp doanh nghiệp.

Dưới đây là những trường Nút ứng dụng không còn hoạt động:

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Dưới đây là những điểm cuối không còn hoạt động:

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

API Instagram Basic Display

Trình gỡ lỗi mã truy cập

Áp dụng cho mọi phiên bản.

Công cụ trình gỡ lỗi mã truy cập hiện chỉ trả về ID người dùng trong ứng dụng khi gỡ lỗi mã.

Lập phiên bản API

Áp dụng cho mọi phiên bản.

API hiện hỗ trợ các lệnh gọi được lập phiên bản. Để truy vấn một phiên bản API cụ thể, hãy thêm số phiên bản vào đường dẫn truy vấn sau URL cơ sở. Ví dụ:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Các yêu cầu không được lập phiên bản (thiếu số phiên bản) sẽ sử dụng phiên bản được chỉ định trong phần Bảng điều khiển ứng dụng > Cài đặt > Nâng cao > Nâng cấp phiên bản API của ứng dụng gọi.

ID người dùng trong ứng dụng

Áp dụng cho phiên bản 11.0 trở lên.

Chúng tôi đã ra mắt ID người dùng trong ứng dụng (ASID). ASID sẽ thay thế ID người dùng chưa xử lý trong khoảng 2 năm đến khi ngừng sử dụng phiên bản 10.0. Do đó, bạn nên bắt đầu đối ghép ID chưa xử lý của người dùng ứng dụng với ASID tương đương.

Tất cả các phiên bản đều hỗ trợ truy vấn dựa trên ID người dùng chưa xử lý.
Chỉ các lệnh gọi phiên bản 11.0 trở lên mới hỗ trợ truy vấn dựa trên ASID.
Lệnh gọi phiên bản 11.0 trở lên sẽ nhận được ASID trong phản hồi, ngay cả khi truy vấn ID người dùng chưa xử lý.

Phân trang theo thời gian

Áp dụng cho v11.0 trở lên.

Chúng tôi đã thêm các thông số since và until vào điểm cuối GET /{user-id}/media để hỗ trợ phân trang theo thời gian.

API Đồ thị trên Instagram

Số lượt thích

Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Nếu truy vấn gián tiếp một File phương tiện trên Instagram thông qua điểm cuối khác hoặc tính năng mở rộng trường, trường like_count sẽ không có trong phản hồi API nếu chủ sở hữu file phương tiện đã ẩn số lượt thích của file phương tiện đó. Tuy nhiên, việc truy vấn trực tiếp File phương tiện trên Instagram (chỉ chủ sở hữu File phương tiện trên Instagram mới có thể thực hiện thao tác này) sẽ trả về số lượt thích thực tế, ngay cả khi số lượt thích của file phương tiện đó đã bị ẩn.

Phân trang theo thời gian

Áp dụng cho v11.0 trở lên.

Chúng tôi đã thêm các thông số since và until vào điểm cuối GET /{ig-user-id}/media để hỗ trợ phân trang theo thời gian.

Trải nghiệm tức thì

Mẫu

Áp dụng cho v11.0 trở lên.

Mẫu Trải nghiệm tức thì đã qua giai đoạn beta và hiện được cung cấp cho mọi nhà phát triển.

Nền tảng Messenger

Webhook postback nhắn tin

Áp dụng cho v11.0 trở lên.

Chúng tôi đã thêm trường mid vào webhook messaging_postbacks để cho phép ứng dụng lấy ID tin nhắn.

Ngừng sử dụng mẫu dành cho hàng không

Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 06/12/2021.

Các lệnh gọi đến POST /{page-id}/messages có chứa mẫu dành cho hàng không bất kỳ (template_type thuộc loại airline_boardingpass, airline_checkin, airline_itinerary, airline_update) sẽ không thành công.

oEmbed

Tính năng đọc oEmbed mới

Áp dụng cho mọi phiên bản.

Chúng tôi đã thay thế sản phẩm oEmbed bằng tính năng Đọc oEmbed mới. Nếu đã triển khai sản phẩm oEmbed trước ngày 08/06/2021, bạn sẽ phải hoàn thành quy trình Xét duyệt ứng dụng cho tính năng Đọc oEmbed trước ngày 07/09/2021. Nếu chưa được phê duyệt tính năng Đọc oEmbed trước ngày 07/09/2021, bạn sẽ không thể triển khai oEmbed.

API Trang

ID bình luận

Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Trường id cho bình luận sẽ không được trả về cho bất kỳ ứng dụng nào chỉ sử dụng tính năng Quyền truy cập nội dung công khai trên Trang để truy vấn điểm cuối Trang. Trong đó có các trường id là /PAGEPOST-ID/comments hoặc /COMMENT-ID/comments. Để lấy trường id cho bình luận đối với các bình luận về bài viết trên Trang, người dùng ứng dụng phải có khả năng thực hiện tác vụ MODERATE trên Trang được truy vấn.

Trải nghiệm Trang mới

Trong những tháng sắp tới, mọi Trang truyền thống sẽ được chuyển sang Trải nghiệm Trang mới. Hãy sử dụng trường của Trang has_transitioned_to_new_page_experience để xác định xem Trang đã được chuyển hay chưa. Sau khi chuyển mọi Trang, trải nghiệm Trang truyền thống sẽ không còn được sử dụng nữa.

Hầu hết các điểm cuối API Trang đều hỗ trợ cả Trang truyền thống và Trang NPE. Các điểm cuối hỗ trợ Trang NPE sẽ hiển thị phần "Trải nghiệm Trang mới" trong tài liệu tham khảo.

Dưới đây là những điểm cuối không hỗ trợ trang NPE:

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

Một số trường của Trang không được cung cấp cho NPE và sẽ trả về giá trị null, một tập dữ liệu khác hoặc trả về lỗi khi được gọi. Vui lòng truy cập phần Tổng quan về trải nghiệm Trang mới để xem danh sách các trường của Trang này.

Quyền

user_likes

Áp dụng cho mọi phiên bản.

Chúng tôi đã cập nhật cách sử dụng hợp lệ cho quyền user_likes. Kể từ ngày 07/09/2021, các ứng dụng đã được phê duyệt quyền này nhưng vi phạm phần mô tả về cách sử dụng mới sẽ bị thu hồi quyền trên.

Cách sử dụng hợp lệ trước đó: Cải thiện đáng kể chất lượng trải nghiệm người dùng trong ứng dụng của bạn (bạn phải nêu rõ cho người dùng biết cách bạn sử dụng dữ liệu của họ để đem lại trải nghiệm đó).
Cách sử dụng hợp lệ mới: Cá nhân hóa trải nghiệm bằng cách liên kết hoặc hiển thị nội dung liên quan đến sở thích của người dùng. Trong đó có việc tuyển chọn nội dung trên quy mô lớn để tùy chỉnh những ứng dụng có lượng nội dung lớn và cho phép mọi người chia sẻ sở thích với người khác, chẳng hạn như trong ứng dụng hẹn hò và ứng dụng âm nhạc.

user_posts

Áp dụng cho mọi phiên bản.

Chúng tôi đã cập nhật cách sử dụng hợp lệ cho quyền user_posts. Kể từ ngày 07/09/2021, các ứng dụng đã được phê duyệt quyền này nhưng vi phạm phần mô tả về cách sử dụng mới sẽ bị thu hồi quyền trên.

Cách sử dụng hợp lệ trước đó: Cải thiện đáng kể chất lượng trải nghiệm người dùng trong ứng dụng của bạn (bạn phải nêu rõ cho người dùng biết cách bạn sử dụng dữ liệu của họ để đem lại trải nghiệm đó).
Cách sử dụng hợp lệ mới: Cho phép mọi người tạo sách bản giấy/sách kỹ thuật số/album dòng thời gian của họ, cũng như chia sẻ kỷ niệm trên dòng thời gian lên Facebook hoặc các ứng dụng mạng xã hội khác.

SDK

Vui lòng truy cập vào Nhật ký thay đổi của iOS SDK, Nhật ký thay đổi của Android SDK và Nhật ký thay đổi của Unity SDK để tìm hiểu về những thay đổi quan trọng sắp tới đối với các SDK này.

API Marketing

Ngày phát hành 08/06/2021 | Ngày hết hạn 23/02/2022 | Bài viết trên blog

Đối tượng

Xóa Đối tượng tùy chỉnh, Đối tượng tương tự và Đối tượng đã lưu

Áp dụng cho mọi phiên bản.

Kể từ ngày 08/06/2021, các Đối tượng tùy chỉnh, Đối tượng tương tự hoặc Đối tượng đã lưu không được dùng trong nhóm quảng cáo đang hoạt động nào trong 2 năm trở lên sẽ bị gắn cờ là "Đối tượng hết hạn". Sau đó, đối tượng sẽ được lên lịch xóa sau 90 ngày kể từ khi bị đánh dấu là "Đối tượng hết hạn".

Nhà phát triển có thể lọc trạng thái "Đối tượng hết hạn" bằng trường operation_status và xem thời gian xóa dự kiến của đối tượng trong hệ thống bằng trường delete_time. Nhà phát triển có thể chọn chủ động xóa đối tượng hoặc sử dụng đối tượng trong nhóm quảng cáo đang hoạt động để tránh bị xóa. Sau khi đối tượng bị xóa, nhà quảng cáo sẽ không thể kích hoạt lại đối tượng.

Đối với các Đối tượng tùy chỉnh (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:

Nếu nhà quảng cáo muốn hệ thống sẽ tự động xóa các đối tượng bị gắn cờ kể từ ngày 06/09/2021, họ không cần làm gì thêm. Tuy nhiên, nhà quảng cáo có thể chủ động xóa đối tượng trước ngày xóa tự động, nếu muốn.
Đối với các đối tượng bị gắn cờ mà nhà quảng cáo muốn duy trì, nhà quảng cáo phải có kế hoạch sử dụng các đối tượng này trong nhóm quảng cáo đang hoạt động trước ngày 06/09/2021 để tránh bị xóa.

Đối với Đối tượng tùy chỉnh từ danh sách khách hàng:

Chúng tôi lưu trữ các đối tượng này thay mặt cho nhà quảng cáo và theo hướng dẫn của họ. Nếu nhà quảng cáo không thực hiện hành động nào trước ngày 06/09/2021 để sử dụng đối tượng bị gắn cờ trong nhóm quảng cáo đang hoạt động, chúng tôi sẽ xem đây là hướng dẫn xóa đối tượng bị gắn cờ của nhà quảng cáo.

Dưới đây là những điểm cuối và trường thông tin sẽ bị ảnh hưởng:

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

Hãy xem phần Tổng quan về đối tượng: Những thay đổi liên quan đến việc xóa đối tượng tùy chỉnh để biết thêm thông tin mới.

API Doanh nghiệp

Áp dụng cho mọi phiên bản.

Chúng tôi đang tạm thời giới hạn quyền truy cập vào các điểm cuối sau. Chỉ những ứng dụng đã gọi thành công các điểm cuối này trong 30 ngày qua mới có thể tiếp tục truy cập.

Tất cả các ứng dụng khác sẽ nhận được lỗi khi thực hiện lệnh gọi đến các điểm cuối này.

API Danh mục

Ngừng sử dụng trường Danh sách cung ứng sản phẩm

Áp dụng cho phiên bản 11.0 trở lên.

Chúng tôi sẽ ngừng sử dụng trường inventory và thay thế bằng trường quantity_to_sell_on_facebook mới. Mặc dù chúng tôi sẽ tiếp tục hỗ trợ trường inventory trong thời gian trước mắt, nhưng bạn nên sử dụng trường quantity_to_sell_on_facebook mới.

Dưới đây là những điểm cuối sẽ bị ảnh hưởng:

Hãy xem phần Số lượng hàng và Các trường được hỗ trợ cho sản phẩm - Quảng cáo động và thương mại để biết thêm thông tin về điểm cập nhật này.

Xóa nhóm sản phẩm không trống

Áp dụng cho phiên bản 11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Chúng tôi sẽ không cho phép xóa nhóm sản phẩm không trống theo mặc định nữa. Bạn có thể xóa nhóm sản phẩm không trống 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 đó.

Dưới đây là điểm cuối sẽ bị ảnh hưởng:

DELETE /<product_group_id>

Xóa bộ sản phẩm trực tiếp

Áp dụng cho phiên bản 11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Chúng tôi sẽ không cho phép xóa danh mục chứa bộ sản phẩm trực tiếp theo mặc định nữa. Để cho phép xóa danh mục chứa bộ sản phẩm trực tiếp, hãy đặt thông số allow_delete_catalog_with_live_product_set của danh mục thành true.

Thay đổi này ảnh hưởng đến điểm cuối sau đây:

DELETE /<product_catalog_id>

Điểm cuối chẩn đoán mới

Áp dụng cho phiên bản 11.0 trở lên.

Chúng tôi đã thêm một điểm cuối mới GET /{product_catalog_id}/diagnostics. Bạn có thể dùng điểm cuối này để truy xuất dữ liệu chẩn đoán cho một danh mục cụ thể, chẳng hạn như các sự cố ngăn việc hiển thị sản phẩm trong kênh và những cơ hội cải thiện khả năng khám phá sản phẩm.

API Thương mại

Chi tiết tổng số tiền thanh toán ước tính cho đơn đặt hàng

Áp dụng cho phiên bản 11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Chúng tôi sẽ thay đổi cách báo cáo chi tiết số tiền thanh toán ước tính theo tổng giá trị đơn đặt hàng cho các lệnh gọi đến điểm cuối {commerce-order-id}/?fields=estimated_payment_details. Trước đây, nếu đơn đặt hàng không được thực hiện, chúng tôi sẽ sử dụng thuế ước tính. Còn với các đơn đặt hàng đã thực hiện, chúng tôi sẽ sử dụng thuế đã nộp. Kể từ phiên bản 11.0, điểm cuối này sẽ luôn sử dụng thuế ước tính. Lưu ý rằng bạn có thể truy cập thông tin chi tiết về thuế đã nộp qua {commerce-order-id}/items?fields=tax_details.

Thước đo mức tăng chuyển đổi

Thay đổi về số liệu

Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Số liệu do trường GET /{objective-id}/?fields=result trả về đã thay đổi.

Chúng tôi đã thêm những số liệu sau đây:

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

Chúng tôi đã gỡ những số liệu sau đây:

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

Chúng tôi đã đổi tên những số liệu sau đây:

Tên cũ	Tên mới
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

Bạn có thể xem danh sách đầy đủ các số liệu có sẵn trong phần Bảng chú giải thuật ngữ về các số liệu mức tăng của Facebook.

API Thông tin chi tiết

Ngừng sử dụng số liệu lượt ghé thăm cửa hàng

Áp dụng cho phiên bản 11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 06/09/2021.

Các số liệu store_visits_actions và cost_per_store_visit_actions sẽ không còn được sử dụng.

Dưới đây là những điểm cuối sẽ bị ảnh hưởng:

API Quảng cáo ưu đãi

Ngừng sử dụng điểm cuối API Quảng cáo ưu đãi

Áp dụng cho v11.0 trở lên. Sẽ áp dụng cho mọi phiên bản kể từ ngày 07/09/2021.

Trong nỗ lực không ngừng nhằm tăng cường tính ổn định của sản phẩm, Facebook sẽ ngừng hỗ trợ sản phẩm Quảng cáo ưu đãi từ ngày 08/06/2021. Bạn nên sử dụng Quảng cáo trên Facebook tiêu chuẩn để cung cấp chương trình giảm giá trực tuyến hoặc tại cửa hàng. Bạn cũng nên đặt thông tin chiết khấu, địa điểm đổi quà, ngày hết hạn và mã khuyến mãi vào ngay nội dung Cấp độ quảng cáo.

Dưới đây là những điểm cuối sẽ ngừng hoạt động:

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes