疑難排解Adobe使用者端資料層

使用此頁面來診斷Adobe使用者端資料層(ACDL)的常見問題。 大部分檢查都使用瀏覽器的開發人員主控台。

檢查資料層 inspect

在主控台中執行以下命令:

命令
結果
adobeDataLayer.version
ACDL版本,例如"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

  • 值已推送為event或eventInfo。 這些金鑰不會以計算狀態儲存。 推送其他鍵下的資料。
  • 陣列遺失專案。 推播陣列會取代整個陣列。 推入完整陣列。 請參閱陣列。
  • 物件未取代字串、數字或布林值。 請先推送null刪除金鑰,然後再推送物件。 請參閱變更值的型別。
  • 日期或函式變成空白物件。 將日期儲存為字串或數字。 檢視值型別。
  • 對getState()結果所做的變更沒有效果。 getState()傳回覆本。 改為推送變更。
  • 含有路徑的​getState()傳回undefined. 檢查路徑中每個索引鍵的拼字。 使用點做為陣列索引,例如items.0.sku,而不是括弧。 請參閱在路徑取得值。

歷史記錄中缺少專案 history-issues

  • 未保留​函式和無效專案。 只會保留資料物件和事件物件。 請參閱ACDL載入後:歷程記錄。
  • 接聽程式擲回錯誤。 當接聽程式擲回錯誤時,觸發此錯誤的專案會更新計算狀態,但不會新增至歷程記錄。
  • 一個push()呼叫包含多種專案。 在個別呼叫中推播每個專案。 檢視每次呼叫推播一個專案。
  • 歷史記錄已清除,例如標籤延伸中的​ 清除資料層歷史記錄 ​動作。
recommendation-more-help
experience-platform-help-collection