Analytics variable mapping in Adobe Experience Edge

The following table shows the variables that the Adobe Experience Platform Edge Network automatically maps into Adobe Analytics. If you use these XDM Field Paths, no additional configuration is necessary to send data to Adobe Analytics.

Previous updates to this table can be found on this page’s commit history on GitHub.

XDM Field Path Analytics dimension and description
application.isClose Helps define the mobile metric Crashes.
application.isInstall Helps determine when to increase the mobile metric First Launches.
application.isLaunch Helps determine when to increase the mobile metric First Launches.
application.closeType Determines if a close event is a crash or not. Valid values include close (A lifecycle session ends and a pause event was received for the previous session) and unknown (A lifecycle session ends without a pause event). Helps set the Crashes metric.
application.isInstall The mobile metric Installs.
application.isLaunch The mobile metric Launches.
application.name Helps set the mobile dimension App ID.
application.isUpgrade The mobile metric Upgrades.
application.version Helps set the mobile dimension App ID.
application.sessionLength The mobile metric Previous Session Length.
commerce.checkouts.id Applies event serialization to the Checkouts metric.
commerce.checkouts.value Increments the Checkouts metric by the desired amount.
commerce.order.currencyCode Sets the currencyCode configuration variable.
commerce.order.purchaseID Sets the purchaseID page variable.
commerce.order.transactionID Sets the transactionID page variable.
commerce.productListAdds.id Applies event serialization to the Cart Additions metric.
commerce.productListAdds.value Increments the Cart Additions metric.
commerce.productListOpens.id Applies event serialization to the Carts metric.
commerce.productListOpens.value Increments the Carts metric.
commerce.productListRemovals.id Applies event serialization to the Cart Removals metric.
commerce.productListRemovals.value Increments the Cart Removals metric.
commerce.productListViews.id Applies event serialization to the Cart Views metric.
commerce.productListViews.value Increments the Cart Views metric.
commerce.productViews.id Applies event serialization to the Product Views metric.
commerce.productViews.value Increments the Product Views metric.
commerce.purchases.value Increments the Orders metric.
device.model The mobile dimension Device Name.
device.colorDepth Helps set the Color Depth dimension.
device.screenHeight Helps set the Monitor Resolution dimension.
device.screenWidth Helps set the Monitor Resolution dimension.
device.type The mobile device type.
environment.browserDetails.acceptLanguage Helps set the Language dimension.
environment.browserDetails.cookiesEnabled Sets the Cookie Support dimension. Valid values include Y (the browser accepts cookies) and N (the browser rejects cookies).
environment.browserDetails.javaEnabled Sets the Java enabled dimension. Valid values include Y (Java is enabled) and N (Java is disabled).
environment.browserDetails.userAgent Used as a fallback unique visitor identification method. Typically populated using the User-Agent HTTP request header. You can map this field to an eVar if you would like to use it in reports.
environment.browserDetails.viewportHeight Sets the Browser Height dimension.
environment.browserDetails.viewportWidth Sets the Browser Width dimension.
environment.carrier The mobile dimension Carrier Name.
environment.connectionType Helps set the Connection type dimension.
environment.ipV4 Used as a fallback unique visitor identification method. Typically populated using the X-Forwarded-For HTTP header.
environment.language The mobile dimension Locale.
environment.operatingSystem The mobile dimension Operating System.
environment.operatingSystemVersion Helps set the Operating System Version dimension.
_experience.analytics.customDimensions.
eVars.eVar1 -
_experience.analytics.customDimensions.
eVars.eVar250		 Sets the respective eVar dimension.
_experience.analytics.customDimensions.
hierarchies.hier1 -
_experience.analytics.customDImensions.
hierarchies.hier5		 Sets the respective Hierarchy dimension.
_experience.analytics.customDimensions.
listProps.prop1.delimiter -
_experience.analytics.customDimensions.
listProps.prop75.delimiter		 List prop delimiter override. Using this field is not recommended, as the delimiter is automatically retrieved from Traffic variable admin under report suite settings. Using this field can create a mismatch between the delimiter used and the delimiter that Analytics expects.
_experience.analytics.customDimensions.
listProps.prop1.values -
_experience.analytics.customDimensions.
listProps.prop75.values		 A string array containing the respective List Prop values.
_experience.analytics.customDimensions.
lists.list1.list[].value -
_experience.analytics.customDimensions.
lists.list3.list[].value		 Concatenates all value strings in each respective list[] array to its respective List variable. Delimiter is automatically chosen based on the value set in Report suite settings.
_experience.analytics.customDimensions.
props.prop1 -
_experience.analytics.customDimensions.
props.prop75		 Sets the respective Prop dimension.
_experience.analytics.event1to100.
event1.id -
_experience.analytics.event901to1000.
event1000.id		 Applies event serialization to the respective Custom events metric.
_experience.analytics.event1to100.
event1.value -
_experience.analytics.event901to1000.
event1000.value		 Increments the respective Custom events metric by the desired amount.
identityMap.ECID[0].id The Adobe Experience Cloud Identity Service ID.
marketing.trackingCode Sets the Tracking Code dimension.
media.mediaTimed.completes.value The Media Analytics metric Content Complete.
media.mediaTimed.dropBeforeStart.value c.a.media.view, c.a.media.timePlayed, c.a.media.play
media.mediaTimed.federated.value The Media Analytics metric Federated Data.
media.mediaTimed.firstQuartiles.value The Media Analytics metric Twenty-five % Progress Marker.
media.mediaTimed.mediaSegmentView.value The Media Analytics metric Content Segment Views.
media.mediaTimed.midpoints.value The Media Analytics metric Fifty % Progress Marker.
media.mediaTimed.pauseTime.value The Media Analytics metric Total Pause Duration.
media.mediaTimed.pauses.value The Media Analytics metric Pause Events.
media.mediaTimed.primaryAssetReference.
@id		 The Media Analytics dimension Asset ID.
media.mediaTimed.primaryAssetReference.
dc:title		 The Media Analytics dimension Video Name.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name		 The Media Analytics dimension Originator.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number		 The Media Analytics dimension Episode.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre		 The Media Analytics dimension Genre.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue		 The Media Analytics dimension Content Rating.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number		 The Media Analytics dimension Season.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier		 The Media Analytics dimension Content ID.
media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name		 The Media Analytics dimension Show.
media.mediaTimed.primaryAssetReference.
showType		 The Media Analytics dimension Show Type.
media.mediaTimed.primaryAssetReference.
xmpDM:duration		 The Media Analytics dimension Video Length.
media.mediaTimed.primaryAssetViewDetails.
@id		 The Media Analytics dimension Media Session ID.
media.mediaTimed.primaryAssetViewDetails.
broadcastChannel		 The Media Analytics dimension Content Channel.
media.mediaTimed.primaryAssetViewDetails.
broadcastContentType		 The Media Analytics dimension Content Type.
media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork		 The Media Analytics dimension Network.
media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value		 The Media Analytics dimension Content Segment.
media.mediaTimed.primaryAssetViewDetails.
playerName		 The Media Analytics dimension Content Player Name.
media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version		 The Media Analytics dimension SDK Version.
media.mediaTimed.primaryAssetViewDetails.
sourceFeed		 The Media Analytics dimension Media Feed Type.
media.mediaTimed.primaryAssetViewDetails.
streamFormat		 The Media Analytics dimension Stream Format.
media.mediaTimed.progress10.value The Media Analytics metric Ten % Progress Marker.
media.mediaTimed.progress95.value The Media Analytics metric Ninety-five % Progress Marker.
media.mediaTimed.resumes.value The Media Analytics metric Content Resumes.
media.mediaTimed.starts.value The Media Analytics metric Media Starts.
media.mediaTimed.thirdQuartiles.value The Media Analytics metric Seventy-five % Progress Marker.
media.mediaTimed.timePlayed.value The Media Analytics metric Content Time Spent.
media.mediaTimed.totalTimePlayed.value The Media Analytics metric Media Time Spent.
placeContext.geo.latitude The Mobile dimension Latitude.
placeContext.geo.longitude The Mobile dimension Longitude.
placeContext.geo.postalCode The Zip Code dimension.
placeContext.geo.stateProvince The US States dimension.
placeContext.localTime Helps populate Time Zones in Report & Analytics. Appears as t_time_info in Data feeds.
productListItems[]._experience.analytics.
customDimensions.eVars.eVar1 -
productListItems[]._experience.analytics.
customDimensions.eVars.eVar250		 Applies product syntax merchandising to eVars.
productListItems[]._experience.analytics.
event1to100.event1.value -
productListItems[]._experience.analytics.
event901-1000.event1000.value		 Applies product syntax merchandising to events.
productListItems[].lineItemId The Category dimension. See also the products page variable.
productListItems[].name The Product dimension. See also the products page variable. If productListItems[].SKU and productListItems[].name both contain data, the value in productListItems[].SKU is used.
productListItems[].priceTotal Helps determine the Revenue metric. See also the products page variable.
productListItems[].quantity Helps determine the Units metric. See also the products page variable.
productListItems[].SKU The Product dimension. See also the products page variable. If productListItems[].SKU and productListItems[].name both contain data, the value in productListItems[].SKU is used.
web.webInteraction.URL The linkURL implementation variable.
web.webInteraction.name The Custom link, Download link, or Exit link dimension, depending on the value in web.webInteraction.type
web.webInteraction.type Determines the type of link clicked. Valid values include other (Custom links), download (Download links), and exit (Exit links).
web.webPageDetails.URL The Page URL dimension.
web.webPageDetails.isErrorPage Flag that helps determine the ‘Pages Not Found’ dimension and metric.
web.webPageDetails.name The Page dimension.
web.webPageDetails.server The Server dimension.
web.webPageDetails.siteSection The Site Section dimension.
web.webReferrer.URL The Referrer dimension.

Mapping other XDM fields to Analytics variables

If there are any dimensions or metrics that you want to add to Adobe Analytics, you can do so through Context Data variables. Any XDM field elements that are not automatically mapped are sent to Adobe Analytics as Context Data with the prefix a.x. You can then map this context data variable to the desired Analytics variable using Processing rules. For example, if you send the following event:

alloy("event",{
    "xdm":{
        "_atag":{
            "search":{
                "term":"Example search term"
            }
        }
    }
})

The Web SDK sends that data to Adobe Analytics as the context data variable a.x._atag.search.term. You can then use a processing rule to assign that context data variable value to the desired Analytics variable, such as an eVar:

Search term processing rule

On this page