Set up App Tracking Transparency

If you want to record the device’s ID for Advertisers (IDFA), you must display a prompt to get your user’s authorization. To do this, you need to include Apple’s App Tracking Transparency (ATT) framework in your app. The Adjust SDK stores the user’s authorization status and sends it to Adjust’s servers with each request.

Authorization statuses

ATT authorization wrapper

+ (void)requestAppTrackingAuthorizationWithCompletionHandler:(void (^_Nullable)(NSUInteger status))completion;

The Adjust SDK contains a wrapper around Apple’s requestTrackingAuthorizationWithCompletionHandler method. You can use this wrapper if you don’t want to customize the ATT prompt.

The callback method triggers when your user responds to the consent dialog. This method sends the user’s consent status code to Adjust’s servers. You can define responses to each status code within the callback function.

You must specify text content for the ATT. To do this, add your text to the NSUserTrackingUsageDescription key in your Info.plist file.

1
Adjust.requestAppTrackingAuthorization { status in
2
   switch status {
3
   case 0:
4
      // ATTrackingManagerAuthorizationStatusNotDetermined case
5
      break
6
   case 1:
7
      // ATTrackingManagerAuthorizationStatusRestricted case
8
      break
9
   case 2:
10
      // ATTrackingManagerAuthorizationStatusDenied case
11
      break
12
   case 3:
13
      // ATTrackingManagerAuthorizationStatusAuthorized case
14
      break
15
   default:
16
      break
17
   }
18
}

1
[Adjust requestAppTrackingAuthorizationWithCompletionHandler:^(NSUInteger status) {
2
   switch (status) {
3
      case 0:
4
         // ATTrackingManagerAuthorizationStatusNotDetermined case
5
         break;
6
      case 1:
7
         // ATTrackingManagerAuthorizationStatusRestricted case
8
         break;
9
      case 2:
10
         // ATTrackingManagerAuthorizationStatusDenied case
11
         break;
12
      case 3:
13
         // ATTrackingManagerAuthorizationStatusAuthorized case
14
         break;
15
   }
16
}];

Get current authorization status

+ (int)appTrackingAuthorizationStatus;

You can retrieve a user’s current authorization status at any time. Call the getAppTrackingAuthorizationStatus method to return the authorization status code as an integer.

1
let authorizationStatus = Adjust.appTrackingAuthorizationStatus();

1
int authorizationStatus = [Adjust appTrackingAuthorizationStatus];

Custom prompt timing

@property (nonatomic, assign) NSUInteger attConsentWaitingInterval;

If your app includes an onboarding process or a tutorial, you may want to delay sending your user’s ATT consent status until after the user has completed this process. To do this, you can set the attConsentWaitingInterval property to delay the sending of data for up to 360 seconds to give the user time to complete the initial onboarding. After the timeout ends or the user sets their consent status, the SDK sends all information it has recorded during the delay to Adjust’s servers along with the user’s consent status.

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
    appToken: yourAppToken,
    environment: environment)
//...
adjustConfig?.attConsentWaitingInterval = 30
//...
Adjust.initSdk(adjustConfig)

 ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
                                                        environment:environment];
//...
[adjustConfig setAttConsentWaitingInterval:30];
//...
[Adjust initSdk:adjustConfig];

iOS 17 consent handling

With the release of iOS 17, Apple implemented new rules on what data developers may send to third-parties. To ensure that developers can demonstrate compliance with Apple’s privacy guidelines, the Adjust SDK makes use of two separate endpoints for consenting and non-consenting users.

By default, the Adjust SDK sends a limited set of data to Adjust’s servers for probabilistic modeling using the analytics.adjust.com endpoint. This endpoint doesn’t receive the following information:

• idfa: The device ID For Advertisers (IDFA).
• started_at: The device startup time.

Only if the user grants ATT consent, the Adjust SDK gains access to both the idfa and started_at properties for deterministic attribution and sends the full payload to consent.adjust.com.

Both of these endpoints are available for all URL strategies.

Disable the usage of App Tracking Transparency

- (void)disableAppTrackingTransparencyUsage;

In case you want to disable Adjust SDK’s automatic interaction with AppTrackingTransparency.framework, call the disableAppTrackingTransparencyUsage method on your ADJConfig instance before SDK initialization.

let yourAppToken = "{YourAppToken}"
let environment = ADJEnvironmentSandbox
let adjustConfig = ADJConfig(
   appToken: yourAppToken,
   environment: environment)
adjustConfig?.disableAppTrackingTransparencyUsage()
Adjust.initSdk(adjustConfig)

NSString *yourAppToken = @"{YourAppToken}";
NSString *environment = ADJEnvironmentSandbox;
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:appToken
                                                  environment:environment];
[adjustConfig disableAppTrackingTransparencyUsage];
[Adjust initSdk:adjustConfig];

setupWebViewJavascriptBridge(function (bridge) {
   var yourAppToken = yourAppToken;
   var environment = AdjustConfig.EnvironmentSandbox;
   var adjustConfig = new AdjustConfig(yourAppToken, environment);
   adjustConfig.disableAppTrackingTransparencyUsage();
   Adjust.initSdk(adjustConfig);
});