Review SDK support and compatibility

AI-generated Key Takeaways

• The Google IMA SDK supports VAST event callbacks for a variety of interactions, such as complete, creativeView, start, and others, for comprehensive video ad tracking.

• Google IMA SDKs are compatible across multiple platforms, including HTML5 (desktop and mobile web), iOS, Android, and tvOS, catering to a diverse range of devices and operating systems.

• Seeking should be disabled during ad playback to prevent errors, ensuring smooth ad delivery and user experience.

• The IMA SDK supports various video advertising features including VAST 4.2, VAST 3, VMAP 1.0.1, Ad Manager video features, AdSense for video features, and Ad Manager Ad Exchange features.

• Older versions of the IMA SDK, including Flash v2, HTML5 v1, iOS v1, Android v1, and Google Cast v2, have been deprecated, so it is recommended to utilize the latest SDK versions for optimal performance and compatibility.

Select platform: HTML5 Android iOS tvOS

VAST event compatibility

Fully supported

All video players must fire the callbacks that trigger the following events:

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind, start, thirdQuartile

Optionally supported

Because Android applications do not typically control the device's volume, the mute and unmute events are generally not fired.

Be sure to disable seeking in your video player while ads are being played. If the SDK detects seeking during an ad, it throws an error.

Supported video player platforms

The Google IMA SDKs are supported on the following platforms:

Platform	Version	Ad Type
HTML5	Desktop: Chrome, Firefox, Safari, Edge, Opera Mobile: Chrome/Android Browser (Android for phones and tablets), Safari and Chrome (iOS)	Linear, non-linear and companion ads, Ad Manager Video Solutions, Ad Exchange video, and AFV ads
iOS	iOS 10.0+	Linear and companion ads, Ad Manager video, Ad Exchange video, and AFV ads
Android	Android 4.4+	Linear and companion ads, Ad Manager video, Ad Exchange video, and AFV ads
tvOS	tvOS 14+	Linear ads, Ad Manager video, and Ad Exchange video

Note: The IMA Cast v2 SDK is obsolete. See CAF Native Ad Breaks for information on serving client-side ads on Google Cast devices.

Video features and SDK versions

To learn more about the following features, read video advertising overview.

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

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

• Companion adSlotId
• Companion delivery options
• Icons

² 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

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

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

⁵ Non-linear ads (Overlays), Skippable (non-TrueView), and TrueView InStream ads are supported on HTML5 mobile web on iOS 10+ when playsinline is used .

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

⁷ 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)

⁸ 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.

⁹ Of the VAST 4 features supported by Google Ad Manager, IMA support the following features:

• VAST 4.2
  • Support for Secure Interactive Media Interface Definition (SIMID)
  • Allowance of multiple UniversalAdID nodes
• VAST 4.0
  • AdID
  • Mezzanine file
  • New VAST error codes
  • AdVerifications support

Deprecated SDKs

	Flash v2	HTML5 v1	iOS v1	Android v1	Google Cast v2
Ad Manager Video features
Linear ads
Non-linear ads
Interactive (VPAID 1.0) ads
Redirects (VAST 2.0)
Companion backfill (AdSense for video, Ad Manager Ad Exchange)
Audio ads
Google Publisher Tag (GPT) compatibility
Frequency caps
Competitive exclusions (stream)
Competitive exclusions (pod)
Competitive exclusions (whole page)
Content awareness
Ad Rules and Manual ad breaks in ad rules
Podding
Bumpers
Multi-event tracking (MET) for reporting
Dynamic allocation
Skippable
InStream Select
AdSense for Video features
Text ads
AdSense VAST InStream
AdSense overlay
Skippable
InStream Select
User Choice (YouTube)
F2F ads in Ad Manager
Ad Manager Ad Exchange features
Linear ads