First session delay

The First Session Delay feature allows you to delay SDK initialization during the very first SDK session only. While in this delay mode, the Adjust SDK records all activity (such as installs and events) in memory, but does not transmit any data to Adjust servers.

This gives your app an opportunity to gather additional data that may not be available at launch and, if needed, modify the SDK configuration before any data is sent.

When and Why to Use First Session Delay

Use this feature if you need to:

• Set COPPA compliance for the user.
• Assign an external device ID.
• Show the App Tracking Transparency (ATT) dialog and act on the user’s response.

Enabling First Session Delay

To initialize the SDK in delayed mode, use the following setup:

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

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

After this, the SDK will be initialized in memory and will not process anything until you explicitly call:

1
Adjust.endFirstSessionDelay()

1
[Adjust endFirstSessionDelay];

Configuration changing while on delay

While the SDK is in first session delay mode, it is possible to change COPPA compliance, as if it were set in the config during initSdk.

To enable COPPA compliance:

1
Adjust.enableCoppaComplianceInDelay()

1
[Adjust enableCoppaComplianceInDelay];

To disable COPPA compliance:

1
Adjust.disableCoppaComplianceInDelay()

1
[Adjust disableCoppaComplianceInDelay];

While the SDK is in first session delay mode, it is possible to set the external device ID, as if it were configured during initSdk.

To set the external device ID:

1
Adjust.setExternalDeviceIdInDelay("YourExternalDeviceId")

1
[Adjust setExternalDeviceIdInDelay:@"YourExternalDeviceId"];