Google IMA iOS SDK release history

Version Release Date Notes
3.23.0 2024-06-12
  • Adds VODConfigID to IMAVideoStitcherVODStreamRequest.
  • Makes the background transparent for companion ads.
  • Rejects null value for adTagURL in IMAAdsRequest.
  • Changes asset-level fallback logic to iterate through all ads in the original VAST until the SDK identifies a playable creative. If no playable creative is found, the ad isn't played.
3.22.1 2024-04-12
  • Fixes an issue with the most recent Cocoapods release which prevented apps from building on iOS Simulators.
3.22.0 2024-04-03
3.20.0 2024-01-28
  • Enables companion ad support for pod serving
  • Enable Pod Serving VOD stream requests.
  • Adds a getter for cue points to the stream manager.
3.19.2 2023-04-28
  • Reduced minimum iOS version for compilation to iOS 12.
3.19.1 2023-04-20
  • Increased minimum iOS version for compilation to iOS 14.
  • Removed support for the ARMv7 platform.
  • Fixes an error where a click Ad Event wasn't fired on SIMID clickthrough.
  • Stops incorrectly signalling OMID support in VPAID Secure mode.
  • Fixes an issue with SIMID resize event support.
  • Adds the IMAVideoStitcherVODStreamRequest class, which provides support for the Google Video Stitcher VOD API.
  • SDK version 3.18.5 is scheduled to be deprecated on 2024-04-20. See the Deprecation Schedule for more details.
3.18.5 2023-03-10
3.18.4 2022-12-08
  • Service release. No new features.
  • SDK version 3.18.2 is scheduled to be deprecated on 2023-12-08. See the Deprecation Schedule for more details.
3.18.2 2022-11-07
  • Adds user_context to stream request.
  • Fixes erroneous "Invalid internal message" warnings.
  • SDK version 3.18.1 is scheduled to be deprecated on 2023-11-07. See the Deprecation Schedule for more details.
3.18.1 2022-10-02
  • Fixes an issue that caused the SDK to crash with UIViewControllerHierarchyInconsistency
  • SDK version 3.17.0 is scheduled to be deprecated on 2023-10-02. See the Deprecation Schedule for more details.
3.17.0 2022-08-03
  • Increases the maximum default bitrate for non-mobile devices if the maximum bitrate is not set by the publisher.
  • SDK version 3.16.3 is scheduled to be deprecated on 2023-08-03. See the Deprecation Schedule for more details.
3.16.3 2022-04-19
  • Added IMACompanionAdSlot.initWithView(view: UIView) to support fluid sized companion ads.
  • The IMA iOS SDK is now packaged as an xcframework.
  • Adds M1 simulator support.
  • Fixed an issue where it was possible to overwrite the IMA SDK version information.
  • Fixed an issue where the iOS SDK created duplicate symbol warnings.
  • SDK version 3.15.1 is scheduled to be deprecated on 2023-04-19. See the Deprecation Schedule for more details.
3.15.1 2022-02-23
  • Increased minimum iOS version to 12
  • SDK version 3.14.5 is scheduled to be deprecated on 2023-02-23. See the Deprecation Schedule for more details.
3.14.5 2021-10-05
  • Added IMASettings:sameAppKeyEnabled API which helps you deliver more relevant and personalized ads by using data collected from your apps. The API is currently enabled by default with no changes needed from publishers.
  • Added nullability contracts to all APIs.
  • SDK version 3.14.4 is scheduled to be deprecated on 2022-10-05. See the Deprecation Schedule for more details.
3.14.4 2021-07-06
  • Fixed an issue that caused missing events when apps are backgrounded.
  • Fixed an issue that allowed publishers to manually set islat on iOS <14.
  • Increased minimum iOS version to iOS 11
  • SDK version 3.14.3 is scheduled to be deprecated on 2022-07-06. See the Deprecation Schedule for more details.
3.14.3 2021-05-03
  • Fixed an issue that caused warning messages on iOS < 12.
  • Added IMASettings:sessionid to let publishers customize session ID.
  • Fixed an issue where ad pause and resume events would fire during content.
  • Ensured ad UI content insets aren't adjusted automatically
  • Last version of the IMA SDK for iOS to support iOS 10.
  • SDK version 3.14.1 is scheduled to be deprecated on 2022-05-03. See the Deprecation Schedule for more details.
3.14.1 2021-02-17
  • Fixed an issue where duplicate ad events were sometimes fired when preloading was enabled.
  • Implemented PodServing Support.
  • Fixed an issue with double deeplink opening on iOS 13+.
  • SDK version 3.13.0 is scheduled to be deprecated on 2022-02-17. See the Deprecation Schedule for more details.
3.13.0 2020-10-13
  • The SDK is now built with Xcode 12.
  • Fixed an issue where seeking out of an ad break would not fire the AD_BREAK_ENDED event.
  • Removed deprecated fields on IMAAVPlayerVideoDisplay, IMAVideoDisplay,and IMAVideoDisplayDelegate.
  • Fixed an issue where PiP would minimize on each ad completion.
  • Fixed a bug where live streams would end playback as soon as they were AirPlayed.
  • Fixed an issue where pressing skip did nothing for shared playback.
  • Fixed an issue where content would briefly flash between ads in a pod for shared playback.
  • Added the IMAAVPlayerVideoDisplay.streamAssetOptions API.
  • Exposed ad period duration in IMAStreamManagerDelegate.
  • Fixed an issue where an "Ads cannot be requested because the ad container is not attached to the view hierarchy." error was fired erroneously.
  • SDK version 3.12.1 is scheduled to be deprecated on 2021-10-13. See the Deprecation Schedule for more details.
3.12.1 2020-08-11
  • Official release version for iOS 14.
  • Fixed an issue where opening a click through and then closing the app would cause a memory leak.
  • SDK version 3.12.0 is scheduled to be deprecated on 2021-08-11. See the Deprecation Schedule for more details.
3.12.0 2020-08-05
  • Adds support for Google's Additional Consent mode. For more information, see Google’s Additional Consent Mode technical specification.
  • Adds support for the "language_name" key for stream subtitles.
  • Fixes an issue that caused audio-only ads to timeout.
  • Fixes an issue where skipping the first ad in a preroll would cause the second ad to ignore its own skip offset.
  • Adds viewController as a new required initialization argument or property for IMAAdDisplayContainer.
  • Reduces erroneous RESUME events.
  • Adds IMAAdsRenderingSettings.enablePreloading, which is enabled by default, to improve ad rendering performance.
  • Adds the ICON_TAPPED event.
  • Fixes an issue where the IABTCF_gdprApplies was only acknowledged if it was a string.
  • SDK version 3.11.4 is scheduled to be deprecated on 2021-08-05. See the Deprecation Schedule for more details.
3.11.4 2020-03-26
  • Increases the minimum runtime version to iOS 10
  • Fixes a bug where some UI updates could trigger on a background thread
  • Fixes an issue where strict flags would make IMACompanionAd's init conflict with NSObject's
  • Deprecates the loadURL method on the IMAVideoDisplay protocol
  • Adds support for client-side SIMID ads
  • SDK version 3.11.3 is scheduled to be deprecated on 2021-03-26. See the Deprecation Schedule for more details.
3.11.3 2020-02-12
  • 3.11.3 will be the final version of the IMA SDK that supports iOS 9.x
  • Fixes a bug where importing the framework header did not import IMAFriendlyObstruction.h
  • Fixes an issue where clickthroughs would crash on iOS 9.x
  • SDK version 3.11.2 is scheduled to be deprecated on 2021-02-12. See the Deprecation Schedule for more details.
3.11.2 2020-01-22
3.11.1 2019-12-04
  • Adds support for automatic inclusion of consent parameters from IAB TCFv2 and CCPA.
  • Fixes an issue that caused crashing when using the Control Center.
  • Adds support for TrueView for Action ads.
  • Adds playerVideoDisplay:didLoadPlayerItem: for DAI.
  • Updates IMAAVPlayerVideoDisplayDelegate names for consistency with Obj-C style conventions.
  • Fixes an issue that prevented LOG and INTERACTION ad events from including the ad object in some cases.
  • Adds automatic integration of Google Ad requests for implementations of IAB TCFv2-compliant consent management providers, such as Google's Funding Choices.
  • Fixes an issue with VMAP breakstart and breakend tracking events.
  • Adds the replaceAdTagParameters method to the IMAStreamManager, which provides the ability to replace all ad tag parameters during a live stream.
  • Adds the AD_BREAK_FETCH_ERROR event to indicate that an ad break will not play.
  • SDK version 3.10.1 is scheduled to be deprecated on 2020-12-04. See the Deprecation Schedule for more details.
3.10.1 2019-09-19
  • Adds support for iOS 13 and iPadOS.
  • SDK version 3.9.2 is scheduled to be deprecated on 2020-09-19. See the Deprecation Schedule for more details.
3.9.2 2019-08-16
  • This fixes an issue where a clear IMA ad UI view would remain after ads had played, preventing the user from interacting with the player.
  • SDK version 3.9.1 is scheduled to be deprecated on 2020-08-16. See the Deprecation Schedule for more details.
3.9.1 2019-07-18
  • Fixed issues with accuracy of is_lat reporting.
  • IMAAdEventType.adData is now typed.
  • Added the authToken and streamFormat APIs to IMAStreamRequest.
  • Removed mediaUrl support from LinearAd. Use adMedia instead.
  • Fixed YouTube metadata bug for unlisted videos.
  • Fixed incorrect ad ID identification.
  • Replaced mediaWidth and mediaHeight with adMedia.width and adMedia.height.
  • Fixed an issue where companion ads would only render once.
  • Now when a video ad type is not supported, the SDK will throw the error kIMAError_VAST_TRAFFICKING_ERROR rather than kIMAError_FAILED_TO_REQUEST_ADS.
  • videoDisplayDidPlay: is now deprecated, in favor of videoDisplayDidResume:.
  • SDK version 3.9.0 is scheduled to be deprecated on 2020-07-18. See the Deprecation Schedule for more details.
3.9.0 2019-03-22
3.8.2 2019-02-19
  • Adds the AD_PERIOD_STARTED and AD_PERIOD_ENDED events. These events are supported for DAI only.
  • Fixes an issue where the ad view animated on start.
  • Fixes an issue where video errors weren't fired for Live or VOD..
  • Fixes an issue where content did not resume on iOS+AirPlay.
  • SDK version 3.8.1 is scheduled to be deprecated on 2020-02-19. See the Deprecation Schedule for more details.
3.8.1 2018-11-13
  • Fixes an issue where ad tags with multiple slot size were parsed incorrectly.
  • Adds [IMAVideoDisplay seekStreamToTime] to support skippable ads in IMA DAI VOD streams.
  • Adds IMAAdRenderingSettings.loadVideoTimeout.
  • Adds IMAAd.VASTMediaWidth, IMAAd.VASTMediaHeight, and IMAAd.VASTMediaBitrate.
  • Reduces binary size by ~15% due to build improvements.
  • SDK version 3.7.3 is scheduled to be deprecated on 2019-11-13. See the Deprecation Schedule for more details.
3.7.3 2018-08-21
  • Improves error handling for a malformed stream manifest.
  • Fixes an issue with custom in-app URL clickthroughs in HTML companions.
  • Fixes an issue with back-to-back skippable video ads.
  • SDK version 3.7.2 is scheduled to be deprecated on 2019-08-21. See the Deprecation Schedule for more details.
3.7.2 2018-05-15
  • Fixes an issue where some companions would expand to a full screen WebView.
  • SDK version 3.7.1 is scheduled to be deprecated on 2019-05-15. See the Deprecation Schedule for more details.
3.7.1 2018-04-30
3.7.0.1 2018-02-12
  • Cocoapods-only release to fix a podspec error. Pulls down the library files for 3.7.0.
3.7.0 2018-01-30
  • Drops support for iOS 8 and below.
  • Service release, no new features.
  • SDK version 3.6.1 is scheduled to be deprecated on 201901-30. See the Deprecation Schedule for more details.
3.6.1 2017-10-09
  • Adds IMAAdsRequest.liveStreamPrefetchSeconds.
  • SDK version 3.6.0 is scheduled to be deprecated on 2018-10-09. See the Deprecation Schedule for more details.
3.6.0 2017-07-24
  • Adds IMAAdsRequest.vastLoadTimeout.
  • Adds IMAAd.wrapperAdIDs.
  • Adds IMAAd.skipTimeOffset.
  • Fixes an error where the SDK could not detect the video view used for ad playback if it was removed from and re-added to the view hierarchy.
  • SDK version 3.5.2 is scheduled to be deprecated on 2018-07-24. See the Deprecation Schedule for more details.
3.5.2 2017-05-02
  • Removes auto-resuming when coming back into app from backgrounding. Call [IMAAdsManager resume] to resume.
  • Adds [IMAAdsRenderingSettings playAdsAfterTime].
  • SDK version 3.5.1 is scheduled to be deprecated on 2018-05-02. See the Deprecation Schedule for more details.
3.5.1 2017-04-03
  • The SDK will now throw kIMAError_FAILED_TO_REQUEST_ADS if the IMAAdDisplayContainer is not in the view hierarchy when an ad or stream request is made. Previously, these requests failed silently.
  • SDK version 3.5.0 is scheduled to be deprecated on 2018-04-03. See the Deprecation Schedule for more details.
3.5.0 2017-03-24
  • Fixes an issue with bitcode support.
  • Adds adsResponse to the IMAAdsRequest object.
  • Fixes an issue with Swift builds.
  • SDK version 3.4.2 is scheduled to be deprecated on 2018-03-24. See the Deprecation Schedule for more details.
3.4.2 2017-03-09
  • Service release, no new features.
  • SDK version 3.4.1 is scheduled to be deprecated on 2018-03-09. See the Deprecation Schedule for more details.
3.4.1 2017-02-03
  • The SDK is now distributed as a dynamic framework. As a result we no longer publish a separate AdMob version of the Framework - you can use the same version whether or not your implementation also uses AdMob.
  • Adds support for video icons.
  • Adds the following new properties to IMAAd:
    • adSystem
    • creativeID
    • creativeAdID
    • universalAdIdValue
    • universalAdIdRegistry
    • advertiserName
    • surveyURL
    • dealID
    • wrapperCreativeIDs
    • wrapperSystems
  • Adds the following new properties to IMAAdsRequest:
    • contentDuration
    • contentKeywords
    • contentTitle
  • Adds [IMAAdsManager setVolume:].
  • Adds [IMACompanionDelegate companionSlotWasClicked].
  • Adds IMASettings.disableNowPlayingInfo.
  • SDK version 3.3.1 is scheduled to be deprecated on 2018-02-03. See the Deprecation Schedule for more details.
Rollback to 3.3.1 2016-01-31
  • Due to issue with building for specific devices, rolled back to 3.3.1.
3.4.0 2017-01-26
  • The SDK is now distributed as a dynamic framework. As a result we no longer publish a separate AdMob version of the Framework - you can use the same version whether or not your implementation also uses AdMob.
  • Adds support for video icons.
  • Adds the following new properties to IMAAd:
    • adSystem
    • creativeID
    • creativeAdID
    • universalAdIdValue
    • universalAdIdRegistry
    • advertiserName
    • surveyURL
    • dealID
    • wrapperCreativeIDs
    • wrapperSystems
  • Adds the following new properties to IMAAdsRequest:
    • contentDuration
    • contentKeywords
    • contentTitle
  • Adds [IMAAdsManager setVolume:].
  • Adds [IMACompanionDelegate companionSlotWasClicked].
  • Adds IMASettings.disableNowPlayingInfo.
  • SDK version 3.3.1 is scheduled to be deprecated on 2018-01-26. See the Deprecation Schedule for more details.
3.3.1 2016-09-16
  • Drops support for iOS 7 and below.
  • SDK version 3.2.1 is scheduled to be deprecated on 2017-09-16. See the Deprecation Schedule for more details.
3.2.1 2016-05-09
  • Adds bitcode support.
3.2.0 2016-04-14
    Note: Due to an error, bitcode support was non-functional in this release.
  • Adds bitcode support.
  • Adds support for clickthrough URLs that lead to the app store.
3.1.0 2015-12-17
  • Out of beta.
  • Adds support for Picture in Picture on iOS 9. For more information, see our Picture in Picture guide or our implementation in the Advanced Sample.
  • IMAContentPlayhead should now be passed to the IMAAdsRequest instead of the IMAAdsManager.
  • Adds support for HTML5 companions.
  • Adds [IMAAdsManager discardAdBreak].
Beta v16 2015-09-04
  • Updates to be compatible with iOS 9's App Transport Security feature.
  • Fixes a crash on IMAAdsLoader deallocation.
Beta v15 2015-07-22
  • Introduces ad buffer events via IMAAdsManager delegates. This facilitates adding elements such as activity indicators and buffering bars to the player.
  • Exposes debugging mode. Publishers can now set the IMASettings enableDebugMode setting to YES to get more verbose logging in the console. This should not be used in production, as it will watermark the ad player.
  • IMAAdsManager destroy now correctly terminates ads in all cases.
  • Allows the reuse of display containers.
  • Allows publishers to destroy IMA objects from within delegate methods.
  • IMAAdsManager now only has a weak reference to contentPlayhead (fixing potential memory leaks). You will now need to retain any IMAAVPlayerContentPlayhead instance or object that implements IMAContentPlayhead as a property, otherwise the object will be immediately released.
  • Removes video resizing animation.
  • Removes unnecessary initial resume ad event.
Beta v14 2015-05-27
  • Fixed an issue where the ad player would occasionally stop to buffer and never resume playback.
  • Moved IMASettings to its own header file.
Beta v13 2015-04-29
  • Added support for background ad playback. For more info see Background Ad Playback.
  • The SDK can now be imported as a framework. For more info on upgrading, see our blog post on this release.
  • Reduced ad loading times on iOS 8.
  • Fixed an issue where companion ads disappeared after an ad ended. Companions ads will now display until the slot is refreshed.
  • Added a 10 second timeout for SDK loading.
  • IMASettings now implements NSCopying.
  • Fixed an issue where apps would crash when headphones were unplugged.
  • Ads are now silenced when the device is silenced by default. The publisher can change this by setting the AVAudioSession category.
  • Fixed bugs with Control Center play and pause not working on iOS versions less than 8.
  • Ads are no longer paused when the notifiation drawer is opened.
  • Added a VERSION file to the downloadable zip.
  • To improve performance, ad rendering is now done natively via AVPlayer on all iOS versions.
Beta v12 2015-02-12
  • Now uses native ad playback on iOS 7 and older. This prevents the SDK from interfering with MPMoviePlayerController events and controls.
  • Fixed an issue where adPlaybackInfo was not populated at the LOADED and START events.
  • Adds IMASettings.maxRedirects to specify the number of redirects after which subsequent redirects will be denied, and the ad load aborted.
  • Adds support for manual ad playback.
Beta v11 2014-12-17
  • Fixes a memory leak introduced in Beta v10 with the addition of WKWebView.
Beta v10 2014-11-20
  • The SDK now uses WKWebView on iOS 8 to render ads instead of UIWebView. This fixes multiple issues related to communication between the SDK native and JS layers. As a side effect of this change, the IMA SDK will now require that your app be built with support for arm64.
  • Added a TAPPED event which is fired whenever the user taps on a non-clickable part of an ad. This can be used to detect taps on an ad to show player controls.
  • To conform to iOS convention, the following methods have been deprecated and replaced with methods that take a reference to the calling object:
    • IMAAdsManagerDelegate - adDidProgressToTime:currentTime:
    • IMAWebOpenerDelegate - willOpenInExternalBrowser
    • IMAWebOpenerDelegate - willOpenInAppBrowser
    • IMAWebOpenerDelegate - didCloseInAppBrowser
    • IMAWebOpenerDelegate - didOpenInAppBrowser
    • IMAWebOpenerDelegate - willCloseInAppBrowser
Beta v9 2014-10-27
  • Contains fixes for memory leaks in IMAJavascript classes.
Beta v8 2014-10-13
  • Introduces IMAUIElements, which allows showing or hiding SDK UI elements programmatically.
Beta v7 2014-08-11
  • Introduced the concept of IMAAdDisplayContainer and changed how companion ads are handled. See Changes to the IMA SDK for IOS for information on required code changes in your app.
  • Removed references to OCMock headers and sources.
  • Fixes slowly updating ad UI elements on iOS 8.
Beta v6 2014-05-27
  • Exposes description, title, and contentType on the IMAAd object.
  • Adds support for the 64-bit iOS simulator
Beta v5 2014-02-14
  • Adds arm64 support.
  • Fixes conflicts with integrations with Google+.
Beta v4 2013-12-12
  • Fixes memory leaks in IMAAdsManager and IMAAdsLoader.
  • IMAAdPodInfo has three new APIs: podIndex, timeOffset, maxDuration. API docs will be updated to reflect this shortly.
Beta v3 2013-09-25
  • Service release, no new features.
Beta v2 2013-07-07
  • Public release of Beta version of SDK.
Closed Beta v2 2013-06-24
Closed Beta v1 2013-04-02
  • Initial Beta release.