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.
[null,null,["Last updated 2025-04-14 UTC."],[[["The latest IMA SDK for tvOS (version 4.13.0) includes fixes for null pointer exceptions, improved ad playback logic, and enhanced ad request parameters."],["This SDK supports features like Cloud Video Stitcher integration, Pod Serving VOD stream requests, and Google's Additional Consent mode."],["It has undergone several updates for compatibility with the latest tvOS versions and includes bug fixes related to ad playback, UI elements, and tracking functionalities."],["The SDK requires a minimum of tvOS 12 and supports features like App Tracking Transparency for tvOS 14 and above."],["Earlier versions of the SDK have been deprecated, and users are encouraged to upgrade to the latest version for optimal performance and features."]]],["The updates address bug fixes and feature enhancements across various versions. Key actions include adding support for skippable ads, VOD Pod Serving, and Google Video Stitcher APIs. Memory leaks and null pointer exceptions were fixed, and tracking logic for ad interactions was improved. The SDK now respects safe area guides, enforces ad container attachment, and supports privacy features. New events like `AD_CAN_PLAY` and properties for session management were introduced, alongside updates for compatibility with new tvOS versions and Google's ad consent modes.\n"]]
