XDM对象变量映射到Adobe Analytics

最近更新： 2025年3月6日

主题：
实施基础知识

创建对象：

管理员
开发人员

下表显示了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.ipV4`	用作后备的独特访客识别方法。通常使用 `X-Forwarded-For` HTTP 头填充。
`xdm.environment._dc.language`	移动维度区域设置。仅在未设置xdm.environment.language时使用。
`xdm.environment.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`	`c.a.media.view`, `c.a.media.timePlayed`, `c.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将该数据作为值为1的上下文数据变量somevalue发送到Adobe Analytics。然后，您可以使用处理规则将该上下文数据变量值分配给所需的Analytics变量，如eVar：

搜索词处理规则