佇列和記錄

adobeDataLayer陣列有兩個角色。 在Adobe Client Data Layer (ACDL)程式庫載入之前,它是等待處理的​ 佇列 ​專案。 程式庫載入後,它就是推送的資料和事件的​歷程記錄。

ACDL載入前:佇列 queue

在程式庫載入之前,adobeDataLayer是純JavaScript陣列,push()是標準陣列方法。 每次推播都會將專案新增至陣列結尾,而不會執行其他動作。 因此,任何指令碼都可以隨時推送資料、事件和函式,即便程式庫尚未下載。

載入程式庫時,會執行下列動作:

  1. 從陣列中移除所有已排入佇列的專案。
  2. 將ACDL方法新增至相同陣列,包括其自己的push()版本。
  3. 以原始順序再次推送已排入佇列的專案,一次一個。 系統會將每個專案視為在程式庫載入後推播的專案來處理。

全域adobeDataLayer物件在整個過程中保持相同的陣列。 先前儲存的指令碼仍可繼續使用的參考。

當ACDL就緒時執行程式碼 ready

陣列上保證只有push()存在,因為程式庫可能尚未載入。 若要呼叫其他方法(例如getState()或addEventListener()),請推送函式:

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
  console.log(dl.getState());
  dl.addEventListener("click", handleClick);
});

如果ACDL已經載入,它會立即呼叫函式。 如果沒有,函式會在佇列中等待,並在程式庫載入時(在之前推送的專案之後)執行。 函式接收資料層作為其引數,並作為this。

IMPORTANT
如果佇列的函式在程式庫載入時擲回錯誤,ACDL會停止處理佇列。 在該函式之後排入佇列的專案會遺失。 攔截您推送之函式中的錯誤。

ACDL載入後:歷史記錄 history

程式庫載入後,陣列會保留推送內容的記錄。 ACDL會將某些專案加入陣列並移除其他專案:

已推送的專案
保留在陣列中
資料物件
是
事件物件,包括其event和eventInfo金鑰
是
函數
沒有。 ACDL會呼叫它,但不會保留它。
無效的專案,例如字串或數字
沒有。 ACDL會記錄錯誤,但不會保留。

歷史記錄會儲存您推送的物件,而非物件的副本。 如果您在推播物件之後變更該物件,則歷史記錄會顯示變更,但計算狀態不會顯示變更。

您可以輸入adobeDataLayer並展開陣列,在瀏覽器的開發人員主控台中檢查歷史記錄。 歷程記錄中的專案數量為adobeDataLayer.length。

從接聽程式推送的專案順序 nested-order

當事件接聽程式按下專案時,ACDL會在完成處理觸發接聽程式的專案之前處理該專案。 因此,監聽器推播的專案會顯示在歷史記錄中,而觸發它的專案則顯示在歷史記錄中。

監聽器如何使用歷程記錄 replay

當您新增具有past或all 範圍的接聽程式時,ACDL會依序立即呼叫歷程記錄中每個相符專案的接聽程式。 此重播可讓延遲載入的指令碼(例如標籤程式庫)對載入前發生的事件做出反應。

重新執行會在加入監聽器時使用陣列中的專案。 如果清除歷史記錄,則不會重播清除的專案。

請勿直接修改陣列 modify

只使用push()將專案新增至資料層。 請勿使用其他變更陣列的JavaScript陣列方法,例如pop()、shift()、unshift()、splice()、sort()、reverse()、fill()或copyWithin()。 這些方法會略過ACDL,因此計算的狀態和監聽器不會反映變更,而新監聽器的重播會變得不一致。

您可以使用不會變更陣列的方法讀取陣列,例如filter()或find()。

清除歷史記錄 clear

ACDL保留的每次推播都會將專案新增至陣列。 在長時間保持開啟狀態的頁面上(例如單頁應用程式),歷史記錄會持續成長。 您可以在自然中斷時將其清除,例如,在每個虛擬頁面檢視之後。

清除歷程記錄不會變更計算狀態或移除接聽程式。 它只會影響為稍後以past或all範圍新增的接聽程式重播哪些專案。

  • 如果您使用標籤,請在ACDL標籤延伸中使用 清除資料層歷程記錄 動作。 它可以保留陣列中目前計算狀態的快照,或保留陣列空白。

  • 在您自己的程式碼​中,將ACDL載入後的陣列長度設定為0:

    code language-js
    window.adobeDataLayer.push(function(dl) {
      dl.length = 0;
    });
    
recommendation-more-help
experience-platform-help-collection