list

列表变量是自定义变量，您可以根据需要随意使用。它们的工作方式与 eVar 类似，只是它们可以在同一点击中包含多个值。列表变量没有字符限制。

请确保在解决方案设计文档中记录如何使用每个列表变量及其逻辑。

在报告包设置中设置列表变量

确保先在报告包设置中配置每个列表变量，然后再在实施中使用它们。请参阅管理员指南中的转化变量。此步骤适用于所有实现方法。

使用 Web SDK 的列表变量

如果使用 XDM对象，列表变量使用XDM字段 xdm._experience.analytics.customDimensions.lists.list1.list[] 到 xdm._experience.analytics.customDimensions.lists.list3.list[]. 每个数组元素含有一个包含每个字符串的 "value" 对象。 无需提供分隔符；Adobe数据收集服务器会自动检测并包含中设置的正确分隔符 报表包设置.

"xdm": {
  "_experience": {
    "analytics": {
      "customDimensions": {
        "lists": {
          "list1": {
            "list": [
              {
                "value": "Example value 1"
              },
              {
                "value": "Example value 2"
              },
              {
                "value": "Example value 3"
              }
            ]
          }
        }
      }
    }
  }
}

如果使用 数据对象，列表变量使用 data.__adobe.analytics.list1 - data.adobe.analytics.list3 遵循AppMeasurement语法。 确保使用中设置的中正确的分隔符 报表包设置.

"data": {
  "__adobe": {
    "analytics": {
      "list1": "Example value 1,Example value 2,Example value 3"
    }
  }
}

使用 Adobe Analytics 扩展程序的列表变量

Adobe Analytics 扩展程序中没有专门的字段来使用此变量。 按照 AppMeasurement 语法使用自定义代码编辑器。

AppMeasurement 和 Analytics 扩展代码编辑器中的 s.list1 – s.list3

每个列表变量都是一个字符串，其中包含特定于贵组织的自定义值。它们没有字节数上限；但是，单个值的最大长度为 255 字节。在报告包设置中设置变量时，将会确定使用的分隔符。 在分隔多个项目时不要使用空格。

// A list variable configured with a comma as a delimiter
s.list1 = "Example value 1,Example value 2,Example value 3";

比较列表属性与列表变量

列表属性和列表变量都可以在同一点击中包含多个值。但是，这两种变量类型之间有几个关键区别。