Adobe Client Data Layerのトラブルシューティング
このページでは、Adobe Client Data Layer (ACDL)に関する一般的な問題について説明します。 ほとんどのチェックは、ブラウザーの開発者コンソールを使用します。
データレイヤーの検査 inspect
コンソールで次のコマンドを実行します。
コマンド
結果
adobeDataLayer.versionACDL バージョン (
"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