流媒体事件

流媒体跟踪的工作方式是，向Adobe数据收集端点发送一系列事件调用，每个调用都表示播放器状态的转变。 每个事件都属于由会话开始调用打开的活动会话。 会话在过期后自动关闭，或者可以通过会话结束调用立即关闭。

事件分为六个类别（会话、播放、广告、章节、播放器状态和质量），每个类别涵盖媒体体验的不同方面。

会话事件

会话事件适用于任何类型的媒体跟踪，包括：视频点播、直播、播客和有声读物。 它们定义跟踪会话本身的边界。 最重要的会话事件是会话开始，因为几乎所有其他事件类型都依赖于它生成的会话ID。 当用户启动会话时（例如按下“播放”或播放器开始自动播放时），将其作为第一个事件发送。

会话打开后，请使用会话结束或会话结束来指示观看体验的结束方式。 当查看者到达内容的自然结尾时（视频结束、播客剧集结束或有声读物的最后一章结束），发送会话结束。 会话结束不会关闭会话；会话在自然过期之前保持打开状态，因此仍会捕获任何尾随事件，例如最终ping。

如果查看器在到达结束之前离开，请发送会话结束以立即关闭会话。 仅当没有其他事件跟进时（例如，当播放器被破坏或页面卸载时），才会发送会话结束。 会话结束是硬关闭：发送会话后，会话将被终止，并且其后无法跟踪任何进一步事件。 在大多数情况下，更安全的做法是允许会话自然过期。 例如，查看器无限期暂停、应用程序转入后台或内容加载失败。

如果在10分钟内未收到任何事件，或者在30分钟内未检测到播放头移动，则会话将自动过期。 如果满足任一条件且查看器返回内容，则必须调用“会话开始”以打开新会话，然后再发送任何进一步事件。

播放事件

播放事件在整个会话期间跟踪媒体播放器中的状态转变。 它们构成事件流的核心，并应用于任何内容类型。

主播放事件是播放。 在调用“会话开始”后，“播放”表示内容已开始播放，无论这是初始开始、自动播放触发还是返回播放状态。 暂停开始表示用户已暂停播放。 没有专用的恢复事件；当查看器恢复时，再次发送“播放”。 在缓冲停止后，播放的工作方式相同 — 当播放器停止等待数据时，发送缓冲开始，然后在缓冲解析后进行播放。

在主内容播放期间，每10秒发送Ping；在广告播放期间，每1秒发送一次。 Ping保持会话活动状态并记录播放头运动。 在Mobile SDK上，Ping会自动发送；在所有其他平台上，都必须手动发送。

每当播放器的自适应比特率算法切换到其他质量级别时，发送比特率更改。 在QoE数据中包含新比特率值将启用“平均比特率”报表。

广告事件

广告事件跟踪媒体会话中的广告。 常见场景包括在视频开始之前推出的前置广告、在长格式视频或实时流期间定期插入的中置广告以及内容结束后的后置广告。 单个广告时间可以包含一个或多个单独的广告。

每个广告时间遵循相同的结构。 广告时间开始打开广告时间，广告时间结束关闭它。 这两个事件充当将所有单个广告事件包装在一起的书挡。 在休息时间内，当每个广告开始播放时，发送广告开始。 如果广告播放到其全长，则使用广告结束对其进行关注，如果查看器选择跳过按钮，则使用广告跳过。 忽略任一书档会导致时间内的所有广告事件被忽略，并且广告持续时间被错误地归因于主内容。

以下示例显示了一个包含三个广告的广告时间的正确事件序列，其中查看器跳过了第三个广告：

章节事件

章节事件是可选的，可跟踪会话中的命名内容区段。 它们非常适合于自然划分为多个独立部分的内容。 常见的示例包括有声读物中的章节、纪录片中的行为、视频课程中的课程或播客剧集中的区段。 当您想要了解查看者在区段级别的参与时，例如确定哪些章节受众倾向于跳过，请使用章节事件。

当章节开始时，发送章节开始。 如果查看者一直观看至章节结束，请发送章节结束。 如果查看器未观看至完成就搜寻超出章节边界的内容，请改为发送章节跳过。 在关闭章节时，必须先完成章节或跳过章节，然后才能打开新章节；章节不能重叠。

播放器状态事件

播放器状态事件跟踪查看者在整个会话期间与播放器控件的交互方式。 它们有助于了解辅助功能用法，例如查看器启用隐藏式字幕或静音的频率。 此外，它们还可揭示查看行为模式，例如全屏与内联查看以及画中画多任务处理。

五个可跟踪的状态是： fullscreen、mute、closedCaptioning、pictureInPicture和inFocus。 当播放器进入其中任一状态时，发送状态开始；当播放器退出时，发送状态结束。 可以同时激活多个状态；查看器可以同时处于全屏和静音状态，并且同一事件调用中可以结束多个状态。

错误事件

错误事件在会话期间记录播放失败 — 流请求失败、编解码器错误或外部投放失败。 每当发生有意义的错误时发送该报告。 错误事件不会关闭会话；可以继续播放，并在同一会话下跟踪后续事件。 如果错误无法恢复，则使用会话结束跟踪该错误，以显式关闭会话。