支持与兼容性

本页提供了有关 HTML5 IMA 客户端支持以及浏览器、视频格式和平台的兼容性的一般信息。

支持的视频格式和浏览器

对各种功能的支持因浏览器而异,并且并非所有主流浏览器都支持单一默认视频格式。大多数浏览器使用三种主要的视频格式为 H.264、WebM 和 Ogg Theora。

支持的视频播放器

典型的 HTML5 视频播放器支持大多数 IMA 功能,包括 HTML <video> 标记。如需查看支持 IMA SDK 的已知视频播放器的列表,请参阅视频技术合作伙伴计划

VAST 事件兼容性

本部分列出了根据 VAST 响应中返回的信息自动向服务器报告的 VAST 事件。

完全支持

completecreativeViewfirstQuartileimpressionmidpointpauseresumerewind(在快退时触发)、startthirdQuartile

部分支持

  • click

    系统仅针对视频广告发送 Click 事件。在 Android、iOS 或桌面设备上的原生全屏播放器上无法捕获点击次数,但当视频关闭时,页内点击跟踪元素仍然可以捕获点击次数。不过,如果视频元素在 iPad 上使用原生控件,则无法捕获点击。

  • fullscreen

    IMA SDK 支持模拟全屏模式,在该模式下,视频会占据整个浏览器窗口。 当视频的 offsetWidthoffsetHeight 至少为文档正文的大小时,我们就认为该视频处于全屏模式。 所有浏览器均支持此模式。 如需查看模拟全屏示例,请下载示例

    在 iPhone 和 3.0 之前的 Android 平台上,视频将始终在全屏模式下播放。

  • muteunmute

    iOS 和 Android 只有原生音量控制。因此,IMA SDK 无法确定音量或静音状态,我们也无法收到更改通知。下面列出了支持和不支持 muteunmute 的浏览器版本:

    • 支持: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 对勾标记 对勾标记 对勾标记 红色 X
VPAID 2 (HTML5) 对勾标记 红色 X 红色 X 红色 X
VMAP 1.0.1 警告 2 3 警告 2 警告 2 警告 2
OM SDK 1.3 对勾标记 对勾标记 对勾标记 红色 X
Ad Manager 视频功能
线性广告 对勾标记 对勾标记 对勾标记 对勾标记
YouTube 托管的素材资源 警告 4 红色 X 红色 X 红色 X
非线性广告(重叠式广告) 警告 5 红色 X 红色 X 红色 X
随播广告 对勾标记 对勾标记 对勾标记 红色 X
VAST 3 备用随播广告资源 对勾标记 对勾标记 红色 X 红色 X
Active View 可见度 对勾标记 对勾标记 对勾标记 红色 X
电台广告 对勾标记 对勾标记 对勾标记 对勾标记
VAST 重定向 对勾标记 对勾标记 对勾标记 对勾标记
有展示请求的随播补余广告 对勾标记 对勾标记 对勾标记 红色 X
Google 发布商代码 (GPT) 兼容性 对勾标记 红色 X 红色 X 红色 X
内容认知度 对勾标记 对勾标记 对勾标记 对勾标记
广告规则 警告 3 对勾标记 对勾标记 对勾标记
广告规则中的手动广告插播时间点 对勾标记 红色 X 红色 X 红色 X
频次上限 6 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除(视频流) 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除(广告连播) 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除(整个网页) 对勾标记 红色 X 红色 X 红色 X
广告连播 警告 3 对勾标记 对勾标记 对勾标记
导视广告 对勾标记 对勾标记 对勾标记 对勾标记
生成多事件跟踪 (MET) 报告 对勾标记 对勾标记 对勾标记 对勾标记
动态分配(AdSense 视频广告、Ad Manager Ad Exchange) 对勾标记 对勾标记 对勾标记 对勾标记
可跳过的广告(非 TrueView)8 警告 5 对勾标记 对勾标记 对勾标记
插播可选广告 对勾标记 红色 X 红色 X 红色 X
资源预加载 警告 7 红色 X 对勾标记 红色 X
AdSense 视频广告功能
TrueView InStream 警告 5 对勾标记 对勾标记 红色 X
插播可选广告 对勾标记 对勾标记 对勾标记 红色 X
标准插播广告 对勾标记 对勾标记 对勾标记 对勾标记
全幅广告 对勾标记 红色 X 红色 X 红色 X
随播广告 对勾标记 对勾标记 对勾标记 红色 X
随播补余广告 红色 X 对勾标记 对勾标记 红色 X
叠加层 警告 5 红色 X 红色 X 红色 X
资源预加载 警告 7 红色 X 对勾标记 红色 X
Ad Manager Ad Exchange 功能
TrueView InStream 警告 5 对勾标记 对勾标记 红色 X
插播可选广告 对勾标记 对勾标记 对勾标记 红色 X
标准插播广告 对勾标记 对勾标记 对勾标记 对勾标记
全幅广告 对勾标记 红色 X 红色 X 红色 X
随播广告 对勾标记 对勾标记 对勾标记 红色 X
随播补余广告 红色 X 对勾标记 对勾标记 红色 X
叠加层 警告 5 红色 X 红色 X 红色 X
Active View 可见度 对勾标记 对勾标记 对勾标记 红色 X
资源预加载 警告 7 红色 X 对勾标记 红色 X
为什么显示该广告? 对勾标记 对勾标记 对勾标记 对勾标记

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 秒的可跳过广告。 当播放时长短于最短时长的广告时,系统不会显示跳过按钮。

9Google Ad Manager 支持的 VAST 4 功能中,IMA 支持以下功能: