requestTrackingAuthorization(completionHandler:)

Presents a modal UI that asks someone for permission to access data that your app can use to track a person or device.

Declaration

class func requestTrackingAuthorization(completionHandler completion: @escaping  @Sendable (ATTrackingManager.AuthorizationStatus) -> Void)

class func requestTrackingAuthorization() async -> ATTrackingManager.AuthorizationStatus

Discussion

This method requests authorization to access app-related data that the app can use to track the person or the device. In France, Germany, Italy, Poland, and Romania, the system presents a full-page sheet; otherwise, the system prompts the person with an alert.

Handle the person’s response

When the person answers the prompt, the system calls the completion handler with a status object (ATTrackingManager.AuthorizationStatus) set to ATTrackingManager.AuthorizationStatus.authorized or ATTrackingManager.AuthorizationStatus.denied, depending on the person’s response.

The status is ATTrackingManager.AuthorizationStatus.notDetermined if the system dismisses the prompt without a decision from the person; in this scenario, your app needs to call the method again to receive an authorization answer from the person.

In some cases, the system doesn’t display the prompt and instead runs your completion handler immediately. The system doesn’t prompt the person when:

Tracking is restricted for the device; in this case, the trackingAuthorizationStatus is ATTrackingManager.AuthorizationStatus.restricted regardless of whether the system has shown the person the prompt.
The person disables “Allow Apps to Request to Track” (called “Allow Apps to Request to Link Your Activity Across Companies” in the European Union) in Settings > Privacy & Security > Tracking.
An existing permission request is pending.
Your code invokes this method through an app extension.
The app’s state is a value other than UIApplicationStateActive.

Prompt again after a year

In the European Union, if a person answers the prompt, the system notes the date and doesn’t allow the prompt to display again until a year passes. You can make an additional request after a year whether the person approves or denies your app’s previous tracking request, unless the person disables tracking in Settings > Privacy & Security > Tracking.

Configure the app’s target properties

To use this method, add the NSUserTrackingUsageDescription key to your app’s target properties in Xcode.

In France, Germany, Italy, Poland, and Romania, the full-page sheet displays the NSUserTrackingMarkdownUsageDescription string with support for rich-text elements if you include it in your app’s target configuration in Xcode.