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.
• Indicate that the user falls under the Play Store’s “Designed for Families” (kids) category.
• Assign an external device ID.

Enabling First Session Delay

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

val appToken = "{YourAppToken}"
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
val config = AdjustConfig(this, appToken, environment)
config.enableFirstSessionDelay()
// ...
Adjust.initSdk(config)

String appToken = "{YourAppToken}";
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
AdjustConfig config = new AdjustConfig(this, appToken, environment);
config.enableFirstSessionDelay();
// ...
Adjust.initSdk(config);

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}");

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

To enable Play Store kids compliance:

1
Adjust.enablePlayStoreKidsComplianceInDelay()

1
Adjust.enablePlayStoreKidsComplianceInDelay();

To disable Play Store kids compliance:

1
Adjust.disablePlayStoreKidsComplianceInDelay()

1
Adjust.disablePlayStoreKidsComplianceInDelay();