---
title: "Initialize the SDK"
slug: "mapp-intelligence-android-sdk-v5-initialize-sdk"
description: "Initialize the Mapp Intelligence Android SDK v5 in your Application class and create a reliable base setup for tracking."
updated: 2026-04-30T12:39:27Z
published: 2026-04-30T12:39:27Z
canonical: "docs.mapp.com/mapp-intelligence-android-sdk-v5-initialize-sdk"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Initialize the SDK

## What initialization means

Initialization is the step where you pass at least one Track ID and a valid Track Domain to `Webtrekk.getInstance().init(context, configuration)`. From this point on, the SDK is available to the rest of your app.

---

## Where initialization should happen

Initialize the SDK once during app startup:

- In your `Application` subclass's `onCreate()`.
- Register that `Application` subclass via the `android:name` attribute on the `<application>` element in `AndroidManifest.xml`.

> [!NOTE]
> This follows common Android startup practice for app-wide libraries: initialize them once in `Application.onCreate()`, not lazily from individual activities or fragments.

> [!WARNING]
> **Note:** The SDK targets Android phone and tablet apps. Wear OS and Android TV are not officially supported.

---

## Minimum required configuration

You must provide:

- at least one **Track ID**
- a valid **Track Domain** (HTTPS)

---

## Example

**Kotlin**

**Application subclass:**

```kotlin
import android.app.Application
import webtrekk.android.sdk.Webtrekk
import webtrekk.android.sdk.WebtrekkConfiguration

class SampleApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        val configuration = WebtrekkConfiguration.Builder(
            listOf("YOUR_TRACK_ID"),
            "https://your-trackdomain.com"
        ).build()

        Webtrekk.getInstance().init(this, configuration)
    }
}
```

**AndroidManifest.xml:**

```xml
<application
    android:name=".SampleApplication"
    ... >
    ...
</application>
```

**Java**

```java
import android.app.Application;
import java.util.Arrays;
import webtrekk.android.sdk.Webtrekk;
import webtrekk.android.sdk.WebtrekkConfiguration;

public class SampleApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        WebtrekkConfiguration configuration = new WebtrekkConfiguration.Builder(
            Arrays.asList("YOUR_TRACK_ID"),
            "https://your-trackdomain.com"
        ).build();

        Webtrekk.getInstance().init(this, configuration);
    }
}
```

---

## What to verify after initialization

- the app starts without errors
- your Track ID and Track Domain values are correct
- the Track Domain uses `https://`
- the initialization code runs exactly once during app startup
- your `Application` subclass is registered in `AndroidManifest.xml`

---

## What not to overload into this step

Keep initialization minimal. Logging, request interval, batch support, user matching, crash tracking, and other optional behavior should be set in [Configure Global Tracking](/v1/docs/mapp-intelligence-android-sdk-v5-configure-global-tracking).

---

## Next step

Once the SDK starts successfully, continue with [Configure Global Tracking](/v1/docs/mapp-intelligence-android-sdk-v5-configure-global-tracking).

> [!WARNING]
> If the SDK is not initialized correctly, later SDK calls can fail because the required configuration is missing.

---

## Related

- [Quickstart](/v1/docs/mapp-intelligence-android-sdk-v5-quickstart)
- [Add the SDK Dependency](/v1/docs/mapp-intelligence-android-sdk-v5-add-sdk-dependency)
- [Configure Global Tracking](/v1/docs/mapp-intelligence-android-sdk-v5-configure-global-tracking)
- [No Tracking Data Visible](/v1/docs/mapp-intelligence-android-sdk-v5-no-tracking-data-visible)

Track IDs are used to assign requests to an account. You find the track ID under *Mapp Q3 >**Configuration > System Configuration > Data Collection.* If the same information is to be recorded for multiple accounts, you can enter the corresponding Track IDs of the accounts comma-separated.

Specify your Mapp Intelligence track domain. This information is provided by your account manager.