メソッドの概要

Adobe Client Data Layer (ACDL) ライブラリが読み込まれると、次のメソッドとプロパティがadobeDataLayer配列に追加されます。

メソッドまたはプロパティ
説明
push()
データ層にデータ、イベント、関数を追加します。 ライブラリの読み込み前と読み込み後に使用できます。
getState()
計算状態またはパスの値のコピーを返します。
addEventListener()
名前付きイベントまたは組み込みイベントがトリガーされたときに関数を呼び出します。
removeEventListener()
addEventListener()さんが追加したリスナーを削除します。
version
ACDL ライブラリのバージョン ("3.0.1"など)を含む文字列。

メソッドを安全に呼び出す call-safely

ACDLが非同期で読み込まれる場合(推奨されるアプローチです)、コードはライブラリが読み込まれる前に実行できます。 この時点では、adobeDataLayerはプレーン配列です:push()は存在しますが、getState()、addEventListener()、removeEventListener()は存在しません。

これらのメソッドを安全に呼び出すには、関数をプッシュします。 ACDLは、ライブラリの準備が整うと同時にそれを実行し、データレイヤーを引数として渡します。

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
  const title = dl.getState("page.title");
  dl.addEventListener("cart add", handleCartAdd);
});

adobeDataLayer.getState()への直接呼び出しは、ブラウザーの開発者コンソールやACDL イベントリスナーから実行されるコードなど、ACDLが既に読み込まれている場合にのみ機能します。

配列メソッド array-methods

adobeDataLayerは引き続きJavaScript配列です。 filter()、find()、lengthなど、変更しないメソッドを使用して読むことができます。 splice()やshift()など、配列を変更するメソッドを使用しないでください。 ​ キューと履歴を参照してください。

recommendation-more-help
experience-platform-help-collection