了解 DAI Ad Break API

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

借助 DAI 广告插播时间点 API,您可以执行以下操作:

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

本指南介绍了 DAI Ad Break API 方法,并详细介绍了 DAI 全方位服务和广告连播投放流程的广告插播时间点生命周期。

了解 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:广告插播时间点已向用户投放。
  • BREAK_STATE_EXPIRED:广告插播时间点在投放前已过期。仅当您在直播活动中启用多广告插播时间点排期时适用。如需了解详情,请参阅中贴片广告插播时间点设置。 默认情况下,广告插播时间点会在 expectedStartTime 字段值之后 30 分钟过期,如果您未设置 expectedStartTime 字段,则会在决策开始后 30 分钟过期。您可以使用 expireDuration 字段自定义此时长。

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

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

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

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

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

了解全方位服务 DAI 流程

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

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

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

在直播活动中启用多广告插播时间点安排后,您可以在 AdBreak 实体上设置 matchParams 字段。通过此流程,Google DAI 可以将检测到的清单广告标记与处于 BREAK_STATE_SCHEDULED 或 BREAK_STATE_DECISIONED 状态的广告插播时间点进行匹配。

全方位服务 DAI 流程中从创建到完成的广告插播时间点实体。

了解 Pod 传送流程

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

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

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

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

广告插播时间点实体完成状态。

提交第一个请求

如需设置 API 访问权限并发出第一个请求,请参阅使用 DAI 广告插播时间点 API。