Web擴充功能的事件型別

在標籤規則中，事件是必須發生的活動，才會引發規則。 例如，網頁擴充功能可提供「手勢」事件型別，來監視應發生的特定滑鼠或觸控手勢。 一旦該手勢發生，事件邏輯就會引發規則。

事件型別程式庫模組的設計目的，是偵測活動是否發生，然後呼叫函式以引發相關規則。 偵測到的事件是可自訂的。 例如，可以偵測使用者何時做出特定手勢、快速捲動或互動某物。

本文說明如何在Adobe Experience Platform中定義Web擴充功能的事件型別。

事件型別由擴充功能定義，通常包含下列專案：

module.exports同時接受settings和trigger引數。 這可啟用事件型別的自訂。

module.exports = function(settings, trigger) { … };

以經過5秒的活動為例，經過5秒後，活動已發生且規則將引發。 此模組看起來與此範例類似。

module.exports = function(settings, trigger) {
  setTimeout(trigger, 5000);
};

如果要讓Adobe Experience Platform使用者能夠設定持續時間，則需要輸入並儲存設定物件的持續時間選項。 該物件可能如下所示：

{
  "duration": 25000
}

若要運用於使用者定義的持續時間，需要更新模組以包含此專案。

module.exports = function(settings, trigger) {
  setTimeout(trigger, settings.duration);
};

傳遞內容事件資料

觸發規則時，就發生的事件提供其他詳細資訊，通常有其效用。 建立規則的使用者可利用這項資訊來達成特定行為。例如，如果行銷人員想要建立每當使用者滑動畫面時就會傳送分析信標的規則。 擴充功能必須提供swipe事件型別，行銷人員才能使用此事件型別觸發適當規則。 假設行銷人員想要納入信標上發生撥動時的角度，這很難在不提供其他資訊的情況下完成。 若要就發生的事件提供其他相關資訊，請在呼叫 trigger 函數時傳遞一個物件。例如：

trigger({
  swipeAngle: 90 // the value would be the detected angle
});

行銷人員隨後可藉由在文字欄位中指定 %event.swipeAngle% 值，在分析信標上使用此值。他們也可以從其他內容 (例如自訂程式碼動作) 中存取 event.swipeAngle。也有可能包含其他型別的選用事件資訊，這些資訊可能以相同的方式對行銷人員有所幫助。

nativeEvent

如果您的事件型別以原生事件為基礎（例如，如果您的擴充功能提供了click事件型別），建議您依照下列方式設定nativeEvent屬性。

trigger({
  nativeEvent: nativeEvent // the value would be the underlying native event
});

這對於嘗試從原生事件存取任何資訊 (例如游標座標) 的行銷人員，可能有其效用。

element

如果專案與發生的事件之間有強烈的關係，建議將element屬性設定為專案的DOM節點。 例如，如果您的擴充功能提供click事件型別，而您允許行銷人員加以設定，唯有選取ID為herobanner的元素時才會觸發規則。 在此案例中，如果使用者選取主圖橫幅，建議呼叫trigger並將element設定為主圖橫幅的DOM節點。

trigger({
  element: element // the value would be the DOM node
});

遵循規則順序

標籤讓使用者能夠排序規則。 例如，使用者可建立兩個規則，這兩個規則都會使用方向變更事件型別，並且會自訂規則引發的順序。 假設Adobe Experience Platform使用者在規則A中為方向變更事件指定了順序值2，並且在規則B中為方向變更事件指定了順序值1。這表示當行動裝置上的方向變更時，規則B應在規則A之前引發（先引發順序值較低的規則）。

如前所述，對於已設定為要使用事件類型的每個規則，匯出的函數將在事件模組中呼叫一次。每次呼叫匯出的函數時，都會傳遞一個與特定規則繫結的唯一 trigger 函數。在剛才說明的案例中，我們匯出的函式將會以繫結至規則B的trigger函式呼叫一次，然後以繫結至規則A的trigger函式再呼叫一次。規則B會先觸發，因為使用者為其指定的順序值比規則A低。當我們的程式庫模組偵測到方向變更時，請務必按照提供給程式庫模組的相同順序來呼叫trigger函式。

在以下範例程式碼中應留意，當偵測到方向變更時，觸發函數將會按照其提供至匯出函數時的順序進行呼叫：

var triggers = [];

window.addEventListener('orientationchange', function() {
  triggers.forEach(function(trigger) {
    trigger();
  });
});

module.exports = function(settings, trigger) {
  triggers.push(trigger);
};

這可確實保留使用者指定的順序。

若以不同的順序呼叫觸發函數，將是不當的實作：

var triggers = [];

window.addEventListener('orientationchange', function() {
  for (var i = triggers.length - 1; i >= 0; i--) {
    triggers[i]();
  }
});

module.exports = function(settings, trigger) {
  triggers.push(trigger);
};

自然程式設計實務準則通常會維持正確的順序，但仍須了解其影響並據此進行開發。