Configuring App Tracking Transparency Prompts for Mobile Apps

OneTrust Mobile Prompts allow organizations to display a prompt to a user either before or after an iOS Permission dialogue is displayed in accordance with the App Tracking Transparency (ATT) framework. Market research shows that a Pre-Prompt designed to educate users prior to collecting iOS permissions leads to better opt-in results. Being transparent with users for the purposes you are collecting an iOS permission is a great way to build trust and brand credibility.

Watch our technical implementation webinar recording for here. For technical documentation to support this workshop, please reference the OneTrust SDK Portal.

App Tracking Transparency Prompts

OneTrust offers the following two types of prompt options for ATT purposes, which can be configured within the application:

Pre-Prompts

A Pre-Prompt is a notice to the user, presented before an iOS Permission dialogue has been shown or requested, intended to educate the user on the reasons for which the app is going to process their personal data. OneTrust allows organizations to customize the messaging, translations, and branding of this Pre-Prompt. If a user wishes to continue, the OneTrust Pre-Prompt will display the iOS permission dialogue to the user and their Yes/No selection for Allow Tracking will be logged in OneTrust for audit and reporting requirements.

Settings Prompts

A Settings Prompt is intended to educate and deep-link a user who has already Accepted/Rejected an iOS permission dialogue to the App's iOS settings for ATT. Once a user has made their selection with iOS, there is no way for the OneTrust SDK to update this consent setting on behalf of the user. They must update it themselves in iOS settings. Therefore, a Post-Prompt should be only used if a user has opted out of an iOS Permission, but now they wish to access part of the app that requires the iOS Permission to be toggled back On. Once a user updates their preference in iOS settings, the OneTrust SDK will check and log consent of the change to OneTrust for audit and reporting requirements.

To enable App Tracking Transparency Prompts for configuration

  1. On the Cookie Consent menu, select Templates. The Templates screen appears.

  2. Select a template. The Template Details screen appears.
    Note:

    For more information on creating templates, see Creating Mobile Templates.

  3. Enable the Mobile App Template setting in the right-hand pane. A confirmation modal will appear to permit configuration of Mobile App Templates.
    Note:

    This confirmation will only appear once for new templates which haven't yet been configured for mobile apps. The configuration options will be enabled by default.





  4. Click Mobile App from the Platform selector.


  5. Navigate to the Prompt tab.
  6. Click the Plus icon next to Design to open the platform design options.
  7. Select the App Tracking Transparency Prompt to expand the section.


  8. Enable the App Tracking Transparency Prompt setting. The Pre-Prompt and Settings Prompts edit options will appear.


  9. Manually enable the Settings Prompt in the same way to display the edit options.


To configure the Pre-prompt for App Tracking Transparency

  1. On the Cookie Consent menu, select Templates. The Templates screen appears.

  2. Select a template. The Template Details screen appears.
    Note:

    For more information on creating templates, see Creating Mobile Templates.

  3. Click Mobile App from the Platform selector.


  4. Navigate to the Prompt tab.
    Note:

    See To enable App Tracking Transparency Prompts for configuration to ensure that the prompt is enabled.

  5. Click the Edit icon next to Pre-Prompt. The Pre-Prompt preview screen appears.


  6. Configure the Pre-Prompt logo as needed. Any changes made will show to the right on the Preview screen.


    Field
    Description
    Show Logo

    Enable or disable this setting to show or hide the logo.

    Logo

    Click the Select File button to upload a logo image for the prompt.

    Title Text

    Enter text for the prompt title.

    Description Text

    Enter text the prompt body to describe the intent of the prompt.

    Continue Button Text

    Enter text for the Continue button. The default text is Continue.

  7. Click the Save and Close button once configuration is complete.

To configure the ATT Settings prompt

  1. On the Cookie Consent menu, select Templates. The Templates screen appears.

  2. Select a template. The Template Details screen appears.
    Note:

    For more information on creating templates, see Creating Mobile Templates.

  3. Click Mobile App from the Platform selector.


  4. Navigate to the Prompt tab.
    Note:

    See To enable App Tracking Transparency Prompts for configuration to ensure that the prompt is enabled.

  5. Click the Edit icon next to Settings Prompt. The App Tracking Transparency Prompt preview screen appears.


  6. Configure the Settings prompt as needed.


    Field
    Description
    Show Logo

    Enable or disable this setting to show or hide the logo.

    Logo

    Click the Select File button to upload a logo image for the prompt.

    Title Text

    Enter text for the prompt title.

    Description Text

    Enter text the prompt body to describe the intent of the prompt.

    Accept Button Text

    Enter text for the Accept button. The default text is Settings.

    Not Now Button Text

    Enter text for the Not Now button. The default text is Not Now.

  7. Click the Save and Close button once configuration is complete.

To link Categories & Purposes on ATT Prompts

You can link mobile templates enabled with the ATT framework with existing Categories & Purposes to collect user preferences based on their interaction with the ATT prompts.

For additional information on ATT and the possible mobile experiences, see App Tracking Transparency User Journey Configurations.

  1. On the Cookie Consent menu, select Templates. The Templates screen appears.

  2. Select a template. The Template Details screen appears.

  3. On the Details tab, enable the Mobile App Template setting in the right-hand pane. A confirmation modal will appear to permit configuration of Mobile App Templates.
  4. Navigate to the Prompt tab.
  5. Click the Plus icon next to Design to open the platform design options. This is available for either the Pre-Prompt or Settings Prompt.
  6. Expand the App Tracking Transparency Prompt dropdown, then enable the Enable App Tracking Transparency Prompt.


  7. Enable the Enable Link to Categories & Purposes setting. A confirmation modal will appear to also confirm that you wish to enable the Settings Prompt.


  8. Click the Confirm button to continue.


  9. Turn on the Enable Settings Prompt setting. A confirmation modal will appear with more information about the Settings prompt.
  10. Click the Confirm button to continue.


  11. Click the Edit icon next to the now exposed Categories & Purposes option.


  12. Select from the field the available Categories & Purposes you want to link for this template.


  13. Click the Save and Close button.
  14. Click the Save Template button. You will also need to republish your SDK to adopt the template's latest changes.