キューと履歴

adobeDataLayer配列には2つの役割があります。 Adobe Client Data Layer (ACDL) ライブラリが読み込まれる前は、処理待ちの項目の​ キュー ​です。 ライブラリが読み込まれると、プッシュされたデータとイベントの​ 履歴 ​になります。

ACDLが読み込まれる前:キュー queue

ライブラリが読み込まれるまで、adobeDataLayerはプレーン JavaScript配列であり、push()は標準の配列方式です。 各プッシュは、項目を配列の最後に追加し、それ以外は何もしません。 そのため、ライブラリがまだダウンロードされていなくても、スクリプトはいつでもデータ、イベント、関数をプッシュできます。

ライブラリが読み込まれると、次のことが行われます。

  1. 配列からキューに入ったすべての項目を削除します。
  2. ACDL メソッドを同じ配列に追加します。これには、独自のバージョン push()が含まれます。
  3. キュー内のアイテムを、一度に1つずつ元の順序で再びプッシュします。 各アイテムは、ライブラリの読み込み後にプッシュされたかのように処理されます。

グローバル adobeDataLayer オブジェクトは、全体を通して同じ配列のままです。 以前に保存されたスクリプトが機能し続けるという参照があります。

ACDLの準備ができたらコードを実行する ready

ライブラリがまだ読み込まれていない可能性があるため、配列にはpush()のみが存在することが保証されます。 getState()やaddEventListener()などの他のメソッドを呼び出すには、関数をプッシュします。

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
  console.log(dl.getState());
  dl.addEventListener("click", handleClick);
});

ACDLが既に読み込まれている場合は、すぐに関数を呼び出します。 そうでない場合、関数はキュー内で待機し、ライブラリが読み込まれたときに、その前にプッシュされたアイテムの後で実行されます。 関数は、データ レイヤーを引数として受け取り、thisとして受け取ります。

IMPORTANT
キュー内の関数がライブラリの読み込み中にエラーをスローした場合、ACDLはキューの処理を停止します。 その関数の後にキューに入れた項目は失われます。 プッシュする関数内のエラーを検出します。

ACDLの読み込み後:履歴 history

ライブラリが読み込まれた後、配列はプッシュされた内容の記録を保持します。 ACDLは、配列に特定の種類の項目を追加し、他の項目を削除します。

プッシュされた項目
配列内に保持
データオブジェクト
はい
イベントオブジェクト (キーeventとeventInfoを含む)
はい
関数
いいえ。 ACDLはそれを呼び出し、それを保持しません。
文字列や数値などの無効な項目
いいえ。 ACDLはエラーを記録し、それを保持しません。

ヒストリーには、プッシュしたオブジェクトが保持され、そのコピーは保持されません。 プッシュした後にオブジェクトを変更すると、履歴には変更が表示されますが、計算状態にはありません。

ブラウザーのデベロッパーコンソールで履歴を調べるには、adobeDataLayerと入力して配列を展開します。 履歴の項目の数はadobeDataLayer.lengthです。

リスナーからプッシュされたアイテムの順序 nested-order

イベントリスナーが項目をプッシュすると、ACDLはその項目を、リスナーをトリガーした項目の処理を完了する前に処理します。 その結果、リスナーがプッシュした項目は、それをトリガーした項目の前の履歴に表示されます。

リスナーによる履歴の使用方法 replay

pastまたはall ​ スコープ ​を持つリスナーを追加すると、ACDLは、履歴内の一致する各項目に対して直ちに呼び出します。 このリプレイでは、タグライブラリなど、読み込みが遅いスクリプトは、読み込み前に発生したイベントに反応することができます。

リプレイでは、リスナーが追加されたときに配列にある項目を使用します。 履歴が消去された場合、消去された項目は再生されません。

配列を直接変更しない modify

データ レイヤーに項目を追加できるのはpush()個のみです。 pop()、shift()、unshift()、splice()、sort()、reverse()、fill()またはcopyWithin()など、配列を変更する他のJavaScript配列方式を使用しないでください。 これらの方法はACDLをバイパスするため、計算状態とリスナーは変更を反映せず、新しいリスナーのリプレイは一貫性がなくなります。

filter()やfind()など、変更しないメソッドを使用して配列を読み取ることができます。

履歴を消去 clear

ACDLが保持するすべてのプッシュは、配列に項目を追加します。 シングルページアプリケーションなど、長い間開いているページでは、歴史が成長し続けます。 バーチャルページビューの後など、自然な区切りで消去できます。

履歴を消去しても、計算状態が変更されたり、リスナーが削除されたりすることはありません。 後でpastまたはallのスコープで追加されるリスナーに対して再生されるアイテムにのみ影響します。

  • タグ​を使用する場合は、ACDL タグ拡張機能で「​ データレイヤー履歴を消去」アクションを使用します。 現在の計算状態のスナップショットを配列内に保持することも、配列を空のままにすることもできます。

  • 独自のコード​で、ACDLが読み込まれた後、配列の長さを0に設定します。

    code language-js
    window.adobeDataLayer.push(function(dl) {
      dl.length = 0;
    });
    
recommendation-more-help
experience-platform-help-collection