MBE 像素與轉換 API 啟用教學

Meta Business 擴充功能（MBE）像素與轉換 API 流程，可讓用戶建立或選擇自己的企業管理平台、粉絲專頁和 Meta 像素。建議可以使用網站代管功能的合作夥伴遵循這項流程。只要使用完成這項流程後傳回的像素，合作夥伴就能代表其顧客，使用瀏覽器或轉換 API 傳送事件到 Facebook。這項流程沒有目錄功能。

準備工作

您的應用程式必須屬於通過驗證之商家的企業管理平台。深入瞭解如何驗證商家。
要有一個 Facebook 應用程式，且這個應用程式必須有下列存取層級、功能以及權限：
- 存取層級：Advanced Access
- 功能：廣告管理標準存取
- 公開權限：ads_management、pages_read_engagement 及 ads_read
- 非公開權限：manage_business_extension - 這是非公開權限，必須由 Facebook 代表將您的應用程式新增到許可清單中。
- 系統用戶存取權杖：要有存取權杖才能傳送事件到轉換 API。要代表顧客產生存取權杖，請使用 FBE 傳回的存取權杖，再另外進行一次 API呼叫，將這個權杖轉換成系統用戶存取權杖。

必要配置

其他項目

欄位類型說明

欄位	類型	說明
`setup`	設定	必填賣家的 Facebook 設定，例如其不重複的識別資料（`external_business_id`）或其目錄的幣別（`currency`）。請參閱設定物件詳細資料。
`business_config`	business_config	必填 Facebook Business 擴充功能用於設定 Facebook Business 擴充功能工作流程的設定物件。請參閱 `business_config` 物件詳細資料。
`repeat`	布林值	必填將這個值設為 `false`。

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 擴充功能第一版升級時。如果您要從第一版移轉至第二版，請聯絡 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`