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
Adds a privacy manifest PrivacyInfo.xcprivacy file and a signature for the SDK.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[[["This page provides release notes for the IMA SDK for tvOS, detailing updates, bug fixes, and new features across different versions."],["The latest release, version 4.14.1 (2024-12-03), includes features like network code parameter addition, click-through URL validation, and skippable ad support in VOD Pod Serving streams."],["Several releases have focused on enhancing compatibility, updating the minimum tvOS versions, and introducing support for Google Video Stitcher Live and VOD APIs."],["Over time, there have been fixes for various issues, including memory leaks, CPU utilization, audio playback during ads, and correct encoding of tracking URLs."],["The IMA SDK deprecated older versions of tvOS, and version 4.2.1 was the last to support tvOS 9.x."]]],[]]