方法概觀

Adobe使用者端資料層(ACDL)程式庫載入時,會將下列方法和屬性新增至adobeDataLayer陣列:

方法或屬性
說明
push()
將資料、事件和函式新增至資料層。 可在程式庫載入之前和之後使用。
getState()
傳回計算狀態的復本,或路徑上的值的復本。
addEventListener()
觸發具名事件或內建事件時呼叫函式。
removeEventListener()
移除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