Conversion Variables (eVar)

The Custom Insight Conversion Variable (or eVar) is placed in the Adobe code on selected web pages of your site. Its primary purpose is to segment conversion success metrics in custom marketing reports. An eVar can be visit-based and function similarly to cookies. Values passed into eVar variables follow the user for a predetermined period of time.

When an eVar is set to a value for a visitor, Adobe automatically remembers that value until it expires. Any success events that a visitor encounters while the eVar value is active are counted toward the eVar value.

eVars are best used to measure cause and effect, such as:

If traffic measurement or pathing is desired, using traffic variables is recommended.

Note: Only a single value can be stored in an eVar in an image request. If multiple values are desired in an eVar value, we recommend that you implement List variables (list vars).

Conversion Variables - Descriptions

Descriptions of fields used when editing conversion variables.




The friendly name of the conversion variable. This name is how the eVar is referred to in general reporting, and will be the name of the report in the left-hand menu.


(eVar only)

The type of variable value:

Text String: Captures text values used on your site.

This is the most common type of eVar, and the default setting. It acts similar to other variables, where the value within it is a static text string. If you are tracking things such as internal campaigns or internal search keywords, this is the recommended setting.

Counter: Counts the number of times an action occurs before the success event.

For example, if you use an eVar to track internal searches on your site, set this value to Text String to track the use of search terms. Set this value to Counter to count the number of searches made, regardless of search terms used. For example, you can use a counter eVar to track the number of times someone used your internal search before making a purchase.


Determines how Analytics assigns credit for a success event if a variable receives multiple values before the event. Supported values include:

Most Recent: The last eVar value always receives credit for success events until that eVar expires.

Original Value: The first eVar always receives credit for success events until that eVar expires.

Linear: Allocates success events equally across all eVar values. Since Linear allocation accurately distributes values only within a visit, use Linear allocation with an eVar expiration of Visit.

Note: Switching allocation to or from Linear prevents historical data from displaying. Mixing allocation types in the reporting interface can lead to misstated data in reports. For example, Linear allocation might divide revenue across a number of different eVar values. After changing back to Most Recent allocation, 100% of that revenue would be associated with the most recent single value. This association can lead to incorrect conclusions by users.

To avoid the likelihood of confusion in reporting, Analytics makes the historical data unavailable to the interface. It can be viewed if you decide to change the given eVar back to the initial allocation setting, although you should not change eVar allocation settings simply to access the historical data. Adobe recommends using a new eVar when new allocation settings are desired for data already being recorded, rather than changing allocation settings on an eVar that already has a significant amount of historical data built up.

Expire After

Specifies a time period, or event, after which the eVar value expires (no longer receives credit for success events). If a success event occurs after eVar expiration, the None value receives credit for the event (no eVar was active).

If you select an event as an expiration value, the variable expires only if the event occurs. If the event does not occur, the variable never expires.

The available expiration options can be classified under four main categories:

  • At a page view or visit level. Conversion events beyond the page view or visit do not associate with the eVar.
  • Based on a time period, such as day, week, month, or year. Conversion events beyond the specified time period do not associate with the eVar. The expiration period starts when the variable is set. eVars expire based on the time they were set, to the second (minute, hour, day, month, etc):
    • MINUTE=60 seconds
    • HOUR=3600 seconds (60 minutes)
    • DAY=86400 seconds (24 hours)
    • WEEK=604800 seconds (7 days)
    • MONTH=2678400 seconds (31 days)
    • QUARTER=8035200 seconds (93 days - 3 months of 31 days)
    • YEAR=31536000 seconds (365 days)

    If a visit starts at 7:00 AM on Monday and an eVar is set within that visit at 7:15 AM, expiration is as shown below:

    • Day expiration: eVar expires at 7:15 AM on Tuesday.
    • Week expiration: eVar expires on the following Monday at 7:15 AM.
    • Month expiration: eVar expires 31 days from Monday at 7:15 AM.
  • Specific conversion events. Any other conversion events that fire after the specific event designated associate with the eVar.
  • Never. As long as the visitorID cookie is intact, any amount of time can pass between eVar and event.


(eVar only)

Defines the eVar status:

Disabled: Disables the eVar. Removes the eVar from the conversion variable list.

No Subrelations: Prevents you from breaking down the eVar with a subrelation.

Basic Subrelations: Lets you break down an eVar by any report with full subrelations (for example, Products or Campaign).


Resets any existing value in the eVar.

Use this setting when repurposing an eVar so you do mix an old value into a new report. Resetting does not erase historical data.


(eVar only)

Merchandising variables can follow one of two syntaxes:

Products Syntax: Associates the eVar value to a product.
Note: If Products Syntax is selected, the Merchandising Binding Event section is disabled and not selectable for edit. For this syntax, Binding Events are not applicable.

Conversion Variable Syntax: Associates the eVar with a product only if a Binding Event occurs. In this case, you select the events that act as Binding Events.

Changing this setting without updating your JavaScript code accordingly causes lost data. See Merchandising Variables.

Merchandising Binding Event

(eVar only)

If Merchandising is set to Conversion Variable Syntax, the selected events bind the current eVar value with a product.

To use a Binding Event, set Allocation to Most Recent. If Allocation is Original Value, the first eVar product binding remains until the eVar expires.