啟用整合

啟用商店是讓賣家整合至「Meta 商務」的必要步驟。無縫啟用可確保賣家的產品是最新的、訂單資訊正確同步、易於按季度或年度核對，以及銀行和支付資訊設定正確，可及時進行支付並產生報告。

必備條件

您必須與 Facebook Business 擴充功能（FBE）整合，使賣家具有以下能力，以達到我們的商店整合品質標準：

• 在平台中輕鬆探索 Meta 整合
• 將他們的第 3 方帳號連結至 Meta 資產（企業管理平台、適用的現有目錄、適用的現有像素、粉絲專頁、Instagram 用戶名稱）
• 設定和編輯他們的站內商店設定（退貨設定、法律資料、銀行帳戶資料、稅務資料）
• 將其他資產（粉絲專頁、Instagram 用戶名稱）連結到商店
• 編輯設定
• 撤離

準備工作

1. 將已驗證的商家整合到 FBE 中。
2. 將 FBE 加入您的應用程式，並取得 FBE 開發人員面板的存取權限。請查看此圖表，以瞭解「商務」的 FBE 流程。
3. 按照 FBE 設定步驟操作，然後提交您的整合以進行 FBE 整合審查。這包括在您的平台中啟用 FBE 功能管理體驗，讓商家能夠變更自己的功能，甚至解除安裝 FBE 設定。

需求 1：與 Facebook Business 擴充功能整合

Facebook Business 擴充功能（FBE）是 Meta 擁有的彈出式介面，以外掛程式的形式存在於第三方網站上，可簡化與 Meta 整合的整個程序。FBE 可讓商家輕鬆設定 Meta 像素、目錄和商店，有助於商家將自己的商品和服務與您平台上的 Facebook 和 Instagram 通路連結。成功連結後，您就能協助商家運用一系列強大的功能。

簡而言之，FBE 整合中的責任分工概述如下：

• 歸屬於 Meta：介面、驗證、連結，以及可用來查看所連結的資產、管理已安裝的功能和商務整合狀態的平台 [（FBE 管理檢視）]（FBE 功能管理檢視）
• 歸屬於合作夥伴：設定像素、透過 API 將庫存上傳至 Facebook 目錄

設定完成後，您的任何商家即可使用現有資產或選擇建立新資產（或兩者併用），開始進行 FBE 啟用流程。

步驟 1：將 FBE 的進入點加到您的應用程式

建立 FBE 的進入點，以供用戶選擇、管理或建立自己的資產（例如商家、目錄、商店、像素等等）。這些進入點可以採用下列任一形式：

• 企業登入（即 Facebook 登入）– 可讓商家使用您放在網站上的按鈕，從您的平台初始化連結。
• 商業應用程式 – 可讓商家從 Meta 平台初始化連結。若要啟用此流程並將您的應用程式列在 Meta 的商業應用程式上，您必須在自己的網站上提供自訂驗證用戶介面。此用戶介面必須能讓用戶選擇他們的業務，然後帶著所選擇的資訊重新導向回 Meta 流程。

範例

https://facebook.com/dialog/oauth?
client_id=<FB_APP_ID>
&display=page
&redirect_uri="https://partner-site.com/redirectlanding"
&response_type=token
&scope=manage_business_extension
//   additionally use catalog_management or ads_management
//   &scope=manage_business_extension,catalog_management,ads_management
&extras={
  "setup": {
    "external_business_id": "foo-123",
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "domain": "https://example-shop.partner-site.com/",
    "channel": "ECOMMERCE",
    "business_vertical": "ECOMMERCE"
  },
  "business_config": {
    "business": {
      "name": "Foo Business"
    },
    "catalog_feed_scheduled": {
      "enabled": true,
      "feed_url": "https://partner-site.com/feed-url"
    },
    "page_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business",
      "below_button_text": "Powered by FBE Partner"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    },
    "messenger_menu": {
      "enabled": true,
      "cta_button_text": "Shop Now",
      "cta_button_url": "https://partner-site.com/foo-business"
    }
  },
  "repeat": false
}

根據您選擇的設定，您有多種方式可以取得商家的存取權杖以用於後續步驟：

• 企業登入 – 如同使用一般的 Facebook 登入，此流程結束時會傳回 access_token，可讓您用來取得更多資產（例如像素編號、粉絲專頁編號和 Instagram Business 編號）
• 商業應用程式 – 透過 Webhooks。

步驟 2：設定 FBE_install Webhooks

想要名列在 App Store 中的所有合作夥伴都需要 Webhooks。如果您不打算將應用程式放在 App Store，可以選擇忽略這個部分或之後再回來查閱。您的任一商家每次安裝、修改或解除安裝 FBE 時，Meta 都會發出 Webhook 事件。每次收到 Webhook 事件時，您的應用程式應該都會利用此事件，並瞭解該商家已在與您應用程式的連結中修改、新增或移除哪些資產。應用程式的運作方式應根據最新連結的資產進行更新。強烈建議您實作並測試您向我們訂閱的 Webhook。

設定 Webhook：

1. 在可妥善處理 Meta 要求的安全伺服器上建立端點。
2. 在應用程式主控板中，配置您的 FBE Webhooks 描述：
1. 在 FBE 區塊 > Webhooks 頁籤中，輸入應用程式的回呼網址。
2. 輸入驗證權杖，然後驗證您的端點。

設定後，就會自動訂閱 fbe_install Webhook。

如需更詳細的步驟，請參閱 Webhook。

通知

收到有關安裝的 Webhook 通知時，您需要：

1. 儲存存取權杖（及其類型），並記錄應用程式已獲得存取權限的資產。
2. 根據所授予的資產，啟用一組功能。
3. 如果缺少特定功能所需的資產，請只停用該功能。例如，如果您的應用程式已獲得目錄的存取權限，但未獲得像素的存取權限，則只實作支援目錄的功能，而不要實作支援像素的功能。
4. 依據用戶有權存取的資產，通知用戶有關應用程式運作方式的更新資訊。

收到有關現有安裝的更新資訊時，您需要：

1. 更新已授予您的資產存取權杖和記錄。
2. 依據已授予平台的資產，更新應用程式將為賣家啟用的功能組合。
3. 依據用戶有權存取的資產，通知用戶有關應用程式運作方式的更新資訊。

收到解除安裝通知時，您需要：

1. 停用應用程式為賣家實作的功能。
2. 通知賣家有關其配置的變更。

步驟 3：利用傳回的權杖擷取資產詳細資訊

您可以透過下列任一方法（或兩者並行），取得有關透過 FBE 連結您平台的商家資訊：

• Webhook—想要名列在 App Store 中的所有合作夥伴都需要。設定 Webhook 後，將可透過步驟 2 中 Webhook 設定的 Webhook 承載，接收透過 FBE 啟用或編輯的商家詳細資訊。
• FBE 安裝 API 端點—建議自行託管的商家使用。針對已安裝 FBE 的任何商家，您都可以使用 fbe_installs 端點來查詢其基本安裝資訊。使用商家的存取權杖和外部商家編號，您可以呼叫 FBE 安裝 API 端點來取得有關其設定的詳細資訊。

範例：FBE 安裝 API 呼叫

curl -i -X GET \   "https://graph.facebook.com/<version>/fbe_business/fbe_installs?fbe_external_business_id=<external business id>&access_token=<access token sanitized>"

步驟 4：擷取系統用戶權杖

用戶安裝 FBE 後，擴充功能會在用戶端的企業管理平台上產生員工的系統用戶。請注意，此系統用戶不再顯示在企業管理平台中，但會存在於後端。此新系統用戶的命名方式遵循 {App Name} System User (FBE) 架構。

若要這麼做，請發出下列 API 呼叫：

curl -X POST \
  -F 'app_id={app_id}' \
  -F 'scope=ads_management,catalog_management,manage_business_extension' \ 
  -F 'access_token={user_access_token}' \
  -F 'fbe_external_business_id={fbe_external_business_id}' \ 
https://graph.facebook.com/<API_VERSION>/<client_business_manager_id>/access_token

針對 scope 欄位，請使用 manage_business_extension 權限。依據您的使用案例（參見步驟 5），可能也會需要 ads_management、catalog_management、pages_read_engagement、business_management、instagram_basic 和 manage_business_extension 權限。

• 如果您的應用程式需要讀取及管理商家的廣告帳號，請要求 ads_management 權限。有了此權限，您就可以建立廣告行銷活動、擷取廣告衡量指標、組建廣告管理工具等等。
• 如果您的應用程式需要建立、讀取、更新或刪除商家為管理員的商家擁有商品目錄，則應該要求 catalog_management 權限。建議所有應用程式都要有此權限。這樣可以讓應用程式組建與商務相關的動態廣告和庫存管理解決方案。

步驟 5：設定管理檢視

若要讓商家進一步配置功能（而不限於安裝中指定的功能），您可以將商家從您的平台導向我們的 FBE 功能管理檢視。您可以使用 JavaScript SDK 或網址來新增進入點，以啟用「FBE 管理檢視」。這兩種方法都需要顯示可供點擊來啟用「FBE 管理檢視」視窗的按鈕。

步驟 6：新增解除安裝 FBE 的進入點

您的平台應新增可供商家解除安裝 FBE 的進入點。建議您向適當的端點發出 DELETE 要求來執行此操作。

範例：呼叫我們的刪除端點

curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

如果您已實作 fbe_install Webhook，您將會在用戶解除安裝 FBE 時收到事件。

瞭解詳情

• Facebook Business 擴充功能（FBE）
• FBE 設定步驟
• FBE 開發人員面板
• 解除安裝 FBE
• Webhooks