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 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.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 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. 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.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[].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. |
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: