DocumentationAnalyticsImplementation Guide

Analytics variable mapping in Adobe Experience Edge

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
  • Developer

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. These fields are included in the Adobe Analytics ExperienceEvent Template field group.

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 lifecycle metric Crashes.
application.isInstall
Helps determine when to increase the mobile lifecycle metric First Launches.
application.isLaunch
Helps determine when to increase the mobile lifecycle 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 mobile lifecycle metric Crashes metric.
application.isInstall
The mobile lifecycle metric Installs.
application.isLaunch
The mobile lifecycle metric Launches.
application.name
Helps set the mobile lifecycle dimension App ID.
application.isUpgrade
The mobile lifecycle metric Upgrades.
application.version
Helps set the mobile lifecycle dimension App ID.
application.sessionLength
The mobile lifecycle 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.payments[0].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 lifecycle 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 lifecycle 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 lifecycle dimension Operating System.
environment.operatingSystemVersion
Helps set the mobile lifecycle dimension Operating System Version.
_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. Each event ID resides in its 100-group parent. For example, to apply serialization to event678, use _experience.analytics.event601to700.event678.id.
_experience.analytics.event1to100.
event1.value
[...]
_experience.analytics.event901to1000.
event1000.value
Increments the respective Custom events metric by the desired amount. Each event resides in its 100-group parent. For example, the field for event567 is _experience.analytics.event501to600.event567.value.
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._schema.latitude
The Mobile dimension Latitude.
placeContext.geo._schema.longitude
The Mobile dimension Longitude.
placeContext.geo.postalCode
The Zip Code dimension.
placeContext.geo.stateProvince
The US States dimension.
placeContext.localTime
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[].productCategories[].categoryID
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

recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690