Adobe Client Data Layerのトラブルシューティング

このページでは、Adobe Client Data Layer (ACDL)に関する一般的な問題について説明します。 ほとんどのチェックは、ブラウザーの開発者コンソールを使用します。

データレイヤーの検査 inspect

コンソールで次のコマンドを実行します。

コマンド
結果
adobeDataLayer.version
ACDL バージョン ("3.0.1"など)。 undefinedの場合、ACDLは読み込まれていません。
adobeDataLayer.getState()
計算状態。
adobeDataLayer
データおよびイベントオブジェクトの履歴が、処理された順序で表示されます。

イベントが発生するのを見るには、一時的なリスナーを追加します。

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.
ライブラリが複数回読み込まれました。 最初のコピーは機能し続けます。 余分なコピーを削除します。 「​ ライブラリを1回だけ読み込む」を参照してください。
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の場合は、次の点を確認してください。

  • ライブラリがページにありません。 ​ タグ拡張機能がACDLを読み込む場合は、adobe-client-data-layer.min.jsのネットワークパネル、またはタグライブラリを確認してください。 コンテンツセキュリティポリシーでスクリプトが許可されていることを確認します。
  • 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は、異なるオプションを使用しても、2番目の登録を無視します。
  • 以前のリスナーが同じプッシュに対してエラー​をスローし、残りのリスナーが停止しました。 コンソールにエラーがないか確認します。
  • プッシュはイベントではありません。 event値が見つからないか、空であるか、文字列ではないオブジェクトはデータとして扱われます。 トリガーはイベントリスナーではなく、adobeDataLayer:change リスナーです。

リスナーが予想以上に頻繁に実行される listener-called-too-often

  • 過去のイベントを再生します。 既定のall スコープでは、新しいリスナーが、既に履歴にある一致するイベントに対して実行されます。 この動作は想定内です。 以前のイベントが既に処理されている場合は、future スコープを使用します。
  • 複数追加されました。 繰り返し実行され、毎回新しい匿名の関数を渡すコードは、毎回新しいリスナーを追加します。 名前付き関数を使用します。 名前付き関数の使用を参照してください。
  • パスを使用しています。 パスを持つリスナーは、値が変更されなくても、パスを含むプッシュごとに実行されます。

計算状態でデータが欠落または間違っている state-issues

  • 値はeventまたはeventInfoとしてプッシュされました。 これらのキーは、計算状態では保存されません。 他のキーの下にデータをプッシュします。
  • 配列がアイテムを失いました。 配列をプッシュすると、配列全体が置き換えられます。 配列全体をプッシュします。 配列を参照してください。
  • オブジェクトが文字列、数値、またはブール値を置き換えませんでした。 最初にnullをプッシュしてキーを削除し、次にオブジェクトをプッシュします。 値の型の変更を参照してください。
  • 日付または関数が空のオブジェクトになりました。 日付を文字列または数値として保存します。 値の種類を参照してください。
  • getState()の結果に対して行われた変更は、影響を与えませんでした。 getState()はコピーを返します。 変更をプッシュします。
  • パスを持つ​getState()はundefinedを返します。 パス内のすべてのキーのスペルを確認します。 items.0.skuなどの配列インデックスには、角括弧ではなくドットを使用します。 ​ パスで値を取得を参照してください。

アイテムが履歴に含まれていません history-issues

  • 関数と無効な項目は保持されません。 データオブジェクトとイベントオブジェクトのみが保持されます。 ACDLが読み込まれた後の履歴を参照してください。
  • リスナーがエラーをスローしました。 リスナーがエラーをスローすると、それをトリガーした項目は計算状態を更新しますが、履歴には追加されません。
  • 1回のpush()呼び出しに複数種類の項目が含まれていました。 各項目を個別の呼び出しにプッシュします。 通話ごとに1件の項目をプッシュ ​を参照してください。
  • 履歴が消去されました。例えば、タグ拡張機能の「データレイヤー履歴を消去」アクションで消去されました。
recommendation-more-help
experience-platform-help-collection