是的,您可以使用 JavaScript 回應各種小工具事件。 做法是在小工具設定中前往小工具程式碼面板,點選+ 事件處理按鈕。 事件處理程式碼就會加入小工具程式碼中。
這段程式碼會在各種小工具事件發生時,將訊息輸出至主控台。
只要依需求將這些事件處理常式替換為您自己的程式碼即可。
可用的事件如下:
- INITIALIZED:小工具載入時觸發。
- RESOURCE_GROUP_OPENED:在目錄中開啟群組時觸發。傳遞參數 name 和 resourceGroupId。
- RESERVATION_STARTED:開啟資源進行預訂時觸發。傳遞參數 name 和 resourceId。
- RESERVATION_SAVED:從預訂畫面進入購物車畫面時觸發。傳遞參數 name 和 resourceId。
- INDIRECT_ORDER_STARTED:出現付款表單並等待付款時觸發。
- ORDER_COMPLETED:訂單成功完成時觸發。事件資料可以自行產生(請見下方說明)。若未自行產生,則會傳遞一個只含基本標準欄位 orderNumber、total 和 deposit 的物件。
您可以自行產生 ORDER_COMPLETED 事件的資料。 做法是前往觸發器區段。 建立一個在收到客戶訂單時自動執行的觸發器。 在觸發器中新增一項任務。 接著新增傳送資料至 JS動作,並在資料範本(JSON)欄位中輸入 JSON 範本,例如:
{
"orderNumber": "[bukza_order_number]",
"total": [bukza_total],
"phone": "[bukza_phone]"
}
範本中可以插入任何訂單參數。
在某些情況下,您可能無法將含事件處理常式的小工具程式碼直接加入自己的頁面。 例如小工具安裝在社群網站上,或您提供給客戶的是小工具的直接連結。 這時,您可以透過內部 iframe,直接在小工具內執行自己的程式碼。
做法是勾選使用內部 iframe 處理事件核取方塊:
接著有兩種做法:將處理程式碼放在您自己的網站上並填入頁面 URL,或直接將頁面原始碼插入小工具中。
建議採用第一種做法,因為程式碼會從您自己的網域執行,並可存取瀏覽器中的使用者資料。 這樣就能識別使用者,對分析系統可能很有幫助。
若您沒有網站,可以採用第二種做法。無論採用哪一種做法,小工具頁面的所有 URL 參數都會傳遞至內部 iframe。 例如,要處理小工具直接連結中的 UTM 標籤時,就需要這些參數。
請在內部 iframe 中使用下方程式碼。 這段程式碼同樣會在小工具事件發生時,將訊息輸出至主控台。
<html>
<script>
window.addEventListener('message', function (e) {
if (e && e.origin && e.origin.indexOf('bukza.') !== -1) {
var message = JSON.parse(e.data);
switch (message.event) {
case 'INITIALIZED':
console.log('widget opened');
break;
case 'RESOURCE_GROUP_OPENED':
console.log('entered to group ' + message.data.name);
break;
case 'RESERVATION_STARTED':
console.log('started for ' + message.data.name);
break;
case 'RESERVATION_SAVED':
console.log('saved for ' + message.data.name);
break;
case 'INDIRECT_ORDER_STARTED':
console.log('waiting for payment');
break;
case 'ORDER_COMPLETED':
console.log('order completed #' + message.data.orderNumber);
break;
}
}
}, false);
</script>
</html>