Business Messages 小工具

Business Messages 小工具 JavaScript 程式庫會以程式輔助方式初始化及 啟用 Business Messages 小工具的參與度追蹤功能。

函式與屬性

函式和屬性可讓您精細控管元素 和初始化。

Init

動態初始化要做為 Business Messages 小工具。函式會傳回可解析的承諾， 初始化完成

window.bmwidget.init(HTMLElement, {agentId, context}):Promise

• HTMLElement 是要初始化為小工具的元素。
• {agentId, context} 是 data-bm-widget-agent-id 和 data-bm-widget-context HTML 屬性。

掃描

掃描文件中，找出任何包含 data-bm-widget-agent-id 屬性，並將這些元素轉換為商家 「訊息」小工具。載入網頁時自動呼叫 window.bmwidget.scan() 以及在指令碼初始化期間

window.bmwidget.scan():void

有權限

唯讀布林值標記，設為 true (如果使用者裝置支援) Business Messages。

window.bmwidget.supported:boolean

活動

程式庫會在初始化的 HTML 元素上觸發事件 Business Messages 小工具。

繫結成功

HTML 元素出現下列情形時，會觸發 bm-widget-bind-success 事件 已順利繫結為 Business Messages 小工具，可立即使用。

domNode.addEventListener('bm-widget-bind-success', (event) => {
  console.log(event.data);
});

繫結失敗

嘗試繫結至 HTML 時，會觸發 bm-widget-bind-fail 事件 就會發生故障這可能是因為網址驗證失敗，或 因為無法取得 HTML 元素。驗證失敗 如果網址尚未註冊為 Business Messages 小工具項目，就會發生這種情形 ，或是使用者的裝置不受支援。 event.data 屬性詳細資料 導致失敗的原因

domNode.addEventListener('bm-widget-bind-fail', (event) => {
  console.log(event.data);
});

意圖觸發條件

使用者輕觸已初始化的商家時，會觸發 bm-widget-intent-trigger 事件 訊息小工具進入點。這個事件表示輕觸了，但沒有表示 Business Messages 對話介面是否成功初始化。

domNode.addEventListener('bm-widget-intent-trigger', (event) => {
  console.log(event.data);
});