借助动态广告插播 (DAI) 视频流活动监控工具 (SAM) API,您可以检查和排查单个直播和视频点播 (VOD) 观看会话的问题。
如需直观地检查单个直播或 VOD 观看会话并排查相关问题,请使用 Google Ad Manager 界面中的视频流活动监控工具。如需以编程方式检索会话的诊断数据,请使用 Ad Manager API networks.daiSessions 资源。
了解应用场景
借助 SAM API,您可以自动执行直播诊断,并解决 DAI 集成中的广告投放问题,例如:
- 验证直播会话创建:确认 Google DAI 在创建直播或 VOD 会话时收到的参数、
STITCHED或POD_SERVING的拼接模式、报告模式和内容元数据。 - 审核广告请求和响应:检查传出的视频广告投放模板 (VAST) 和视频多广告播放列表 (VMAP) 广告代码、HTTP 状态代码、响应延迟时间、原始 XML 响应正文和封装容器重定向链。
- 排查广告连播决策和广告素材问题:验证 Google DAI 为每个广告连播选择或舍弃了哪些广告、广告连播中每个广告的时长,以及广告素材的来源广告系统。
- 跟踪广告预提取执行情况:确定 Google DAI 是否预提取了广告连播,并检查每个广告连播的预提取阶段。
- 验证 DAI Ad Break API 和 Pod serving DAI API 调用:根据 API 调用(例如 DAI Ad Break API 和 Pod serving DAI API),检查实际广告插播时间点执行情况、投放的广告时长和插入的补位广告时长。
- 验证广告事件跟踪:确认客户端或服务器端跟踪 ping 是否成功,并检查广告服务器的 HTTP 响应。
- 自动执行会话监控和提醒:解析严重级别为
INFO、WARNING或ERROR的结构化发现结果条目,以在自动化集成测试和生产监控流水线中检测播放或变现问题。
了解顶级资源
SAM API 是 admanager.googleapis.com 端点上的 Google Ad Manager REST API(Beta 版)的一部分,并公开了 networks.daiSessions.get 只读方法。您可以使用 DAI 会话 ID 或自定义调试密钥查询 DaiSession 资源。DAI 会在播放后保留会话记录最多三天。
SAM API 不支持列出 Google Ad Manager 广告资源网中的所有 DaiSession 资源。
使用 SAM 检查 DAI 视频流响应
如需验证 Google DAI 如何处理您的直播请求,请检查 DaiSession 响应:
- 全方位服务 DAI API:检查
creationContext.streamCreateRequest字段以验证直播注册调用,检查adSelections和adPods映射以查看广告决策,并检查adBreaks映射以确认拼接的广告、补位广告素材和底层内容时长。 - 广告连播投放 DAI API:确认
creationContext.stitchingType字段已设置为POD_SERVING值,将adPods和adBreaks映射中的adBreakId字段与广告连播清单或广告连播片段请求调用进行交叉核对,并检查trackingPings映射中的服务器端或媒体验证信标。 - DAI 广告插播时间点 API:将
AdBreak对象的breakSequence值与AdBreak.breakSequence属性进行匹配。
提交第一个请求
如需设置身份验证并检索 DAI 会话资源,请参阅使用视频流活动监控工具 API。