データと計算状態
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はプッシュされたオブジェクト内の各キーを計算された状態と比較します。
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"]
["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()はコピーを返します。 返されたオブジェクトを変更しても、データレイヤーは変更されません。 計算状態を変更するには、常に変更をプッシュします。