了解 DAI Ad Break API

借助动态广告插播 (DAI) 广告插播时间点 API,您可以创建和管理直播活动中即将到来的广告插播时间点的时间和广告定位数据。

借助 DAI Ad Break API,您可以执行以下操作:

  • 提高流量高峰期的广告填充率:为动态广告插播 (DAI) 服务提供更多时间,以便为您的直播活动选择收益最高的广告。如果您的直播活动具有高并发性、动态广告代码或高延迟广告,我们建议您使用 DAI 广告插播 API。
  • 全面掌控广告插播时间点:提前创建、更新和删除广告插播时间点,与清单内广告信号相比,这种方式更加灵活;与即时决策相比,这种方式可提高广告连播投放的填充率。
  • 提供不间断的观看体验:通过提供精确的插播信息,最大限度地减少与广告相关的播放错误,例如广告插播时段填充不足或填充过度。

本指南介绍了 DAI Ad Break API 方法,并详细介绍了 DAI Full Service 和 Pod Serving 流程的广告插播时间生命周期。

了解 DAI 广告插播 API 方法

该 API 公开了以下用于管理 AdBreak 资源的标准方法:

  • Create:为 LiveStreamEvent 实体定义新的 AdBreak 实体。(可选)设置 expectedStartTime 属性,以安排在广告插播时间点开始前 60 秒内开始进行广告决策。
  • Get:检索特定 AdBreak 实体的详细信息,包括广告插播时间点状态和时间元数据。
  • List:返回之前使用 API 为指定 LiveStreamEvent 实体创建的 AdBreak 实体列表,按时间倒序排序。请注意,该 API 不会返回仅在内容流清单中定义的广告插播时间。
  • Update:在广告决策开始之前修改现有 AdBreak 实体。
  • Delete:取消之前创建的 AdBreak 实体的广告决策。

了解广告插播时间点生命周期

AdBreak 实体具有以下状态:

  • BREAK_STATE_UNSPECIFIED:默认状态。
  • BREAK_STATE_SCHEDULED:广告插播时间点已成功创建,并已安排用于广告决策。
  • BREAK_STATE_DECISIONED:DAI 服务已开始为广告插播时间点选择广告。您无法修改广告插播时间点,但仍可取消广告插播时间点,这可能会对广告服务器产生不利影响。
  • BREAK_STATE_COMPLETE:广告插播时间点已向用户投放。

下图显示了 AdBreak 实体的时间轴,从创建到完成。

从创建到完成的广告插播时间点实体

您可以在广告插播时间点预计开始前 1 到 300 分钟创建 AdBreak 实体。

  • 请避免在广告插播的预计开始时间前不到 1 分钟时创建广告插播,因为 Google DAI 可能没有足够的时间来做出广告决策,从而导致广告填充率降低。
  • 请避免在广告插播时间点的预期开始时间前 6 小时以上创建广告插播时间点,因为广告服务器可能会使所请求的广告失效。

以下部分介绍了 DAI 全服务和广告连播投放流程中的广告插播时间点状态转换。

了解全方位服务 DAI 流程

Google 全服务 DAI 可同时管理内容清单和广告连播。

对于自定义广告定位,请使用 DAI Ad Break API 在内容直播清单中相应广告标记之前创建 AdBreak 实体。

  • 此准备时间可让 Google DAI 服务使用您的 AdBreak 数据来做出广告决策。
  • 当 Google DAI 检测到清单广告标记时,系统会使用包含 AdBreak 实体数据的广告决策,并将实体的状态转换为 BREAK_STATE_COMPLETE

Pod 服务流程中从创建到完成的广告插播时间点实体中断实体。

了解 Pod 服务流程

在此流程中,您需要管理直播内容清单,或使用第三方清单操纵服务来检测清单中的广告标记。

在广告插播时间点预计开始时间之前调用 DAI 广告插播 API,以提前创建 AdBreak 实体,以便在需要请求广告连播片段或广告清单时使用。

当视频拼接器检测到清单广告标记并发出包含广告插播时间点 ID 的广告片段请求时,Google DAI 会使用具有相同 ID 的 AdBreak 数据来做出广告决策。

在客户端请求广告媒体后,您通过 API 创建的 AdBreak 实体会转换为 BREAK_STATE_COMPLETE 状态。

广告插播时间点实体的完整状态

提交第一个请求

如需设置 API 访问权限并发出您的第一个请求,请参阅使用 DAI Ad Break API