本页提供关于 HTML5 IMA 客户端支持以及浏览器、视频格式和平台的兼容性的一般信息。
支持的视频格式和浏览器
对各种功能的支持因浏览器而异,并且不是所有主流浏览器都支持的单一默认视频格式。大多数浏览器中使用的三种主要视频格式分别是 H.264、WebM 和 Ogg Theora。
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
、unmute
iOS 和 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 预计 DOM 在 SDK 启动时是静态的。只要 IMA 在框架完成移动 DOM 元素后启动 IMA,IMA 就会支持 JavaScript 框架。具体而言,构建 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.1 及更高版本 | 线性广告和随播广告、Ad Manager 视频广告、Ad Exchange 视频广告和 AFV 广告 |
tvOS | tvOS 14 及更高版本 | 线性广告、Ad Manager 视频广告和 Ad Exchange 视频广告 |
视频功能和 SDK 版本
如需详细了解以下功能,请参阅视频广告概览。
HTML5 v3 | iOS v3 | Android v3 | tvOS | |
---|---|---|---|---|
IAB 视频套件 | ||||
VAST 4 | ![]() |
![]() |
![]() |
![]() |
VAST 3 | ![]() |
![]() |
![]() |
![]() |
VAST 2 | ![]() |
![]() |
![]() |
![]() |
SIMID 1.0 | ![]() |
![]() |
![]() |
![]() |
VPAID 2 (HTML5) | ![]() |
![]() |
![]() |
![]() |
VMAP 1.0.1 | ![]() |
![]() |
![]() |
![]() |
OM SDK 1.3 | ![]() |
![]() |
![]() |
![]() |
Ad Manager 视频广告功能 | ||||
线性广告 | ![]() |
![]() |
![]() |
![]() |
YouTube 托管的素材资源 | ![]() |
![]() |
![]() |
![]() |
非线性广告(重叠式广告) | ![]() |
![]() |
![]() |
![]() |
随播广告 | ![]() |
![]() |
![]() |
![]() |
VAST 3 备用随播广告资源 | ![]() |
![]() |
![]() |
![]() |
Active View 可见度 | ![]() |
![]() |
![]() |
![]() |
电台广告 | ![]() |
![]() |
![]() |
![]() |
VAST 重定向 | ![]() |
![]() |
![]() |
![]() |
具有展示请求的随播补余广告 | ![]() |
![]() |
![]() |
![]() |
Google 发布商代码 (GPT) 兼容性 | ![]() |
![]() |
![]() |
![]() |
内容认知度 | ![]() |
![]() |
![]() |
![]() |
广告规则 | ![]() |
![]() |
![]() |
![]() |
广告规则中的手动广告插播时间点 |
![]() |
![]() |
![]() |
![]() |
频次上限 8 | ![]() |
![]() |
![]() |
![]() |
竞争性排除规则(视频流) | ![]() |
![]() |
![]() |
![]() |
竞争性排除规则(广告连播) | ![]() |
![]() |
![]() |
![]() |
竞争排除(整个网页) | ![]() |
![]() |
![]() |
![]() |
广告连播 | ![]() |
![]() |
![]() |
![]() |
导视广告 | ![]() |
![]() |
![]() |
![]() |
多事件跟踪 (MET) 报告 | ![]() |
![]() |
![]() |
![]() |
动态分配(AdSense 视频广告、Ad Manager Ad Exchange) | ![]() |
![]() |
![]() |
![]() |
可跳过式广告(非 TrueView 广告)11 | ![]() |
![]() |
![]() |
![]() |
插播可选广告 | ![]() |
![]() |
![]() |
![]() |
资源预加载 | ![]() |
![]() |
![]() |
![]() |
AdSense 视频广告功能 | ||||
TrueView InStream | ![]() |
![]() |
![]() |
![]() |
插播可选广告 | ![]() |
![]() |
![]() |
![]() |
标准插播广告 | ![]() |
![]() |
![]() |
![]() |
全幅广告 | ![]() |
![]() |
![]() |
![]() |
随播广告 | ![]() |
![]() |
![]() |
![]() |
随播补余广告 | ![]() |
![]() |
![]() |
![]() |
叠加层 | ![]() |
![]() |
![]() |
![]() |
资源预加载 | ![]() |
![]() |
![]() |
![]() |
Ad Manager Ad Exchange 功能 | ||||
TrueView InStream | ![]() |
![]() |
![]() |
![]() |
插播可选广告 | ![]() |
![]() |
![]() |
![]() |
标准插播广告 | ![]() |
![]() |
![]() |
![]() |
全幅广告 | ![]() |
![]() |
![]() |
![]() |
随播广告 | ![]() |
![]() |
![]() |
![]() |
随播补余广告 | ![]() |
![]() |
![]() |
![]() |
叠加层 | ![]() |
![]() |
![]() |
![]() |
Active View 可见度 | ![]() |
![]() |
![]() |
![]() |
资源预加载 | ![]() |
![]() |
![]() |
![]() |
为什么显示该广告? | ![]() |
![]() |
![]() |
![]() |
1 HTML5 SDK 不支持 Ad Manager 前端尚不支持的任何 VAST 3.0 功能。
2 非 HTML5 SDK 尚不支持以下 VAST 3.0 功能:
- 随播广告
adSlotId
- 随播广告素材投放选项
- 图标
- Ad Manager 前端尚不支持的任何 VAST 3.0 功能
3 目前尚不支持以下 VMAP 功能:
- VMAP 特有的跟踪事件
- VMAP 特定的错误代码
- 重叠式广告
- 时间偏移值(hh:mm:ss 或“start”和“end”除外)
- 显示
breakType
属性 repeatAfter
个属性
4 若要在 iPhone 上支持 VMAP 和广告规则,则需要自定义广告播放。
5 YouTube 托管的广告素材在桌面版网站上受支持,但在移动网站上不受支持。
6 使用 playsinline
时,适用于 iOS 10 及更高版本。
7 需要使用 IMA SDK for Android Beta 版 v10 及更高版本或 iOS Beta v13 及更高版本。
8 广告规则和竞争性排除规则结合使用需要使用 Cookie 或 PPID。
9 原生素材资源预加载不适用于以下各项:
- iOS 设备上的移动网站
- Android 4.0 之前版本的移动网络
- YouTube 托管的广告,包括 TrueView 格式的广告
-
IMA 手动中断播放功能(任何依赖于
AD_BREAK_READY
事件的实现)
10 需要 IMA SDK 版本 3.6.0+。
11 SDK 不支持时长不足 8 秒的可跳过广告。当播放时长短于最小时长的广告时,系统不会显示 Skip 按钮。
12 支持以下 VAST 4.0 功能:
- AdID
- Mezzanine 文件
- 新的 VAST 错误代码