入門設定整合

完成商店的入門設定是讓賣家整合至 Meta 商務平台的必要步驟。流暢的入門設定流程有助確保賣家的商品資訊為最新，也可確保妥善同步訂單資訊，更可協助進行季度或年度查核，以及正確設定銀行與支付款項資訊，以便及時支付款項和製作分析報告。

必要條件

您需要與 Facebook Business 擴充功能（FBE）整合以符合我們的商店整合品質標準，亦即確保賣家可以執行以下操作：

• 在平台中輕鬆探索 Meta 整合工具
• 連結第三方帳戶與 Meta 資產，例如企業管理平台、現有目錄（如適用）、現有像素（如適用）、專頁、Instagram 用戶名稱
• 設定和編輯站內商店設定，例如退貨設定、法律資訊、銀行帳戶資訊、稅務資料
• 將其他資產（例如專頁、Instagram 用戶名稱）連結至商店
• 編輯設定
• 退出入門設定

準備工作

1. 將已驗證企業整合至 Facebook Business 擴充功能。
2. 將 Facebook Business 擴充功能加至您的應用程式，然後獲取對 Facebook Business 擴充功能開發人員面板的存取權限。請查看此圖表，了解適用於商務功能的 Facebook Business 擴充功能流程。
3. 按照 Facebook Business 擴充功能設定步驟操作，然後提交整合工具以供 Facebook Business 擴充功能整合工具審查。在操作過程中，您需要在平台中實現 Facebook Business 擴充功能的功能管理體驗，以便企業變更功能，甚至解除安裝 Facebook Business 擴充功能設定。

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

Facebook Business 擴充功能（FBE）是 Meta 的彈出視窗式介面，以附加程式的形式在第三方網站上運行，可簡化與 Meta 整合時的整體過程。Facebook Business 擴充功能可讓企業輕鬆設定 Meta 像素、目錄和商店，幫助企業在您的平台上將其產品和服務與 Facebook 和 Instagram 渠道連結起來。建立連結後，您便可以幫助企業善用一系列強大功能。

簡單來說，透過 Facebook Business 擴充功能作整合時，各方責任劃分大致如下：

• Meta 的責任：介面、驗證、連結和平台 [（Facebook Business 擴充功能管理檢視畫面）]（Facebook Business 擴充功能的功能管理檢視畫面），用於查看已連結資產、管理已安裝功能和查看商務整合工具狀態
• 合作夥伴的責任：設定像素、透過 API 將庫存上載至 Facebook 目錄

設定完成後，您的任何企業都可透過現有資產或建立新資產來開始 Facebook Business 擴充功能入門設定流程；或者結合兩者來開始流程皆可。

第 1 步：將 Facebook Business 擴充功能的入口點加至您的應用程式

建立 Facebook Business 擴充功能的入口點，以便用戶在其中選擇、管理或建立資產，例如企業、目錄、商店、像素等。這些入口點可以採用以下形式之一：

• 企業登入（一般稱為「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 商家編號
• 商業應用程式 — 透過 Webhooks 進行。

第 2 步：設定 FBE_install Webhooks

所有想在應用程式商店上架的合作夥伴均須設定 Webhooks。如果您未計劃在應用程式商店中上架應用程式，可以選擇略過此部分或稍後再回來查看。每當企業安裝、修改或解除安裝 Facebook Business 擴充功能時，Meta 便會觸發 Webhook 事件。每次收到 Webhook 事件後，您的應用程式應可使用該事件了解企業在與您應用程式的連結中修改、新增或移除了哪些內容。您應用程式的行為應根據最新的已連結資產來作更新。我們強烈建議您訂閱和測試我們的 Webhook。

如要設定 Webhooks，請採取以下操作：

1. 在安全的伺服器上建立可妥善處理 Meta 要求的端點。
2. 在應用程式管理中心中，按照以下步驟配置您的 Facebook Business 擴充功能 Webhooks 說明：
1. 依次前往 Facebook Business 擴充功能部分 > Webhooks 分頁，輸入您應用程式的回呼網址。
2. 輸入驗證憑證，然後驗證您的端點。

完成設定後，系統便會自動訂閱 fbe_install Webhook。

如需進一步了解詳細步驟，請參閱 Webhook。

通知

收到有關安裝的 Webhook 通知後，您需要執行以下步驟：

1. 儲存存取憑證（及其類型），並記錄您的應用程式獲授權存取的資產。
2. 根據獲授權的資產，啟用特定功能組合。
3. 如果缺少特定功能所需的資產，請僅禁用該功能。例如，如果您的應用程式獲授權存取目錄，但無權存取像素，則僅執行目錄支援的功能，不執行像素支援的功能。
4. 根據應用程式有權存取的資產，通知用戶關於應用程式行為方式的更新。

收到有關現有安裝的更新後，您需要執行以下步驟：

1. 更新您已獲授權的資產之存取憑證和記錄。
2. 根據平台獲授權的資產，更新您的應用程式會為此賣家啟用的特定功能組合。
3. 根據應用程式有權存取的資產，通知用戶關於應用程式行為方式的更新。

收到有關解除安裝的通知後，您需要執行以下步驟：

1. 停用您應用程式為相關賣家執行的功能。
2. 通知賣家關於其配置的變更。

第 3 步：透過傳回的憑證擷取資產詳情

您可以使用以下兩種／其中一種方法，獲取透過 Facebook Business 擴充功能連結至您平台的企業相關資訊：

• Webhook — 對於任何想在應用程式商店上架的合作夥伴，此為必要項目。設定 Webhook 後，如果企業透過 Facebook Business 擴充功能開始入門設定流程或作出編輯，您便可以使用在第 2 步設定的 Webhook，在 Webhook 裝載中收到有關詳情。
• Facebook Business 擴充功能安裝 API 端點 — 對於自行託管的企業，此為建議項目。對於任何已安裝 Facebook Business 擴充功能的企業，您都可以使用 fbe_installs 端點查詢其基本安裝資訊。您可以使用企業的存取憑證和外部企業編號呼叫 Facebook Business 擴充功能安裝 API 端點，以獲取企業的詳細設定資訊。

範例：Facebook Business 擴充功能安裝 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 步：擷取系統用戶憑證

用戶安裝 Facebook Business 擴充功能後，擴充功能會在客戶的企業管理平台上建立員工系統用戶。請注意，雖然此系統用戶已不再在企業管理平台顯示，但仍存在於後端。我們會按照 {App Name} 系統用戶（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 步：設定管理檢視畫面

除了安裝時所指定的功能以外，如要允許企業配置更多功能，您可以將企業從您的平台導向我們的 Facebook Business 擴充功能的功能管理視圖。您可以使用 JavaScript SDK 或網址，新增用於啟動 Facebook Business 擴充功能管理檢視畫面的入口點。這兩種方法均需要顯示一個可供用戶點擊的按鈕，點擊後將啟動 Facebook Business 擴充功能管理檢視畫面視窗。

第 6 步：新增用於解除安裝 Facebook Business 擴充功能的入口點

您應要為平台新增入口點（例如按鈕），以便企業解除安裝 Facebook Business 擴充功能。要做到這一點，我們建議您向相應端點發出 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，便可以在用戶解除安裝 Facebook Business 擴充功能時收到事件。

了解詳情

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