Disable or enable the SDK
By default, the Adtrace SDK runs when your app is open. You can disable and re-enable the SDK to pause and resume recording. When the SDK is disabled, it does not send any data to Adtrace servers.
Important
You can only call setEnabled after the first session. This setting persists between sessions. If you disable the SDK, it stays disabled until you enable it again.
Unlike offline mode, disabling the SDK stops tracking completely. No data is recorded while the SDK is disabled.
| Disable SDK | Offline mode | |
|---|---|---|
| Data recording | Stops completely | Continues locally |
| Network sends | Suspended | Suspended |
| Persists between sessions | Yes, stays disabled until re-enabled | No, starts online each launch |
| When re-enabled | Does not replay disabled period | Sends queued data with correct timestamps |
Method signature
public static void setEnabled(boolean enabled)
| Parameter | Type | Description |
|---|---|---|
enabled | boolean | Set true to enable the SDK. Set false to disable the SDK. |
Disable the SDK
Call setEnabled(false) on AdTrace to stop tracking on the current device.
- Java
- Kotlin
- Javascript
AdTrace.setEnabled(false);
AdTrace.setEnabled(false)
AdTrace.setEnabled(false);
Enable the SDK
Call setEnabled(true) to resume tracking.
- Java
- Kotlin
- Javascript
AdTrace.setEnabled(true);
AdTrace.setEnabled(true)
AdTrace.setEnabled(true);
Check if the SDK is enabled
Call isEnabled to see whether the SDK is currently enabled.
Method signature
public static boolean isEnabled()
Example
- Java
- Kotlin
- Javascript
boolean enabled = AdTrace.isEnabled();
val enabled = AdTrace.isEnabled()
let enabled = AdTrace.isEnabled();