Skip to main content

Release Notes

GitHub Releases

Releases are also published on GitHub Releases.

Breaking change in 6.2.0

TeadsAdPlacementType has a new banner case. Any Swift switch statement that exhaustively matches over this enum will fail to compile until the new case is handled.

Teads SDK iOS Release Notes​

[6.2.2] – 10 September 2026​

Changes

  • Internal API endpoint revisions.

[6.2.1] – 25 August 2026​

Fixes

  • Fixed Media ads not resuming playback correctly after returning from Safari (Media and MediaNative placements).
  • Fixed Media ads not resuming playback when the app returns to the foreground.
  • Fixed redundant height updates and viewability tracking not pausing correctly during fullscreen playback, for Banner and Feed placements.
  • Fixed a launch crash in Swift Package Manager integrations of the AdMob adapter (_GADNativeAdvertiserAsset symbol not found) — the SPM distribution is now a static framework.

API Changes

  • The AdMob mediation adapter (TeadsAdMobAdapter) is now distributed as a static framework via Swift Package Manager. Call TeadsAdMobMediation.register() once at startup so the linker keeps the custom-event classes — see the AdMob integration guide.
  • Podspecs for the core SDK and all mediation adapters (AdMob, AppLovin, Prebid, Smart AdServer) now declare a required Swift version.

[6.2.0] – 23 June 2026​

Features

  • Anchored Banner placement — New TeadsAdPlacementBanner for Direct integration, and an anchored banner path in GADMAdapterTeadsBanner for AdMob mediation. Adaptive sizing is driven by the JS engine via the heightUpdated event.
  • Floor price API — floorPrice exposed on the Banner, Feed, and Interstitial placement configs; pbf accepted in the AdMob Banner custom event JSON.
  • Recommendations — publisher impression id — obPubImp exposed on TeadsAdPlacementRecommendationsURLConfig and forwarded to the bridge as the pubImpId URL parameter.
  • No-fill handling — Banner and Feed placements now emit .failed (with error data) when the SFWidget reports no fill, instead of leaving the placement silent.
  • Legacy API deprecation — Classic createInReadPlacement / createNativePlacement APIs are marked deprecated; they remain fully functional and emit compiler warnings to encourage migration to Teads.createPlacement.
  • Privacy — GPP section IDs are now read from the standardized IABGPP_GppSID UserDefaults key; IABTCF_CmpSdkID is forwarded alongside the consent string.
  • Mediation adapter distribution — TeadsAdMobAdapter and TeadsAppLovinAdapter are distributed as signed binary xcframeworks via Swift Package Manager.
  • GMA compatibility — SPM dependency range extended to support GoogleMobileAds SDK v13.

API Changes

  • TeadsAdPlacementType has a new banner case — Swift consumers using exhaustive switch on this enum must handle this case after upgrading.

Fixes

  • Fixed missing event emissions in Media and MediaNative placements.
  • Fixed IDFA fallback being bypassed when userId is an empty string.
  • Fixed hasGDPRConsentForTeads logic; IABTCF_CmpSdkID is now bridged into the consent payload.
  • Dispatched OM session setup to the main thread via GCD to avoid actor-isolation ordering issues.
  • Removed the AVAudioSession.outputVolume KVO from the OM bridge.

[6.1.0] - 9 Apr 2026​

Features

  • New Interstitial ad format: fullscreen ad placement with preload/show/dismiss lifecycle, ad cache TTL, and AdMob mediation adapter (GADMAdapterTeadsInterstitial). See the AdMob Interstitial integration guide for details.

Changes

  • SDK framework is now compiled with Xcode 26.2

Fixes

  • Made Teads.configure() thread-safe

[6.0.11] - 25 Mar 2026​

Features

  • Added IAB TCF v2.3 support for enhanced privacy consent handling
  • Support for Google Mobile Ads SDK v13 in TeadsAdMobAdapter

Fixes

  • Fixed TeadsPrivacy.gdprApplies not reading IABTCF_gdprApplies correctly under TCF v2
  • Fixed privacy consent not being bridged into config-based placements
  • Aligned podspec minimum iOS deployment target to 14.0

[6.0.10] - 11 Mar 2026​

Fixes

  • Fixed Immersive Feed presentation issues

[6.0.9] - 5 Mar 2026​

Fixes

  • Fixed Prebid adapter stability and thread safety issues

[6.0.8] - 17 Feb 2026​

Fixes

  • Fixed fill rate issues on Media placement
  • Fixed test mode for Feed and Recommendations placements

[6.0.7] - 4 Feb 2026​

Features

  • Audio session management for unified placements: Added disableAudioSessionManagement configuration option to TeadsAdPlacementMediaConfig for TeadsAdPlacementMedia and TeadsAdPlacementMediaNative placements.
  • Playback events: Forwarding playback events (.startPlayAudio, .stopPlayAudio, .play, .pause, .complete) through TeadsAdPlacementEventsDelegate for unified placements.

[6.0.6] - 29 Jan 2026​

Internal release.

[6.0.5] - 28 Dec 2025​

Prebid adapter

Do not use the Prebid adapter with this version.

Fixes

  • Fixed crash issue in Media placement
  • Fixed click on recommendation in SwiftUI component

[6.0.4] – 12 Dec 2025​

Fixes

  • API changes for reporting

[6.0.3] – 12 Dec 2025​

Fixes

  • API changes for reporting

[6.0.2] – 4 Dec 2025​

Features

  • Added orientation change support.

[6.0.1] – 20 Nov 2025​

Fixes

  • Privacy manifest: Removed a faulty privacy manifest category.

[6.0.0] – 29 Oct 2025​

Unified Placement Interface

This release introduces a unified interface for creating all placement types via Teads.createPlacement(), providing a consistent API across the SDK.

New Placement Types

  • Feed placement: New TeadsAdPlacementFeed class for content recommendation widgets.
  • Recommendations placement: New TeadsAdPlacementRecommendations for programmatic access to content recommendations.

Features

  • Unified event system: Single TeadsAdPlacementEventsDelegate for all placement types.
  • Dark mode: Support via toggleDarkMode() and configuration parameter.
  • Explore More: Feature to show additional content when users navigate away.
  • SwiftUI support: Native SwiftUI implementation patterns.

Legacy Release Notes​

[5.5.2] – 31 Jul 2025​

Improvements

  • Bumped AppLovin and GAM dependency versions for Swift Package Manager compatibility

[5.5.1] – 8 Jul 2025​

Fixes

  • Blank creatives: Fixed an issue where blank creatives could appear in some placements github.com.

[5.5.0] – 2 Jul 2025​

Features

  • Prebid Standard Integration: Created a TeadsPBMPluginRenderer to support Prebid Standard Integration github.com.
  • Native API improvements: Exposed a universalClickURL property on the TeadsNativeAd to retrieve the destination URL when a user taps on a native ad.
  • Documentation: Improved open source documentation for native ad formats github.com.

[5.3.0] – 25 Mar 2025​

Features

  • GAM version bump: Updated the Google Ad Manager adapter to version 12.2.0 github.com.

Fixes

  • VTS issue: Fixed an issue related to the Video Tracking Services (VTS) not behaving as expected github.com.

[5.2.0] – 27 Feb 2025​

Features

  • OMSDK update: Updated the Open Measurement SDK bundled in the Teads SDK github.com.

[5.1.8] – 9 Jan 2025​

Features

  • Signed artifacts: The SDK is now signed when using Swift Package Manager (SPM) and AppLovin MAX. SPM is available for TeadsSDK, AdMob and AppLovin MAX (not yet for Smart).
  • Bitcode removal: Removed Bitcode support since Xcode 14 no longer supports it github.com.

Fixes

  • Bitcode flag removal: Fixed build issues related to the obsolete Bitcode flag github.com.

[5.1.6] – 10 Dec 2024​

Features

  • GPP consent signals: Added support for Global Privacy Platform (GPP) consent signals in AdPlacementSettings github.com.
  • Xcode 16 compatibility: Updated the SDK to build with Xcode 16 github.com.

Fixes

  • Main thread warning: Fixed a warning about code running on the wrong thread github.com.
  • Remove Bitcode: Fully removed Bitcode support after Apple deprecated it github.com.

[5.1.3] – 3 Jul 2024​

Features

  • Privacy API compliance: Added compliance with Apple's NSPrivacyAccessedAPICategoryUserDefaults in the privacy manifest github.com.

[5.1.2] – 2 May 2024​

Features

  • Prebid standalone integration: Updated to support the latest Prebid standalone integration github.com.

[5.1.1] – 4 Apr 2024​

Features

  • Privacy manifest: Updated the privacy manifest for App Store privacy labeling github.com.
  • Dependency updates: Updated Google Mobile Ads SDK to v11.2.0 and AppLovin SDK to v12.3.1 github.com.

[5.0.27] – 29 Jan 2024​

Features

  • Programmatic native binding: Added a NativeAd tag binder allowing UI elements to be bound programmatically with TeadsNativeAdView.bind github.com.

[5.0.26] – 15 Jan 2024​

Fixes

  • Resize in WebView & mediation: Fixed ad resizing issues when ads were displayed in a WebView or under mediation github.com.

[5.0.25] – 10 Jan 2024​

Fixes

  • Concurrency crash: Fixed a crash in MediatedResizeViewManager caused by multithreading in the Google mediation context github.com.

[5.0.24] – 3 Jan 2024​

Fixes

  • Concurrency issues: Addressed crashes related to multi‑threading in RemoteConfigManager and MediatedResizeViewManager github.com.
  • AppLovin adapter: Fixed initialization status in the AppLovin adapter github.com.

[5.0.23] – 23 Nov 2023​

Features

  • Public placement ID: Exposed TeadsAdPlacement.pid publicly for easier debugging github.com.
  • Validation tool UI: Improved the validation tool's alert dialog UX github.com.

Fixes

  • AR creatives: Fixed an issue causing augmented reality creatives not to load correctly github.com.

[5.0.22] – 26 Oct 2023​

Improvements

  • Visibility algorithm: Improved the visibility algorithm for the Flutter plugin, ensuring that visibility tracking is more accurate github.com.

[5.0.21] – 28 Sep 2023​

Features

  • Google Mobile Ads API: Implemented the new Google Mobile Ads API (v9) with an updated API for registering TeadsAdapterSettings via GADRequest.register() github.com.
  • OM SDK update: Updated the Open Measurement SDK for certification github.com.

Fixes

  • Image loader: Removed an unnecessary dispatch to the main queue in ImageLoader that could cause performance issues github.com.
  • API removal: Removed the customEventExtra API in favour of using register() for custom adapter settings github.com.

[5.0.20] – 19 Aug 2023​

Fixes

  • Visibility algorithm: Corrected the visibility algorithm in the Flutter plugin github.com.

[5.0.19] – 19 Jul 2023​

Features

  • Flutter compatibility: Added compatibility with Flutter apps github.com.
  • Media scale mode: Introduced a MediaScale property (renamed from mediaContentMode) to control the video scale mode in native ads github.com.

Fixes

  • Memory leaks: Fixed memory leaks and improved the cleanup of ad resources github.com.

[5.0.18] – 23 Jun 2023​

Features

  • Media scale: Added the ability to set the media scale mode in native ads github.com.

Fixes

  • AdPlacement retention: Prevented AdPlacement objects from being deallocated prematurely github.com.
  • Logging: Added console warnings for better debugging github.com.

[5.0.17] – 30 May 2023​

Fixes

  • AppLovin clicks: Handled AppLovin's performClick() call to avoid incorrect click behaviour github.com.
  • Multiple tracking: Fixed a concurrency crash when multiple tracking instances were created github.com.

[5.0.16] – 19 May 2023​

Fixes

  • Concurrency crash: Fixed a crash when multiple placements were instantiated concurrently github.com.

[5.0.15] – 28 Apr 2023​

Improvements

  • Native tracking: Improved native ad tracking and monitoring to ensure better tracking of user engagement github.com.

[5.0.14] – 18 Apr 2023​

Fixes

  • Parameter parsing: Fixed incorrect parsing of parameters in the mediation adapter github.com.

[5.0.13] – 12 Apr 2023​

Features

  • AR creatives: Added support for augmented reality creatives github.com.

API Changes

  • API deprecation: Marked disableMediaPreload as deprecated; removed MoPub support github.com.

[5.0.12] – 3 Apr 2023​

Features

  • AppLovin adapter: Added a new AppLovin adapter for better integration github.com.
  • Multithreading improvements: Improved internal multithreading to reduce race conditions github.com.
  • AdChoices view: Added a public TeadsAdChoicesView class that can be integrated into native ads github.com.

[5.0.11] – 15 Mar 2023​

Features

  • Video component: Added a contentAspectRatio property to the VideoComponent class for fine-grained aspect ratio control github.com.

Fixes

  • JSContext: Fixed an issue with JSContext management that could lead to a crash github.com.
  • VAST errors: Resolved VAST-related errors causing playback issues github.com.

[5.0.10] – 7 Mar 2023​

Features

  • Optional delegate: Made the TeadsAdPlacement delegate optional when initializing a placement github.com.

[5.0.9] – 28 Feb 2023​

Improvements

  • Error management: Improved error handling to make debugging easier github.com.
  • Documentation: Enhanced documentation around the SDK's APIs and integration github.com.
  • UI enhancements: Added shadow effects on overlay UI elements and improved memory cleanup github.com.

[5.0.8] – 21 Feb 2023​

Features

  • End‑screen redesign: Updated the end‑screen layout, including button image and text size, and added a background blur github.com.
  • Media CTA button: In Media ads, the call‑to‑action button is now hidden after video playback finishes github.com.

Fixes

  • OM verification parameters: Fixed verificationParameters being nil during some OM SDK verifications github.com.

API Changes

  • Video aspect ratio: Added a public contentAspectRatio property on TeadsNativeAd.video github.com.

[5.0.7] – 15 Feb 2023​

Features

  • Log dispatching: Added the ability to dispatch log messages through the TeadsAdPlacement delegate github.com.
  • End‑screen image types: Added support for different image types for the end‑screen call‑to‑action button github.com.

Fixes

  • VAST errors: Fixed certain VAST errors and improved handling of incorrectly formatted creatives github.com.
  • End‑screen: Fixed an issue where the end‑screen could be broken under certain conditions github.com.

API Changes

  • AdFailReason: AdFailReason now conforms to CustomNSError, making its errorCode an Int github.com.

[5.0.6] – 8 Feb 2023​

Fixes

  • Content management: Fixed an issue in the content management platform that caused invalid asset URLs github.com.
  • Xcode 13: Corrected an issue where the SDK version number could be overridden when built with Xcode 13 github.com.

[5.0.5] – 31 Jan 2023​

API Changes (Breaking)

  • Playback delegate: TeadsSoundDelegate has been renamed to TeadsPlaybackDelegate, with new events didPlay, didPause, and didComplete github.com.

[5.0.4] – 30 Jan 2023​

Fixes

  • Scroller/flow creative: Fixed a scroller/flow creative that could be displayed late when the slot was rendered github.com.

[5.0.3] – 19 Jan 2023​

Features

  • OM SDK update: Updated the Open Measurement SDK to version 1.3.24 github.com.

Improvements

  • Close button: Added a close button after the countdown finishes github.com.
  • Visibility: Ensured a minimum visible area of 50×50 points github.com.

Fixes

  • Scroller creative: Fixed an issue where a scroller creative might not display correctly github.com.

[5.0.2] – 10 Jan 2023​

Major release

  • New JS engine: Introduced a new JavaScript engine for ad rendering github.com.
  • Unified entry point: Simplified API with a single entry point ad placement to manage Teads ads github.com.
  • Media Native Native placement: Added support for Media Native native placements github.com.
  • Animated images: Added support for animated images in background scrollers github.com.

Fixes

  • VPAID creatives: Resolved issues related to VPAID creatives, including sound button placement, resizing and resolution github.com.

[4.8.8] – 30 Jul 2022​

Fixes

  • Xcode 13 beta: Fixed a crash when running on the iOS 15 beta using Xcode 13 github.com.

[4.8.7] – 4 Jun 2022​

Features

  • OM SDK: Updated the Open Measurement SDK to version 1.3.19 github.com.

[4.8.6] – 26 Feb 2022​

Fixes

  • First‑ad issue: Fixed an issue causing the first ad experience to stop when the SDK was used for the first time github.com.

[4.8.5] – 3 Feb 2022​

Fixes

  • GMA v8: Fixed an issue with Google Mobile Ads SDK v8 and addressed a crash github.com.

[4.8.4] – 9 Dec 2021​

Features

  • Simulator arm64: Added arm64 support for the iOS simulator github.com.

Fixes

  • Ad resize delegate: Fixed a crash when using TeadsAdSettings.subscribeAdResizeDelegate github.com.

[4.8.3] – 3 Dec 2021​

Fixes

  • Mediation resize: Fixed a crash in mediation when subscribing to the ad resize delegate github.com.

[4.8.0] – 26 Oct 2021​

Features

  • SmartAd adapter: Added support for the SmartAd adapter and validated the resize implementation github.com.
  • OM SDK: Updated to the latest OM SDK and removed all UIWebView references github.com.

[4.7.8] – 8 Jul 2021​

Fixes

  • Ratio update: Ensured the ratio update is dispatched on the main thread github.com.
  • Player creative: Fixed rendering issues in the player creative and improved memory management github.com.

[4.7.7] – 24 Jun 2021​

Fixes

  • VPAID start: Fixed an issue preventing VPAID creatives from starting github.com.
  • Performance management: Improved performance management github.com.

[4.7.5] – 19 May 2021​

Features

  • View resize method: Added a method to resize the view in mediation github.com.

[4.7.4] – 7 May 2021​

Fixes

  • Issue #124: Fixed issue #124 where TFAdDelegate.didUpdateRatio becomes mandatory github.com.

[4.7.3] – 26 Apr 2021​

Fixes

  • General improvements: Various fixes and minor improvements github.com.

[4.7.2] – 19 Mar 2021​

Features

  • TCF v2: Added support for the Transparency and Consent Framework v2 specifications github.com.

[4.6.0] – 28 Sep 2020​

Features

  • Final validation tool: Introduced the final validation tool for creatives github.com.

Fixes

  • Crashes: Fixed crashes occurring under specific conditions github.com.

[4.5.0] – 19 Jun 2020​

Features

  • CCPA support: Added support for the US Privacy String (CCPA) according to IAB guidelines github.com.

Fixes

  • Improvements: Various bug fixes and improvements github.com.

[4.4.0] – 4 Mar 2020​

Features

  • OM SDK: Updated the Open Measurement SDK github.com.
  • Display management: Improved management of display visibility github.com.

[4.3.5] – 10 Jan 2020​

Fixes

  • Custom operator: Fixed a custom operator declaration github.com.

[4.3.4] – 9 Jan 2020​

Features

  • Scroller behaviour: Upgraded scroller behaviour and deprecated enableLitEndScreen in settings github.com.

Fixes

  • Bug & performance: Various bug fixes and performance improvements github.com.

[4.3.2] – 3 Jan 2020​

API Changes

  • Deprecated setAdContainerView: Deprecated the method for setting the ad container view on the ad view github.com.

Fixes

  • Bug fixes & improvements: Minor bug fixes and performance improvements github.com.

[4.3.1] – 20 Nov 2019​

Fixes

  • AdMob & MoPub: Added compatibility fixes for AdMob and MoPub adapters github.com.

[4.3.0] – 29 Oct 2019​

API Changes

  • Ad container & iOS 13: Deprecated adContainerId in mediation adapters. Added support for low‑power mode and iOS 13 github.com.

Fixes

  • Minor improvements: Various fixes and minor improvements github.com.

[4.2.6] – 24 Sep 2019​

Fixes

  • VPAID corner bug: Fixed a bug causing VPAID creatives to appear in the corner github.com.
  • Click events: Fixed click events not working in certain cases github.com.
  • Minor improvements: Additional minor improvements github.com.

[4.2.5] – 19 Aug 2019​

Fixes

  • Minor improvements: Minor improvements github.com.

[4.2.4] – 25 Jul 2019​

Features

  • Geolocation removal: Removed geolocation usage from the SDK github.com.

API Changes

  • Versioning: Introduced TeadsSDKPrevious for backwards compatibility with apps built using older Xcode versions github.com.

[4.2.3] – 22 Jul 2019​

Fixes

  • VPAID: Fixed VPAID ad issues that could cause the ad not to play github.com.

[4.2.2] – 11 Jun 2019​

Fixes

  • Performance improvements: Various performance enhancements github.com.

[4.2.1] – 7 May 2019​

Features

  • Full‑screen dismissal: Added a method to dismiss full‑screen ads programmatically github.com.

Fixes

  • Memory management: Improved memory management github.com.

[4.2.0] – 9 Apr 2019​

Major changes

  • Media class: Introduced an Media class for easier integration github.com.
  • SDK version: Exposed Teads.sdkVersion for retrieving the SDK version github.com.
  • Visibility logs: Added visibility overlay logs for debugging github.com.

API Changes

  • Delegate method: Changed the delegate method signature for ad view ratio updates (breaking change) github.com.

[4.1.6] – 18 Dec 2018​

Fixes

  • Performance: Improved performance and stability github.com.

[4.1.5] – 13 Nov 2018​

Fixes

  • SDK performance: Improved overall SDK performance github.com.

[4.1.4] – 31 Oct 2018​

Fixes

  • iOS 12 tracking: Fixed tracking issues on iOS 12 github.com.

[4.1.3] – 31 Oct 2018​

Fixes

[4.1.2] – 23 Oct 2018​

Fixes

  • Tracking issue: Fixed tracking issues on iOS 12 github.com.
  • Audio session: Added audio session handling github.com.
  • Circuit breaker: Fixed a bug in the circuit breaker github.com.

[4.1.1] – 9 Oct 2018​

Fixes

[4.1.0] – 9 Oct 2018​

Features

  • Xcode 10 support: Officially added support for Xcode 10 github.com.

[4.0.10] – 9 Oct 2018​

Fixes

[4.0.9] – 29 Aug 2018​

Features

  • GDPR support: Added support for GDPR compliance github.com.
  • Improvements: Various improvements and bug fixes github.com.
  • Xcode 10 & Swift 4.2: Provided a dedicated build supporting Xcode 10 and Swift 4.2 github.com.

[4.0.7] – 22 Jun 2018​

Features

  • Visibility: Improved visibility handling github.com.
  • Opt‑out cookie: Added an opt‑out cookie github.com.

Fixes

  • Header/footer colours: Fixed clear colours for header and footer backgrounds github.com.
  • Quartile tracking: Fixed quartile tracking after replay github.com.
  • Pause tracking: Fixed pause tracking that could be sent when tapping the end‑screen "Learn more" button github.com.

[v4] – 9 Oct 2018 (development merge)​

Changes

  • Pull request: Merged pull request #101 from the teads/develop branch github.com.

[2.7.17] – 28 Jun 2018​

Fixes

  • Table view integration: Fixed an issue affecting table view integration github.com.

[2.7.16] – 29 Mar 2018​

Features

  • Brand safety: Added brand‑safety support. For apps containing news content, developers should set the page URL (for example https://news.com/myArticle) with setPageUrl so that ads are delivered in brand‑safe contexts github.com.

[2.7.15] – 19 Feb 2018​

Fixes

  • Status bar guideline: Fixed a regression due to changes in Apple guidelines for UIStatusBarDataNetworkItemView github.com.

[2.7.14] – 29 Jan 2018​

Fixes

  • Internal fixes: Internal bug fixes and improvements github.com.
  • VAST media file selection: Improved VAST mediafile selection github.com.

[2.7.13] – 11 Dec 2017​

Features

  • Xcode 9: The SDK is now built with Xcode 9, which supports iOS 8+. Developers should use Xcode 9 for future builds github.com.
  • iPhone X: Adjusted the UI for full‑screen ads on iPhone X github.com.

Fixes

  • WKWebView integration: Fixed issues with (wk)webview integration github.com.

[2.7.12] – 29 Nov 2017​

Fixes

  • WKWebView bug: Fixed a JavaScript reinjection issue in WKWebView that caused the WKNavigationDelegate not to respond github.com.

[2.7.11] – 21 Nov 2017​

Features

  • VPAID support: Improved VPAID support for creatives using the IMA SDK for HTML github.com.

[2.7.8] – 27 Sep 2017​

Fixes

  • Xcode 8 build: Fixed an issue that resulted in a build error on Xcode 8 github.com.

[2.7.7] – 22 Sep 2017​

Fixes

  • Display format: General fixes and improvements for display format github.com.
  • iPhone X crash: Fixed a crash on the iPhone X github.com.

This file summarizes all publicly available Teads SDK iOS release notes up to version 5.5.1 (July 2025) and includes a placeholder for the forthcoming unified SDK (6.0.1).