广告元数据

本指南介绍了 Video Stitcher API 支持的广告元数据功能。广告元数据是从广告代码响应中的 VAST 广告中提取的，其中包含广告跟踪事件和随播广告。广告代码网址是在会话创建请求中配置的。如需了解详情，请参阅管理直播会话和管理 VOD 会话。

准备工作

确保您熟悉 Video Stitcher API 中的介绍性概念和术语。如需了解详情，请参阅技术概览。

广告元数据包含与拼接广告相关联的广告跟踪事件和随播广告。广告跟踪事件包含一个回调 ping，用于跟踪 VAST 广告与观看者互动情况。随播广告是一种用于补充父级 VAST 广告的广告。在客户端跟踪模式下，您负责根据观看者的行为触发事件。

在服务器端跟踪模式下，每个广告片段 URI 都封装在重定向 URI 中，每当播放器请求这些片段时，Video Stitcher API 都会处理进度事件。不过，Video Stitcher API 不处理 activity 事件（例如 pause）。

在客户端跟踪模式下，客户端负责触发事件。如需了解详情，请参阅事件文档。

进度事件是指在广告播放期间经过指定时间时应触发的事件。例如，应在广告开头触发事件 Start。如需详细了解进度事件，请参阅进度事件对象。

活动事件是指在观看者执行特定活动时应触发的事件。例如，当观看者暂停广告视频时，应触发事件 pause。如需详细了解 activity 事件，请参阅 activity 事件对象。

VOD 会话创建请求的响应中会返回一个插页式广告对象。如需了解如何创建 VOD 会话，请参阅如何创建 VOD 会话。

插页式广告包含每个插入的广告的元数据。启用客户端广告跟踪模式后，客户端负责在必要时触发跟踪事件。如需了解详情，请参阅插页式广告对象。

Video Stitcher API 会持续将广告插入直播中；每当插入新的广告时，都会生成广告元数据信息。

对于 HLS，用于提取广告元数据的 AdMetadataURI 可在 #EXT-X-DATERANGE 标记中找到。

对于 DASH，用于提取广告元数据的 AdMetadataURI 可在每个 <Period> 元素的 <EventStream> 元素中找到。

随播广告是指可能与插入的线性广告一起显示的补充广告。如需了解详情，请参阅随播广告对象。