Web扩展的数据元素类型

在数据收集标记中，数据元素本质上是页面上数据段的别名。 此数据可在查询字符串参数、Cookie、DOM元素或其他位置中找到。 数据元素可以被规则引用，并充当访问这些数据段的抽象。

数据元素类型由扩展提供，允许用户配置数据元素，以特定方式访问数据段。 例如，扩展可以提供“本地存储项”数据元素类型，用户可在其中指定本地存储项名称。 当数据元素被规则引用时，扩展将能够使用用户在配置数据元素时提供的本地存储项名称来查找本地存储项值。

本文档介绍如何在Adobe Experience Platform中为Web扩展定义数据元素类型。

数据元素类型通常包含以下内容：

假设您想要允许用户从名为 productName 的本地存储项中检索一段数据。 您的模块可能如下所示：

module.exports = function(settings) {
  return localStorage.getItem('productName');
}

如果要让Adobe Experience Platform用户可以配置本地存储项名称，则可以允许用户输入名称，然后将该名称保存到settings对象。 该对象可能如下所示：

{
  itemName: "campaignId"
}

要对用户定义的本地存储项名称执行操作，您的模块需要更改为：

module.exports = function(settings) {
  return localStorage.getItem(settings.itemName);
}

默认值支持

请注意，用户可以选择为任何数据元素配置默认值。 如果您的数据元素库模块返回值 undefined 或 null，则它将被自动替换为用户为数据元素配置的默认值。

上下文事件数据

如果因为触发了规则而导致检索数据元素（例如数据元素在规则的条件和操作中使用），则会将第二个参数传递给您的模块，其中包含有关触发规则的事件的上下文信息。 该参数在某些情况下可能会有所帮助并且可以按如下方式访问：

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

event 对象必须包含以下属性：

提供触发规则的事件类型的扩展可以选择性地向此 event 对象添加任何其他有用信息。