移轉指南：MBE 第 2 版移轉至 MBE 第 3 版

本指南說明移轉 Meta Business 擴充功能（MBE 第 2 版）上現有的商業應用程式時，需要進行哪些變更，才能與 MBE 第 3 版相容。往後，MBE 將需要這些更新項目，且無法與下一版圖形 API 向下相容。

MBE 第 3 版的主要優點

MBE 第 3 版可讓第三方開發人員：

1. 提供商家更簡單的初始設定流程。

2. 幫助減少流失顧客。

3. 可讓商家彈性管理想要為各個商業應用程式啟用的功能。例如，網路賣家剛開始可以使用某個商業應用程式來設定訊息功能，之後再透過同一個應用程式選擇啟用 Facebook 商店。這是向商家追加銷售多個 FBE 功能的絕佳方式。

4. 在與 FBE 的整合中納入多種商家類型。例如，第三方應用程式可以針對只需要廣告主工具的部分商家提供一種類型的整合，另外針對只需要訊息工具的商家單獨提供另一種類型的整合。

開始之前

請確認您的 Meta 合作夥伴經理知道您要進行此升級作業，讓他們可以在您需要協助時，提供適當的支援。

總覽

專用術語

功能（Feature）：可以為商家提供成果的特定整合。每個整合都有獨特的實作需求，您可以設定想要啟用哪些功能。範例可包括 page_cta、chat_plugin 等。如需完整清單，請參閱此功能清單。

產業（Vertical）：代表商家類型。您可以依據所服務的商家類型，整合一或多種產業。單一商家也可以依據自己的需求，使用一或多個產業來設定。如需完整清單，請參閱此產業清單。

意願（Intent）：「意願」是特定使用案例的 MBE 名稱。例如，名為 CATALOG_ADS 意願的使用案例可以讓您的應用程式執行目錄廣告，以同步和宣傳目錄的產品和服務。意願會顯示在功能選單上，並對應商家取得之多項功能的組合。

使用第 3 版的意願類似第 2 版的「管道」。您不需要在登入流程中配置意願，但這麼做可提示您的商家或廣告主，先完成指定意願的初始設定，才會在功能選單中看到其餘的可用意願。若未在登入流程中配置意願，商家或廣告主將會在功能選單中看到您所屬產業的所有可用意願，並能夠在 MBE 開始時選擇自己的意願。

如需完整清單，請參閱這個依產業分類的意願清單。

第 2 版與第 3 版的主要差異

MBE 第 3 版可讓您更精確地掌控商家在初始設定期間可啟用的功能。因此，我們將升級用戶介面，並變更 Webhook 和 API 回應，以反映此層級的功能細節。

根據您選擇啟用的功能，以及您針對商家傳入的產業，MBE 會在初始設定流程中顯示功能選單，讓商家可以選擇想要安裝的功能。然後商家就可以在「管理檢視」中管理這些功能，並可在您的介面上重新進入流程或透過「管理檢視」介面來新增更多功能。

建議

由於商家啟用的功能集為動態選用性質，因此建議您建置一個用來保存記錄的架構。針對每個商家：

1. 保存已啟用的功能及其相關資產清單。
2. 與 Meta API 同步，以確保這個已啟用哪些功能的記錄保持更新和準確。

需求

MBE 第 3 版可讓商家用戶：

• 選擇加入與自己相關的應用程式功能子集

• 陸續新增或移除個別功能，不受其他功能影響

因此，應用程式整合需要：

1. 遵循更新。在商家每次完成流程或更新商家功能時，系統會傳送 Webhook。

2. 一旦收到 Webhook，呼叫 FBE 安裝 API 即可檢查哪些功能已啟用。商家每次完成流程時，都可啟用或停用功能。

3. 在您的平台中，更新已為此商家啟用的功能記錄。

4. 根據功能清單中的合作夥伴實作詳細資訊，啟用每項功能。例如，如果您啟用了多個需要專屬個別目錄的功能，則必須維持每個目錄的同步狀態。如果需要其他功能資訊，請從功能配置 API 擷取。

您的應用程式不應假設應用程式支援的所有資產都會傳回。例如：

• 商家只使用 Instagram 帳號也可以設立商店。因此，您的應用程式不應要求商家設定粉絲專頁來啟用此功能。

• 商家不需要設定粉絲專頁或 Instagram 行動呼籲（CTA）按鈕，也可以設定轉換摘要來提升廣告成效。您的應用程式不應要求商家設定粉絲專頁或 Instagram 帳號來啟用此功能。

將您的整合更新至第 3 版

本節說明如何將 MBE 第 3 版的必要變更項目更新至整合中。由於 MBE 第 3 版與 MBE 第 2 版基本上完全不同，建議您遵循這些實作守則，以減少對用戶造成的可能干擾。

步驟 1：設定功能及回應更新

• 更新 Webhook 流程：遵循 Webhooks，其指出商家已更新所要啟用的功能集。

• 更新與 FBE 安裝 API 的整合：呼叫 FBE 安裝 API 並更新您的記錄，以瞭解商家啟用了哪些功能。

• 更新與功能配置 API 的整合：配置每個功能，並在需要時呼叫功能配置 API 來擷取每個功能的其他資訊。

步驟 2：配置應用程式支援的功能

針對您的商家顯示在功能選單中的功能，是您在 MBE 開發人員面板中配置的功能。

步驟 3：配置產業

配置產業時，請務必在 business_vertical 下的額外配置中，針對每個商家傳送適當的產業。例如，若是美髮沙龍，請傳送 ‘APPOINTMENTS’。若是銷售產品的商店，請傳送 ‘ECOMMERCE'。

如果商家屬於多個產業，請在您的介面上針對每個進入點傳送不同的產業（視商家嘗試達到的目標而定）。例如，如果美髮沙龍既提供預約服務，也銷售美髮產品，您可以從進入點 1 傳送 ‘APPOINTMENTS’，並從進入點 2 傳送 ‘ECOMMERCE’。每個進入點都需要配置自己的產業特定功能，才能正常運作。

同時透過這兩個產業進行初始設定的商家或廣告主，如果使用同一個 external_id，則會被「鎖定」在同一個企業管理平台的各別產業。商家用來初始設定之第一個產業中的資產（粉絲專頁、像素、目錄），會在第二個產業中預先選取，但商家可以選擇為第二個產業選取不同的資產。商家安裝的所有功能都可以在功能配置 API 上讀取。

步驟 4：用戶介面變更

更新後的初始設定流程（最小初始設定）會顯示「功能選單」，其中會顯示一個意願清單，這些意願是您為商家啟用之一或多個功能的組合包。商家可以選擇他們想要安裝的意願。如果您希望商家先安裝特定意願，然後才看到功能選單，請在設定物件中傳入 intent 參數。您可以從此參數的意願清單中選擇。如果您想要針對用戶介面更新進行實驗，或不想要這個新的更新用戶介面，flow_config 物件中的參數 use_minimal_onboarding 可決定要顯示哪個用戶介面。若將 Use_minimal_onboarding 設為 false，則會維持 MBE 第 2 版用戶介面。

步驟 5：管理檢視

第 3 版的「管理檢視」會顯示商家已安裝的所有功能，並提供外部連結，以安裝更多功能。「管理檢視」的連結已更新為：

<a href=”https://business.facebook.com/latest/business_app_store/manage_external_business_connection?asset_id=<page_id>&business_id=<business_id>&app_id=<app_id>&external_business_id=<external_business_id>"><button>Launch Management View</button></a>

步驟 6：啟用功能變更

為了啟用這些功能變更，已更新下列 API：

Webhook 更新

每次安裝和解除安裝都會傳送 Webhook，且其中只包含商家已安裝的功能。

針對解除安裝，回應時還會傳送一個僅包含已安裝功能的 Webhook（例如，不包含已解除安裝的功能）。每次傳送 Webhook 後，請從 FBE 安裝 API 擷取真實資訊來源。

回應

{
  "data": [{
    "ad_account_id": "<ad_account_id>",
    "business_manager_id": "<business_manager_id>",
    "catalog_id": "<catalog_id>",
    "commerce_merchant_settings_id": "<commerce_merchant_settings_id>",
    "onsite_eligible": true,
    "profiles": [
      "<page_id>",
      "<instagram_profile_id>"
    ],
    "pages": [
      "<page_id>"
    ],
    instagram_profiles": [
"<instagram_profile_id>"
    ],
    "pixel_id": "<pixel_id>",
    "token_type": "<token_type>",
    "installed_features": [
        {
            "feature_instance_id": "<unique_id>",
            “feature_name” : string, 
            "feature_type": enum,
            "connected_assets": {
                “ad_account_id”: "<ad_account_id>",
                “business_manager_id”: "<business_manager_id>",
                “catalog_id”: "<catalog_id>",
                “commerce_merchant_settings_id”: "<commerce_merchant_settings_id>",
                “ig_profile_id”: "<instagram_profile_id>"               
                "page_id": "<page_id>",
                "pixel_id": "<pixel_id>",
            },
            “additional_info”: {
               “onsite_commerce_eligible”: bool
            }
        }
    
  }]
}

回應欄位

FBE 安裝 API 更新

更新的 API 模型會傳送商家已啟用之每個功能和每個功能所連結資產的清單。主要變更為新增 installed_features 欄位。此承載與 Webhook 回應相同。

接收 Webhook 之後，請按照下列建議步驟操作：

1. 使用所收到的外部商家編號和存取權杖呼叫 FBE 安裝 API。此 API 包含已安裝功能及其連結資產的真實資訊來源。請妥善記錄這些功能配置。

2. 為該商家啟用這些功能（有關「啟用」含義的詳細資訊位於功能清單表格中），並從功能配置 API 擷取功能的任何其他必要資訊。

下列程式碼範例顯示對 FBE 安裝 API 的要求和對應 API 回應的範例。在回應中，新增的第 3 版欄位會醒目標示。

要求

CURL -X GET 
'https://graph.facebook.com/<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

回應

{
  "data": [{
    "ad_account_id": "<ad_account_id>",
    "business_manager_id": "<business_manager_id>",
    "catalog_id": "<catalog_id>",
    "commerce_merchant_settings_id": "<commerce_merchant_settings_id>",
    "onsite_eligible": true,
    "profiles": [
      "<page_id>",
      "<instagram_profile_id>"
    ],
    "pages": [
      "<page_id>"
    ],
    "instagram_profiles": [
      "<instagram_profile_id>"
    ],
    "pixel_id": "<pixel_id>",
    "token_type": "<token_type>",
<!--UPDATES BELOW-->
    "installed_features": [
        {
            "feature_instance_id": "<unique_id>",
            “feature_name” : string, 
            "feature_type": enum,
            "connected_assets": {
                “ad_account_id”: "<ad_account_id>",
                “business_manager_id”: "<business_manager_id>",
                “catalog_id”: "<catalog_id>",
                “commerce_merchant_settings_id”: "<commerce_merchant_settings_id>",
                “ig_profile_id”: "<instagram_profile_id>"               
                "page_id": "<page_id>",
                "pixel_id": "<pixel_id>",
            },
            “additional_info”: {
               “onsite_commerce_eligible”: bool
            }
        }
    ]
  }]
}

功能配置 API 回應更新

更新的模型包含每個功能的功能實例編號，以及該商家安裝之該類型所有功能陣列組成的新欄位（例如：多頁 CTA）。

針對功能清單中描述的不可自訂功能，只會顯示功能實例編號和已啟用標示。您只能透過 POST 要求來更新可自訂的功能。

此模型不同於 FBE 安裝 API，因為它提供所連結資產之外的其他功能資訊，包括已啟用狀態和特定功能自訂項目。呼叫 FBE 安裝 API 後，如果需要有關功能已啟用狀態或配置的更多資訊，請使用此 API。

讀取

您可以使用下列要求來讀取任何商家目前的功能配置狀態：

CURL -X GET 
'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

更新

若要更新所有功能，請使用下列 POST 要求：

CURL -i -X POST \   
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' 
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

回應

{
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  “ig_cta”: {...}
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

測試

測試之前，請將下列各項傳送給您的 Meta 業務代表：

1. 您想要啟用的功能。

2. 流程測試者個人的用戶編號。

3. 您的測試版應用程式編號，以便我們將該應用程式加入第 3 版的允許清單。

4. 如果您進行測試時需要協助，請在測試版應用程式上授予角色給您的 Meta 業務代表。

若要測試這些第 3 版變更，請完成初始設定流程，並確認：

1. 您在安裝和解除安裝時收到 Webhook。

2. Webhook、安裝 API 和功能配置 API 具有上述更新（正確顯示已安裝和解除安裝的功能）。

3. 功能選單會反映您想要商家安裝的功能（依產業分類）。

若要測試初始設定流程，您可以：

1. 透過商家登入。

2. 透過商業應用程式（若適用）

請務必針對您想要的功能，以及想要顯示在「商家登入」和「商業應用程式」中的用戶介面，傳送正確的商家配置物件。

功能清單

MBE 第 3 版提供下列功能，您可以為商家啟用這些功能。所有這些功能都可以透過 FBE 安裝 API 傳入（在安裝流程期間），但是如表格所示，並非所有功能都可以透過功能配置 API 來配置（商家或廣告主已經安裝 MBE 之後）。

messenger_chat 程式碼範例

<div class="fb-customerchat"
            page_id=PAGE_ID 
</div>

產業清單

識別您的應用程式屬於哪個（些）產業：

依產業分類的意願（使用案例）

廣告

廣告創意

電子商務

預約

訂位

餐飲

名單型廣告

成效衡量和最佳化

資料整合