XDM ExperienceEvent类

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

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

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

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

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

属性

描述

_id
（必需）

Experience Event Class _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

一个映射字段，其中包含事件应用于的个人的一组命名空间标识。此字段在摄取身份数据时由系统自动更新。要为实时客户档案正确使用此字段，请不要尝试在数据操作中手动更新字段的内容。

有关其用例的更多信息，请参阅架构组合基础知识中关于标识映射的部分。

timestamp
（必需）

事件发生时间的ISO 8601时间戳，按照RFC 3339第5.6节格式设置。此时间戳必须是过去的时间，但必须是从1970年开始的时间。有关使用此字段的最佳实践，请参阅下面有关时间戳的部分。

事件建模的最佳实践

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

时间戳 timestamps

事件架构的根timestamp字段只能 2}表示事件本身的观察结果，并且必须发生在过去。 但是，事件必须从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