XDM对象变量映射到Adobe Analytics

下表显示了Adobe Experience PlatformEdge 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[].SKUxdm.productListItems[].name 都包含数据,则使用 xdm.productListItems[].SKU 中的值。
xdm.productListItems[].priceTotal
帮助确定收入量度。另请参阅产品页面变量。
xdm.productListItems[].quantity
帮助确定单位量度。另请参阅产品页面变量。
xdm.productListItems[].SKU
产品维度。另请参阅产品页面变量。 如果 xdm.productListItems[].SKUxdm.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字段元素都将作为上下文数据发送给Adobe Analytics,前缀为 a.x. 然后,您可以使用将此上下文数据变量映射到所需的Analytics变量 处理规则. 例如,如果发送以下事件:

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

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

搜索词处理规则

显式映射

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

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

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

搜索词处理规则

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