方法概觀
Adobe使用者端資料層(ACDL)程式庫載入時,會將下列方法和屬性新增至adobeDataLayer陣列:
方法或屬性
說明
將資料、事件和函式新增至資料層。 可在程式庫載入之前和之後使用。
傳回計算狀態的復本,或路徑上的值的復本。
觸發具名事件或內建事件時呼叫函式。
移除
addEventListener()新增的接聽程式。version包含ACDL程式庫版本的字串,例如
"3.0.1"。安全地呼叫方法 call-safely
如果ACDL以非同步方式載入(此為建議做法),您的程式碼可能會在程式庫載入之前執行。 此時,adobeDataLayer是純陣列: push()存在,但getState()、addEventListener()和removeEventListener()不存在。
若要安全地呼叫這些方法,請推送函式。 ACDL會在程式庫準備就緒後立即執行,並傳遞資料層作為其引數:
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
const title = dl.getState("page.title");
dl.addEventListener("cart add", handleCartAdd);
});
只有在您確定ACDL已載入時(例如瀏覽器的開發人員主控台或從ACDL事件接聽程式執行的程式碼中),呼叫adobeDataLayer.getState()才能直接運作。
陣列方法 array-methods
adobeDataLayer仍是JavaScript陣列。 您可以使用不會變更它的方法(例如filter()、find()和length)來讀取它。 請勿使用變更陣列的方法,例如splice()或shift()。 請參閱佇列和歷程記錄。
recommendation-more-help
experience-platform-help-collection