查看 SDK 支持和兼容性

请选择平台： HTML5 Android iOS tvOS

本页提供有关 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。

部分支持

  • 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 希望在启动 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 对勾标记 对勾标记 对勾标记 Red-X
VPAID 2 (HTML5) 对勾标记 Red-X Red-X Red-X
VMAP 1.0.1 警告 2 3 警告 2 警告 2 警告 2
OM SDK 1.3 对勾标记 对勾标记 对勾标记 Red-X
Ad Manager 视频功能
线性广告 对勾标记 对勾标记 对勾标记 对勾标记
YouTube 托管的素材资源 警告 4 Red-X Red-X Red-X
非线性广告（重叠式广告） 警告 5 Red-X Red-X Red-X
随播广告 对勾标记 对勾标记 对勾标记 Red-X
VAST 3 备用随播广告资源 对勾标记 对勾标记 Red-X Red-X
Active View 可见率 对勾标记 对勾标记 对勾标记 Red-X
音频广告 对勾标记 对勾标记 对勾标记 对勾标记
VAST 重定向 对勾标记 对勾标记 对勾标记 对勾标记
包含展示广告请求的随播广告回填 对勾标记 对勾标记 对勾标记 Red-X
Google 发布商代码 (GPT) 兼容性 对勾标记 Red-X Red-X Red-X
内容感知 对勾标记 对勾标记 对勾标记 对勾标记
广告规则 警告 3 对勾标记 对勾标记 对勾标记
广告规则中的手动广告插播时间点 对勾标记 Red-X Red-X Red-X
频次上限 6 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除（直播） 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除（播客） 对勾标记 对勾标记 对勾标记 对勾标记
竞争排除（整个网页） 对勾标记 Red-X Red-X Red-X
广告连播 警告 3 对勾标记 对勾标记 对勾标记
导视广告 对勾标记 对勾标记 对勾标记 对勾标记
报告多事件跟踪 (MET) 对勾标记 对勾标记 对勾标记 对勾标记
动态分配（AdSense 视频广告、Ad Manager Ad Exchange） 对勾标记 对勾标记 对勾标记 对勾标记
可跳过（非 TrueView）8 警告 5 对勾标记 对勾标记 对勾标记
插播可选广告 对勾标记 Red-X Red-X Red-X
资源预加载 警告 7 Red-X 对勾标记 Red-X
AdSense 视频广告功能
TrueView InStream 警告 5 对勾标记 对勾标记 Red-X
插播可选广告 对勾标记 对勾标记 对勾标记 Red-X
标准插播广告 对勾标记 对勾标记 对勾标记 对勾标记
全槽 对勾标记 Red-X Red-X Red-X
随播广告 对勾标记 对勾标记 对勾标记 Red-X
随播回填 Red-X 对勾标记 对勾标记 Red-X
叠加层 警告 5 Red-X Red-X Red-X
资源预加载 警告 7 Red-X 对勾标记 Red-X
Ad Manager Ad Exchange 功能
TrueView InStream 警告 5 对勾标记 对勾标记 Red-X
插播可选广告 对勾标记 对勾标记 对勾标记 Red-X
标准插播广告 对勾标记 对勾标记 对勾标记 对勾标记
全槽 对勾标记 Red-X Red-X Red-X
随播广告 对勾标记 对勾标记 对勾标记 Red-X
随播回填 Red-X 对勾标记 对勾标记 Red-X
叠加层 警告 5 Red-X Red-X Red-X
Active View 可见率 对勾标记 对勾标记 对勾标记 Red-X
资源预加载 警告 7 Red-X 对勾标记 Red-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 在 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 支持以下功能：