GoogleUserMessagingPlatform Framework Reference

AI-generated Key Takeaways

• UMPConsentInformation manages user consent status and related information within the User Messaging Platform (UMP) SDK.

• It provides access to consent status, form status, privacy options requirement status, and whether ads can be requested based on the gathered consent.

• The requestConsentInfoUpdateWithParameters:completionHandler: method must be called in every app session to refresh consent information before using it.

• Shared instance can be accessed through sharedInstance property and provides methods for resetting consent state and requesting updates.

• The SDK has methods for checking consent status and ensuring compliance with configured messages before requesting ads.

UMPConsentInformation

@interface UMPConsentInformation : NSObject

Consent information. All methods must be called on the main thread.

• sharedInstance

  The shared consent information instance.

  Declaration

  Swift

  class var shared: ConsentInformation { get }

  Objective-C

  @property (class, nonatomic, readonly, nonnull) UMPConsentInformation *sharedInstance;

• consentStatus

  The user’s consent status. This value defaults to UMPConsentStatusUnknown until requestConsentInfoUpdateWithParameters:completionHandler: is called, and defaults to the previous session’s value until |completionHandler| from requestConsentInfoUpdateWithParameters:completionHandler: is called.

  Declaration

  Swift

  var consentStatus: ConsentStatus { get }

  Objective-C

  @property (nonatomic, readonly) UMPConsentStatus consentStatus;

• canRequestAds

  Indicates whether the SDK has gathered consent aligned with the app’s configured messages. Returns NO until requestConsentInfoUpdateWithParameters:completionHandler: is called.

  Declaration

  Swift

  var canRequestAds: Bool { get }

  Objective-C

  @property (nonatomic, readonly) BOOL canRequestAds;

• formStatus

  Consent form status. This value defaults to UMPFormStatusUnknown and requires a call to requestConsentInfoUpdateWithParameters:completionHandler: to update.

  Declaration

  Swift

  var formStatus: FormStatus { get }

  Objective-C

  @property (nonatomic, readonly) UMPFormStatus formStatus;

• privacyOptionsRequirementStatus

  Privacy options requirement status. This value defaults to UMPPrivacyOptionsRequirementStatusUnknown until requestConsentInfoUpdateWithParameters:completionHandler: is called, and defaults to the previous session’s value until |completionHandler| from requestConsentInfoUpdateWithParameters:completionHandler: is called.

  Declaration

  Swift

  var privacyOptionsRequirementStatus: PrivacyOptionsRequirementStatus { get }

  Objective-C

  @property (nonatomic, readonly) UMPPrivacyOptionsRequirementStatus privacyOptionsRequirementStatus;

• -requestConsentInfoUpdateWithParameters:completionHandler:

  Requests consent information update. Must be called in every app session before checking the user’s consentStatus or loading a consent form. After calling this method, consentStatus will be updated synchronously to hold the consent state from the previous app session, if one exists. consentStatus may be updated again immediately before the completion handler is called.

  Declaration

  Swift

  func requestConsentInfoUpdate(with parameters: RequestParameters?) async throws

  Objective-C

  - (void)
      requestConsentInfoUpdateWithParameters:
          (nullable UMPRequestParameters *)parameters
                           completionHandler:
                               (nonnull
                                    UMPConsentInformationUpdateCompletionHandler)
                                   handler;

• -reset

  Clears all consent state from persistent storage.

  Declaration

  Swift

  func reset()

  Objective-C

  - (void)reset;