支持与兼容性

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

支持的视频格式和浏览器

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

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

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 错误代码