Google IMA HTML5 V3 SDK Release History

Version(s) Release Date(s) Notes
3.211.1 5/18/2018
  • Service release, no new features.
3.210.2 5/17/2018
  • Service release, no new features.
3.210.1 5/16/2018
  • Fixes an issue where ads would continue to display after calling AdDisplayContainer.destroy().
  • Adds allow="autoplay" to the iframe used to load VPAID ads.
3.199.0 - 3.209.2 4/3/2018 - 5/15/2018
  • Service releases, no new features.
3.198.2 3/27/2018
  • Fixes an issue with preloading on recent versions of desktop Chrome and Safari.
3.193.2 - 3.197.2 2/28/2018 - 3/20/2018
  • Service releases, no new features.
3.193.1 2/26/2018
  • Remove erroneously documented serialize and deserialize methods on AdError.
3.192.0 2/14/2018
  • Removes unnecessary INVALID_ADX_EXTENSION error code. Ads still play if extension parsing fails.
  • IMA loaded in an iframe will now inherit the autoplay policy of the parent page in Chrome 65+.
  • Fixes a memory leak that occurred when implementations didn't destroy the AdsManager on AdError.
3.191.0, 3.191.1 2/6/2018, 2/7/2018
  • Service releases, no new features.
3.190.0 1/30/2018
  • VPAID ads will now report an error when they stop without reporting an impression. This follows the behavior for all other ads.
3.189.0 1/24/2018
  • Fixes an issue when falling back from various autoplay strategies to click-to-play.
  • Fixes a playback issue on IE 11.
  • Fixes an issue with mid-rolls on iOS 11.
  • Empty VPAID companion ads no longer fire a console error.
  • Downgraded some warnings to use info logs.
3.187.0, 3.188.1 12/14/2017, 1/10/2018
  • Service releases, no new features.
3.186.1 12/7/2017
  • AdErrorEvent.getInnerError() may now return an inner AdError object. This allows checking to see if autoplay failed.
3.184.2 - 3.185.2 11/6/2017 - 12/1/2017
  • Service releases, no new features.
3.184.1 11/2/2017
  • Fixes an issue where preloaded ads would not play if adsManager.init was not called quickly enough.
  • Adds AdError.AUTOPLAY_DISALLOWED, which will fire when the SDK attempts to autoplay an ad but is prevented from doing so by the browser.
Rollback to 3.182.1 10/26/2017
  • Due to an issue affecting some videojs-ima plugin implementations, rolled back to 3.182.1.
3.183.1 10/26/2017
  • Fixes an issue where preloaded ads would not play if adsManager.init was not called fast enough.
3.182.1 10/20/2017
  • Service release, no new features.
3.182.0 10/17/2017
  • Fixes click-to-play linear video ad playback on desktop Safari 11.
Rollback to 3.180.3 10/6/2017
  • Due to an issue with some ads not displaying properly, rolled back to 3.180.3.
3.181.3 10/5/2017
  • Fixes an issue where invalid clickthroughs caused the video to pause.
  • Fixes an issue where an error was thrown on midroll ad break while using discardAdBreak().
3.180.3 9/25/2017
  • Service release, no new features.
Rollback to 3.179.0 9/22/2017
  • Due to an issue with some specific VPAID ads, rolled back to 3.179.0.
3.180.2 9/21/2017
  • Service release, no new features.
3.179.0 9/18/2017
  • Fixes a bug where multiple ad UIs were rendered when preloading ads and re-using the ad container.
3.178.0 8/31/2017
  • Fixes an issue where an exception was thrown if a skippable ad was served to a mobile Safari page incapable of displaying it. This exception is now properly handled by the SDK.
  • Fixes an issue where, in rare cases, CONTENT_RESUME_REQUESTED was not fired for HLS streams on mobile Safari.
3.177.0, 3.177.1 8/22/2017, 8/23/2017
  • Service releases, no new features.
3.176.0 8/10/2017
  • Adds AdsRequest.liveStreamPrefetchSeconds.
  • Removes AdsRenderingSettings.useShareButton.
3.175.0 7/31/2017
  • Displaying a VPAID non-linear ad will now result in a STARTED event being sent from the SDK to the player.
  • VPAID linear ads will now fire the STARTED event on impression rather than on start.
3.174.1 7/25/2017
  • Service release, no new features.
3.174.0 7/24/2017
  • Fixes an issue that caused some pre-roll pods to freeze when pre-loading was enabled.
  • Fixes an issue where mid-roll ads would cause the content to restart from the beginning in some iOS implementations.
  • Fixes an issue where some live stream content would fail to resume after ads on iOS.
3.173.4 7/6/2017
  • Service release, no new features.
3.173.1 7/6/2017
3.173.0 6/28/2017
  • Fixes an issue where content was not restored correctly with custom playback on iOS mobile web when switching content and requesting ads shortly thereafter.
3.172.0 6/14/2017
  • Fixes an issue that caused full slot AdSense ads to fail on mobile.
  • Adds Ad.getSkipTimeOffset().
3.171.0 6/8/2017
  • Adds support for full slot AdSense ads to the following existing AdsManager methods:
    • getCurrentTime()
    • getRemainingTime()
    • getDuration()
    • getAdSkippableState()
    • skip()
3.170.0 6/1/2017
  • Adds AdsRequest.vastLoadTimeout.
  • Adds support for skippable ads on iPhone and iPod touch when using ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus(true).
3.169.1 5/19/2017
  • Adds support for the VPAID AdInteraction event. When triggered, the video player receives the new AdEvent.INTERACTION event.
3.168.0 5/8/2017
  • Changes default media load timeout to 8 seconds from 15 seconds.
  • Fixes an issue where setting ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus() had no effect.
3.167.0 4/25/2017
  • Service release, no new features.
3.166.0 4/12/2017
  • Adds ImaSdkSettings.setDisableCustomPlaybackForIOS10Plus(). Custom playback is now re-enabled on iOS Safari by default (it was disabled in 3.164.0). Ads will be rendered on Safari as they were prior to 3.164.0.
3.165.0 4/5/2017
  • Service release, no new features.
3.164.0 3/29/2017
  • Fixes auto-play support for mobile web on iOS and Android. To enable, mute your video player or call AdsManager.setVolume(0) before calling AdsManager.start().
3.161.4 3/24/2017
  • Adds AdsManager.updateAdsRenderingSettings() to update ad rendering settings after calling getAdsManager().
Rollback to 3.161.1 3/24/2017
  • Rollback to 3.161.1.
3.163.0 3/23/2017
  • Adds AdsManager.updateAdsRenderingSettings() to update ad rendering settings after calling getAdsManager().
3.161.1 3/9/2017
  • Service release, no new features.
3.160.3 3/7/2017
  • Fixes an issue with incorrect ad positions reported for mixed pods.
3.159.0 2/21/2017
  • Adds support for asset level fallback.
3.157.2 - 3.158.1 2/2/2017 - 2/9/2017
  • Service releases, no new features.
3.156.0 1/26/2017
  • Fixes incorrect ad position reporting with mixed VPAID pods.
  • Adds ImaSdkSettings.(set|get)DisableFlashAds().
  • Adds 'application/dash+xml' as a valid mime type.
  • Adds the following methods to Ad:
    • getUniversalAdIdValue()
    • getUniversalAdIdRegistry()
  • Adds the following properties to AdsRequest:
    • contentDuration
    • contentKeywords
    • contentTitle
3.155.0 1/19/2017
  • Service release, no new features.
3.154.1 1/10/2017
  • Ad.getWrapperCreativeIds() is now more robust in matching creatives through wrappers.
3.153.3 12/8/2016
  • Service release, no new features.
3.153.1 12/7/2016
  • Adds Ad.getDealId().
  • Adds Ad.getSurveyUrl().
  • Adds Ad.getWrapperCreativeIds().
  • Adds icon support to Flash and HTML5 VPAID ads in ENABLED mode. Icons will not work in INSECURE mode.
3.151.1 11/10/2016
  • Adds Ad.getAdvertiserName().
  • Fixes an issue with Flash VPAIDs in HTML5.
3.148.1 - 3.150.1 10/20/2016 - 11/7/2016
  • Service releases, no new features.
3.147.1 10/14/2016
  • Adds Ad.getCreativeId().
3.146.2 10/10/2016
  • Fixes a bug where specific Flash VPAID ads were being terminated prematurely.
  • Fixes an issue where Flash VPAID ads were cropped in fullscreen mode.
3.145.0 9/22/2016
  • Adds Ad.getApiFramework().
3.144.0 9/13/2016
  • Adds AdError.ErrorCode.VAST_PROBLEM_DISPLAYING_MEDIA_FILE.
3.141.2 - 3.143.1 8/26/2016 - 9/7/2016
  • Service releases, no new features.
3.140.1 8/18/2016
  • Fixes a click-through issue for insecure Flash VPAID ads.
3.139.0 8/10/2016
  • Removes AdsRenderingSettings.AUTO_SCALE.
3.138.3, 3.138.5 8/2/2016, 8/4/2016
  • Service releases, no new features.
3.137.0 7/26/2016
  • Adds Ad.getVastMediaWidth() and Ad.getVastMediaHeight().
  • Fixes cursor stylng in built-in ad UI.
3.136.0 7/18/2016
  • Service release, no new features.
3.135.1 6/29/2016
  • Adds support for media asset preloading via AdsRenderingSettings.enablePreloading.
3.134.0 6/16/2016
  • Fixes an issue where the skip ad button would sometimes dissapear if the countdown timer was clicked.
3.133.0 6/7/2016
  • Fixes a visual glitch with skip buttons on Android 4.4.4. Skip buttons on other platforms were not affected by this glitch and are not affected by this change.
3.130.0 5/17/2016
  • Service release, no new features.
3.128.2 5/3/2016
  • Adds AdsRenderingSettings.playAdsAfterTime.
3.124.0 - 3.127.2 3/16/2016 - 4/19/2016
  • Service releases, no new features.
3.123.0 2/24/2016
  • Adds VPAID Flash creatives support to VMAP/Ad rules.
3.121.1, 3.122.0 2/16/2016, 2/19/2016
  • Service releases, no new features.
3.120.0 1/27/2016
  • Adds the videoElement parameter to AdsManager.init. This can be used to specify the custom video element to be used if it's not ready when the AdDisplayContainer constructor is called. The AdDisplayContainer constructor is still the preferred way of providing a custom video element.
  • Adds AdsRenderingSettings.useStyledLinearAds.
3.118.1 1/14/2016
  • Service release, no new features.
3.118.0 1/13/2016
  • VPAID Flash creatives are now supported in IMA HTML5.
3.117.1 1/11/2016
  • Service release, no new features.
3.116.4 12/10/2015
  • Mobile ads that don't use custom click tracking will now feature a new UI with a "Learn More" button. Clicking on the ad will now pause or resume it instead of directing the user to the ad's landing page.
3.115.0 12/3/2015
  • Any non-linear AdSense or Ad Exchange ad greater than 90 pixels in height will now be rendered as a fullslot ad.
  • The new fullslot ad takes up the entire content and contains a countdown timer and skip button. The playing of the content resumes after the ad closes, either from the timer or when the user skips the ad.
  • Non-linear AdSense or Ad Exchange ads with heights less than 90px can also be forced to render fullslot by setting adsRequest.forceNonLinearFullSlot=true.
3.113.1 11/12/2015
3.112.0 11/5/2015
  • Service release, no new features.
3.111.0 10/28/2015
  • Adds AdEvent.LINEAR_CHANGED.
  • Adds AdEvent.DURATION_CHANGE.
  • Uses new UI on 1% of eligible ad requests.
3.110.0 10/21/2015
  • Adds Ad.getTraffickingParameters and Ad.getTraffickingParametersString.
3.109.0 10/7/2015
  • Service release, no new features.
3.108.1 9/23/2015
  • Adds companion ad support for VPAID ads.
3.107.1 9/18/2015
  • Custom playback on Android 4.0+ has been disabled. Ads will still work, but will use an SDK-owned player instead of the user-provided player.
3.101.22 9/10/2015
  • VPAID mode now defaults to ENABLED instead of DISABLED.
3.101.21 9/4/2015
  • Service release, no new features.
3.101.17 8/27/2015
  • Makes Ad.getContentType() available after the LOADED event rather than the STARTED event. This provides earlier access to ad data.
3.101.12, 3.101.14 8/16/2015, 8/20/2015
  • Service releases, no new features.
3.101.10 8/6/2015
3.101.9 7/31/2015
  • Service release, no new features.
3.101.8 7/25/2015
  • Fixes issue of correlator values not updating for DFP tags of the format pubads.g.doubleclick.net/gampad/live/ads.
3.101.6 7/23/2015
3.101.4 7/13/2015
  • Custom playback is disabled on 5% of Android 4.0+ devices. This number will ramp up to 100% over the course of future releases.
3.101.3 6/26/2015
  • Service release, no new features.
3.101.2 6/17/2015
  • TrueView ads will now have a "Learn more" button in the upper right. Clicking on the ad outside of this "Learn more" button will no longer take users to the advertiser's site.
  • The Skip button for skippable ads will now be shown even when custom click tracking is used.
Rollback to 3.101.1 6/4/2015
  • Due to issues with Android playback, rolled back to 3.101.1.
3.102.1 6/4/2015
  • TrueView ads will now have a "Learn more" button in the upper right. Clicking on the ad outside of this "Learn more" button will no longer take users to the advertiser's site.
  • The Skip button for skippable ads will now be shown even when custom click tracking is used.
  • Custom playback on Android 4.0+ will be disabled. Ads will still work, but will use an SDK-owned player instead of the user-provided player.
3.100.0, 3.101.1 5/14/2015, 5/27/2015
  • Service releases, no new features.
3.99.4 5/12/2015
  • Fixed a VPAID adapter bug which caused skip button and ad clickthrough elements to occasionally be unclickable.
  • TrueView ads will now properly return skippable state via AdsManager.getAdSkippableState().
3.98.0 4/30/2015
  • Now allows for ima3.js to be loaded in a separate DOM or iframe from the video container as long as it's in the same origin.
3.97.0 4/22/2015
  • Fixes a bug where client.js fails to load due to incorrect protocol usage.
  • Fixes a VPAID adapter bug where the adapter fails to load if it is loaded into the <head> section.
3.94.0 - 3.96.1 4/2/2015 - 4/16/2015
  • Service releases, no new features.
3.93.1 3/23/2015
  • Adds setAdWillAutoPlay method on AdsRequest. This will let publishers specify if the ad will be played in response to a user action or if the ad will be auto played.
3.92.0 3/5/2015
  • Service release, no new features.
3.91.0 2/25/2015
  • Fixes a VPAID related bug where the video player was firing a 'play' event to VPAID ads instead of the expected 'playing' event.
3.90.2 2/20/2015
  • Service release, no new features.
3.87.0 2/4/2015
  • Fixes a bug where clients not using the IMA UI were getting incorrect values from getAdSkippableState.
  • Release versioning will now change from 3.1.X to 3.X.Y.
3.1.85 1/28/2015
  • Added AdEvent.Type.AD_METADATA.
3.1.82, 3.1.84 12/5/2014, 1/20/2015
  • Service release, no new features.
3.1.81 11/19/2014
  • Fixed a Freewheel tag issue with certain third party ad requests.
3.1.80 11/13/2014
  • Added getPlayerType, setPlayerType, getPlayerVersion, and setPlayerVersion to ImaSdkSettings to allow partner players to specify the player type and player version while integrating with the SDK.
3.1.79 11/6/2014
  • Internet Explorer 11 is now supported in the IMA HTML5 SDK. See the announcement for more information.
3.1.77 - 3.1.78 10/22/2014 - 10/29/2014
  • Service releases, no new features.
Rollback to 3.1.75 10/17/2014
  • Due to issues with ad playback on mobile web, rolled back to 3.1.75.
3.1.74 - 3.1.76 10/3/2014 - 10/16/2014
  • Service releases, no new features.
3.1.73 10/3/2014
  • Enables custom click tracking for all mobile devices. This reverts a change introduced in the previous release (3.1.72), which enabled custom click tracking only for iPhone and pre-4.0 Android. This more limited custom click tracking will be added back into the SDK at a later date.
3.1.72 10/2/2014
  • We now recommend you always pass in your content video player as the custom playback element, as custom playback will only be used in certain environments.
  • Custom click tracking elements are now only used in certain environments. Note: if you render your custom click tracking element over your video player, it will break the clickthrough and skip ability of rendered ads.
  • For more information on these changes, see Upgrading to the New Custom Playback.
3.1.71 9/19/2014
  • Service release, no new features.
3.1.70 9/18/2014
  • Changed reportAdAutoPlayed to setAdWillAutoPlay on the AdsRequest.
3.1.69 9/18/2014
  • The Learn more button will be displayed for mobile ads regardless of the length of the ad.
3.1.68 9/17/2014
  • Added the reportAdAutoPlayed setting to the AdsRequest. Note that reportAdAutoPlayed is renamed to setAdWillAutoPlay. See the 3.1.70 release notes.
3.1.67 9/16/2014
  • Service release, no new features.
3.1.66 9/11/2014
  • Adds (1) the uiElements setting to AdsRenderingSettings and (2) the getUiElements API on the Ad.
3.1.65 9/4/2014
  • Makes the skip button more easily discoverable to screen reader users by turning it into a real button.
3.1.64 8/28/2014
  • Service release, no new features.
3.1.63 8/22/2014
  • Added support for VPAID 2 JavaScript creatives.
  • Added support for VAST 3 icons.
  • Added the following new features for companion ads:
    • Support for the "required" attribute in the VAST CompanionAds element.
    • Support for the "adSlotID" attribute in the VAST Companion element.
    • If multiple companions are returned in the VAST, the SDK will select the most appropriate companion ad for the given environment.
  • Fixed the bug where ImaSdkSettings.setNumRedirects and ImaSdkSettings.getNumRedirects were inaccessible.
  • Added the isCustomPlaybackUsed and isCustomClickTrackingUsed API methods.
3.1.62 8/14/2014
  • Update (9/11/2014): We do not currently recommend that publishers pass in their custom player. We will be releasing a feature to auto-switch between the custom player and an SDK-owned player by the end of September, at which point we will start recommending this implementation.
    We now recommend publishers always pass a custom video player when creating an AdDisplayContainer. Stay tuned for an upcoming guide on modifying your code.
  • Publishers will no longer have to save and restore content player state on the CONTENT_PAUSE_REQUESTED and CONTENT_RESUME_REQUESTED events.
3.1.58 - 3.1.61 7/16/2014 - 8/5/2014
  • Service releases, no new features.
3.1.57 6/26/2014
  • Adds an IMPRESSION event on the AdsManager which will be raised when an impression is recorded.
  • Adds VOLUME_CHANGED and VOLUME_MUTED events to the AdsManager.
3.1.55 6/11/2014
  • The GPT Console can now work if it is enabled with all officially recognized flags ('google_console', 'google_force_console', and 'googfc' for use on mobile devices). No need to set the parameter values (such as 'google_console=1').
3.1.54 6/9/2014
  • If a user does not specify the preferred maximum bitrate, the default for cell phones is 500 kbit and the default for other devices, including desktop, is 1,000 kbit.
  • Removed ImaSdkSettings.getCompetitiveExclusion().
  • Exposed the minSuggestedDuration API on the Ad class.
3.1.53 5/29/2014
  • The SDK core will now always be loaded from imasdk.googleapis.com.
3.1.52 5/23/2014
  • Service release, no new features.
3.1.51 5/12/2014
  • Fixed a bug that caused paused ads to resume automatically when the user locked the device.
  • Updated the documentation for VAST timeout errors and specified the lengths of the timeouts.
3.1.50 4/30/2014
  • Fixes a bug that caused errors for publishers who modified the Array prototype (e.g. motools users).
  • Changes Ad.getContentType functionality to return an empty string instead of null when the contentType is unknown.
  • Introduces a 25% experiment to load the core binary from our new domain, imasdk.googleapis.com. This will only affect publishers who specifically whitelist s0.2mdn.net for CORS. According to our tests, this should be no one.
  • Turns the new domain up to 1% on 5/1/2014, 25% on 5/2/2014, and 100% on 5/7/2014.
3.1.48 - 3.1.49 4/14/2014 - 4/21/2014
  • Service releases, no new features.
3.1.47 4/11/2014
  • Add the new APIs Ad.getTitle(), Ad.getDescription(), and Ad.getContentType().
  • Support the VAST 3 CACHEBUSTER and ERRORCODE macros.
3.1.46 4/3/2014
  • The getCompanionAds API now takes an google.ima.CompanionAdSelectionSettings as its third optional parameter
  • Fix the Safari iOS bug in iPad that freezes a video ad in slow networks.
3.1.45 3/6/2014
  • Added the AdsLoader.setAutoPlayAdBreaks API that allows the publisher to choose whether VMAP and AdRules ad breaks are played automatically.
  • Added the adBreakReady event that will be dispatched by the AdsManager when an ad break would have played if autoPlayAdBreaks is set to false.
3.1.44 1/28/2014
  • Added the VAST_MEDIA_LOAD_TIMEOUT error code to google.ima.AdError.ErrorCode for media timeouts.
3.1.42 12/19/2013
  • Service release, no new features.
3.1.41 12/16/2013
  • Fixed the adsManager.skip() API to work with ad rules.
3.1.39 - 3.1.40 12/11/2013 - 12/13/2013
  • Service releases, no new features.
3.1.38 12/4/2013
  • Exposes google.ima.settings and its setLocale method to ima3.js.
3.1.36 - 3.1.37 11/19/2013 - 11/20/2013
  • Service releases, no new features.
3.1.35 11/14/2013
  • When no custom click tracking is specified for custom playback, the clicks are tracked by the SDK iframe, not by the custom video element.
  • Enables the video ad UI be the default, including rendering of the skip button.
  • Changes visible string "Advertisment" to "Advertisement".
3.1.34 10/22/2013
  • Added loadVideoTimeout to AdsRenderingSettings.
  • Change ad timeout default to 15 seconds. If an ad doesn't start playing after 15 seconds, it will be abandoned and CONTENT_RESUME_REQUESTED fired.
  • Better support for VAST-compatible error codes. Deprecated several unused error codes, consolidated others. The error code 200 is now represented by VAST_TRAFFICKING_ERROR constant. The UNKNOWN_AD_RESPONSE is now SDK-specific, code 1010.
  • Disabled ad scrubbing on iPhone implementations.
3.1.33 10/10/2013
  • Fixed a bug in detecting some ad clicks on mobile devices.
3.1.24 - 3.1.32 8/26/2013 - 10/3/2013
  • Service releases, no new features.
3.1.23 8/22/2013
  • New APIs for AdPodInfo: exposed maximum pod duration, pod index, and pod time offset. For more information about these new APIs, see the AdPodInfo page.
3.1.21 - 3.1.22 8/15/2013 - 8/20/2013
  • Service releases, no new features.
3.1.20 8/7/2013
  • Bug fix: Fixed problems with parsing VAST wrappers that do not contain creatives.
  • Bug fix: Fixed problems with Safari desktop fullscreen.
3.1.18 - 3.1.19 7/17/2013 - 7/30/2013
  • Service releases, no new features.
3.1.12 5/21/2013
  • Fixes bug within the Companions API implementation (non-GPT).
3.1.10 5/14/2013
  • If GPT (Google Publisher Tag) is used to display companions, the SDK will now retrieve companion slot sizes from it and append them to the ad request to Google DFP, overriding any publisher-provided sizes.
3.1.1 1/04/2013
  • Service release, no new features
3.1 12/18/2012
3.0.15 10/22/2012
  • The AdDisplayContainer must be now specified at the time of creating the AdsLoader. The deprecated way of passing the AdDisplayContainer via the getAdsManager method will be removed in the next release. Refer to the AdDisplayContainer migration guide for more information about the changes.
  • Various changes to custom playback support:
    • Moved the custom playback settings to the constructor of AdDisplayContainer. The deprecated way of setting them via the AdsRenderingSettings will be removed in the next release.
    • When using custom playback video and click tracking elements, the SDK will not show or hide these elements automatically. The publisher must control the displaying of the custom playback elements.
    • For custom playback video on iPhone/iPod, the SDK will not exit from full-screen when a linear ad is finished. For video ad playback controlled by the SDK, there is no change in behavior.
    • In the next release, the SDK will no longer resize custom playback video and click tracking elements when init and resize are called.
    Several of these changes have been implemented to preserve as many rendering properties of the custom playback elements as possible and allow them to be controlled by the publisher code.
3.0.14 9/26/2012
  • Added auto align for nonlinear ads.
  • Content resume is now sent after the post-roll finishes.

Send feedback about...

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