文档Analytics实施指南

XDM对象变量映射到Adobe Analytics

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 管理员
  • 开发人员

下表显示了Adobe Experience Platform Edge Network自动映射到Adobe Analytics中的XDM变量。 如果使用这些XDM字段路径，则无需额外配置即可将数据发送到Adobe Analytics。 这些字段包含在​ Adobe Analytics ExperienceEvent Template ​字段组中。 如果您打算将数据同时发送到Adobe Analytics和Adobe Experience Platform，则建议使用这些字段。

如果您的组织计划迁移到Customer Journey Analytics，Adobe建议改用data对象在不符合架构的情况下直接将数据发送到Adobe Analytics。 此策略允许您的组织使用自己的架构，而不是使用Adobe Analytics ExperienceEvent模板​(不太适用于Customer Journey Analytics)。 有关类似的映射表，请参阅映射到Adobe Analytics的数据对象变量。

价值优先级

此表的大多数XDM对象字段与数据对象字段一致。 如果同时设置给定的XDM对象字段及其各自的数据对象字段，则数据对象字段优先。 如果同时使用XDM对象字段和数据对象字段，Adobe建议使用数据对象字段设置自定义事件。 如果字段data.__adobe.analytics.events存在，它将覆盖所有与商务和自定义事件相关的XDM对象字段。

XDM对象字段映射

可以在此页面的 GitHub 上的提交历史记录中找到此表之前的更新内容。

XDM 字段路径
Analytics变量和描述
xdm.application.isClose
帮助定义移动生命周期量度崩溃。
xdm.application.isInstall
帮助确定何时增加首次发布移动生命周期量度。
xdm.application.closeType
确定关闭事件是否为崩溃。 有效值包括 close（生命周期会话结束，前一个会接话收到暂停事件）和 unknown（生命周期会话结束，没有暂停事件）。 帮助设置移动生命周期量度崩溃量度。
xdm.application.isInstall
移动生命周期量度安装。
xdm.application.isLaunch
移动生命周期量度发布。
xdm.application.name
帮助设置移动生命周期维度应用程序 ID。
xdm.application.isUpgrade
移动生命周期量度升级。
xdm.application.version
帮助设置移动生命周期维度应用程序 ID。
xdm.application.sessionLength
移动生命周期量度上一个会话长度。
xdm.commerce.checkouts.id
将事件序列化应用于“结账”量度。
xdm.commerce.checkouts.value
按所需的量增加“结账” 量度。
xdm.commerce.order.currencyCode
设置 currencyCode 配置变量。
xdm.commerce.order.purchaseID
设置 purchaseID 页面变量。
xdm.commerce.order.payments[0].transactionID
设置 transactionID 页面变量。
xdm.commerce.productListAdds.id
将事件序列化应用于添加到购物车的次数量度。
xdm.commerce.productListAdds.value
增加购物车添加 量度。
xdm.commerce.productListOpens.id
将事件序列化应用于“购物车”量度。
xdm.commerce.productListOpens.value
增加购物车 量度。
xdm.commerce.productListRemovals.id
将事件序列化应用于“购物车移除”量度。
xdm.commerce.productListRemovals.value
增加购物车减货 量度。
xdm.commerce.productListViews.id
将事件序列化应用于“购物车查看”量度。
xdm.commerce.productListViews.value
增加购物车查看次数 量度。
xdm.commerce.productViews.id
将事件序列化应用于“产品查看”量度。
xdm.commerce.productViews.value
增加“产品查看次数” 量度。
xdm.commerce.purchases.value
增加“订单” 量度。
xdm.device.model
移动生命周期维度设备名称。
xdm.device.colorDepth
帮助设置 “颜色深度” 维度。
xdm.device.screenHeight
帮助设置移动维度 “监测器分辨率” 维度。
xdm.device.screenWidth
帮助设置移动维度 “监测器分辨率” 维度。
xdm.device.type
移动设备类型。
xdm.environment.browserDetails.acceptLanguage
帮助设置 “语言” 维度。
xdm.environment.browserDetails.cookiesEnabled
设置 “Cookie 支持” 维度。 有效值包括 Y（浏览器接受 Cookie）和 N（浏览器拒绝 Cookie）。
xdm.environment.browserDetails.javaEnabled
设置 “启用 Java” 维度。 有效值包括 Y（Java 已启用）和 N（Java 已禁用）。
xdm.environment.browserDetails.userAgent
用作后备的独特访客识别方法。 通常使用 User-Agent HTTP 请求头填充。 如果要在报告中使用此字段，可以将其映射到 eVar。
xdm.environment.browserDetails.viewportHeight
设置 “浏览器高度” 维度。
xdm.environment.browserDetails.viewportWidth
设置 “浏览器宽度” 维度。
xdm.environment.carrier
移动生命周期维度运营商名称。
xdm.environment.connectionType
帮助设置 “连接类型” 维度。
xdm.environment._dc.language
设置上下文数据变量a.locale。 仅在未设置xdm.environment.language时使用。 Adobe建议超过xdm.environment.language使用此字段。
xdm.environment.ipV4
用作后备的独特访客 ​ 识别方法。 通常使用 X-Forwarded-For HTTP 头填充。
xdm.environment.language
设置上下文数据变量a.locale。 Adobe建议改用xdm.environment._dc.language。
xdm.environment.operatingSystem
移动生命周期维度操作系统。
xdm.environment.operatingSystemVersion
帮助设置移动生命周期维度操作系统版本。
xdm._experience.analytics.customDimensions.
eVars.eVar1
[...]
xdm._experience.analytics.customDimensions.
eVars.eVar250
设置相应的 eVar 维度。
xdm._experience.analytics.customDimensions.
hierarchies.hier1
[...]
xdm._experience.analytics.customDimensions.
hierarchies.hier5
设置相应的层级维度。
xdm._experience.analytics.customDimensions.
listProps.prop1.delimiter
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.delimiter
列表属性分隔符覆盖。不建议使用此字段，因为会从报告包设置下的流量变量管理中自动检索分隔符。使用此字段可能会导致使用的分隔符与 Analytics 需要的分隔符不匹配。
xdm._experience.analytics.customDimensions.
listProps.prop1.values
[...]
xdm._experience.analytics.customDimensions.
listProps.prop75.values
一个字符串数组，包含相应的 List Prop 值。
xdm._experience.analytics.customDimensions.
lists.list1.list[].value
[...]
xdm._experience.analytics.customDimensions.
lists.list3.list[].value
将每个 list[] 数组中的所有 value 字符串连接到其各自的列表变量。分隔符是根据报表包设置中的值集自动选择的。
xdm._experience.analytics.customDimensions.
props.prop1
[...]
xdm._experience.analytics.customDimensions.
props.prop75
设置相应的 Prop 维度。
xdm._experience.analytics.event1to100.
event1.id
[...]
xdm._experience.analytics.event901to1000.
event1000.id
将事件序列化应用于相应的自定义事件量度。每个事件 ID 驻留在其 100 组父项中。例如，要将序列化应用于 event678，请使用 xdm._experience.analytics.event601to700.event678.id。
xdm._experience.analytics.event1to100.
event1.value
[...]
xdm._experience.analytics.event901to1000.
event1000.value
按所需的量增加相应的自定义事件量度。每个事件驻留在其 100 组父项中。例如，event567 的字段为 xdm._experience.analytics.event501to600.event567.value。
xdm.identityMap.ECID[0].id
Adobe Experience Cloud 身份标识服务 ID。
xdm.marketing.trackingCode
设置 “跟踪代码” 维度。
xdm.media.mediaTimed.completes.value
流媒体服务量度内容结束。
xdm.media.mediaTimed.dropBeforeStart.value
a.media.view, a.media.timePlayed, a.media.play
xdm.media.mediaTimed.federated.value
流媒体服务量度联合数据。
xdm.media.mediaTimed.firstQuartiles.value
流媒体服务量度25%进度标记。
xdm.media.mediaTimed.mediaSegmentView.value
流媒体服务量度内容区段视图。
xdm.media.mediaTimed.midpoints.value
流媒体服务量度50%进度标记。
xdm.media.mediaTimed.pauseTime.value
流媒体服务量度总暂停持续时间。
xdm.media.mediaTimed.pauses.value
流媒体服务量度暂停事件。
xdm.mediaCollection.sessionDetails.assetID
流媒体服务维度资产ID。
xdm.mediaCollection.sessionDetails.friendlyName
流媒体服务维度视频名称。
xdm.mediaCollection.sessionDetails.originator
流媒体服务维度发起人。
xdm.mediaCollection.sessionDetails.episode
流媒体服务维度Episode。
xdm.mediaCollection.sessionDetails.genre
流媒体服务维度流派。
xdm.mediaCollection.sessionDetails.rating
流媒体服务维度内容评级。
xdm.mediaCollection.sessionDetails.season
流媒体服务维度季。
xdm.mediaCollection.sessionDetails.name
流媒体服务维度内容ID。
xdm.mediaCollection.sessionDetails.show
流媒体服务维度节目。
xdm.mediaCollection.sessionDetails.showType
流媒体服务维度节目类型。
xdm.mediaCollection.sessionDetails.length
流媒体服务维度视频长度。
xdm.media.mediaTimed.primaryAssetViewDetails.@id
流媒体服务维度媒体会话ID。
xdm.mediaCollection.sessionDetails.channel
流媒体服务维度内容频道。
xdm.mediaCollection.sessionDetails.contentType
流媒体服务维度内容类型。
xdm.mediaCollection.sessionDetails.network
流媒体服务维度网络。
xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value
流媒体服务维度内容区段。
xdm.mediaCollection.sessionDetails.playerName
流媒体服务维度内容播放器名称。
xdm.mediaCollection.sessionDetails.appVersion
流媒体服务维度SDK版本。
xdm.mediaCollection.sessionDetails.feed
流媒体服务维度媒体馈送类型。
xdm.mediaCollection.sessionDetails.streamFormat
流媒体服务维度流格式。
xdm.media.mediaTimed.progress10.value
流媒体服务量度1%进度标记。
xdm.media.mediaTimed.progress95.value
流媒体服务量度95%进度标记。
xdm.mediaCollection.sessionDetails.hasResume
流媒体服务量度内容继续。
xdm.media.mediaTimed.starts.value
流媒体服务量度媒体开始。
xdm.media.mediaTimed.thirdQuartiles.value
流媒体服务量度75%进度标记。
xdm.media.mediaTimed.timePlayed.value
流媒体服务量度内容逗留时间。
xdm.media.mediaTimed.totalTimePlayed.value
流媒体服务量度媒体逗留时间。
xdm.placeContext.geo._schema.latitude
访客的纬度位置。 帮助设置移动生命周期位置维度。
xdm.placeContext.geo._schema.longitude
访客的经度位置。 帮助设置移动生命周期位置维度。
xdm.placeContext.geo.postalCode
“邮政编码” 维度。
xdm.placeContext.geo.stateProvince
“美国” 维度。
xdm.placeContext.localTime
在数据馈送中显示为 t_time_info。
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar1
[...]
xdm.productListItems[]._experience.analytics.
customDimensions.eVars.eVar250
将产品语法促销应用于 eVar。
xdm.productListItems[]._experience.analytics.
event1to100.event1.value
[...]
xdm.productListItems[]._experience.analytics.
event901-1000.event1000.value
将产品语法促销应用于事件。
xdm.productListItems[].productCategories[].categoryID
“类别” 维度。另请参阅产品页面变量。
xdm.productListItems[].name
产品维度。另请参阅产品页面变量。 如果 xdm.productListItems[].SKU 和 xdm.productListItems[].name 都包含数据，则使用 xdm.productListItems[].SKU 中的值。
xdm.productListItems[].priceTotal
帮助确定收入量度。另请参阅产品页面变量。
xdm.productListItems[].quantity
帮助确定单位量度。另请参阅产品页面变量。
xdm.productListItems[].SKU
产品维度。另请参阅产品页面变量。 如果 xdm.productListItems[].SKU 和 xdm.productListItems[].name 都包含数据，则使用 xdm.productListItems[].SKU 中的值。
xdm.web.webInteraction.URL
linkURL 实施变量。
xdm.web.webInteraction.name
自定义链接、下载链接 或者退出链接维度取决于 xdm.web.webInteraction.type 中的值
xdm.web.webInteraction.type
确定链接点击的类型。 有效值包括 other（自定义链接）、download（下载链接）和 exit（退出链接）。
xdm.web.webPageDetails.URL
页面 URL 维度。
xdm.web.webPageDetails.isErrorPage
帮助确定“找不到页面”维度和量度。
xdm.web.webPageDetails.name
页面维度。
xdm.web.webPageDetails.server
服务器维度。
xdm.web.webPageDetails.siteSection
网站分区维度。
xdm.web.webReferrer.URL
推荐人维度。

将其他 XDM 字段映射到 Analytics 变量

如果有任何维度或量度要添加到Adobe Analytics中，可以通过上下文数据变量进行添加。

隐式映射

任何未自动映射的XDM字段元素将作为前缀为a.x.的上下文数据发送到Adobe Analytics。 然后，可以使用处理规则将此上下文数据变量映射到所需的Analytics变量。 例如，如果发送以下事件：

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

Web SDK 将该数据作为上下文数据变量发送给 Adobe Analytics a.x._atag.search.term。 然后，您可以使用处理规则将该上下文数据变量值分配给所需的Analytics变量，如eVar：

搜索词处理规则

显式映射

您还可以将XDM字段元素显式映射为上下文数据。 使用contextData元素显式映射的任何XDM字段元素将作为不带前缀的上下文数据发送到Adobe Analytics。 然后，可以使用处理规则将此上下文数据变量映射到所需的Analytics变量。 例如，如果发送以下事件：

alloy("event",{
    "xdm":{
        "_atag":{
            "analytics": {
                "contextData" : {
                    "someValue" : "1"
                }
            }
        }
    }
})

Web SDK将该数据作为值为somevalue的上下文数据变量1发送到Adobe Analytics。 然后，您可以使用处理规则将该上下文数据变量值分配给所需的Analytics变量，如eVar：

搜索词处理规则

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