数据和计算状态
Adobe Client Data Layer (ACDL)将您推送的每个数据对象合并到一个名为 计算状态 的对象。 任何脚本都可以通过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例如,下面的第二次推送仅更改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()返回副本。 更改返回的对象不会更改数据层。 要更改计算状态,请始终推送更改。