Tích hợp Pixel và API Chuyển đổi cho MBE

Thông qua quy trình Pixel và API Chuyển đổi cho Tiện ích Meta Business (MBE), người dùng có thể tạo hoặc chọn Trình quản lý kinh doanh, Trang và Meta Pixel. Các đối tác có khả năng lưu trữ trang web nên dùng quy trình này. Khi sử dụng pixel được trả về sau khi hoàn tất quy trình này, các đối tác có thể gửi sự kiện đến Facebook thay mặt cho khách hàng thông qua trình duyệt hoặc API Chuyển đổi. Quy trình này không có các tính năng của Danh mục.

Trước khi bạn bắt đầu

Ứng dụng của bạn phải do Trình quản lý kinh doanh là doanh nghiệp đã được xác minh sở hữu. Tìm hiểu thêm về cách xác minh doanh nghiệp của bạn.
Ứng dụng trên Facebook phải có cấp độ truy cập, tính năng và quyền sau đây:
- Cấp độ truy cập: Quyền truy cập nâng cao
- Tính năng: Quyền quản lý quảng cáo tiêu chuẩn
- Quyền công khai: ads_management, pages_read_engagement và ads_read
- Quyền riêng tư: manage_business_extension - Đây là quyền riêng tư yêu cầu đại diện Facebook thêm ứng dụng của bạn vào danh sách cho phép.
- Mã truy cập người dùng hệ thống: Cần có mã truy cập để gửi sự kiện đến API Chuyển đổi. Để tạo Mã truy cập thay mặt cho khách hàng, hãy sử dụng Mã truy cập được trả về qua FBE và chuyển đổi thành Mã truy cập người dùng hệ thống bằng cách thực hiện một lệnh gọi API khác.

Cấu hình được yêu cầu

Extras

Trường Loại Mô tả

Trường	Loại	Mô tả
`setup`	thiết lập	Bắt buộc Đối tượng thiết lập Facebook của người bán, chẳng hạn như thông tin nhận dạng duy nhất (`external_business_id`) hoặc đơn vị tiền tệ cho danh mục (`currency`) của họ. Hãy xem phần chi tiết đối tượng thiết lập.
`business_config`	business_config	Bắt buộc Đối tượng cấu hình mà Tiện ích Facebook Business sử dụng để đặt cấu hình quy trình Tiện ích Facebook Business. Hãy xem phần chi tiết đối tượng `business_config`.
`repeat`	boolean	Bắt buộc Đặt giá trị này thành `false`.

setup

thiết lập

Bắt buộc

Đối tượng thiết lập Facebook của người bán, chẳng hạn như thông tin nhận dạng duy nhất (external_business_id) hoặc đơn vị tiền tệ cho danh mục (currency) của họ. Hãy xem phần chi tiết đối tượng thiết lập.

business_config

business_config

Bắt buộc

Đối tượng cấu hình mà Tiện ích Facebook Business sử dụng để đặt cấu hình quy trình Tiện ích Facebook Business. Hãy xem phần chi tiết đối tượng business_config.

repeat

boolean

Bắt buộc

Đặt giá trị này thành false.

Thiết lập

Sử dụng đối tượng này để xác định chế độ cài đặt cho sự hiện diện của người dùng cuối trên Facebook

Trường	Mô tả
`external_business_id` chuỗi	Bắt buộc ID doanh nghiệp duy nhất để đại diện cho doanh nghiệp của khách hàng. Chúng tôi sử dụng ID này làm thông tin nhận dạng duy nhất. Ví dụ: nếu công ty của người bán có tên là "Fubar" thì "fubar-123" có thể là `external_business_id` của họ.
`timezone` chuỗi	Không bắt buộc Múi giờ hoạt động của doanh nghiệp. Hãy xem phần các giá trị múi giờ có thể sử dụng.
`currency` chuỗi	Không bắt buộc Mã đơn vị tiền tệ ISO gồm 3 chữ cái của đơn vị tiền tệ mặc định được dùng cho các mặt hàng trong danh mục của doanh nghiệp. Hãy xem phần mã đơn vị tiền tệ được hỗ trợ.
`business_vertical` enum	Bắt buộc Ngành dọc gắn liền với doanh nghiệp Giá trị:`ECOMMERCE`
`merchant_settings_id` chuỗi	Không bắt buộc Được dùng khi nâng cấp từ Tiện ích Facebook Business, v1. Liên hệ với đại diện Facebook của bạn nếu bạn đang chuyển từ v1 sang v2.
`domain` chuỗi	Bắt buộc cho các kênh COMMERCE và COMMERCE_OFFSITE Miền được dùng để phê duyệt thủ công trên Instagram. Ví dụ: `https://exampleshop.partnersite.com`.
`channel` enum	Bắt buộc Cung cấp cho đối tác cách thức đặt cấu hình quy trình API Chuyển đổi của FBE. Đối với quy trình API Chuyển đổi, giá trị này phải là `CONVERSIONS_API`. `CONVERSIONS_API` - Quy trình cho phép người dùng cuối tạo hoặc chọn các đối tượng Trình quản lý kinh doanh, Tài khoản quảng cáo và Meta Pixel. Khi tạo các đối tượng này, người dùng cuối sẽ có thể gửi sự kiện từ trang web của họ lên Facebook thông qua API Chuyển đổi hoặc Pixel trình duyệt.
`business_manager_id` chuỗi	Không bắt buộc ID Trình quản lý kinh doanh cho Trình quản lý kinh doanh hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.
`ad_account_id` chuỗi	Không bắt buộc ID tài khoản quảng cáo cho tài khoản quảng cáo hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.
`page_id` chuỗi	Không bắt buộc ID Trang cho Trang Facebook hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.
`ig_profile_id` chuỗi	Không bắt buộc ID Trang kinh doanh trên Instagram cho Trang kinh doanh hiện tại trên Instagram của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.
`pixel_id` chuỗi	Không bắt buộc ID pixel cho Pixel hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.
`catalog_id` chuỗi	Không bắt buộc ID Danh mục cho danh mục hiện tại của người dùng mà đối tác có thể nhập để chọn trước cho người dùng trong quy trình thiết lập.

Cấu hình doanh nghiệp

Sử dụng đối tượng này để đặt cấu hình cài đặt cho doanh nghiệp của người dùng cuối. Đối tượng này bao gồm CTA, v.v. Mỗi trường bao gồm một "loại" được liên kết với bảng tương ứng bên dưới.

Trường	Mô tả
`business` Loại: FBEBusinessPropertiesConfigData	Bắt buộc Thông tin về doanh nghiệp của người dùng cuối
`messenger_chat` Loại: FBEMessengerChatConfigData	Không bắt buộc Các tính năng chat của Messenger trên trang Facebook của người dùng cuối, chẳng hạn như `enabled` và `domains`.
`catalog_feed_scheduled` Loại: FBECatalogFeedConfigData	Không bắt buộc Xác định xem Tiện ích Facebook Business có sử dụng phương pháp nguồn cấp dữ liệu hay không. Phương pháp này sẽ lấy mặt hàng trong danh mục từ `feed_url`.
`page_cta` Loại: FBEPageCtaConfigData	Không bắt buộc Nút kêu gọi hành động (CTA) trên trang của người dùng cuối, chẳng hạn như `cta_button_text`, `cta_button_url`, v.v.
`ig_cta` Loại: FBEIGCtaConfigData	Không bắt buộc Các tính năng cho nút kêu gọi hành động (CTA) trên Instagram, chẳng hạn như `enabled`, `cta_button_text`, `cta_button_url`, v.v.
`messenger_menu` Loại: FBEMessengerMenuConfigData	Không bắt buộc Các tính năng cho menu cố định trên Messenger, chẳng hạn như `cta_button-text` và `cta_button_url`