轉移指南：Meta Business 擴充功能 v2 版至 v3 版

本指南說明轉移 Meta Business 擴充功能（MBE v2 版）上的現有商業應用程式時需要有哪些變更，方可與 Meta Business 擴充功能 v3 版相容。日後，Meta Business 擴充功能需要這些更新才能使用，下一版 Graph API 將不會向下相容。

Meta Business 擴充功能 v3 版的主要優點

第三方應用程式開發人員可以透過 Meta Business 擴充功能 v3 版提供以下支援：

1. 為企業提供更簡單的初始功能設定流程。

2. 幫助減少顧客流失。

3. 允許企業靈活管理企業想為每個商業應用程式啟用的功能。例如，網上賣家一開始可以為商業應用程式設定訊息功能，然後再選擇為同一個應用程式啟用 Facebook 商店。這是向企業追加銷售多種 Facebook Business 擴充功能的絕佳方式。

4. 支援多種企業類型，以便企業與 Facebook Business 擴充功能整合。例如，第三方應用程式可以為只需廣告客戶工具的部分企業提供某一類整合工具，然後單獨為只需訊息工具的企業提供另一類整合工具。

準備工作

確保您的 Meta 合作夥伴經理知道您正在進行此項升級，以便他們能在您需要幫助時提供適當支援。

概覽

術語

功能：可為您的企業帶來成果的特定整合工具。每項整合工具都有各自的執行要求，您可以根據需要設定要啟用的功能。例子包括 page_cta、chat_plugin 等。如要查看完整清單，請參閱此功能清單。

行業：代表企業所屬的類型。您可以與一個或多個行業整合，具體視乎您為哪類型的企業提供服務。您也可為單個企業設定一個或多個行業，具體視乎企業需求而定。如要查看完整清單，請參閱此行業清單。

意向：意向是指特定使用案例對應的 Meta Business 擴充功能名稱。例如，CATALOG_ADS 意向是一種使用案例的名稱，此使用案例允許您的應用程式刊登目錄廣告、同步和推廣目錄內商品與服務。意向會顯示在功能選單中，並與企業可以使用的一系列功能相對應。

使用 v3 版的意向與 v2 版中的「渠道」十分類似。您不一定要在登入流程中配置意向，但配置後系統便會提示您的商家或廣告客戶先完成特定意向的初始功能設定流程，然後才能查看功能選單中的其他可用意向。若您不在登入流程中配置意向，系統就會向商家或廣告客戶顯示包含您所選行業內所有可用意向的功能選單，並且允許他們在一開始使用 Meta Business 擴充功能時選擇自己的意向。

如要查看完整清單，請參閱此按行業分類的意向清單。

v2 版與 v3 版之間的主要差異

Meta Business 擴充功能 v3 版針對企業可在初始功能設定流程中啟用的功能，提升精確度和提供更多控制項。有鑑於此，我們將會升級用戶介面並變更 Webhook 和 API 回應，以反映此程度的功能細節。

根據您選擇啟用的功能和為企業提交的行業資訊，Meta Business 擴充功能會在初始功能設定流程中顯示功能選單，供企業選擇要安裝的功能。接著，企業可以在管理檢視畫面中管理這些功能，以及透過在您的介面重新進入初始功能設定流程或透過管理檢視畫面介面，來新增更多功能。

建議

由於企業啟用的功能組合並非固定而且屬選用性質，我們建議您組建一個架構以作記錄。請為每間企業採取以下措施：

1. 保存已啟用的功能清單及其相關資產。
2. 與 Meta API 同步，確保此功能啟用記錄為最新版本且內容準確無誤。

必要條件

Meta Business 擴充功能 v3 版支援企業用戶完成以下操作：

• 選擇使用您應用程式中與其相關的一部分功能

• 隨時間獨立新增或移除某些功能，不受其他功能影響亦不影響其他功能

因此，應用程式整合工具需要採取以下操作：

1. 聽取更新。每當企業展開初始功能流程或更新已啟用的功能時，系統都會傳送 Webhook。

2. 收到 Webhook 後，請呼叫 Facebook Business 擴充功能安裝 API 以查看已啟用的功能。每當企業展開流程時，他們都能啟用或停用某些功能。

3. 在平台內更新已為該企業啟用的功能記錄。

4. 根據功能清單所列的合作夥伴執行詳情，啟用每項功能。例如，如果您已啟用多項需要獨立目錄的功能，則必須為每個目錄保持同步。如有需要，請從功能配置 API 中提取更多功能資訊。

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

• 如果企業想設定商店，其實也可以選擇使用 Instagram 帳戶完成操作。因此，您的應用程式不應要求企業為啟用此功能而設定專頁。

• 如果企業想設定轉換動態消息以提升廣告成效，其實也不一定要設定專頁或 Instagram 呼籲字句（CTA）按鈕。您的應用程式不應要求企業為啟用此功能而設定專頁或 Instagram 帳戶。

將整合工具更新至 v3 版

此部分介紹如何根據 Meta Business 擴充功能 v3 版的所需變更，來更新您的整合工具。Meta Business 擴充功能 v3 版的設計從根本上與 Meta Business 擴充功能 v2 版不同，因此我們建議您按照以下執行指引操作，減少用戶遇到服務中斷的機會。

第 1 步：設定功能並回應更新

• 更新 Webhook 流程：聽取特定 Webhooks，這些 Webhooks 會表明企業已更新要啟用的功能組合。

• 使用 Facebook Business 擴充功能安裝 API 更新整合工具：透過呼叫 Facebook Business 擴充功能安裝 API 及更新記錄，了解企業已啟用的功能。

• 使用功能配置 API 更新整合工具：配置每項功能，並在需要時呼叫功能配置 API 以提取每項功能的其他資訊。

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

功能選單中對商家顯示的功能，就是您在 Meta Business 擴充功能開發人員面板中配置的功能。

第 3 步：配置行業

配置行業時，請務必在 extras 配置中的 business_vertical 下為每個企業傳送適當的行業。例如，如果為髮型屋，可傳送 ‘APPOINTMENTS’；如果為售賣產品的商店，則傳送 ‘ECOMMERCE'。

如果企業屬於多個行業，則為您介面上的每個入口點傳送不同的行業（視乎企業希望達成的目標而定）。例如，如果髮型屋同時提供預約服務和售賣美髮產品，您可以從入口點 1 傳送 ‘APPOINTMENTS’ 並從入口點 2 傳送 ‘ECOMMERCE’。每個入口點都需要經配置其行業專屬功能，才能正常運作。

若商家或廣告客戶使用的是同一個 external_id，而且同時就兩個行業完成初始功能設定，有關商家或廣告客戶將被「鎖定」就不同行業使用同一個企業管理平台。系統將就第二個行業預選商家在初始功能設定時為第一個行業所選的資產（專頁、像素、目錄），但商家可以為第二個行業選擇其他資產。商家安裝的所有功能均可透過功能配置 API 讀取。

第 4 步：用戶介面變更

更新後的初始功能設定流程（精簡版初始功能設定）會顯示「功能選單」，當中會展示意向清單，列出您為企業啟用的一個或一連串功能。企業可以選擇想安裝的意向。如果您想讓企業先安裝某個特定的意向，然後才能查看功能選單，請在 setup 物件中傳送 intent 參數。您可以從意向清單中選擇此參數。如果您想就用戶介面更新進行實驗，或不想使用此更新版用戶介面，可以使用 flow_config 物件中的 use_minimal_onboarding 參數來決定要顯示的用戶介面。若將 Use_minimal_onboarding 設為 false，系統會保留 Meta Business 擴充功能 v2 版的用戶介面。

第 5 步：管理檢視畫面

v3 版的管理檢視畫面會顯示企業已經安裝的所有功能，且設有外部連結以供安裝更多功能。管理檢視畫面的連結已更新為如下連結：

<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 時，請您均從 Facebook Business 擴充功能安裝 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
            }
        }
    
  }]
}

回應欄位

Facebook Business 擴充功能安裝 API 更新

更新後的 API 模型會傳送企業已啟用之每項功能的清單，以及與每項功能連結的資產。當中一項主要變更是新增了 installed_features 欄位。此裝載與 Webhook 回應相同。

收到 Webhook 後，請按照以下建議步驟操作：

1. 使用收到的外部企業編號和存取憑證呼叫 Facebook Business 擴充功能安裝 API。此 API 包含已安裝功能的可信數據源及其已連結資產。請妥善記錄這些功能配置。

2. 為該企業啟用這些功能（請參閱功能清單表格了解「啟用」的具體含義），並從功能配置 API 中提取有關功能的任何其他所需資訊。

以下代碼範例是對 Facebook Business 擴充功能安裝 API 的要求範例及對應的 API 回應。回應中，額外的 v3 欄位已作重點標示。

要求

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 要求只能用於更新可自訂的功能。

此模型不同於 Facebook Business 擴充功能安裝 API，因為前者會提供已連結資產以外的其他功能資訊，包括已啟用狀態和具體的功能自訂項目。呼叫 Facebook Business 擴充功能安裝 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. 您的測試版應用程式編號，以便我們將其加入 v3 版的許可清單。

4. 若在測試方面需要幫助，請向您的 Meta 代表指派測試版應用程式角色。

如要測試這些 v3 版變更，請完成 Meta Business 擴充功能初始功能設定流程並確保符合以下條件：

1. 您在執行安裝和解除安裝操作後收到 Webhook。

2. Webhook、安裝 API 和功能配置 API 已經完成上述更新（準確顯示已安裝和已解除安裝的功能）。

3. 功能選單有展示您想讓企業安裝的功能（按行業）。

您可以透過以下方式測試初始功能設定流程：

1. 完成企業登入流程。

2. 完成商業應用程式流程（如適用）

請務必就您需要的功能以及想在企業登入和商業應用程式中看到的用戶介面，傳送正確的商業配置物件。

功能清單

Meta Business 擴充功能 v3 版提供以下可供您為企業啟用的功能。以下所有功能均可透過 Facebook Business 擴充功能安裝 API 在安裝流程中提交；但就如表格所示，並非所有功能都可透過功能配置 API，在商家或廣告客戶安裝 Meta Business 擴充功能後加以配置。

messenger_chat 代碼範例

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

行業清單

找出您的應用程式屬於哪個或哪些行業：

按行業分類的意向（使用案例）

廣告

廣告創意

電子商務

預約

預訂

飲食

名單型廣告

成效衡量和優化

資料整合