List variables are custom variables that you can use however you’d like. They work similarly to eVars, except they can contain multiple values in the same hit. List variables do not have a character limit.
Make sure you record how you use each list variable and their logic in your solution design document.
List variables store the most recent 250 values per visitor. If there are more than 250 unique values for a given visitor, the oldest values are not attributed to metrics.
Make sure that you configure each list variable in report suite settings before using them in your implementation. See Conversion variables in the Admin guide.
There is not a dedicated field in Launch to use this variable. Use the custom code editor, following AppMeasurement syntax.
Each list variable is a string that contains custom values specific to your organization. They do not have a maximum byte count; however, each individual value has a maximum of 255 bytes. The delimiter that you use is determined when setting up the variable in report suite settings. Do not use spaces when delimiting multiple items.
// A list variable configured with a comma as a delimiter
s.list1 = "Example value 1,Example value 2,Example value 3";
If you set duplicate values in the same hit, Adobe de-duplicates all instances of those values. For example, if you set s.list1 = "Example,Example";
, one instance is counted in reports.
List props and list vars can both contain multiple values in the same hit. However, there are several key differences between these two variable types.