Google UMP SDK

3.0.0

2025-03-24

• Breaking changes :
  • Updated the minimum supported Xcode version to 16.0.
  • Updated Swift API names to follow the naming conventions from Apple’s Swift API Design Guidelines .
  Version 2

  Version 3

  Classes

  UMPConsentForm

  ConsentForm

  UMPConsentInformation

  ConsentInformation

  UMPConsentStatus

  ConsentStatus

  UMPDebugGeography

  DebugGeography

  UMPDebugSettings

  DebugSettings

  UMPFormErrorCode

  FormErrorCode

  UMPFormStatus

  FormStatus

  UMPPrivacyOptionsRequirementStatus

  PrivacyOptionsRequirementStatus

  UMPRequestErrorCode

  RequestErrorCode

  UMPRequestParameters

  RequestParameters

  UMPVersionString

  Version

  Properties

  sharedInstance

  shared

  tagForUnderAgeOfConsent

  isTaggedForUnderAgeOfConsent
• Added internal functionality to call Firebase consent APIs when consent mode support is configured through Privacy & messaging .

2.7.0

2024-10-30

• To support testing with regulated US states, added the following options to UMPDebugGeography :
• UMPDebugGeographyRegulatedUSState
• UMPDebugGeographyOther
• Deprecated UMPDebugGeographyNotEEA . Use UMPDebugGeographyOther instead.

2.6.0

2024-09-05

• UIViewController references for consent messages are now nullable and not required. The SDK uses the app’s main window to look up view controllers automatically when one is not provided.

2.5.0

2024-06-26

• Updated canRequestAds API to return true when the app has no privacy messages configured.
• Updated nullability on -[UMPConsentForm init] from nullable to nonnull .

2.4.0

2024-04-24

• Updated the signing identity from AdMob Inc. to Google LLC using team ID EQHXZ8M8AV . If this triggers a notice in Xcode, select “Accept Change” to accept the new identity.

2.3.0

2024-03-14

• Added support for privacy manifest files .
• Updated the Info.plist to work around a Swift Package Manager issue on Xcode 15.3.

2.2.0

2024-02-20

• Increased minimum supported Xcode version to 15.1.
• Increased iOS minimum deployment target to 12.0.
• Removed all references to advertisingIdentifier .
• Added Info.plist files to make the SDK compatible with Xcode 15.3.
• Increased CocoaPods minimum version to 1.12.0.
• Removed bitcode from the binary.

2.1.0

2023-07-24

This release introduces several new APIs to simplify the consent gathering process. Adopting these new APIs is not required for existing integrations.

The minimum deployment target has been increased to iOS 11.0.

Updated minimum supported Xcode version to 14.1

• armv7 is not supported in Xcode 14 and has been removed from the SDK.

Calling requestConsentInfoUpdateWithParameters:completionHandler: is now required before interacting with other public APIs. Before calling it, the following are returned:

• UMPFormStatus returns UMPFormStatusUnknown
• UMPConsentStatus returns UMPConsentStatusUnknown
• UMPPrivacyOptionsRequirementStatus returns UMPPrivacyOptionsStatusUnknown
• UMPConsentInformation.shared.canRequestAds returns false

UMPConsentForm

• Added method +loadAndPresentIfRequiredFromViewController:completionHandler: to combine load and show calls. This method is intended for the use case of showing a form if needed when the app starts.
• Added method +presentPrivacyOptionsFormFromViewController:completionHandler: , to be called when users interact with your app's privacy setting.

UMPConsentInformation

• Added canRequestAds property.
• Added privacyOptionsRequirementStatus property to indicate whether privacy options are required to be shown in this session.

Resolved an issue where the form fails to present but the UMPConsentFormPresentCompletionHandler is never invoked.

2.0.1

2022-09-12

• Resolved an issue where forms intended to be single-use could still be reused.

2.0.0

2021-03-15

• Removed the UMPConsentType API. This API was unsupported.
• Removed the i386 slice.

1.4.0

2020-11-23

• Included an arm64 slice for simulators to support testing on Apple Silicon devices.
• Publishers must build this SDK version with Xcode 12.

1.3.0

2020-10-21

Updated the SDK from a .framework to a .xcframework.

1.2.0

2020-09-16

Updated Xcode version to build the SDK from 10.3 -> 11.0 .

1.1.0

2020-08-11

• Added support for iOS 14.
  • Added support for App Tracking Transparency . Messages requesting IDFA permissions from users can be configured on the Funding Choices UI .
  • Allowed UMPDebugSettings.testDeviceIdentifiers to accept a new identifier when IDFA is unavailable.
• Fixed a bug that would cause -[UMPConsentForm loadWithCompletionHandler:] to be called back twice if loading a form timed out.

1.0.0

2020-07-06

General Availability release.