活動

事件會告訴其他指令碼,頁面上發生了某些事情,例如頁面檢視、點按或表單提交。 您以event金鑰的物件形式推送事件至Adobe使用者端資料層(ACDL)。 已為該事件名稱註冊事件接聽程式的指令碼被呼叫。

事件物件 event-objects

事件物件具有下列索引鍵:

索引鍵
必要
說明
event
是
為事件命名的非空白字串。 事件名稱區分大小寫: cart add和Cart add是不同的事件。
eventInfo
無
有關此次事件出現的任何其他資訊,例如訪客點按的元件參考。 ACDL將eventInfo傳遞給接聽程式,但不會將其儲存在已計算的狀態。
任何其他索引鍵
無
使用與資料推送相同的規則,合併至計算狀態的資料。
window.adobeDataLayer = window.adobeDataLayer || [];

// An event with no data
window.adobeDataLayer.push({ event: "page loaded" });

// An event with extra information for listeners
window.adobeDataLayer.push({
  event: "click",
  eventInfo: { reference: "component.hero-1" }
});

// An event that also updates the computed state
window.adobeDataLayer.push({
  event: "cart add",
  eventInfo: { sku: "a-100" },
  cart: { itemCount: 3 }
});

在這些推播之後,計算狀態為{ cart: { itemCount: 3 } }。 event和eventInfo索引鍵不是計算狀態的一部分,但事件物件會以history的形式保留在資料層陣列中。

如果event索引鍵遺失、空白或非字串,ACDL會將物件視為資料推送。 未呼叫任何事件接聽程式,且計算狀態不包含event或eventInfo機碼。

TIP
選擇事件的命名慣例,例如noun verb (cart add, form submit)或object.action (cart.add, form.submit),並隨處使用。 由於名稱區分大小寫,因此不一致的名稱是監聽器無法執行的常見原因。

內建事件 built-in-events

除了已命名事件之外,ACDL還會觸發兩個內建事件:

  • adobeDataLayer:change:推播變更計算狀態時觸發。 攜帶資料的資料推送和事件推送會觸發它。
  • adobeDataLayer:event:每次事件推播都會觸發,無論名稱為何。

下表顯示每種推送觸發器的事件:

推播
adobeDataLayer:event
adobeDataLayer:change
已命名事件
僅限資料,例如{ page: { title: "Home" } }
無
是
無
僅限事件,例如{ event: "click" }
是
無
是
事件和eventInfo,例如{ event: "click", eventInfo: {...} }
是
無
是
事件和資料,例如{ event: "cart add", cart: {...} }
是
是
是

當一個推播觸發多個事件時,ACDL會依下列順序呼叫接聽程式: adobeDataLayer:event,然後adobeDataLayer:change,再呼叫具名事件。

聽眾收到的內容 listener-arguments

ACDL會使用一個引數呼叫每個接聽程式:推送的完整物件復本,包括event、eventInfo和任何資料。

window.adobeDataLayer.push(function(dl) {
  dl.addEventListener("cart add", function(event) {
    console.log(event.eventInfo.sku);       // "a-100"
    console.log(event.cart.itemCount);      // 3
    console.log(dl.getState("cart"));       // { itemCount: 3 }
  });
});

下列詳細資料適用於每個監聽器:

  • 已更新計算狀態。 當監聽器執行時,計算狀態已經包含觸發它的推播資料。
  • 引數為復本。 變更它不會變更資料層或推送的物件。
  • this是資料層。 在接聽程式函式內,this參考adobeDataLayer陣列。
  • 偵聽程式同步執行。 ACDL會在push()傳回之前呼叫每個接聽程式。 縮短接聽程式的時間,不要在其中執行緩慢的工作。

聆聽過去和未來的活動 scope

依預設,新監聽器會針對資料層陣列中已存在的相符事件以及稍後推播的相符事件執行。 此行為表示指令碼可隨時新增其接聽程式,而不會遺失先前發生的事件,例如載入標籤程式庫之前推送的頁面檢視。

您可以使用scope選項變更此行為,使其僅接聽過去的事件,或僅接聽未來的事件。 如需ACDL保留過去事件的方式,請參閱佇列與歷程記錄。

避免無盡的回圈 loops

監聽器可以推送至資料層。 ACDL會在監聽器傳回之前立即處理推送。 如果接聽程式再次按下觸發相同接聽程式的專案,呼叫永遠都不會結束,直到瀏覽器擲回棧疊溢位錯誤,例如RangeError: Maximum call stack size exceeded。 例如,推播資料觸發程式本身的adobeDataLayer:change接聽程式。

只有在新的推播無法觸發相同的監聽器時,才會從監聽器推播。

recommendation-more-help
experience-platform-help-collection