操作类型
配置之后 Adobe Experience Platform Web SDK标记扩展,您必须配置操作类型。
本页介绍支持的操作类型。 Adobe Experience Platform Web SDK标记扩展.
发送事件 send-event
向Adobe发送事件 Experience Platform 以便Adobe Experience Platform可以收集您发送的数据并对该信息执行相应的操作。 选择一个实例(如果有多个实例)。 您要发送的任何数据均可发送 XDM数据 字段。 使用符合XDM架构的JSON对象。 此对象可以在页面上创建,也可以通过 自定义代码 数据元素.
根据您的实施, Send Event操作类型中还有一些其他字段也可能很有用。 请注意,这些字段都是可选的。
- 类型: 此字段允许您指定将记录在XDM架构中的事件类型。 请参阅
type
在sendEvent
命令以了解更多信息。 - 数据: 可使用此字段发送不匹配XDM架构的数据。 如果您尝试更新Adobe Target配置文件或发送Target Recommendations属性,则此字段非常有用。 请参阅
data
在sendEvent
命令以了解更多信息。 - 数据集ID: 如果您需要将数据发送到您在数据流中指定的数据集以外的其他数据集,则可以在此处指定该数据集ID。
- 文档将卸载: 如果您想确保事件可到达服务器,即使用户离开页面,请检查 文档将卸载 复选框。 这允许事件访问服务器,但响应将被忽略。
- 呈现可视化个性化决策: 如果您想在页面上呈现个性化内容,请选中 呈现可视化个性化决策 复选框。 如有必要,您还可以指定决策范围和/或曲面。 请参阅 个性化文档 以了解有关呈现个性化内容的更多信息。
设置同意 set-consent
收到用户的同意后,必须使用“设置同意”操作类型将此同意告知Adobe Experience Platform Web SDK。 目前,支持两种类型的标准:“Adobe”和“IAB TCF”。请参阅 支持客户同意首选项. 使用Adobe版本2.0时,仅支持数据元素值。 您将需要创建一个解析为同意对象的数据元素。
在此操作中,还会向您提供一个可选字段,用于包含标识映射,以便在收到同意后可以同步标识。 将同意配置为“Pending”或“Out”时,同步很有用,因为同意调用可能是第一个要触发的调用。
更新变量 update-variable
使用此操作作为事件结果来修改XDM对象。 此操作旨在构建一个对象,以便以后从 发送事件 操作,以记录事件XDM对象。
要使用此操作类型,您必须定义 变量 数据元素。 选择要修改的可变数据元素后,将显示一个编辑器,类似于的编辑器 XDM对象 数据元素。
用于编辑器的XDM架构是在 变量 数据元素。 您可以设置对象的一个或多个属性,方法是单击左侧的树中的其中一个属性,然后修改右侧的值。例如,在下面的屏幕快照中,productedBy属性将设置为数据元素“Producted by data element”。
更新变量操作中的编辑器与XDM对象数据元素中的编辑器之间存在一些差异。 首先,更新变量操作具有一个标记为“xdm”的根级别项。 如果单击此项目,则可以指定要用于设置整个对象的数据元素。 其次,更新变量操作包含复选框,用于清除xdm对象中的数据。 单击左侧的其中一个属性,然后选中右侧的复选框以清除值。 这将在设置变量上的任何值之前清除当前值。
发送媒体事件 send-media-event
向Adobe Experience Platform和/或Adobe Analytics发送媒体事件。 当您跟踪网站上的媒体事件时,此操作很有用。 选择一个实例(如果有多个实例)。 该操作需要 playerId
表示跟踪的媒体会话的唯一标识符。 它还需要 体验质量 和 playhead
启动媒体会话时的数据元素。
此 发送媒体事件 操作类型支持以下属性:
- 实例:正在使用的Web SDK实例。
- 媒体事件类型:所跟踪的媒体事件的类型。
- 播放器ID:媒体会话的唯一标识符。
- 播放头:媒体播放的当前位置(以秒为单位)。
- 媒体会话详细信息:发送媒体开始事件时,应指定所需的媒体会话详细信息。
- 章节详细信息:在此部分中,您可以在发送章节开始媒体事件时指定章节详细信息。
- 广告详细信息:发送
AdBreakStart
事件,必须指定所需的广告详细信息。 - 广告Pod详细信息:有关发送广告面板的详细信息
AdStart
事件。 - 错误详细信息:有关正在跟踪的播放错误的详细信息。
- 状态更新详细信息:正在更新的播放器状态。
- 自定义元数据:有关正在跟踪的媒体事件的自定义元数据。
- 体验质量:所跟踪的体验数据的媒体质量。
获取Media Analytics跟踪器 get-media-analytics-tracker
此操作用于获取旧版Media Analytics API。 配置操作并提供对象名称时,旧版Media Analytics API将导出到该窗口对象。 如果未提供,则将其导出到 window.Media
与当前Media JS库一样。
后续步骤 next-steps
阅读本文后,您应该对如何配置操作有了更好的了解。 接下来,阅读如何 配置数据元素类型.