通知

仅在 Google Ad Manager 360 中提供。

DAI 播放器和应用开发指南

请使用以下信息为动态广告插播 (DAI) 规划和管理播放器及应用开发。

平台支持

对动态广告插播的支持如下所示,其中包括不支持该功能的平台。您可以点击相应内容来查看示例应用以及详细了解各个平台。

基本示例应用仅展示视频跟踪事件,非常适合仅使用前贴片广告的发布商。

高级示例应用展示了所有的基本应用功能,以及书签、快速恢复、字幕、指示进度和倒计时器等功能,非常适合通过长篇内容获利的发布商。

广告平台 是否支持 SSB 支持 DAI 的 IMA SDK 示例应用 其他文档
iOS iOS IMA SDK iOS 示例应用 iOS
快速入门指南

iOS 参考信息
Android
或 FireTV
Android IMA SDK Android 示例应用 Android
快速入门指南

Android 参考信息
tvOS
(Apple TV)
tvOS IMA SDK tvOS 示例应用 tvOS 快速入门指南
tvOS 参考信息
Roku 运行时
下载 SDK
Roku 示例应用 Roku
快速入门指南
Chromecast 运行时
下载 SDK

示例接收器应用
通常情况下,您还必须有一款可以“投屏”到 Chromecast 设备的 iOS 或 Android 应用。如需查看示例,请参阅适用于 iOS 和 Android 的“高级示例”应用。

Chromecast
快速入门指南
HTML5 运行时
下载 SDK
HTML5 示例应用
DAI 演示 HTML5 播放器
HTML5
快速入门指南

视频播放器控件支持

只有在 IMA SDK 处于启用状态时,系统才支持视频播放器控件。所有高级示例应用均展示了如何针对各种受支持的平台使用相关功能。此外,广告插入点信息功能也可在基本示例应用内展示。

  • 总广告倒计时和每个广告倒计时:能够添加倒计时,用以标明全部广告的总剩余时长。

    iOS 和 Android:IMA SDK 支持此可选功能。

    Roku 和 tvOS:在 IMA SDK 中,相应高级示例应用展示了此功能的示例。如果必须使用此功能,则需要添加自定义代码。

  • 字幕:可在内容流中添加字幕。支持的字幕程序包括:

    时序文本标记语言 (TTML) (side-car):TTML 旨在针对字幕和图片说明功能转码或交换当前使用的旧版分发内容格式中的时序文本信息。

    WebVTT (side-car):WebVTT 文件可为视频内容、文本视频说明、内容导航章节以及(从更笼统的角度来说)与音频或视频内容在时间上对应的任何形式元数据提供图片说明或字幕。

  • 书签:书签功能可用于保存内容流中的某个具体点,方便之后返回同一位置。假设一位用户观看某内容 5 分钟后离开了相应视频流,然后又返回观看。由于书签可保存用户在视频流中的位置,因此用户返回时便可从上次停下的位置继续观看,畅享流畅一致的体验。
  • 跳回跳回功能可将用户带回至其已跳过的广告插播时间点的起始处,并在该广告插播结束后将用户返回至其跳转时的位置。
  • 进度指示:该功能通常用于长篇内容。借助它,用户在内容栏上滚动时可查看相应内容的第一帧。

替换默认广告代码

在 Ad Manager 中指定用于 VOD 的 DAI 内容来源线性直播视频流时,您需要指定默认的视频广告代码

当您的视频播放器请求视频流时,系统会完全按照您在界面中指定的方式使用该广告代码。不过,您可以在视频流请求中替换该代码的参数。

了解如何向您的视频流提供定位参数

替换视频流变体参数

默认的 HLS 播放列表顺序由发布商决定。

可在视频流创建期间指定替换变体选项和顺序参数。这样一来,您便可以根据主播放列表请求和变体的顺序指定应包含的变体子集。除非被明确替换,否则变体的子集和顺序在相应视频流的整个播放期内将保持不变。

了解如何替换视频流变体参数

常见问题解答

全部展开  全部收起

如何展示前贴片广告?

在 VOD 视频流中,您可以配置是否按照广告规则展示前贴片广告。

在线性直播视频流中,您可以将 Ad Manager 配置为展示前贴片广告。(可选)您的视频播放器可以在请求 Ad Manager DAI 直播视频流之前发出客户端 Ad Manager 广告请求,以便向用户展示前贴片广告。

设置视频中的非广告部分


在线性直播视频流中,您可以使用“视频中的非广告部分”功能来避免在观看者刚刚看过前贴片广告后立即向其展示其他 DAI 广告。

若要在视频中暂停显示广告,则需完成下面这两个部分:

  1. 设置 DAI 直播视频流时指定“暂停显示广告的时长”。
  2. 将设为 1dai-ah 参数传入到视频流创建请求中的 adtagparameters 数组内。此数组与您在替换 Ad Manager 广告代码参数以及设置视频流变体参数时使用的数组相同。
如何从多个 CDN 分发视频点播内容?

为视频点播内容创建 CDN 配置时,您可以选择指定默认 CDN 配置以及额外的 CDN 分发设置。这样您就可以设置多个 CDN,并在会话开始时使用键值对动态地选择希望从哪个 CDN 分发内容。

在您设置并保存 CDN 配置后,Ad Manager 会为每个配置分配一个名称。此名称应以 dai-dlid 参数值的形式传递到视频流创建请求中。*

对于 SSB,只需以 dai-dlid=AaBbC1aaBa0obA1BABaaBA 的形式传递该参数(其中 AaBbC1aaBa0obA1BABaaBA 是在 Ad Manager 中显示的名称)。

在使用 IMA SDK 时,则应使用广告代码参数将该参数传递到视频流创建请求中。

*如果未向相应请求传递任何名称,则 Ad Manager 会使用默认的 CDN。

如何在示例应用中请求视频点播视频流?
VOD 视频流请求中包含 cmsid 和 vid,以供您用于将广告定位到视频内容中。
如果在从 Ad Manager 检索视频内容时遇到问题,该怎么办?
如果您的应用检测到无法接收 Ad Manager 响应这一问题,那么您应该对逻辑进行编码以播放没有广告的原始内容。对于 VOD 视频流,该参数是在您的内容来源 MRSS Feed 中针对 Ad Manager 指定的 ingestUrl。对于线性直播视频流,该逻辑是编码器中相应视频流的网址。详细了解 DAI 备用视频流的最佳做法
为什么我应该弃用服务器端信标 (SSB),而改用 IMA SDK?
借助 IMA SDK,发布商可以获取更丰富的信号用以生成报表,且可更准确地进行事件跟踪。详细了解适用于 DAI 的服务器端信标
如何对服务器端视频流进行问题排查?
每当您的视频播放器向 Ad Manager DAI 请求视频流时,会话 ID 都会随相应视频流一同返回。您应该确保,当您需要调试视频流中的广告时,您可从自己的应用中查看此视频流 ID。您可以利用此视频流 ID 监控视频流活动以及对其进行问题排查
对于与 DAI 问题排查或服务中断相关的任何问题,请与发布商支持团队联系

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
7096556628912767843
true
搜索支持中心
true
true
true
true
true
148
false
false