eVar
This help page describes how to implement eVars. For information on how eVars work as a dimension, see eVars in the Components user guide.
eVars are custom variables that you can use however you’d like. If you have a solution design document, most dimensions specific to your organization end up as eVars. By default, eVars persist beyond the hit they are set on. You can customize their expiration and allocation under Conversion variables in Report suite settings.
The number of available eVars depends on your contract with ÃÛ¶¹ÊÓƵ. Up to 250 eVars are available if your contract with ÃÛ¶¹ÊÓƵ supports it.
Set up eVars in report suite settings
Before using eVars in your implementation, make sure that you configure each eVar in report suite settings. See Conversion variables in the Admin guide.
eVars using the Web SDK
eVars are mapped to the following variables:
- XDM object:
xdm._experience.analytics.customDimensions.eVars.eVar1toxdm._experience.analytics.customDimensions.eVars.eVar250 - Data object:
data.__adobe.analytics.eVar1todata.__adobe.analytics.eVar250; ordata.__adobe.analytics.v1todata.__adobe.analytics.v250
eVars using the ÃÛ¶¹ÊÓƵ Analytics extension
You can set eVars either while configuring the Analytics extension (global variables) or under rules.
- Log in to using your ÃÛ¶¹ÊÓƵID credentials.
- Click the desired tag property.
- Go to the Rules tab, then click the desired rule (or create a rule).
- Under Actions, click an existing ÃÛ¶¹ÊÓƵ Analytics - Set Variables action or click the ‘+’ icon.
- Set the Extension drop-down list to ÃÛ¶¹ÊÓƵ Analytics, and the Action Type to Set Variables.
- Locate the eVars section.
You can set an eVar to a value or a data element. You can also copy the value from another Analytics variable.
s.eVar1 - s.eVar250 in AppMeasurement and the Analytics extension custom code editor
Each eVar is a string that contains custom values specific to your organization. Their max length is 255 bytes; values longer than 255 bytes are automatically truncated when sent to ÃÛ¶¹ÊÓƵ.
s.eVar1 = "Example custom value";
Counter eVars
eVar values typically contain a string value. However, you can configure eVars to instead contain a counter. For example, you would like to count the number of internal searches made before a purchase. Instead of setting a text value, you would use the following syntax:
// Increment a counter eVar by 1
s.eVar1 = "+1";
// Increment a counter eVar by 12.49
s.eVar1 = "+12.49";
If more than two decimal places are given, the eVar counter rounds to two decimal places. An eVar counter cannot contain negative numbers.