list

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

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

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

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

使用 Web SDK 的列表变量

如果使用​ XDM对象，则列表变量使用xdm._experience.analytics.customDimensions.lists.list1.list[]到xdm._experience.analytics.customDimensions.lists.list3.list[]的XDM字段。 每个数组元素含有一个包含每个字符串的 "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";

比较列表属性与列表变量

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