Google IMA tvOS SDK release history

Version Release Date Notes
4.14.1 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 would cause some Campaign Manager tracking URLs to be incorrectly encoded.
  • Fixes an issue that caused STARTED events to not be dispatched on some ad sessions.
4.13.0 2024-06-13
  • Adds VODConfigID to IMAVideoStitcherVODStreamRequest.
  • Fixes nullpointerexception when adTagURL is null 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.
  • Fixes issue where tracking pings to ad.doubleclick.net were not being fired.
  • Sets the SDK's ad size rendering constraints based on the view frame instead of the safe area layout guide for the playerView.
4.12.0 2024-04-03
4.11.1 2024-02-22
  • Fixes an issue where content audio could be heard during ad playback.
4.10.0 2024-01-24
  • Enables Pod Serving VOD stream requests.
  • Updates constraints for the AdUI to respect safe area guides.
  • Adds a getter for cue points to iOS/tvOS stream manager
4.9.2 2023-08-15
  • Fixed a bug which causes high CPU utilization for some DAI streams.
4.9.1 2023-04-20
4.8.2 2022-11-03
  • Added userContext to IMA stream requests.
  • Fixed bug that caused unnecessary "Invalid internal message" warnings.
4.7.0 2022-07-20
  • Fixed an issue with publishers overwriting IMA SDK version information.
  • Added AD_CAN_PLAY event. Fired when the ad is ready to play without buffering.
  • Increased max default bitrate to unlimited for non-mobile devices.
4.6.1 2022-02-23
  • Service release; No public changes.
4.5.0 2021-12-06
  • Raised the minimum tvOS version to tvOS 12.
  • Fixed a bug that could result in multiple Why this Ad icons.
  • Removed need for MPNowPlayingSession.
4.4.2 2021-05-03
  • Fixed an issue that caused warning messages on tvOS < 12.
  • Last version of the IMA SDK for iOS to support tvOS 10.
4.4.1 2021-03-09
  • Added IMASettings.sessionID property to allow publishers to manually set their sessionID.
  • Added support for PiP.
  • Fixed an issue where ad pause and resume events could sometimes fire during content.
  • Added IMAVideoDisplay.nowPlayingSession to properly support play/pause events on tvOS 14+.
  • Fixed a bug where adsense linear ads were being reported to the publisher as non linear.
  • Fixed an issue where IMAStreamManager.replaceAdTagParameters would not issue an update.
  • Added pod serving APIs.
  • Enforced adContainer attachment to window.
4.3.2 2020-08-11
4.3.1 2020-08-05
  • Added support for Google's Additional Consent mode. For more information, see Google's Additional Consent Mode technical specification.
  • Added support for the "language_name" key for stream subtitles.
  • Fixed an issue that caused audio-only ads to timeout.
  • Fixed an issue where skipping the first ad in a preroll would cause the second ad to ignore its own skip offset.
  • Added IMAAdDisplayContainer.focusEnvironment, which allows publishers to transfer focus to SDK during ad breaks. This is required whenever the user needs to interact with the ad UI (e.g. skippables, VAST icons).
  • Added viewController as a new required initialization argument or property for IMAAdDisplayContainer.
  • Fixed non-English localization support.
  • Reduced erroneous RESUME events.
  • Added IMAAdsRenderingSettings.enablePreloading, which is enabled by default, to improve ad rendering performance.
  • Added support for skippable ads (client-side and VOD) and VAST icons (client-side and DAI)
  • Added the ICON_FALLBACK_IMAGE_CLOSED and ICON_TAPPED events. We recommend automatically resuming on ICON_FALLBACK_IMAGE_CLOSED since the SDK pauses on fallback image open.
  • Fixed an issue where the IABTCF_gdprApplies was only acknowledged if it was a string.
4.2.3 2020-05-06
  • Fixed an issue where certain app bundle IDs could cause traffic to be misclassified.
4.2.2 2020-03-26
  • Increased the minimum runtime version to tvOS 10
  • Fixed a bug where some UI updates could trigger on a background thread
  • Fixed an issue where strict flags would make IMACompanionAd's init conflict with NSObject's
  • Deprecated the loadURL method on the IMAVideoDisplay protocol
4.2.1 2020-02-12
  • 4.2.1 will be the final version of the IMA SDK that supports tvOS 9.x
  • Fixed an issue where clickthroughs would crash on tvOS 9.x
4.2.0 2019-10-30
  • Fixed an intermittent crash issue on tvOS 13.
4.1.0 2019-09-23
  • Added support for tvOS 13.
  • Added playerVideoDisplay:didLoadPlayerItem: for DAI.
  • Added IMAAd.companionAds and IMACompanionAd for DAI ads.
  • Updated IMAAVPlayerVideoDisplayDelegate names to better fit Objective-C style.
4.0.5 2019-08-16
  • Fixed an issue where the play button on the Apple TV remote did not resume content.
4.0.2 2019-07-18
  • Fixed an issue where the user's "Limit Ad Tracking" setting was incorrectly transmitted.
  • IMAAdEventType.adData is now typed.
  • Added the authToken API on IMAStreamRequest.
4.0.1 Deprecated 2019-07-02
  • Combined client-side and DAI tvOS SDKs
  • Fixed an issue where AdsLists weren't parsed and threw AdsLoader errors on tvOS.

Show earlier versions

Version Release Date Notes
3.9.1 2019-03-28
  • Changed the default stream initialization timeout from 5 seconds to 8 seconds.
  • Added initializationTimeout property to IMAStreamRequest to enable configuration of the stream initialization timeout.
3.9.0 2019-03-06
  • Added adPeriodDidStart and adPeriodDidEnd callbacks to IMAStreamManagerDelegate.
3.8.1 2018-12-06
  • To prevent duplicate metrics recording, ad events like AD_BREAK_STARTED/AD_BREAK_ENDED no longer fire when re-watching/seeking an ad.
3.8.0 2018-05-21
  • Adds support for the npa ad tag parameter.
3.7.1 2018-02-26
  • Fixes a bug where tracking URLs containing curly braces ("{" or "}") were not being pinged on tvOS 11.2.6.
3.7.0 2018-01-24
  • Adds the following as acceptable values for IMAStreamRequest.adTagParameters keys:
    • audio range (dai-aor)
    • exclude (dai-excl)
    • order start (dai-os)
    • video range (dai-sr)
  • Adds the following to IMAAd: advertiserName, creativeID, creativeAdID, dealID, universalAdIDRegistry, universalAdIDValue, wrapperAdIDs, wrapperAdSystems, wrapperCreativeIDs, and wrapperDealIDs.
  • The SDK now fires AD_BREAK_STARTED when joining a stream in the middle of an ad break so listeners can render the ad UI.
  • Adds IMAAVPlayerVideoDisplayDelegate so that users of IMAAVPlayerVideoDisplay can receive the AVAssetURL of the stream to be loaded. With the AVAssetURL object, users can register for FairPlay content protection playback.
3.6.0 2017-09-19
  • Removes nonfunctional IMAStreamRequest.attemptPreroll.
  • Adds the following as accepted IMAStreamRequest.adTagParameters:
    • dai-ah (Ad Holiday)
    • dai-dlid (Delivery Location)
  • Adds IMAStreamRequest.streamActivityMonitorID.
  • Fixes an issue where [IMAStreamManagerDelegate streamManager:didReceiveError:] wasn't called for a stream that didn't play or load.
3.5.0 2017-04-24
  • Adds IMAAd.companions.
  • Adds the IMACompanion class.
3.4.1 2017-03-31
  • Service release, no new features.
3.4.0 2017-03-13
  • Fixes bitcode support.
  • Adds the following properties to AdBreakInfo:
    • adBreakIndex
    • timeOffset
3.3.0 2016-12-05
  • Exposes [IMAAVPlayerVideoDisplay reset], to be called when you need to replace the AVPlayerItem on your content player with a backup AVPlayerItem.
3.2.0 2016-08-22
  • Fixes an issue when submitting an app that uses the framework for testing.
3.1.0 2016-05-09
  • Initial release.