本页提供了有关 HTML5 IMA 客户端支持以及浏览器、视频格式和平台的兼容性的一般信息。
支持的视频格式和浏览器
对各种功能的支持因浏览器而异，并且并非所有主流浏览器都支持单一默认视频格式。大多数浏览器使用三种主要的视频格式为 H.264、WebM 和 Ogg Theora。
支持的视频播放器
典型的 HTML5 视频播放器支持大多数 IMA 功能，包括 HTML <video> 标记。如需查看支持 IMA SDK 的已知视频播放器的列表，请参阅视频技术合作伙伴计划。
VAST 事件兼容性
本部分列出了根据 VAST 响应中返回的信息自动向服务器报告的 VAST 事件。
完全支持
complete、creativeView、firstQuartile、impression、midpoint、pause、resume、rewind（在快退时触发）、start、thirdQuartile。
部分支持
click系统仅针对视频广告发送
Click事件。在 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 元素一经实例化，就不应再移动它。
Apple AirPlay 支持
IMA SDK 目前不支持 Apple AirPlay。在检测到 AirPlay 时停用 AirPlay 或停用广告请求。
支持的视频播放器平台
以下平台支持 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 14 及更高版本 | 线性广告、Ad Manager 视频广告和 Ad Exchange 视频广告 |
视频功能和 SDK 版本
如需详细了解以下功能，请参阅视频广告概览。
| HTML5 版本 3 | 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
使用 playsinline
时，iOS 10 及更高版本上的 HTML5 移动网站支持非线性广告（重叠式广告）、可跳过（非 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 版本 2 | HTML5 版本 1 | 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 功能 | |||||
| 线性广告 | |
|
|
|
|