MBE 像素和轉換 API 啟用流程

Meta Business 擴充功能（FBE）的像素和轉換 API 流程允許用戶建立或選擇其企業管理平台、專頁和 Meta 像素。建議擁有網站託管功能的合作夥伴使用此流程。透過使用完成此流程後傳回的像素，合作夥伴能夠代表客戶，經由瀏覽器或轉換 API 向 Facebook 傳送事件。此流程不設目錄功能。

準備工作

您應用程式的擁有者必須是屬於已驗證企業的企業管理平台。進一步了解如何驗證企業。
需要具有以下存取權級別、功能和權限的 Facebook 應用程式：
- 存取權級別：進階存取權限
- 功能：廣告管理一般存取權限
- 公開權限：ads_management、pages_read_engagement 和 ads_read
- 私人權限：manage_business_extension：這是一項私人權限，會要求您的 Facebook 業務代表將您的應用程式加至許可名單。
- 系統用戶存取憑證：向轉換 API 傳送事件需要使用存取憑證。如要代表客戶產生存取憑證，請使用透過 FBE 傳回的存取憑證，並執行額外的 API 呼叫以將該憑證轉換為系統用戶存取憑證。

所需配置

extras 物件

欄位類型描述

欄位	類型	描述
`setup`	setup 物件	必填賣家的 Facebook 設定，如他們的不重複識別碼 (`external_business_id`)，或者其目錄的貨幣 (`currency`)。請參閱設定物件詳細資訊。
`business_config`	business_config 物件	必填 Facebook Business 擴充功能用於配置 Facebook Business 擴充功能流程的配置物件。請參閱 `business_config` 物件詳細資訊。
`repeat`	布林值	必填將此值設定為 `false`。

setup

setup 物件

必填

賣家的 Facebook 設定，如他們的不重複識別碼 (external_business_id)，或者其目錄的貨幣 (currency)。請參閱設定物件詳細資訊。

business_config

business_config 物件

必填

Facebook Business 擴充功能用於配置 Facebook Business 擴充功能流程的配置物件。請參閱 business_config 物件詳細資訊。

repeat

布林值

必填

將此值設定為 false。

設定

使用此物件來定義終端用戶在 Facebook 的狀態設定

欄位	說明
`external_business_id` 字串	必填代表客戶企業的不重複企業編號。我們會以此作為不重複的識別資料。例如，賣家的公司名稱為「Fubar」，那麼他們的 `external_business_id` 可以是「fubar-123」。
`timezone` 字串	選用項目企業所在時區。請參閱可使用的時區值。
`currency` 字串	此為選用項目企業目錄商品所用的預設貨幣，格式為三個字母的 ISO 貨幣代碼。請參閱支援的貨幣代碼。
`business_vertical` 列舉	必填與企業關聯的行業。值：`ECOMMERCE`
`merchant_settings_id` 字串	選填從 Facebook Business 擴充功能 v1 升級版本時使用。如果您是從 v1 轉移至 v2，請聯絡您的 Facebook 業務代表。
`domain` 字串	必填（COMMERCE 和 COMMERCE_OFFSITE 渠道）用於 Instagram 手動審查的網域，例如：`https://exampleshop.partnersite.com`。
`channel` 列舉	此為必要項目為合作夥伴提供 FBE 轉換 API 流程的配置方法。如果是轉換 API 流程，此值應為 `CONVERSIONS_API`。 `CONVERSIONS_API`：允許終端用戶建立或選擇企業管理平台、廣告帳戶和 Meta 像素物件的流程。建立這些物件讓終端用戶能夠經由轉換 API 或瀏覽器像素，從網站向 Facebook 傳送事件。
`business_manager_id` 字串	選填用戶現有企業管理平台的企業管理平台編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。
`ad_account_id` 字串	選填用戶現有廣告帳戶的廣告帳戶編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。
`page_id` 字串	選填用戶現有 Facebook 專頁的專頁編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。
`ig_profile_id` 字串	選填用戶現有 Instagram 商業檔案的 Instagram 商業檔案編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。
`pixel_id` 字串	選填用戶現有像素的像素編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。
`catalog_id` 字串	選填用戶現有目錄的目錄編號；合作夥伴可輸入此編號，以便為用戶在設定流程中預選。

企業配置

使用此物件為終端用戶配置企業設定。當中包括 CTA 等多種內容。每個欄位包含一個連接到下方相應表格的「類型」。

欄位	說明
`business` 類型：FBEBusinessPropertiesConfigData	此為必要項目終端用戶企業的資訊。
`messenger_chat` 類型：FBEMessengerChatConfigData	此為選用項目終端用戶 Facebook 專頁的 Messenger 聊天室功能，例如 `enabled` 和 `domains`。
`catalog_feed_scheduled` 類型：FBECatalogFeedConfigData	此為選用項目確定 Facebook Business 擴充功能是否應使用摘要方法，從 `feed_url` 獲取目錄商品。
`page_cta` 類型：FBEPageCtaConfigData	此為選用項目終端用戶專頁上的呼籲字句（CTA）按鈕，例如 `cta_button_text` 和 `cta_button_url` 等。
`ig_cta` 類型：FBEIGCtaConfigData	此為選用項目 Instagram 呼籲字句（CTA）功能所提供的功能，例如 `enabled`、`cta_button_text` 和 `cta_button_url` 等。
`messenger_menu` 類型：FBEMessengerMenuConfigData	此為選用項目 Messenger 常駐選單功能所提供的功能，例如 `cta_button-text` 和 `cta_button_url`。