Google IMA iOS SDK release history

    • The Interactive Media Ads (IMA) SDK for iOS has undergone numerous updates including significant changes to privacy and compliance features like privacy manifests and App Tracking Transparency support.

    • Recent versions introduce extensive support for Google Video Stitcher, Pod Serving, and various Digital Ad Insertion (DAI) functionalities.

    • Performance enhancements such as ad preloading and native rendering with AVPlayer have been implemented across different releases.

    • The SDK has seen continuous API evolution with new classes, properties, and methods added or deprecated, along with updates to platform support, increasing minimum iOS requirements and adding support for newer devices.

    • Multiple bug fixes addressing memory leaks, event handling, and playback issues have been included in various releases.

    Version
    Release Date
    Notes
    3.28.10
    2025-10-22
    • Enables interstitial support for Server-Directed Ad Insertion (SDAI) live and VOD streams by introducing a useHLSInterstitial field to the stream request.
    • Improves memory management for companion ads to prevent memory leaks when your application destroys the adsManager object.
    • Increased minimum iOS version to 15.
    • On 2026-10-22, SDK version 3.27.4 deprecates. For more details, see Deprecation schedule .
    3.27.4
    2025-08-28
    • Fixes IMARemoteControl class creation to only happen when the player starts playback.
    • On 2026-08-28, SDK version 3.26.1 deprecates. For more details, see Deprecation Schedule .
    3.26.1
    2025-04-02
    • Adds the ad period info to the AD_PERIOD_STARTED event, which you can access from IMAAdEvent.adData property.
    • Adds support for handling HLS interstitials metadata with the IMA SDK.
    • On 2026-04-02, SDK version 3.24.0 deprecates. For more details, see Deprecation Schedule .
    3.24.0
    2024-12-03
    • Adds network code to the list of stream request parameters for all stream types.
    • Fires a LOG event when an invalid click-through URL is clicked, rather than failing silently.
    • Fixes a memory leak when OMID sessions were improperly destroyed.
    • Adds support for skippable ads in VOD Pod Serving streams.
    • Fixes a bug with scrolling support when the video is embedded in a scrollable container.
    • Adds support for minSuggestedDuration to non-linear ads
    • Fixes a bug that caused incorrect encoding for Campaign Manager tracking URLs, in some cases.
    • On 2025-12-03, SDK version 3.23.0 deprecates. For more details, see Deprecation Schedule .
    3.23.0
    2024-06-12
    3.22.1
    2024-04-12
    • Fixes an issue with the most recent Cocoapods release which prevented apps from building on iOS Simulators.
    • On 2025-04-12, SDK version 3.22.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2025-01-28, SDK version 3.19.2 deprecates. For more details, see Deprecation Schedule .
    3.19.2
    2023-04-28
    • Reduced minimum iOS version for compilation to iOS 12.
    • On 2024-04-28, SDK version 3.19.1 deprecates. For more details, see Deprecation Schedule .
    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 .
    • On 2024-04-20, SDK version 3.18.5 deprecates. For more details, see Deprecation Schedule .
    3.18.5
    2023-03-10
    3.18.4
    2022-12-08
    • Service release. No new features.
    • On 2023-12-08, SDK version 3.18.2 deprecates. For more details, see Deprecation Schedule .
    3.18.2
    2022-11-07
    • Adds user_context to stream request.
    • Fixes erroneous "Invalid internal message" warnings.
    • On 2023-11-07, SDK version 3.18.1 deprecates. For more details, see Deprecation Schedule .
    3.18.1
    2022-10-02
    • Fixes an issue that caused the SDK to crash with UIViewControllerHierarchyInconsistency
    • On 2023-10-02, SDK version 3.17.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2023-08-03, SDK version 3.16.3 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2023-04-19, SDK version 3.15.1 deprecates. For more details, see Deprecation Schedule .
    3.15.1
    2022-02-23
    • Increased minimum iOS version to 12
    • On 2023-02-23, SDK version 3.14.5 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2022-10-05, SDK version 3.14.4 deprecates. For more details, see Deprecation Schedule .
    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
    • On 2022-07-06, SDK version 3.14.3 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2022-05-03, SDK version 3.14.1 deprecates. For more details, see Deprecation Schedule .
    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+.
    • On 2022-02-17, SDK version 3.13.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2021-10-13, SDK version 3.12.1 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2021-08-11, SDK version 3.12.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2021-08-05, SDK version 3.11.4 deprecates. For more details, see Deprecation Schedule .
    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
    • On 2021-03-26, SDK version 3.11.3 deprecates. For more details, see Deprecation Schedule .
    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
    • On 2021-02-12, SDK version 3.11.2 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2020-12-04, SDK version 3.10.1 deprecates. For more details, see Deprecation Schedule .
    3.10.1
    2019-09-19
    • Adds support for iOS 13 and iPadOS.
    • On 2020-09-19, SDK version 3.9.2 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2020-08-16, SDK version 3.9.1 deprecates. For more details, see Deprecation Schedule .
    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: .
    • On 2020-07-18, SDK version 3.9.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2020-02-19, SDK version 3.8.1 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2019-11-13, SDK version 3.7.3 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2019-08-21, SDK version 3.7.2 deprecates. For more details, see Deprecation Schedule .
    3.7.2
    2018-05-15
    • Fixes an issue where some companions would expand to a full screen WebView.
    • On 2019-05-15, SDK version 3.7.1 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2019-01-30, SDK version 3.6.1 deprecates. For more details, see Deprecation Schedule .
    3.6.1
    2017-10-09
    • Adds IMAAdsRequest.liveStreamPrefetchSeconds .
    • On 2018-10-09, SDK version 3.6.0 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2018-07-24, SDK version 3.5.2 deprecates. For more details, see Deprecation Schedule .
    3.5.2
    2017-05-02
    • Removes auto-resuming when coming back into app from backgrounding. Call [IMAAdsManager resume] to resume.
    • Adds [IMAAdsRenderingSettings playAdsAfterTime].
    • On 2018-05-02, SDK version 3.5.1 deprecates. For more details, see Deprecation Schedule .
    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.
    • On 2018-04-03, SDK version 3.5.0 deprecates. For more details, see Deprecation Schedule .
    3.5.0
    2017-03-24
    • Fixes an issue with bitcode support.
    • Adds adsResponse to the IMAAdsRequest object.
    • Fixes an issue with Swift builds.
    • On 2018-03-24, SDK version 3.4.2 deprecates. For more details, see Deprecation Schedule .
    3.4.2
    2017-03-09
    • Service release, no new features.
    • On 2018-03-09, SDK version 3.4.1 deprecates. For more details, see Deprecation Schedule .
    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 .
    • On 2018-02-03, SDK version 3.3.1 deprecates. For more details, see Deprecation Schedule .
    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 .
    • On 2018-01-26, SDK version 3.3.1 deprecates. For more details, see Deprecation Schedule .
    3.3.1
    2016-09-16
    • Drops support for iOS 7 and below.
    • On 2017-09-16, SDK version 3.2.1 deprecates. For more details, see Deprecation Schedule .
    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 notification 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.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: