配置商家功能

瞭解有哪些選項可用來為 Facebook Business 擴充功能啟用及配置商業功能。

配置選項

若要為用戶啟用及配置商家功能,請使用下列其中一個可用的選項:

選項說明建議使用方式

透過商家登入進行功能設定

傳遞至商家登入,以啟用及停用 Facebook Business 擴充功能(FBE)的功能。

透過 FBE 開發人員面板為合作夥伴啟用此功能選項。使用此功能時,合作夥伴應讓用戶知道這些功能會自動為其啟用。

如果要為用戶設定預設的功能組合,建議使用此功能。

功能管理檢視

可讓用戶啟用及停用 FBE 功能的自助服務 Facebook 用戶介面。

如果您不想建立用戶介面並使用 Facebooks 的用戶介面自助服務,也不想使用其 Facebook 和 Instagram 的功能,建議使用此功能。

功能配置 API

建立可啟用及停用 FBE 功能的自訂功能管理檢視

建議建立您自己的功能管理檢視,以搭配用戶檢視畫面的外觀與風格。

支援的功能

Facebook Business 擴充功能提供許多您可以為商家啟用的功能。

下列功能依其最適合的產業分組:

標準功能

功能參數說明

Facebook 粉絲專頁行動呼籲

page_cta(s)

類型:FBEPageCtaConfigData

商家 Facebook 粉絲專頁上的行動呼籲(CTA)按鈕。

Instagram 行動呼籲

ig_cta(s)

類型:FBEIGCtaConfigData

商家 Instagram 個人檔案上的行動呼籲(CTA)按鈕。

Messenger 行動呼籲

messenger_menu

類型:FBEMessengerMenuConfigData

用戶傳送訊息給商家時,Messenger 中的行動呼籲(CTA)按鈕。

Messenger 聊天室

messenger_chat

類型:FBEMessengerChatConfigData

可將 Messenger 直接整合在您的網站上,讓顧客能隨時與您的商家互動。

預約專屬功能

功能參數說明

精選服務粉絲專頁小卡片

page_card

類型:FBEPageCardConfigData

需要目錄

商家的 Facebook 粉絲專頁上包含商家精選服務的小卡片。

Messenger 傳送開放預約時段對話串意願

thread_intent

類型:FBEThreadIntentConfigData

為商業帳號管理員提供的 Messenger 建議,可協助管理員在聊天室中輕鬆將開放預約時段傳送給用戶。

不需額外的實作

功能參數說明

Facebook 粉絲專頁行動呼籲

page_cta

類型:FBEPageCtaConfigData

商家 Facebook 粉絲專頁上的行動呼籲(CTA)按鈕。

Instagram 行動呼籲

ig_cta

類型:FBEIGCtaConfigData

商家 Instagram 個人檔案上的行動呼籲(CTA)按鈕。

Messenger 行動呼籲

messenger_menu

類型:FBEMessengerMenuConfigData

用戶傳送訊息給商家時,Messenger 中的行動呼籲(CTA)按鈕。

Messenger 傳送開放預約時段對話串意願

thread_intent

類型:FBEThreadIntentConfigData

為商業帳號管理員提供的 Messenger 建議,可協助管理員在聊天室中輕鬆將開放預約時段傳送給用戶。

需要額外的實作

功能參數說明

精選服務粉絲專頁小卡片

page_card

類型:FBEPageCardConfigData

僅適用於預約產業

需要實作目錄

在商家的 Facebook 粉絲專頁上啟用包含商家精選服務的小卡片。請參閱 FBE 目錄,以瞭解服務產業的必填欄位和格式。

Messenger 聊天室

messenger_chat

類型:FBEMessengerChatConfigData

可將 Messenger 直接整合在您的網站上。此功能可讓顧客以 Messenger 中同樣的個人化、多媒體體驗,隨時與商家互動。

如果 messenger_chat功能配置 API 傳回 enabled: true

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>
  • 可透過 Webhook 或由 FBE 安裝端點指南取得 page_id
  • Facebook 會依據傳入的 page_id 自動擷取自訂項目,因此不需要明確傳遞任何自訂項目。

如需完整實作指南,請參閱顧客洽談外掛程式

透過商家登入進行初始化功能設定

您可以為商家配置任意數量的功能,只要在 business_config 屬性中指定這些功能即可,此屬性會同時透過商家登入和應用程式商店中的 extras 參數傳入。您應在完成 FBE 安裝後立即在這裡指定要為商家啟用的所有功能。

business_config 為 JSON 物件,其中包含說明如何配置各種功能的子欄位。深入瞭解需指定的子欄位和 business_config。例如,若只要配置商家的 Facebook 粉絲專頁 CTA 和 Instagram CTA,您的 business_config 物件應如下所示:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

FBE 功能管理檢視

若要讓商家進一步配置功能(除了您在安裝期間在 business_config 中為商家指定的功能外),您可以將商家從您的平台導向至我們的 FBE 管理檢視。

您可以新增下列任何方法(Javascript SDK 或 URL),新增用來啟動 FBE 管理檢視的進入點。兩個範例都會顯示可點擊的按鈕,該按鈕會啟動「FBE 管理模式」視窗。建議在用戶端完成 FBE 設定前,隱藏 FBE 啟動按鈕。確定傳遞 fbe_external_business_id 作為 external_business_id

您可以傳遞包含所需頁籤名稱的 tab 選用參數,為 FBE 管理檢視指定所選頁籤。例如,可將其設定為「家用」或「商用」。這個參數可用於 JavaScript SDK 或搭配網址方法使用。

Facebook Javascript SDK

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

網址方法

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

FBE 功能配置 API

若要在商家的功能初始安裝後,從您的端點配置及更新功能,可使用 FBE 功能配置 API

對於無法自訂的功能,只會顯示功能實例編號和已啟用的標示。只有可自訂的功能可透過 POST 要求來更新。

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

下列 API 端點可讓您在已安裝 FBE 的平台上,為特定商家啟用、停用及配置功能。用於這些端點的 access_token 與透過商家登入或 Webhook 將您傳回的存取權杖相同。

建議不要將商家配置儲存在您的伺服器上。這些配置應一律透過以下定義的 API 進行查詢,然後修改。用戶可能會在 Facebook 開放平台上或透過 FBE 管理檢視變更這些功能,而您的平台可能就不會有最新的配置。

讀取

若要讀取任何商家目前的功能配置狀態,可發送下列要求:

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

回應

請參閱 business_config 物件

更新

若要更新任何和所有功能,請提供下列 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_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

啟用及配置終端用戶粉絲專頁的行動呼籲按鈕,並發送 POST 要求:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

瞭解詳情

目錄

後續步驟

觸發像素事件