本页提供有关 HTML5 IMA 客户端支持和浏览器、视频格式及平台兼容性的一般信息。
支持的视频格式和浏览器
不同浏览器对各种功能的支持情况各不相同，并且没有一种默认视频格式能获得所有主流浏览器的支持。大多数浏览器中使用的三种主要视频格式是 H.264、WebM 和 Ogg Theora。
支持的视频播放器
大多数 IMA 功能都受典型的 HTML5 视频播放器支持，包括 HTML <video> 标记。如需查看支持 IMA SDK 的已知视频播放器列表，请参阅视频技术合作伙伴计划。
VAST 事件兼容性
此部分列出了根据 VAST 响应中返回的信息自动向服务器报告的 VAST 事件。
完全支持
complete、creativeView、firstQuartile、impression、midpoint、pause、resume、rewind（在向后方向进行任何重大搜索时触发）、start、thirdQuartile。
部分支持
clickClick事件仅针对视频广告发送。 无法在 Android、iOS 或桌面设备上的原生全屏播放器中捕获点击，但当视频关闭时，页内点击跟踪元素仍可捕获点击。不过，如果视频元素在 iPad 上使用原生控件，则无法捕获点击。fullscreen
IMA SDK 支持模拟全屏模式，在该模式下，视频会占满整个浏览器窗口。 当视频的
offsetWidth和offsetHeight至少与文档正文的大小相同时，我们认为视频处于全屏模式。 所有浏览器都支持此模式。 如需查看模拟全屏的示例，请下载示例。在 iPhone 和 3.0 之前的 Android 平台上，视频始终以全屏模式播放。
mute，unmuteiOS 和 Android 仅具有对音量的原生控制。因此，IMA SDK 无法确定音量或静音状态，也不会收到相关更改通知。以下是支持和不支持
mute、unmute的浏览器版本列表：- 支持：Firefox 3.5+、Chrome 8+、Safari 4+
- 不支持：iOS、Android
如需详细了解 VAST 广告投放，请参阅 IAB 指南。
JavaScript 框架的注意事项
将 JavaScript 框架（例如 React 或 AngularJS）与 IMA HTML5 SDK 搭配使用时，需要注意一些事项。这些框架通常会移动 DOM 的元素，这可能会破坏 IMA 功能，因为 IMA 希望在启动 SDK 时 DOM 是静态的。IMA 支持 JavaScript 框架，前提是 IMA 在框架完成 DOM 元素移动后启动。具体而言，在构建 AdDisplayContainer 时作为 containerElement 实参传递的 HTML5 元素一旦实例化，就不应再移动。
支持的视频播放器平台
Google IMA SDK 支持以下平台：
| 平台 | 版本 | 广告类型 |
|---|---|---|
| HTML5 | 桌面设备：Chrome、Firefox、Safari、Edge、Opera 移动设备：Chrome/Android 浏览器（适用于手机和平板电脑的 Android）、Safari 和 Chrome (iOS) |
线性广告、非线性广告和随播广告、Ad Manager 视频广告解决方���、Ad Exchange 视频广告和 AFV 广告 |
| iOS | iOS 10.0 及更高版本 | 线性广告和随播广告、Ad Manager 视频广告、Ad Exchange 视频广告和 AFV 广告 |
| Android | Android 4.4 及更高版本 | 线性广告和随播广告、Ad Manager 视频广告、Ad Exchange 视频广告和 AFV 广告 |
| tvOS | tvOS 15+ | 线性广告、Ad Manager 视频广告和 Ad Exchange 视频广告 |
视频功能和 SDK 版本
如需详细了解以下功能，请参阅视频广告概览。
| HTML5 v3 | iOS v3 | Android v3 | tvOS | |
|---|---|---|---|---|
| IAB 视频套件 | ||||
| VAST 4 |  9 |
9 |
9 |
9 |
| VAST 3 |  |
1 |
1 |
1 |
| VAST 2 | |
|
|
|
| SIMID 1.0 | |
|
|
 |
| VPAID 2 (HTML5) | |
|
|
|
| VMAP 1.0.1 | 2 3 |
2 |
2 |
2 |
| OM SDK 1.3 | |
|
|
|
| Ad Manager 视频功能 | ||||
| 线性广告 | |
|
|
|
| YouTube 托管的素材资源 | 4 |
|
|
|
| 非线性广告（重叠式广告） | 5 |
|
|
|
| 随播广告 | |
|
|
|
| VAST 3 备用随播广告资源 | |
|
|
|
| Active View 可见率 | |
|
|
|
| 音频广告 | |
|
|
|
| VAST 重定向 | |
|
|
|
| 包含展示广告请求的随播广告回填 | |
|
|
|
| Google 发布商代码 (GPT) 兼容性 | |
|
|
|
| 内容感知 | |
|
|
|
| 广告规则 | 3 |
|
|
|
| 广告规则中的手动广告插播时间点 |
|
|
|
|
| 频次上限 6 | |
|
|
|
| 竞争排除（直播） | |
|
|
|
| 竞争排除（播客） | |
|
|
|
| 竞争排除（整个网页） | |
|
|
|
| 广告连播 | 3 |
|
|
|
| 导视广告 | |
|
|
|
| 报告多事件跟踪 (MET) | |
|
|
|
| 动态分配（AdSense 视频广告、Ad Manager Ad Exchange） | |
|
|
|
| 可跳过（非 TrueView）8 | 5 |
|
|
|
| 插播可选广告 | |
|
|
|
| 资源预加载 | 7 |
|
|
|
| AdSense 视频广告功能 | ||||
| TrueView InStream | 5 |
|
|
|
| 插播可选广告 | |
|
|
|
| 标准插播广告 | |
|
|
|
| 全槽 | |
|
|
|
| 随播广告 | |
|
|
|
| 随播回填 | |
|
|
|
| 叠加层 | 5 |
|
|
|
| 资源预加载 | 7 |
|
|
|
| Ad Manager Ad Exchange 功能 | ||||
| TrueView InStream | 5 |
|
|
|
| 插播可选广告 | |
|
|
|
| 标准插播广告 | |
|
|
|
| 全槽 | |
|
|
|
| 随播广告 | |
|
|
|
| 随播回填 | |
|
|
|
| 叠加层 | 5 |
|
|
|
| Active View 可见率 | |
|
|
|
| 资源预加载 | 7 |
|
|
|
| 为什么显示该广告？ | |
|
|
|
1 非 HTML5 SDK 尚不支持以下 VAST 3.0 功能：
- 随播广告素材
adSlotId - 随播广告投放选项
- 图标
2 尚不支持以下 VMAP 功能：
- 特定于 VMAP 的跟踪事件
- 与 VMAP 相关的错误代码
- 重叠式广告
- 除 hh:mm:ss 或“start”和“end”之外的时间偏移量
- 显示
breakType属性 repeatAfter个属性
3 在 iPhone 上支持 VMAP 和广告规则需要自定义广告播放。
4 YouTube 托管的素材资源在桌面设备上受支持，但在移动网站上不受支持。
5 在 iOS 10 及更高版本的 HTML5 移动网站上，如果使用
playsinline
，则支持非线性广告（叠加广告）、可跳过的广告（非 TrueView 广告）和 TrueView 插播广告。
6 广告规则频次上限和竞争性排除规则需要使用 Cookie 或 PPID。
7 原生素材资源预加载不适用于以下情况：
- iOS 设备上的移动网站
- Android 4.0 之前的移动网站
- YouTube 托管的广告，包括 TrueView 格式
-
IMA 手动插播广告功能（任何依赖于
AD_BREAK_READY事件的实现）
8 SDK 不支持时长不足 8 秒的可跳过广告。 如果播放的广告时长低于最低时长，系统不会显示跳过按钮。
9 在 Google Ad Manager 支持的 VAST 4 功能中，IMA 支持以下功能：
- VAST 4.2
- 支持安全交互式媒体接口定义 (SIMID)
- 允许使用多个
UniversalAdID节点
- VAST 4.0
- AdID
- Mezzanine 文件
- 新的 VAST 错误代码
AdVerifications支持
已弃用的 SDK
| Flash v2 | HTML5 v1 | iOS v1 | Android v1 | Google Cast v2 | |
|---|---|---|---|---|---|
| Ad Manager 视频功能 | |||||
| 线性广告 | |
|
|
|
|
| 非线性广告 | |
|
|
|
|
| 互动式 (VPAID 1.0) 广告 | |
|
|
|
|
| 重定向（VAST 2.0） | |
|
|
|
|
| 随播广告补余（AdSense 视频广告、Ad Manager Ad Exchange） | |
|
|
|
|
| 音频广告 | |
|
|
|
|
| Google 发布商代码 (GPT) 兼容性 | |
|
|
|
|
| 频次上限 | |
|
|
|
|
| 竞争排除（直播） | |
|
|
|
|
| 竞争排除（播客） | |
|
|
|
|
| 竞争排除（整个网页） | |
|
|
|
|
| 内容感知 | |
|
|
|
|
| 广告规则和广告规则中的手动广告插播时间点 | |
|
|
|
|
| 广告连播 | |
|
|
|
|
| 导视广告 | |
|
|
|
|
| 用于报告的多事件跟踪 (MET) | |
|
|
|
|
| 动态分配 | |
|
|
|
|
| 可跳过广告 | |
|
|
|
|
| 插播可选广告 | |
|
|
|
|
| AdSense 视频广告功能 | |||||
| 文字广告 | |
|
|
|
|
| AdSense VAST 插播广告 | |
|
|
|
|
| AdSense 叠加广告 | |
|
|
|
|
| 可跳过广告 | |
|
|
|
|
| 插播可选广告 | |
|
|
|
|
| 用户选择（YouTube） | |
|
|
|
|
| Ad Manager 中的 F2F 广告 | |
|
|
|
|
| Ad Manager Ad Exchange 功能 | |||||
| 线性广告 | |
|
|
|
|