Skip to content

Releases

Release History

The following table lists the details of the latest Usercentrics App SDK releases:

Version Release Date Release Notes
2.13.0 February 29, 2024
  • [Feature] New Usercentrics Ready API - The API's new properties introduce a feature that, through Rulesets, allows identification of scenarios where the banner may be bypassed in specific locations, check it out
  • [Improvement] Removes TCF 2.0 warnings - Since TCF 2.0 has been deprecated, we've removed all warnings regarding the usage of version 2.0 of this framework
  • [Improvement] New TCF 2.2 Stacks - Added support for Stacks 44 and 45
  • Android Bug Fixes:
    • [Warning] ⚠️Support for versions lower than Android 5.0 (API Level 20) is planned to be removed in releases starting from end of March/24
    • [Fix] Fully removes support for TLS 1.2 in Android versions lower than 5.0 (API Level 20)
  • iOS Bug Fixes:
    • [Fix] Banner was not correctly rendered given some specific programmatic customization scenarios
    • [Fix] Fixes layout constraints when changing the language for CCPA banners
  • Other Fixes:
    • [Fix] General improvement on resurfacing logic for any Legal Basis change on TCF Purposes
2.12.0 February 15, 2024
  • [Feature] Consent choice persistence - Prevents repeated banner displays across geographies for users moving across different legal frameworks (i.e. in case of frequent travellers)
  • [Improvement] - Displaying the count of third-party vendors by category title
  • Android Bug Fixes:
    • [Fix] Improved UX on language selector popup
  • iOS Bug Fixes:
    • [Fix] Enhancing the UI of First-layer Popups and Sheets for Optimal Display on iPads
  • Other Fixes:
    • [Fix] Aligned purposes descriptions/illustrations and vendor data with GVL translation
    • [Fix] Edge case when certain services, hidden by their respective categories, were visible"
    • [Fix] Minor issues on session restoration when using TCF
2.11.3 January 25, 2024
  • [Improvement] Adds AC String into Updated Consent Event API
  • Other Fixes:
    • [Fix] Ensures accurate and proper display of large links on the Banner First and Second layer
    • [Fix] Deprecates deviceStorage field on TCF Vendor class
2.11.1 January 10, 2024
  • [Improvement] Rework of session restore checks to prevent empty/bogus Controller ID
  • Android Bug Fixes - Experience a smoother Android experience with the resolution of minor bugs:
    • [Fix] Controller ID card replaced at the bottom when using Google Additional Consent
    • [Fix] Language selection menu will respect programmatic customization parameters
    • [Fix] Warning for Chartboost SDK when R8 is enabled
    • [Fix] Minor UI glitch where tab names were truncated when displaying the second layer in landscape mode
  • iOS Bug Fixes:
    • [Fix] Prevent fatal exceptions for a known iOS issue, more details here
  • Other Fixes:
    • [Fix] Solved for Webview continuity previously not restoring consents to Google Additional Technology Providers
    • [Fix] Solves the problem where the option 'Show non-IAB purposes only for EU users' incorrectly impacts users from specific regions
    • [Fix] Application of consents when configuring the CMP to 'Do Not Display' with Geolocation Rules
2.11.0 December 22, 2023
  • [Feature] Google Consent Mode V2 Support - Seamlessly integrate with the latest Google Consent Mode, ensuring enhanced privacy compliance and meeting Google requirements.
  • [Feature] Google Additional Consent Mode V2 - Integrate with the latest Google Additional Consent, allowing you to collect and signal additional consent for ad tech providers not covered by the IAB TCF V2.2.
  • [Feature] Display number of vendors for each purpose on TCF - Easily view the number of vendors associated with each purpose in the Transparency and Consent Framework.
  • [Feature] Chartboost SDK in Consent Mediation - Optimize revenue by effortlessly managing the Chartboost SDK within Usercentrics Consent Mediation.
  • [Improvement] TCFUserDecisions API update - All properties have been changed from variables to constants. The adTechProviders field has been added which represent consents for Google Additional Consent Mode. On iOS this is a required argument, so if this is irrelevant for your configuration, just set an empty list, when needed.
  • [Improvement] Location is only cached by the SDK for offline mode.
  • Android Bug Fixes - Experience a smoother Android experience with the resolution of minor bugs:
    • [Fix] Avoid fetching any image resource after the banner has been closed.
  • iOS Bug Fixes:
    • [Fix] Prevent Long Privacy Legal Links from Being Truncated;
    • [Fix] Enable Scaled Fonts resources when using Custom UI.
  • Other Fixes:
    • [Fix] Third-Party Vendors Count misalignment in some configurations;
    • [Fix] Fix the bug causing the banner to reappear for users outside the European Union, despite configurations being specifically set to enforce GDPR compliance exclusively for EU users;
    • [Fix] Update Link to Report Issues on Zendesk.
2.10.0 November 16, 2023
  • [Improvement] Accessibility: Various issues have been addressed to enhance accessibility.
    • Resolved banner compatibility issues with iOS VoiceOver.
    • Resolved banner compatibility issues with Android TalkBack.
    • Adjusted font sizes to comply with Accessibility requirements on both iOS and Android.
  • [Improvement] Added Ukrainian support language for TCF.
  • [Resolved Issues]
    • Fixed the issue of not disclosing the setting "showCloseButton" has been addressed, preventing errors on Android.
    • Fixed the crash on Android when passing an invalid controller id to restore the user session.
    • Fixed The issue of the remote variant configuration not being used in first layer on Unity.
2.9.0 October 4, 2023
  • [TCF 2.2 Support] As the industry shifts to TCF 2.2 (deadline: November 20, 2024), we are pleased to announce that SDK Version 2.9.0 now offers comprehensive support for this new industry standard. ⚠️Important Note: Please be aware that this version is incompatible with TCF 2.0. Before upgrading to V 2.9.0, ensure a smooth transition to TCF 2.2 following the guidelines on How to migrate from TCF v2.0 to TCF v2.2
  • [Updated Global Vendor List] We've transitioned to Global Vendor List v3 to align with industry standards.
  • [Legitimate Interest] To enhance transparency and privacy, purposes 3 to 6 have been removed, and purpose 11 has been introduced.
  • [Improved User Interface] We've made enhancements to the banner's second layer for a better user experience.
  • [Vendor Count Display] Users can now easily see the total count of IAB and non-IAB vendors.
  • [New Resurface Requirements] We've implemented new resurfacing requirements to keep your CMP compliant with the latest standards.
2.8.2 July 12, 2023
  • [Unity] New getCMPData API, to unlock activeVariant and publsihedApps properties.
  • [Flutter & React Native] Intraction Analytics tracking API is now available.
  • [Improvement] "Default" label value is now supported for consent history entries.
  • [Improvement] Enable support for Hidden Data Processing Services.
2.8.1 May 26, 2023
  • [Fix] onConsentUpdated event was not triggered after initialization.
  • [Fix] Solved issue with Boolean values being sent via consent mediation to Adjust
  • [Fix] Solved Apple TV labels being cut off
  • [Fix] Solved Android TV issue when showing TCF on 2nd layer.
2.8.0 May 08, 2023
  • [Feature] Add support to US Legal Frameworks.
  • [Deprecate] Remove deprecated method showFirstLayer(layout: Layout)
2.7.16 April 17, 2023
  • [Feature] Supporting Limited Fields in Service Descriptions.
  • [Improvement] Accessibility in First and Second Layer.
  • [Improvement] Custom UI objects are getting the latest values.
  • [Fix] General issues.
2.7.15 March 23, 2023
  • [Fix] General issues.
  • [Fix] Switches were showing the wrong value on iOS when pressing too many times repeatedly.
2.7.14 March 03, 2023
  • [Fix] Issue when toggles were showing on second layer even though they were disabled.
  • [Fix] Issue where the first time the app was initialized using the method getTCString, the TCString comes out empty.
  • [Fix] Issue where DPSs accepted by default did not appear as accepted when opening second layer.
2.7.13 February 22, 2023
  • [Feature] Expose PUR enabling properties
  • [Improvement] Extend handling of edge case exceptions.
  • [Improvement] UI updates to CCPA banner variant.
  • [Fix] Issue with third party SDKs being included in POM file.
2.7.12 February 07, 2023
  • [Consent Mediation] Add support for Adjust and Crashlytics.
  • [Consent Mediation] Add support for Custom DPSs.
  • Stability improvements and bug fixes.
2.7.10 January 16, 2023
  • [Improvement] TCF 2.2 Performance upgrades when storing TCString.
  • Stability improvements and bug fixes.
2.7.9 December 21, 2022
  • [Accessibility] Our Second Layer Banner now meets accessibility standards.
  • [Feature] Android's disable system back button property is exposed on GeneralStyleSettings.
  • [Feature] Adding support for "More Information link" option from our Configuration Dashboard.
  • [Improvements] Upgrades to TCF String encoding.
  • Stability improvements and bug fixes.
2.7.8 December 07, 2022
  • [Accessibility] First Layer Banner now meets accessibility standards.
  • Stability improvements and bug fixes.
2.7.7 December 02, 2022
  • [Feature] Enable banner layout options from the Configuration Dashboard. This feature is only for "App Advanced" Configurations. Please contact your CSM if you would like to get access to this feature.
  • [Improvement] Kotlin version has been upgraded to 1.8.0-Beta
  • [Improvement] Upgrade app cycle triggers to support latest updates from Operating Systems.
  • [Fix] Issues with CCPA toggle initial value.
  • Stability improvements and bug fixes.
2.7.6 November 18, 2022
  • [Feature] Support for TCF Resurface options.
  • Stability improvements and bug fixes.
2.7.5 October 26, 2022
  • [Unity] You can now build your own IAB TCF 2.2 Banner with our Data Source & Action Delegate API.
  • [Improvements] Major upgrades to main thread use.
  • [Improvements] Enable support for Swift UI.
  • [Fix] NPE crash happening in edge cases on Android.
2.7.4 October 10, 2022
  • [A/B Testing] With this release, you will now be able to create your own A/B Testing when showing the banner to your users. Check our exclusive page on how to achieve this.
  • [Improvement] Support dynamic colors on iOS.
  • Stability improvements and bug fixes.
2.7.3 September 20, 2022
  • [Improvement] Major performance upgrades on loading times.
2.7.2 August 31, 2022
  • [Feature] Enable option to show "Continue without accepting" button on First Layer.
  • [Feature] It is now possible to customize Legal Links via our Programmatic API.
  • [Improvement] Upgrade Error logs to help you debug the SDK's behaviour better.
  • [Fix] Issue where shouldCollectConsent property was always true for TCF 2.2 variant.
2.7.1 August 19, 2022
  • [Restore User Session] With this release, you will now be able to restore user sessions when using a TCF configuration. This feature however, needs to be enabled and approved. Please contact your Customer Success Manager for more information.
  • [Improvement] API upgrades to increase performance and storage space usage.
  • [Improvement] Updates to TCF 2.2 logic, for custom use cases.
  • [Improvement] Handle "NullPointerException" and unknown origin crashes.
  • [Fix] Issue where SDK was overwriting theme to always be "light" for Dark Mode implementation on iOS.
2.7.0 August 01, 2022
  • [Dark Mode] Enable Dark Mode and advance banner customizations with our updated Customization API.
  • [Consent Mediation] Automatically apply consent to 3rd party SDKs with our Consent Mediation feature.
  • [Fix] UI threading issue on React Native.
2.6.1 June 28, 2022
  • [Unity] Enable EU Proxy.
  • [Unity] Expose USPData for CCPA compliance.
  • [Feature] Added additional customization options for TCF 2.2 banner.
  • [Improvement] UI upgrades to history section.
  • [Fix] Thread freeze issue for edge case initialization flow.
  • Stability improvements and bug fixes.
2.6.0 June 09, 2022
  • [Geolocation Rules] You can now initialize the SDK with a RuleSetID to automatically address different regulations based on user location.
  • [Custom UI] Since we display some fields using HTML, we are now exposing them using Spanned (Android) and NSMutableAttributedString.
  • [Analytics] When building your own UI, you can now integate with our Interaction Analytics API to get all your consent insights.
  • Stability improvements and bug fixes.
2.5.3 May 20, 2022
  • [Fix] Issues when parsing TCF String
  • Stability improvements and bug fixes.
2.5.2 May 16, 2022
  • [Fix] TCF String issue when signalling legitimate interests
2.5.1 May 12, 2022
  • [Fix] TCF String issue with encoding to shorten the length of the string
2.5.0 May 04, 2022
  • [Analytics] If you are using Custom UI, now you can track events using our Track API
  • [Custom UI] Since we display some fields using HTML, we are now exposing them using Spanned (Android) and NSMutableAttributedString.
  • [Improvement] Controller ID section was redesigned to have a better UX.
  • Stability improvements and bug fixes.
2.4.0 April 19, 2022
  • [Customization] You now have full control over the appearance of the First & Second Layer via our Admin Interface Style options and our Programmatic API. We have updated and extended our Programmatic API to simplify banner customization.
  • [UI] Legal links are now added to our the First Layer, and can be hidden or shown as desired via programmatic API.
  • [Feature] Consent button can now be customized via the Configuration Dashboard for the CCPA variant.
  • [Improvement] Initialization flow for stability and avoid edge case crashes.
  • Stability improvements and bug fixes.
2.3.2 April 07, 2022
  • [TV CMP] Our consent banner is now optimized for tvOS and AndroidTV. See more TV
  • [Feature] You may now customize your call to actions: Accept, Deny, Save Buttons independently for First & Second Layer.
  • [Fix] Issue with Deny button not being hidden is now fixed.
2.3.1 March 25, 2022
  • [API] getTCString has been deprecated in favor of getTCFData. This method returns all necessarily data to be consumed related to TCF 2.2 framework.
  • [API] getTCFData is now async to provide accurate results when actions are still pending to be reflected.
  • [Improvement] Required updates for TCF 2.0 framework.
  • [Fix] Issue when showing TCF without any vendors.
  • UI improvements and bug fixes.
2.3.0 February 21, 2022
  • [API] shouldShowCMP has been deprecated in favor of shouldCollectConsent. See Initializing the SDK
  • [Banner API] Banner API v1 is now discontinued and removed from the SDK. ⚠️ If you don't wish to upgrade, please stick to v2.1.0 to avoid unexpected behaviour. See the alert in the "Banner API V1" tab
  • [Banner API] showCloseButton is now a required field for showSecondLayer(). See Presenting the Second Layer
  • [Banner API] BannerSettings now requires a BannerFont object to pass a Bold and Regular font separately to apply for both layers. See Banner Settings
  • [Banner API] UINavigationController has been deprecated in favor of UIViewController as HostView on iOS. See Presenting the Banner
  • [Cross-Platform] React Native and Flutter SDKs are now updated to also support Banner API v2.
  • [Demo App] You can now find a demo app in our documentation to test out your configuration before writing a single line of code. See Sample Apps.
  • [Improvement] Updates to TCF 2.0 framework.
  • [Fix] Issue with position of logo on Second Layer.
  • Stability improvements and bug fixes.
2.2.1 February 08, 2022
  • [Landscape Mode] We are now supporting Landscape Mode.
  • [React Native] Add min React and React Native version to README.
  • [Feature] You can now add a "More Information" link to your banner message to forward users to the 2nd Layer. Appearance > Settings > More Information Link in Banner Message. Then you will be able to add this link in the banner message text editor.
  • [Improvement] Adding support to actively inform users when vendors are sharing data outside a region on TCF 2.0 variant.
  • [Improvement] Upgrade API to facilitate compliance with new Banner API for CCPA variant.
  • [Improvement] Updated Sample Apps to new Banner API. See Sample Apps.
  • [Fix] Issue with local and remote images losing quality on iOS.
  • Stability improvements and bug fixes.
2.2.0 January 28, 2022
  • [Banner API] A complete revamp of our banner API will enable you to have high customisation and versatility to build a end-user friendly consent banner. We can't wait for you to give it a try. For more details, see: Presenting the Banner. ⚠ If you don't wish to upgrade, please stick to v2.1.0 to avoid unexpected behaviour. See the alert in the "Banner API V1" tab
    • Now supporting all legal frameworks we support: GDPR, LGPD, CCPA, TCF 2.0 and many others.
    • Add a Header Image to your banner.
    • Have full control over the layour of your action buttons with Column, Row or Grid configurations.
    • Launch the second layer directly.
  • [Usability] Collect consent only at a category level. Option available in your Admin Interface: Configure > Legal Specifications > Settings > Category Consent.
  • [Feature] "Continue wthout Accepting" feature is now supported for CNIL (French regulation)
  • [Fonts] Configuration Dashboard fonts are now deprecated for App. To enable custom fonts, please inject the font via banner API.
  • [API] Expose user's consent history.
  • [Improvement] Upgrade to API 31 on Android.
  • [Improvement] Upgrade to Kotlin 1.6.10 on Android.
  • [Fix] Issues with v2.0.3 not working with Swift Package Manager on iOS.
  • [Fix] Issue with edge case with RestoreUserSession failing.
  • [Fix] Crashes happening in Beta release of our new Banner API.
  • UI/UX improvements and bug fixes.
2.1.0 December 14, 2021
  • [Beta] New Banner API to enable high customisation and end-user friendly consent banners. See: Presenting the Banner.
  • [Improvement] API section is now available in our documentation to give you more transparency on our SDK.
  • [Improvement] Expose additional properties to build your own you.
  • [Fix] Legitimate interest issue with Purpose Restrictions on TCF 2.0.
  • [Fix] Crashes happening in specific cases with very poor network connections on Android.
2.0.3 November 09, 2021
  • [Fix] Minor issues on UI related to consent toggles.
  • [Fix] Failing to render corner radius on iOS.
2.0.2 November 02, 2021
  • [Improvement] Small upgrades to Usercentrics UI user experience.
  • Stability improvements and bug fixes.
2.0.1 October 06, 2021
  • [Feature] You may now add Accept or Deny action links to the banner description and short description of your Banner.
  • [Improvement] We have now provided a unique method, that can store consent for IAB Vendors and non-IAB vendors at once on our TCF 2.0 variant.
  • [Improvement] As required by the IAB, we have included the latest updates to the TCF 2.0 framework.
  • [Fix] Crash happening when toggles are hidden and changes are done to TCF 2.0 Second Layer
  • UI/UX improvements and bug fixes.
2.0.0 September 21, 2021
  • [API] We have listened to your feedback, and revamped our SDK API to make it easier to integrate and maintain.
  • [Analytics] We are now offering a new level of Analytics, which give you insight of your user interactions with our CMP. This feature is only enabled for Beta Testers. Please contact your Customer Success Manager to request access.
  • [Apple Silicon] With our latest dependency updates, we can now support M1 MacBooks for development.
  • [Improvement] We have optimised the use of resources and added offline capabilities to provide a lightning fast API.
  • [Improvement] We have upgraded the level of debug logs, to provide more transparency and clear error descriptions.
  • [Improvement] As required by the IAB, we have included the latest updates to the TCF 2.0 framework.
  • [Improvement] We have upgraded our language picker to provide a more native experience.
  • [Improvement] Our Android SDK is now available on Maven Central.

Released Betas

The following table lists the Beta features that are currently available:

Beta Disclaimer

These features are currently considered experimental. Please make sure you validate the functionality before pushing to production.

Feature Minimum Version Description
A/B Testing 2.7.4 Test different versions of your Banner simultaneously to optimize user interaction and opt-in rates. This feature works both with a Usercentrics provided solution or with any third party A/B Testing tool.
Consent Mediation 2.7.0 To simplify the process of applying consent, we are adding a mediation feature, that is aware of the Consent API of selected SDKs, and will automatically apply/update consent as soon as it is captured.