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 Adobe. Up to 250 eVars are available if your contract with Adobe 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.eVar1 to xdm._experience.analytics.customDimensions.eVars.eVar250
  • Data object: data.__adobe.analytics.eVar1 to data.__adobe.analytics.eVar250; or data.__adobe.analytics.v1 to data.__adobe.analytics.v250

eVars using the Adobe Analytics extension

You can set eVars either while configuring the Analytics extension (global variables) or under rules.

  1. Log in to Adobe Experience Platform Data Collection using your AdobeID credentials.
  2. Click the desired tag property.
  3. Go to the Rules tab, then click the desired rule (or create a rule).
  4. Under Actions, click an existing Adobe Analytics - Set Variables action or click the ‘+’ icon.
  5. Set the Extension drop-down list to Adobe Analytics, and the Action Type to Set Variables.
  6. 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 Adobe.

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.

You must first configure eVars to ‘Counter’ in the Admin Console before using counter eVars. See Conversion variables in the Admin guide.