Page Summary
-
Version 3.2.0 adds internal functionality to call Firebase consent APIs when consent mode is configured through Privacy & messaging.
-
Version 3.1.0 includes new options for
ConsentDebugSettings.DebugGeographyto support testing with regulated US states and deprecatesDEBUG_GEOGRAPHY_NOT_EEA. -
Version 3.0.0 increased the minimum Android API level to 21, updated
canRequestAdsbehavior, improved privacy message rendering, fixed a bug with edge-to-edge content, and is the official release for ads personalization controls. -
Version 2.2.0 removed all use of Advertising ID and automatically recognizes emulators as test devices for UMP forms.
-
Version 2.1.0 introduced several new APIs to simplify the consent gathering process, made calling
requestConsentInfoUpdate()required, addedcanRequestAds()andloadAndShowConsentFormIfRequired()helper methods, and introduced Privacy Options functionality.
- Added
setConsentSyncId()API to sync a user's consent across apps configured for consent syncing. - Increased the minimum Android API level to 23.
- Added internal functionality to call Firebase consent APIs when consent mode support is configured through Privacy & messaging .
- To support testing with regulated US states, added the following options to
ConsentDebugSettings.DebugGeography: -
DEBUG_GEOGRAPHY_REGULATED_US_STATE -
DEBUG_GEOGRAPHY_REGULATED_OTHER - Deprecated
DEBUG_GEOGRAPHY_NOT_EEA. UseDEBUG_GEOGRAPHY_OTHERinstead.
- Increased the minimum Android API level to 21.
- Updated
canRequestAdsto returntruewhen the app has no privacy messages configured. - Improved privacy message rendering behavior during orientation changes.
- Fixed a bug where privacy messages did not cover the full screen for apps displaying edge-to-edge content.
- Official release version for the ads personalization controls message.
- Removed all use of Advertising ID.
- Emulators are now automatically recognized as test devices when testing UMP forms.
This release introduces several new APIs to simplify the consent gathering process. Adopting these new APIs is not required for existing integrations.
- Calling
requestConsentInfoUpdate()is now required before interacting with other public APIs. Before calling it, the following are returned:-
ConsentStatusreturnsConsentStatus.UNKNOWN -
PrivacyOptionsRequirementStatusreturnsPrivacyOptionsRequirementStatus.UNKNOWN -
ConsentInformation.canRequestAdsreturnsfalse
-
- Added a helper method
canRequestAds(). - Added a static method
UserMessagingPlatform.loadAndShowConsentFormIfRequired()to combine load and show calls. This method is intended for the use case of showing a form if needed when the app starts. - Privacy Options
- Added
getPrivacyOptionsRequirementStatus()to indicate whether privacy options are required to be shown in this session. - Added a static method
showPrivacyOptionsForm()to be called when users interact with your app's privacy setting. - Enabled hardware acceleration on the consent form's window to improve performance of the consent form in game engines such as Unity.
- Removed the
ConsentInformation.ConsentTypeIntDef and theConsentInformation.getConsentType()method.
- General Audience release of the Google UMP SDK.

