佇列和記錄
adobeDataLayer陣列有兩個角色。 在Adobe Client Data Layer (ACDL)程式庫載入之前,它是等待處理的 佇列 專案。 程式庫載入後,它就是推送的資料和事件的歷程記錄。
ACDL載入前:佇列 queue
在程式庫載入之前,adobeDataLayer是純JavaScript陣列,push()是標準陣列方法。 每次推播都會將專案新增至陣列結尾,而不會執行其他動作。 因此,任何指令碼都可以隨時推送資料、事件和函式,即便程式庫尚未下載。
載入程式庫時,會執行下列動作:
- 從陣列中移除所有已排入佇列的專案。
- 將ACDL方法新增至相同陣列,包括其自己的
push()版本。 - 以原始順序再次推送已排入佇列的專案,一次一個。 系統會將每個專案視為在程式庫載入後推播的專案來處理。
全域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。
ACDL載入後:歷史記錄 history
程式庫載入後,陣列會保留推送內容的記錄。 ACDL會將某些專案加入陣列並移除其他專案:
event和eventInfo金鑰歷史記錄會儲存您推送的物件,而非物件的副本。 如果您在推播物件之後變更該物件,則歷史記錄會顯示變更,但計算狀態不會顯示變更。
您可以輸入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; });