数据元素

数据元素是数据字典（或数据映射）的构建块。使用数据元素可跨市场营销和广告技术收集、组织和交付数据。

单个数据元素是一个变量，其值可以映射到查询字符串、URL、Cookie 值、JavaScript 变量等。您可以在整个Adobe Experience Platform中通过其变量名称引用此值。 此数据元素集合将成为可用于构建规则（事件、条件和操作）的已定义数据的字典。此数据字典可在标记之间共享，以便与您添加到资产中的任何扩展一起使用。

在创建规则的整个过程中，要尽可能广泛地使用数据元素，以统一动态数据的定义，并提高标记过程的效率。您只需定义数据规则一次，以后便可以在多个位置使用。

可重用数据元素的概念非常强大，您应该将它们作为最佳实践使用。

例如，如果您通过特定方式引用页面名称或产品ID，或从联盟营销链接或中的查询字符串参数获取信息 AdWords等等，您可以创建数据字典（数据元素），方法是从其源中获取信息，然后在各种标记规则中使用该数据。

使用页面名称为例，假设您通过引用数据层、document.title 元素或网站中的标题标记来使用特定的页面名称模式。Adobe Experience Platform中的标记允许您将数据元素创建为该特定数据点的单一引用点。 之后，您可以在需要引用该页面名称的任意规则中使用此数据元素。如果在未来出于某些原因，您决定更改引用页面名称的方式（例如，您已经引用了 document.title，但现在希望引用某个特定数据层），那么要更改该引用，您无需编辑多个不同的规则。只需在数据元素中更改引用一次，引用该数据元素的所有规则都会自动更新。

数据元素在规则中使用或在脚本中手动调用时会填充数据。在高级别时，您可以：

使用数据元素

在规则中

您可以在规则编辑界面中通过使用搜索框查找数据元素的名称来使用数据元素。

在自定义脚本中

您可以在自定义脚本中通过使用 _satellite 对象语法来使用数据元素：

_satellite.getVar('data element name');

创建数据元素 create-a-data-element

数据元素是规则的构建块。数据元素可用于创建页面上常用项目的数据字典（或数据映射），而无需考虑网站中所包含对象的项目源自何处（查询字符串、URL 或 Cookie 值）。

创建或编辑元素后，您可以将其保存并生成到活动库。这会立即将更改保存到库并执行生成操作。随即会显示生成操作的状态。您还可以从以下位置创建新库： 活动库 下拉菜单。

数据元素类型 types-of-data-elements

以下各节介绍 核心扩展. 其他扩展则使用其他数据元素类型。

Cookie

可在“Cookie 名称”字段中提及任何可用的域 Cookie。

示例：

cookieName

自定义代码

通过选择将自定义JavaScript输入到用户界面中 打开编辑器 并将代码插入编辑器窗口。

编辑器窗口中需要一个返回语句，以指示应该将什么值设置为数据元素值。如果不包含返回语句，数据元素则解析为 undefined。这会触发回退去查找存储的值，如果没有存储的值，则使用默认值。

示例：

var pageType = $('div.page-wrapper').attr('class').split('')[1];
if (window.location.pathname == '/') {
  return 'homepage';
} else {
  return pageType;
}

自定义代码可以接受调用规则中的 event 对象作为参数。这将允许代码读取其中的值。

示例：

// `event` is the default object provided by the rule
var eventType = event.$type;
return eventType; // if this data element is called from a "DOM Ready" event, then `core.dom-ready` is returned

然后，您可以在自定义脚本中通过使用 _satellite 对象语法来使用此数据元素：

// event refers to the calling rule's event
var rule = _satellite.getVar('return event rule', event);

使用百分比(%)语法，您只需指定数据元素名称， 而无需指定 event。

%data element name%

DOM 属性

可以检索任何元素值，例如 div 或 H1 标记。

示例：

CSS 选择器链：

id#dc logo img

获取以下元素的值：

src

JavaScript 变量

可以使用路径字段引用任何可用的 JavaScript 对象或变量。

如果要在标记中收集JavaScript变量或对象属性并将它们与任何扩展或规则一起使用，则可以使用数据元素来捕获这些值。 这样，您就可以在整个规则中引用数据元素，并且如果数据源发生更改，您只需在一个位置更改对该源（数据元素）的引用即可。

例如，假定您的标记包含一个名为 Page_Name 的 JavaScript 变量，如下所示：

<script>
  //data layer
  var Page_Name = "Homepage"
</script>

在创建数据元素时，必须提供该变量的路径。

如果您使用数据收集器对象作为数据层的一部分，则只需在路径中使用点表示法来引用要捕获到数据元素中的对象和属性即可，如 _myData.pageName，或 digitalData.pageName，等等。

示例：

window.document.title

本地存储

在中提供本地存储项目的名称 本地存储项名称 字段。

本地存储允许浏览器将信息从一个页面存储到另一个页面 (https://www.w3schools.com/html/html5_webstorage.asp)。本地存储的工作方式与Cookie非常相似，但更大也更加灵活。

使用提供的字段指定您为本地存储项目创建的值，例如 lastProductViewed.

页面信息

使用这些数据点捕获页面信息，以将其用在规则逻辑中，或者将信息发送到 Analytics 或外部跟踪系统。

您可以选择以下任一页面属性，以将其用在数据元素中：

查询字符串参数

在中指定单个URL参数 URL Parameter 字段。

只有名称部分是必需提供的，并且应该忽略任何特殊标志符，例如“?”或“=”

示例：

contentType

随机数

使用此数据元素可生成一个随机数。随机数通常用于对数据采样或创建ID，例如点击ID。 随机数也可用于对敏感数据进行模糊或加盐处理。一些示例可能包括：

指定随机数的最小值和最大值。

默认值：

最小值：0

最大值：1000000000

会话存储

在中提供会话存储项目的名称 会话存储项名称 字段。

会话存储类似于本地存储，不同之处在于，会话存储在会话结束后会丢弃数据，而本地存储或 Cookie 则可以保留数据。

访客行为

与页面信息类似，此数据元素使用常见行为类型来扩充规则或其他Platform解决方案中的逻辑。

选择以下任一访客行为属性：

一些常见用例包括：

内置数据元素

如果您之前使用过以下任何数据元素，则必须创建其他自定义数据元素：