Launch the ATT consent prompt

To gather a device’s ID for Advertisers (IDFA) on devices running iOS 14.5 and later, you need to display an App Tracking Transparency consent prompt. This prompt allows the user to set their tracking preference and either grant or deny access to their device’s IDFA. All users are opted-out of tracking by default and must grant access to their device's IDFA.

To get consent from your users, you need to do the following:

  1. Implement the ATT consent prompt - Required for iOS 14.5 and later.
  2. Use a pre-permission prompt - Optional, but highly recommended as this improves user opt-in rates.

You need to get consent from users only if the device’s ATT status is 0 ("Not Determined"). For more information about consent status, see Receive consent status in raw data exports.

Note:

You need to show the pre-permission prompt (if applicable) and the ATT consent prompt every time the user reinstalls the app. This is because Apple does not retain the user's consent status after the app is uninstalled.

Implement the ATT consent prompt

Tip:

Adjust recommends using the "Initialize the SDK and then launch the ATT pop-up" approach, where you initialize the Adjust SDK when your app first opens and promptly display the ATT pop-up afterwards. To ensure Adjust records the install with the device's IDFA, set up custom prompt timing to delay sending install information for up to 120 seconds. This gives your users time to respond to the pop-up and enables the Adjust SDK to receive the user's consent status.

All users must opt-in in order for you to be able to gather their IDFA. This includes existing users for whom you already have this information recorded. Adjust supports the following approaches to implementing the ATT pop-up:

Note:

The Adjust SDK reruns the attribution process if your app displays the ATT pop-up conditionally or at a later stage in the user's journey, such as after registration or on the second user session. If the attribution status is different, the SDK sends an updated attribution callback.

Use a pre-permission prompt

A pre-permission prompt gives your users context around why they will see the ATT consent prompt and encourages them to opt-in. Setting up a pre-permission prompt can help your app pass review and optimize your user opt-in rates.

Before you ask for users' consent, read this guide to learn about best practices for designing a prompt that encourages an opt-in.

Tip:

The pre-permission prompt should not act as a consent prompt on its own. Apple maintains that pre-prompts should enable users to make an informed decision. The prompt should not influence the action they take.