XDM对象变量映射到Adobe Analytics

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
实施基础知识

创建对象：

管理员
开发人员

下表显示了Adobe Experience PlatformEdge 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 Template (不太适用于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.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.media.mediaTimed.primaryAssetReference.
@id

流媒体维度资产ID。

xdm.media.mediaTimed.primaryAssetReference.
dc:title

流媒体维度视频名称。

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

流媒体维度发起人。

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

流媒体维度Episode。

xdm.media.mediaTimed.primaryAssetReference.
iptc4xmpExt:Genre

流媒体维度流派。

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

流媒体维度内容评级。

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

流媒体维度季。

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

流媒体维度内容ID。

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

流媒体维度节目。

xdm.media.mediaTimed.primaryAssetReference.
showType

流媒体维度节目类型。

xdm.media.mediaTimed.primaryAssetReference.
xmpDM:duration

流媒体维度视频长度。

xdm.media.mediaTimed.primaryAssetViewDetails.
@id

流媒体维度媒体会话ID。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastChannel

流媒体维度内容频道。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastContentType

流媒体维度内容类型。

xdm.media.mediaTimed.primaryAssetViewDetails.
broadcastNetwork

流媒体维度网络。

xdm.media.mediaTimed.primaryAssetViewDetails.
mediaSegmentView.value

流媒体维度内容区段。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerName

流媒体维度内容播放器名称。

xdm.media.mediaTimed.primaryAssetViewDetails.
playerSDKVersion.version

流媒体维度SDK版本。

xdm.media.mediaTimed.primaryAssetViewDetails.
sourceFeed

流媒体维度媒体馈送类型。

xdm.media.mediaTimed.primaryAssetViewDetails.
streamFormat

流媒体维度流格式。

xdm.media.mediaTimed.progress10.value

流媒体量度1%进度标记。

xdm.media.mediaTimed.progress95.value

流媒体量度95%进度标记。

xdm.media.mediaTimed.resumes.value

流媒体量度内容继续。

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发送给Adobe Analytics，其值为1。然后，您可以使用处理规则将该上下文数据变量值分配给所需的Analytics变量，如eVar：

搜索词处理规则

recommendation-more-help

b4f6d761-4a8b-4322-b801-c85b9e3be690