XDM对象变量映射到Adobe Analytics

Last update: Mon Mar 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Implementation Basics

创建对象：

Admin
Developer

下表显示了Adobe Experience Platform Edge Network自动映射到Adobe Analytics的XDM变量。如果使用这些XDM字段路径，则无需额外配置即可将数据发送到Adobe Analytics。这些字段包含在 Adobe Analytics ExperienceEvent模板 字段组。如果您打算将数据同时发送到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.isLaunch

帮助确定何时增加首次发布移动生命周期量度。

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.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

Media Analytics 量度内容完成。

xdm.media.mediaTimed.dropBeforeStart.value

c.a.media.view, c.a.media.timePlayed, c.a.media.play

xdm.media.mediaTimed.federated.value

Media Analytics 量度联邦数据。

xdm.media.mediaTimed.firstQuartiles.value

Media Analytics 量度 25% 进度标记。

xdm.media.mediaTimed.mediaSegmentView.value

Media Analytics 量度内容区段视图。

xdm.media.mediaTimed.midpoints.value

Media Analytics 量度 50% 进度标记。

xdm.media.mediaTimed.pauseTime.value

Media Analytics 量度总暂停时间。

xdm.media.mediaTimed.pauses.value

Media Analytics 量度暂停事件。

xdm.media.mediaTimed.primaryAssetReference.
@id

Media Analytics 维度资产 ID。

xdm.media.mediaTimed.primaryAssetReference.
dc:title

Media Analytics 维度视频名称。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Creator[N].iptc4xmpExt:Name

Media Analytics 维度发起人。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Episode.iptc4xmpExt:Number

Media Analytics 维度集。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre

Media Analytics 维度流派。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Rating[N].iptc4xmpExt:RatingValue

Media Analytics 维度内容评级。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Season.iptc4xmpExt:Number

Media Analytics 维度季。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Identifier

Media Analytics 维度内容 ID。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Series.iptc4xmpExt:Name

Media Analytics 维度节目。

xdm.media.mediaTimed.primaryAssetReference.
showType

Media Analytics 维度节目类型。

xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration

Media Analytics 维度视频长度。

xdm.media.mediaTimed.primaryAssetViewDetails.
@id

Media Analytics 维度媒体会话 ID。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel

Media Analytics 维度内容频道。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType

Media Analytics 维度内容类型。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork

Media Analytics 维度网络。

xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value

Media Analytics 维度内容区段。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerName

Media Analytics 维度内容播放器名称。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version

Media Analytics 维度 SDK 版本。

xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed

Media Analytics 维度媒体馈送类型。

xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat

Media Analytics 维度流格式。

xdm.media.mediaTimed.progress10.value

Media Analytics 量度 10% 进度标记。

xdm.media.mediaTimed.progress95.value

Media Analytics 量度 95% 进度标记。

xdm.media.mediaTimed.resumes.value

Media Analytics 量度内容恢复。

xdm.media.mediaTimed.starts.value

Media Analytics 量度媒体开始。

xdm.media.mediaTimed.thirdQuartiles.value

Media Analytics 量度 75% 进度标记。

xdm.media.mediaTimed.timePlayed.value

Media Analytics 量度内容花费时间。

xdm.media.mediaTimed.totalTimePlayed.value

Media Analytics 量度媒体花费时间。

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：

搜索词处理规则

recommendation-more-help

b4f6d761-4a8b-4322-b801-c85b9e3be690