XDM ExperienceEvent 类

XDM ExperienceEvent 是一个标准的体验数据模型(XDM)类。 此类用于在发生特定事件或达到特定条件集时创建带时间戳的系统快照。

体验事件是所发生事件的事实记录,包括时间点和所涉及人员的身份。 事件可以是显式的(直接可观察的人类行为)或隐式的(在没有直接人类行为的情况下引发),并且无需聚合或解释即可记录。 有关此类在平台生态系统中使用的更多高级信息,请参阅 XDM概述.

此 XDM ExperienceEvent 类本身为架构提供了多个与时间序列相关的字段。 其中两个字段(_idtimestamp)为 必填 对于所有基于此类的架构,而其余架构是可选的。 在摄取数据时,会自动填充某些字段的值。

Platform UI中显示的XDM ExperienceEvent的结构。

属性
描述
_id
(必需)
体验事件类 _id 字段唯一标识提取到Adobe Experience Platform中的各个事件。 此字段用于跟踪单个事件的唯一性,防止数据重复,并在下游服务中查找该事件。

在检测到重复事件的情况下,Platform应用程序和服务可能会以不同的方式处理重复事件。 例如,如果配置文件服务中的重复事件具有相同的 _id 配置文件存储中已存在。

在某些情况下, _id 可以是 通用唯一标识符(UUID)全局唯一标识符(GUID).

如果您要从源连接流式传输数据或直接从Parquet文件中摄取,则应通过连接特定字段组合以使其成为唯一事件来生成此值。 可连接的事件示例包括主ID、时间戳、事件类型等。 拼接值必须为 uri-reference 带格式的字符串,这意味着必须删除任何冒号字符。 之后,应该使用SHA-256或您选择的其他算法对拼接值进行哈希处理。

区分以下内容很重要 此字段不表示与个人相关的身份 ​而不是数据记录本身。 与人员相关的身份数据应委派到 标识字段 由兼容的字段组提供。
eventMergeId
如果使用 Adobe Experience Platform Web SDK 要摄取数据,这表示导致创建记录的摄取批次的ID。 此字段在数据摄取时由系统自动填充。 不支持在Web SDK实施的上下文之外使用此字段。
eventType
一个字符串,它指示事件的类型或类别。 如果要区分同一架构和数据集中的不同事件类型(例如,将产品查看事件与零售公司的添加到购物车事件区分开来),则可以使用此字段。

此属性的标准值提供在 附录部分,包括目标用例的描述。 此字段是可扩展的枚举,这意味着您还可以使用自己的事件类型字符串对正在跟踪的事件进行分类。

eventType 限制您只能对应用程序上的每次点击使用单个事件,因此您必须使用计算字段让系统知道哪个事件最重要。 有关更多信息,请参阅以下部分: 计算字段的最佳实践.
producedBy
描述事件生成者或来源的字符串值。 如果需要,可以使用此字段过滤掉某些事件生成器,以用于分段目的。

此属性的某些建议值请参见 附录部分. 此字段是可扩展的枚举,这意味着您还可以使用自己的字符串来表示不同的事件生成器。
identityMap
一个映射字段,其中包含事件应用于的个人的一组命名空间标识。 此字段在摄取身份数据时由系统自动更新。 要正确使用此字段,请执行以下操作 Real-time Customer Profile中,请勿尝试在数据操作中手动更新字段内容。

请参阅中有关身份映射的部分 模式组合基础 以了解有关其用例的更多信息。
timestamp
(必需)
事件发生时间的ISO 8601时间戳,格式如下 RFC 3339第5.6节. 此时间戳 必须 发生于过去,但 必须 从1970年开始。 请参阅以下部分: 时间戳 以获取有关使用此字段的最佳实践。

事件建模的最佳实践

以下部分介绍了在Adobe Experience Platform中设计基于事件的体验数据模型(XDM)架构的最佳实践。

时间戳 timestamps

timestamp 事件架构的字段可以 仅限 表示对事件本身的观察,并且必须发生在过去。 但是,该事件 必须 从1970年开始。 如果分段用例需要使用将来可能发生的时间戳,则这些值必须限制在体验事件架构中的其他位置。

例如,如果旅游和酒店业的某个企业正在建模航班预订事件,则班级级别 timestamp 字段表示观察到预订事件的时间。 与事件相关的其他时间戳(如旅行预订的开始日期)应捕获在标准或自定义字段组提供的单独字段中。

突出显示航班预订和开始日期的体验事件架构示例。

通过将类级别时间戳与事件架构中的其他相关日期时间值分开,您可以实施灵活的分段用例,同时保留体验应用程序中客户历程的时间戳帐户。

使用计算字段 calculated

体验应用程序中的某些交互可能会导致技术上共享同一事件时间戳的多个相关事件,因此可以表示为单个事件记录。 例如,如果客户查看了您网站上的产品,这可能会导致事件记录具有两种可能性 eventType 值:“产品查看”事件(commerce.productViews)或普通“页面查看”事件(web.webpagedetails.pageViews)。 在这些情况下,您可以在单次点击中捕获多个事件时,使用计算字段捕获最重要的属性。

使用 Adobe Experience Platform数据准备 来映射、转换和验证XDM中的数据。 使用可用的 映射函数 该服务提供了一些逻辑运算符,当数据被摄取到Experience Platform中时,您可以调用这些逻辑运算符来排列数据优先级,转换和/或合并来自多事件记录的数据。 在上面的示例中,您可以指定 eventType 作为计算字段,每当“产品查看”与“页面查看”都发生时,都会优先显示该字段。

如果您是通过UI手动将数据摄取到Platform,请参阅上的指南 计算字段 有关如何创建计算字段的特定步骤。

如果您要使用源连接将数据流式传输到Platform,则可以配置源以利用计算字段。 请参阅 特定源的文档 有关如何在配置连接时实施计算字段的说明。

兼容的架构字段组 field-groups

NOTE
多个字段组的名称已更改。 查看文档 字段组名称更新 以了解更多信息。

Adobe提供了多个标准字段组用于 XDM ExperienceEvent 类。 以下是类的一些常用字段组的列表:

附录

以下部分包含有关 XDM ExperienceEvent 类。

接受的值 eventType eventType

下表概述了接受的值 eventType,以及它们的定义:

定义
advertising.clicks
此事件跟踪选择播发的操作何时发生。
advertising.completes
此事件跟踪定时媒体资源在何时观看完毕。 这并不一定意味着观看者观看了整个视频,因为观看者可以跳过前面。
advertising.conversions
此事件跟踪客户执行的预定义操作,该操作会触发绩效评估事件。
advertising.federated
此事件跟踪体验事件是否通过数据联合(客户之间的数据共享)创建。
advertising.firstQuartiles
此事件跟踪数字视频广告何时以正常速度播放了其25%的时长。
advertising.impressions
此事件跟踪对有可能被查看的客户的广告展示次数。
advertising.midpoints
此事件跟踪数字视频广告何时以正常速度播放了其50%的时长。
advertising.starts
此事件跟踪数字视频广告何时开始播放。
advertising.thirdQuartiles
此事件跟踪数字视频广告何时以正常速度播放了其75%的时长。
advertising.timePlayed
此事件可跟踪用户在特定定时媒体资源上花费的时间。
application.close
此事件跟踪应用程序何时关闭或发送到后台。
application.launch
此事件跟踪应用程序启动或进入前台的时间。
commerce.backofficeCreditMemoIssued
此事件跟踪向客户发出信用通知的时间。
commerce.backofficeOrderCancelled
此事件跟踪以前启动的购买流程在完成前何时终止。
commerce.backofficeOrderItemsShipped
此事件会跟踪购买的项目实际发运给客户的时间。
commerce.backofficeOrderPlaced
此事件跟踪订单的投放情况。
commerce.backofficeShipmentCompleted
此事件用于跟踪整个发运流程的成功完成。
commerce.checkouts
此事件跟踪产品列表何时发生签出事件。 如果结账过程包含多个步骤,则可能有多个结账事件。 如果有多个步骤,则会使用时间戳和每个事件的引用页面/体验来标识每个单独事件(步骤),并按顺序表示。
commerce.productListAdds
此事件会跟踪产品何时添加到产品列表或购物车。
commerce.productListOpens
此事件跟踪新产品列表(购物车)何时已初始化或创建。
commerce.productListRemovals
此事件会跟踪从产品列表或购物车中删除产品条目的时间。
commerce.productListReopens
此事件会跟踪客户何时重新激活不再可访问(已放弃)的产品列表(购物车),例如通过再营销活动。
commerce.productListViews
此事件会跟踪产品列表或购物车何时收到视图。
commerce.productViews
此事件跟踪产品何时收到一个或多个视图。
commerce.purchases
此事件跟踪订单何时被接受。 这是商业转换中唯一需要执行的操作。 购买事件必须具有引用的产品列表。
commerce.saveForLaters
此事件会跟踪产品列表在保存以供将来使用,例如产品愿望清单。
decisioning.propositionDisplay
此事件跟踪向人员显示决策建议的时间。
decisioning.propositionDismiss
此事件会跟踪何时决定不与提供的优惠合作。
decisioning.propositionInteract
此事件跟踪人员与决策建议交互的时间。
decisioning.propositionSend
此事件会跟踪何时决定向潜在客户发送推荐或选件以供考虑。
decisioning.propositionTrigger
此事件跟踪建议流程的激活情况。 已发生特定条件或操作来提示提供选件。
delivery.feedback
此事件跟踪投放的反馈事件,如电子邮件投放。
directMarketing.emailBounced
此事件可跟踪发送给人员的电子邮件何时退回。
directMarketing.emailBouncedSoft
此事件可跟踪发送给人员的电子邮件何时软退回。
directMarketing.emailClicked
此事件可跟踪用户何时单击营销电子邮件中的链接。
directMarketing.emailDelivered
此事件跟踪电子邮件何时成功发送到人员的电子邮件服务。
directMarketing.emailOpened
此事件可跟踪人员何时打开营销电子邮件。
directMarketing.emailSent
此事件可跟踪营销电子邮件何时发送给人员。
directMarketing.emailUnsubscribed
此事件跟踪人员何时取消订阅营销电子邮件。
inappmessageTracking.dismiss
此事件跟踪何时取消应用程序内消息。
inappmessageTracking.display
此事件会跟踪应用程序内消息的显示时间。
inappmessageTracking.interact
此事件会跟踪与应用程序内消息交互的时间。
leadOperation.callWebhook
此事件跟踪何时调用webhook来响应潜在客户。
leadOperation.changeCampaignStream
此事件表示特定业务商机的营销或参与策略发生变化。
leadOperation.changeEngagementCampaignCadence
此事件会跟踪在营销活动中商机与的参与频率何时发生更改。
leadOperation.convertLead
此事件跟踪商机何时转化。
leadOperation.interestingMoment
此事件跟踪何时为人员录制了有趣的时刻。
leadOperation.mergeLeads
此事件会跟踪来自引用同一实体的多个潜在客户的信息何时合并。
leadOperation.newLead
此事件会跟踪销售线索的创建时间。
leadOperation.scoreChanged
此事件跟踪商机的得分属性值何时更改。
leadOperation.statusInCampaignProgressionChanged
此事件跟踪营销活动中的商机状态何时已更改。
listOperation.addToList
此事件会跟踪将人员添加到营销列表的时间。
listOperation.removeFromList
此事件跟踪人员从营销列表中移除的时间。
media.adBreakComplete
此事件跟踪 adBreakComplete 事件已发生。 此事件在广告时间开始时触发。
media.adBreakStart
此事件跟踪 adBreakStart 事件已发生。 此事件在广告时间结束时触发。
media.adComplete
此事件跟踪 adComplete 事件已发生。 此事件在广告完成时触发。
media.adSkip
此事件跟踪 adSkip 事件已发生。 此事件在跳过广告时触发。
media.adStart
此事件跟踪 adStart 事件已发生。 当广告开始时,将触发此事件。
media.bitrateChange
此事件跟踪 bitrateChange 事件已发生。 此事件在比特率发生更改时触发。
media.bufferStart
此事件跟踪 bufferStart 事件已发生。 当媒体开始缓冲时,将触发此事件。
media.chapterComplete
此事件跟踪 chapterComplete 事件已发生。 此事件在媒体中的章节结束时触发。
media.chapterSkip
此事件跟踪 chapterSkip 事件已发生。 当用户向前或向后跳到媒体内容中的其他部分或章节时,将触发此事件。
media.chapterStart
此事件跟踪 chapterStart 事件已发生。 此事件在媒体内容中的特定部分或章节开始时触发。
media.downloaded
此事件跟踪媒体下载内容的发生时间。
media.error
此事件跟踪 error 事件已发生。 当媒体播放期间发生错误或问题时,将触发此事件。
media.pauseStart
此事件跟踪 pauseStart 事件已发生。 当用户启动媒体播放暂停时,将触发此事件。
media.ping
此事件跟踪 ping 事件已发生。 这将验证介质资源的可用性。
media.play
此事件跟踪 play 事件已发生。 此事件在媒体内容播放时触发,表示用户正在使用。
media.sessionComplete
此事件跟踪 sessionComplete 事件已发生。 此事件标记媒体播放会话的结尾。
media.sessionEnd
此事件跟踪 sessionEnd 事件已发生。 此事件表示媒体会话结束。 此结论可能涉及关闭媒体播放器或停止播放。
media.sessionStart
此事件跟踪 sessionStart 事件已发生。 此事件标记媒体播放会话的开始。 当用户开始播放媒体文件时触发。
media.statesUpdate
此事件跟踪 statesUpdate 事件已发生。 播放器状态跟踪功能可以附加到音频或视频流。 标准状态为:fullscreen、mute、closedCaptioning、pictureInPicture和inFocus。
opportunityEvent.addToOpportunity
此事件跟踪人员添加到商机的时间。
opportunityEvent.opportunityUpdated
此事件跟踪销售机会的更新时间。
opportunityEvent.removeFromOpportunity
此事件跟踪人员从机会中删除的时间。
pushTracking.applicationOpened
此事件跟踪人员从推送通知中打开应用程序的时间。
pushTracking.customAction
此事件跟踪人员何时在推送通知中选择了自定义操作。
web.formFilledOut
此事件跟踪人员在网页上填写表单的时间。
web.webinteraction.linkClicks
此事件跟踪链接何时已被选择一次或多次。
web.webpagedetails.pageViews
此事件跟踪网页何时收到一个或多个视图。
location.entry
此事件跟踪人员或设备在特定位置的进入。
location.exit
此事件跟踪人员或设备从特定位置的退出。

建议值 producedBy producedBy

下表概述了一些接受的值 producedBy

定义
self
自身
system
系统
salesRef
销售代表
customerRep
客户代表
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07