Support and Compatibility

This page provides general information on support and compatibility for browsers, video formats, and platforms.

Supported video formats and browsers

HTML5 is still a new and evolving standard. As a result, support for various features differs among browsers, and there is no single default video format supported by all major browsers. The three main video formats used in the majority of browsers are H.264, WebM and Ogg Theora. Below is a list of these video formats and the browser versions which currently support them:

  • Ogg Theora (video/ogg): Chrome 3+, Firefox 3.5+
  • H.264 (video/mp4): Chrome 3+, Safari 3.1+, iOS 3.2+, Android 2.1+, Internet Explorer 11
  • HLS via M3U8 (application/x-mpegURL): iOS 3.2+, Android 3.0+
  • WebM (video/webm): Chrome 6+, Firefox 4+, Internet Explorer 11

Supported platforms for overlays

In desktop browsers and tablet devices like the iPad, the video plays within a browser environment and overlay ads show while the video is playing. However, if a video plays in fullscreen mode on the iPad, overlays are only visible when the user exits fullscreen mode.
For the iPhone, iPod, and Android phone, the video plays in a native video player. Since nothing can be rendered over the native video player, overlays are only visible once the user exits the native video player.
On the iPhone and iPod, click events on the overlay are captured by the video element. As a result, overlay clickthrough doesn't work by default.

VAST event compatibility

This section lists the VAST events that are automatically reported to the server based on the information returned in the VAST response.

Fully supported
complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (fired when there is any significant seeking in the backward direction), start, thirdQuartile.

Partially supported

  • click

    The Click event is only sent for video ads. Clicks cannot be captured on the native fullscreen players on Android and iOS, or on desktop browsers. On Android, iPhone, and iPod, all videos play in a fullscreen player, but clicks can still be captured by an in-page click tracking element when the video is closed. However, if the video element uses native controls on the iPad, clicks cannot be captured.

  • fullscreen

    We support a simulated full screen mode, in which the video takes up the whole browser window. We consider a video to be in full screen mode when its offsetWidth and offsetHeight are at least the size of the document body. This mode is supported on all browsers. For an example of simulated full screen, download the sample.

    On the iPhone and pre-3.0 Android platforms, video will always play back in full screen mode.

  • mute, unmute

    iOS and Android only have native control of the volume. As such, we cannot determine the volume or mute state, nor are we notified of changes. Below is a list of the browser versions which do and do not support mute, unmute:

    • Supported: Firefox 3.5+, Chrome 8+, Safari 4+
    • Not supported: iOS, Android

Refer to the IAB guidelines for further details on VAST ad serving.

Supported video player platforms

The Google IMA SDKs are supported on the following platforms:

Platform Version Ad Type
HTML5 Desktop: Chrome, Firefox 4.0+, Safari 5+, Internet Explorer 11
Mobile: Chrome/Android Browser (Android 2.3+ for phone, and Android 3+ for tablet), Safari (iOS 8.0+)
Linear, non-linear and companion ads, DFP video, Ad Exchange video, and AFV ads
iOS iOS 8.0+ Linear and companion ads, DFP video, Ad Exchange video, and AFV ads
Android Android 2.3+ Linear and companion ads, DFP video, Ad Exchange video, and AFV ads
Google Cast -- Linear and companion ads, DFP video, Ad Exchange video, and AFV ads

Video features and SDK versions

To learn more about the following features, read video advertising overview. See also the Deprecated SDKs.

HTML5 v3 iOS v3 Android v3 Google Cast
IAB Video Suite
VAST 3 Warning 1 Warning 2 Warning 2 Warning 2
VAST 2 Checkmark Checkmark Checkmark Checkmark
VPAID 2 (HTML5) Checkmark Red-X Red-X Red-X
VMAP 1.0.1 Warning 4 5 Warning 4 Warning 4 Warning 4
DoubleClick for Publishers (DFP) Video features
Linear ads Checkmark Checkmark Checkmark Checkmark
YouTube-hosted assets Warning 6 Red-X Red-X Red-X
Non-linear ads (Overlays) Warning 7 Red-X Red-X Red-X
Companions Checkmark Warning 8 Warning 8 Red-X
VAST 3 alternate companion ad resources Checkmark Checkmark Red-X Red-X
Active View viewability Checkmark Warning 9 Warning 9 Red-X
Audio ads Checkmark Checkmark Checkmark Checkmark
VAST Redirects Checkmark Checkmark Checkmark Checkmark
Companion backfill with display request Checkmark Warning 8 Warning 8 Red-X
Google Publisher Tag (GPT) compatibility Checkmark Red-X Red-X Red-X
Content awareness Checkmark Checkmark Checkmark Checkmark
Ad rules Warning 5 Checkmark Checkmark Checkmark
Manual ad breaks in ad rules Checkmark Red-X Red-X Checkmark
Frequency caps 10 Checkmark Checkmark Checkmark Checkmark
Competitive exclusions (stream) Checkmark Checkmark Checkmark Checkmark
Competitive exclusions (pod) Checkmark Checkmark Checkmark Checkmark
Competitive exclusions (whole page) Checkmark Red-X Red-X Checkmark
Podding Warning 5 Checkmark Checkmark Checkmark
Bumpers Checkmark Checkmark Checkmark Checkmark
Reporting on multi-event tracking (MET) Checkmark Checkmark Checkmark Checkmark
Dynamic allocation (AdSense for video, DoubleClick Ad Exchange) Checkmark Checkmark Checkmark Checkmark
Skippable (non-TrueView) 13 Warning 7 Checkmark Checkmark Red-X
InStream Select Checkmark Red-X Red-X Red-X
Asset Preloading Warning 11 Red-X Warning 12 Red-X
AdSense for Video features
TrueView InStream Warning 7 Checkmark Checkmark Red-X
InStream Select Checkmark Checkmark Checkmark Red-X
Standard InStream Checkmark Checkmark Checkmark Checkmark
Full-slot Checkmark Red-X Red-X Red-X
Companions Checkmark Warning 8 Warning 8 Red-X
Companion backfill Red-X Warning 8 Warning 8 Red-X
Overlays Warning 7 Red-X Red-X Red-X
Asset Preloading Warning 11 Red-X Warning 12 Red-X
DoubleClick Ad Exchange features
TrueView InStream Warning 7 Checkmark Checkmark Red-X
InStream Select Checkmark Checkmark Checkmark Red-X
Standard InStream Checkmark Checkmark Checkmark Checkmark
Full-slot Checkmark Red-X Red-X Red-X
Companions Checkmark Warning 8 Warning 8 Red-X
Companion backfill Red-X Warning 8 Warning 8 Red-X
Overlays Warning 7 Red-X Red-X Red-X
Active View viewability Checkmark Warning 9 Warning 9 Red-X
Asset Preloading Warning 11 Red-X Warning 12 Red-X

1 The HTML5 SDK does not support any VAST 3.0 feature not yet supported by the DFP front end.

2 The following VAST 3.0 features are not yet supported in the non-HTML5 SDKs:

  • Companion adSlotId
  • Companion delivery options
  • Icons
  • Any VAST 3.0 feature not yet supported by the DFP front end

4 The following VMAP features are not yet supported:

  • VMAP-specific tracking events
  • VMAP-specific error codes
  • Overlay ads
  • Time offsets other than hh:mm:ss or "start" and "end"
  • Display breakType attribute
  • repeatAfter attribute

5 Support for VMAP and ad rules on iPhone requires custom ad playback.

6 YouTube-hosted creatives are supported on the desktop but not on mobile web.

7 Not supported on iPhone.

8 The SDK can only render image creatives for the companion ad slot. Custom code and custom creative templates will not be rendered.

9 Requires IMA SDK for Android v3.0.b10+ or for iOS v3.0.b13+.

10 Ad rules frequency caps and competitive exclusions require cookies or PPID.

11 Native asset preload does not work with the following:

  • Mobile web on iOS devices
  • Mobile web on Android pre-4.0
  • YouTube-hosted ads, including TrueView formats
  • IMA manual break playback feature (any implementation that relies on the AD_BREAK_READY event)

12 Requires IMA SDK version 3.6.0+.

13 The SDK does not support skippable ads that are less than 8 seconds long. When ads shorter than the minimum length are played, the Skip button is not displayed.

Send feedback about...

IMA SDK for HTML5
Need help? Visit our support page.