Documentation

Support

Unity LevelPlay

Get started with LevelPlay

SDK integration

LevelPlay platform

Unity LevelPlay

iOS permission pop-up

Implement a pre-permission pop-up to improve the likelihood of receiving tracking authorization from your app users.
Read time 1 minuteLast updated 6 hours ago
The pre permission pop-up is used to improve the likelihood of receiving tracking authorization from your app users. It is designed to appear before your app calls Apple's App Tracking Transparency (ATT) prompt, and provides a soft-launch to Apple's ATT prompt to help you to optimize your users permissions opt-in. ironSource's pre permission pop-up should be used before triggering Apple's ATT prompt. This will help convey to your users the value of app tracking prior to their decision to consent to the opt-in process.

When to display the pop up

Call the pre permission pop-up when the user's authorization status is NotDetermined and after the SDK is initialized. We recommend you display the pop-up only to iOS14+ users.
  • The text is fixed, and cannot be changed
  • The popup should precede Apple's ATT prompt requestTrackingAuthorizationWithCompletionHandler and should not prevent the display of the ATT prompt itself
  • We recommend you explain your implementation of the ATT process in your app's Review Notes, emphasizing that the ATT prompt request is not dependent on the pre pop-up display
  • If you use any other regulation prompts (such as GDPR or COPPA), you should make sure that the text in the permission pop-up is aligned with the text in any other prompts in your app

Enable the permission pop-up API and postbacks

  1. Check that you've integrated ironSource SDK 7.0.4+
  2. Register to ConsentView delegates
  3. Add the pop-up APIs and postbacks

Step 1: Integrate ironSource SDK

Integrate ironSource SDK 7.0.4+: iOS | Unity, 1.0.0+: Flutter | React Native

Step 2: Register to ConsentView delegates

The ironSource SDK fires postbacks to inform you about the pop-up status and user's response to it. This is done via registration to the ConsentView postbacks, and should be set before initializing the ironSource SDK. 
[IronSource setConsentViewWithDelegate:self];
After you register to the listener, you'll be able to receive notifications upon the following events. Make sure to use “pre” as consentViewType for all your APIs and Callbacks when displaying the ironSource pre permission pop-up.

Load and Display statuses

// Consent View was loaded successfully
- (void)consentViewDidLoadSuccess:(NSString *)consentViewType;

// Consent view was failed to load
- (void)consentViewDidFailToLoadWithError:(NSError *)error consentViewType:(NSString *)consentViewType;

// Consent view was displayed successfully
- (void)consentViewDidShowSuccess:(NSString *)consentViewType;

// Consent view was not displayed, due to error
- (void)consentViewDidFailToShowWithError:(NSError *)error consentViewType:(NSString *)consentViewType;

User's actions

These postbacks will be received after the user selects one of the CTA buttons. Define the relevant course of action for each pop-up you implement within your app. 
// The user pressed the Settings or Next buttons
- (void)consentViewDidAccept:(NSString *)consentViewType;
Example: 
// The user pressed the Settings or Next buttons
ironSource.consentViewDidAccept:@"pre";

Step 3: Add the pop-up APIs and postbacks

To display the ironSource permission pop-up, follow the steps below. Make sure to load the pop-up only after the initialization process is completed.
  1. Load the pop-up using the API method loadCosnetView with the relevant type.
[IronSource loadConsentViewWithType:@"pre"];
  1. After the pop-up is loaded, you can show it using the API method showConsentView. Check your user's authorization status to optimize the process.
[IronSource showConsentViewWithViewController:self andType:@"pre"];