数据和计算状态

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"]
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