contextData

上下文数据变量允许您在处理规则可读取的每个页面上定义自定义变量。您可以在上下文数据变量中发送数据，而不是显式地为代码中的 Analytics 变量分配值。然后，处理规则会接收上下文数据变量值并将其传递给相应的 Analytics 变量。请参阅《管理员用户指南》中的处理规则。

上下文数据变量有助于开发团队收集指定元素中的数据而不是编号变量。例如，您可以请求开发团队将页面的作者分配给 s.contextData["author"]，而不是请求他们将其分配给 eVar10。然后，贵组织中的 Analytics 管理员可以创建处理规则，以将上下文数据变量映射到用于报告的 Analytics 变量。开发团队最终只需关注上下文数据变量，而无需考虑 Adobe 提供的许多页面变量。

使用 Web SDK 的上下文数据变量

如果使用 XDM对象，则所有未映射到Adobe Analytics变量的字段都会自动包含为上下文数据变量。 然后，您可以使用处理规则将上下文数据变量分配给所需的 Analytics 变量。

如果使用 数据对象，则所有上下文数据变量都位于 data.__adobe.analytics.contextData 作为键值对：

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "contextData": {
          "example_variable": "Example value",
          "second_example": "Another value"
        }
      }
    }
  }
});

此 处理规则 界面将显示 c.example_variable 和 c.second_example （在适用的下拉菜单中）。

使用 Adobe Analytics 扩展程序的上下文数据变量

Adobe Experience Platform 数据收集中没有专门的位置来设置上下文数据变量。按照 AppMeasurement 语法使用自定义代码编辑器。

AppMeasurement 和 Analytics 扩展自定义代码编辑器中的 s.contextData

s.contextData 变量不会直接接收值。它会将此变量的属性设置为字符串。

// Assign the example_variable property a value
s.contextData["example_variable"] = "Example value";

使用处理规则填充 Analytics 变量

处理规则在保存后会立即生效。它们不适用于历史记录数据。

在链接跟踪调用中发送上下文数据

将上下文数据变量作为 contextData 的属性包含在 s.linkTrackVars 中：

s.contextData["example_variable"] = "Example value";
s.linkTrackVars = "contextData.example_variable";
s.tl(true,"o","Example context data link");

使用上下文数据变量递增事件

创建处理规则时，可以将上下文数据变量分配给事件。

// Assigning this context data variable to an event increments it by one
s.contextData["example_text"] = "Text value";

// Assigning this context data variable to an event increments it by four
s.contextData["example_number"] = "4";