データと計算状態

Adobe Client Data Layer (ACDL)は、プッシュしたすべてのデータオブジェクトを​ 計算状態 ​と呼ばれる1つのオブジェクトに結合します。 任意のスクリプトは、getState()を使用して、いつでも計算状態を読み取ることができます。 あらゆるデータを一度にプッシュすることも、さまざまなスクリプトから多数の小さなプッシュでプッシュすることもできます。 計算状態はどちらでも同じです。

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({ page: { title: "Getting started" } });
window.adobeDataLayer.push({ component: { "hero-1": { title: "Learn more", link: "learn-more.html" } } });
window.adobeDataLayer.push({ page: { language: "en" } });

これらのプッシュの後、adobeDataLayer.getState()は次のオブジェクトを返します。

{
  "page": {
    "title": "Getting started",
    "language": "en"
  },
  "component": {
    "hero-1": {
      "title": "Learn more",
      "link": "learn-more.html"
    }
  }
}

イベントオブジェクトもデータを保持できます。 ACDLは、eventとeventInfoを除くイベントオブジェクト内のすべてのキーをマージします。イベントオブジェクトは、計算状態には保存されません。 ​ イベント ​を参照してください。

ルールの結合 merge-rules

データをプッシュすると、ACDLはプッシュされたオブジェクト内の各キーを計算された状態と比較します。

プッシュ値
計算状態の結果
計算状態に存在しないキー
キーとその値を追加します。
計算状態がオブジェクトも保持するオブジェクト
2つのオブジェクトを結合します。 プッシュしないキーは、現在の値を保持します。 このルールは、ネストのすべてのレベルに適用されます。
文字列、数値またはブール値
現在の値を置き換えます。
配列
現在の値を置き換えます。 配列を参照してください。
null または undefined
キーを削除します。 ​ データの削除を参照してください。

例えば、下の2番目のプッシュはpage.titleだけを変更します。 page.language キーは値を保持します:

adobeDataLayer.push({ page: { title: "Home", language: "en" } });
adobeDataLayer.push({ page: { title: "Products" } });
adobeDataLayer.getState("page");
// { title: "Products", language: "en" }

データの削除 delete

キーを削除するには、nullまたはundefinedを値としてプッシュします。

adobeDataLayer.push({ page: { title: "Products", language: "en" }, user: { id: "123" } });
adobeDataLayer.push({ page: { language: null }, user: null });
adobeDataLayer.getState();
// { page: { title: "Products" } }

オブジェクト内の最後のキーを削除すると、空のオブジェクトが残ります。 オブジェクトも削除するには、オブジェクト自体にnullをプッシュします。

adobeDataLayer.push({ page: { title: null } });
adobeDataLayer.getState();
// { page: {} }

path オプションを使用するリスナーは、そのパスのキーまたはキーを含むオブジェクトを削除するときに呼び出されます。

配列 arrays

配列は単一の値として格納されます。 配列を既に配列を保持しているキーにプッシュすると、ACDLは配列全体を置き換えます。 項目を追加するには、新しい項目で完全な配列をプッシュします。

adobeDataLayer.push({ cart: { skus: ["a-100", "b-200"] } });
adobeDataLayer.push({ cart: { skus: ["a-100", "b-200", "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "b-200", "c-300"]

ACDLは、プッシュした配列からnullおよびundefined個のエントリを削除します。

adobeDataLayer.push({ cart: { skus: ["a-100", null, "c-300"] } });
adobeDataLayer.getState("cart.skus");
// ["a-100", "c-300"]
NOTE
ACDL 2.xでは、配列を置き換える代わりに、配列を位置ごとに結合します。 2.xでは、["c"]を["a", "b"]にプッシュすると、["c", "b"]になります。 両方のバージョンで同じ結果を得るには、常に完全な配列をプッシュします。

値の型を変更する change-type

オブジェクトは、文字列、数値、ブール値、または配列で置き換えることができます。 ただし、ACDL 3.xでは、文字列、数値、ブール値、または配列を現在保持しているキーにオブジェクトをプッシュしても、値は置き換えられません。 現在の値が0、false、または空の文字列の場合、代わりにキーが削除されます。

値をオブジェクトに変更するには、まずキーを削除してからオブジェクトをプッシュします。

adobeDataLayer.push({ product: "a-100" });
adobeDataLayer.push({ product: null });
adobeDataLayer.push({ product: { sku: "a-100", price: 25 } });
adobeDataLayer.getState("product");
// { sku: "a-100", price: 25 }

このような状況を回避するには、各キーのタイプをデータレイヤーデザインで一貫させておきます。

値タイプ value-types

データ レイヤーでJSON互換の値(文字列、数値、ブール値、null、プレーンオブジェクト、配列)を使用します。 ACDLは、結合する他の種類のオブジェクトを変換します。

値
として保存
Date オブジェクト
空のオブジェクト ({})。 日付は、new Date().toISOString()などの文字列または数値として保存します。
関数
空のオブジェクト ({})。
Map または Set
空のオブジェクト ({})。
クラスのインスタンス
インスタンス独自の列挙可能なプロパティのみを含むプレーンオブジェクト。
空のオブジェクト、空の配列、空の文字列、0およびfalse
そのまま保存。

プレーンオブジェクトのみをプッシュします。 ACDLは、文字列、数値、配列などの他の値を直接プッシュすると拒否します。 push()を参照してください。

参照ではなくコピー copies

計算状態は、プッシュするオブジェクトから独立しています。 プッシュした後にオブジェクトを変更しても、計算状態は変更されません。

const page = { title: "Home" };
adobeDataLayer.push({ page: page });
page.title = "Changed";
adobeDataLayer.getState("page.title");
// "Home"

同様に、getState()はコピーを返します。 返されたオブジェクトを変更しても、データレイヤーは変更されません。 計算状態を変更するには、常に変更をプッシュします。

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