疑難排解Adobe使用者端資料層
使用此頁面來診斷Adobe使用者端資料層(ACDL)的常見問題。 大部分檢查都使用瀏覽器的開發人員主控台。
檢查資料層 inspect
在主控台中執行以下命令:
命令
結果
adobeDataLayer.versionACDL版本,例如
"3.0.1"。 如果是undefined,則尚未載入ACDL。adobeDataLayer.getState()計算狀態。
adobeDataLayer資料與事件物件的history,依其處理順序排列。
若要在事件發生時監視事件,請新增暫時接聽程式:
adobeDataLayer.addEventListener("adobeDataLayer:event", function(event) {
console.log("ACDL event:", event.event, event);
}, { scope: "future" });
主控台訊息 console-messages
訊息
原因和解決方案
The following item cannot be handled by the data layer because it does not have a valid format: ...推送的值不是純物件或函式,例如字串或陣列。 尋找推送訊息中所顯示值的程式碼。 檢視無效專案。
Adobe Client Data Layer v... has already been imported/initialized on this page. You may be erroneously loading it a second time.程式庫已載入多次。 第一個復本會持續運作。 移除多餘的復本。 請參閱僅載入程式庫一次。
TypeError: adobeDataLayer.getState is not a function (或addEventListener, removeEventListener)程式碼在程式庫載入前呼叫了ACDL方法。 從您推送的函式呼叫它。 請參閱安全地呼叫方法。
ReferenceError: structuredClone is not defined瀏覽器比ACDL 3.x支援的版本還要舊。 檢視瀏覽器需求。
TypeError: Cannot read properties of null (reading 'event')程式碼已推送
null或undefined。RangeError: Maximum call stack size exceeded監聽器會推送觸發自身的事物。 請參閱避免無盡的回圈。
JavaScript錯誤訊息的措辭在瀏覽器之間稍有不同。 例如,Safari會報告ReferenceError: Can't find variable: structuredClone。
ACDL未載入 not-loaded
如果adobeDataLayer.version是undefined,請檢查下列專案:
- 資料庫不在頁面上。 檢查
adobe-client-data-layer.min.js的網路面板,或標籤庫的網路面板(如果標籤擴充功能載入ACDL)。 請確定您的內容安全性原則允許指令碼。 adobeDataLayer不是陣列。 如果在ACDL載入前,其他指令碼將window.adobeDataLayer設定為陣列以外的專案,則ACDL不會附加至該指令碼。- 指令碼已取代陣列。 諸如
window.adobeDataLayer = [];之類的程式碼會以新的空陣列取代資料層,這會遺失ACDL方法、計算狀態和所有接聽程式。 一律使用window.adobeDataLayer = window.adobeDataLayer || [];。 請參閱建立資料層陣列。 - 佇列函式擲回錯誤。 如果在載入ACDL之前推送的函式擲回錯誤,則主控台中會顯示錯誤,且在該函式之後排入佇列的專案會遺失。 攔截您推送之函式中的錯誤。
監聽器未執行 listener-not-called
檢查下列專案:
- 事件名稱不符。 事件名稱會區分大小寫,且必須完全相符(包括空格)。
- 在新增接聽程式之前已推送事件,而且接聽程式使用
future範圍。 使用預設的all範圍。 檢視範圍。 - 在新增接聽程式之前,已清除歷程記錄,因此沒有可重播的內容。 請參閱清除歷程記錄。
path選項篩選出推播。 具有路徑的接聽程式只會針對包含該路徑的推播執行。 請參閱路徑。- 從未新增接聽程式。 如果監聽器引數不是函式或範圍無效,ACDL就不會新增監聽器。 相反地,
on和handler等金鑰出現在adobeDataLayer.getState()中。 - 已經為事件登入相同的函式。 即使使用不同的選項,ACDL也會忽略第二個註冊。
- 較早的接聽程式針對相同的推播擲回錯誤,這會停止剩餘的接聽程式。 檢查主控台是否有錯誤。
- 推播不是事件。
event值遺失、空白或非字串的物件會被視為資料。 它會觸發adobeDataLayer:change個接聽程式,而非事件接聽程式。
監聽器執行的頻率比預期要高 listener-called-too-often
- 它會重播過去的活動。 使用預設的
all範圍,會針對已存在於歷程記錄中的相符事件執行新的接聽程式。 這是預期中的正常行為。 如果先前事件已處理,請使用future範圍。 - 已新增多次。 重複執行且每次都傳遞新匿名函式的程式碼,每次都新增一個偵聽程式。 使用具名函式。 請參閱使用具名函式。
- 它使用路徑。 具有路徑的接聽程式會在包含路徑的每次推播中執行,即使值未變更亦然。
運算狀態中的資料遺失或錯誤 state-issues
歷史記錄中缺少專案 history-issues
- 未保留函式和無效專案。 只會保留資料物件和事件物件。 請參閱ACDL載入後:歷程記錄。
- 接聽程式擲回錯誤。 當接聽程式擲回錯誤時,觸發此錯誤的專案會更新計算狀態,但不會新增至歷程記錄。
- 一個
push()呼叫包含多種專案。 在個別呼叫中推播每個專案。 檢視每次呼叫推播一個專案。 - 歷史記錄已清除,例如標籤延伸中的 清除資料層歷史記錄 動作。
recommendation-more-help
experience-platform-help-collection