Skip to main content

Set up the Kotzilla SDK

This section will guide you through the configuration of the Kotzilla SDK in the NowInAndroid app example.

Step 1 - Register your application on the platform​

1.1 Register your application using the IDE Plugin​

  • Sign in to the Koin IDE Plugin
  • Open the Application Issues tab in the Issues Panel
  • Click the New App button

This will open the Register Your Application wizard in your browser

1.2 Define your application details​

  • Application Name: Enter “NowInAndroid”
  • Android Package Name: Use “com.google.samples.apps.nowinandroid.demo.debug”
  • App type: Select the default “Debug” value
note

If you choose "Production," you’ll also need to provide the corresponding mapping file for your release build.*

Now that the NowInAndroid app is registered, we will proceed to set up the Kotzilla SDK.

info

You can also register new apps directly from the Kotzilla Console: Go to the Kotzilla Console and log in to your account. On the homepage, click Register Your Application.

Step 2 Set up the Kotzilla SDK​

2.1 Create a Kotzilla project configuration File​

Download the Kotzilla.json file that has been automatically generated. This is the configuration file of your project.

info

Add the Kotzilla.json file into the app-level module of your Android Studio project (nowinandroid/app directory)

Module (app-level) Gradle file ( <project>/<app-module> )

note

If you want to use the Version Catalog configuration, please skip section 2.2 below and follow this guide instead.

2.2 Update Gradle files​

note

Kotzilla SDK is available on both Maven Central and the Kotzilla public repository. More information on how to configure access to the Kotzilla repository is available here

info

In your project root folder, add the plugin and Kotzilla SDK to the build.gradle.kts: Project (root-level) Gradle file (NowInAndroid/build.gradle.kts):

buildscript {
    repositories { ... }
    dependencies {
        // This part to copy paste
        classpath("io.kotzilla:kotzilla-plugin:1.0.1")
    }
}
info

In your app module add the plugin and Kotzilla SDK dependency to the build.gradle.kts file within the module directory:

Module (app-level) Gradle file (NowInAndroid/app/build.gradle.kts):

// --- Plugins ---
plugins {
  // Add the Kotzilla Gradle plugin
  id("io.kotzilla.kotzilla-plugin")
}

// --- Dependencies ---
dependencies {
  // The Kotzilla SDK library dependency
  implementation("io.kotzilla:kotzilla-sdk:1.0.1")
}

2.3 Sync your project​

Once installed, sync your NowInAndroid project with the updated Gradle files to apply the changes.

Step 3. Start the Kotzilla SDK in your NowInAndroid App​

In your Application class:

  • Start the Kotzilla SDK using analytics() during Koin initialisation
import io.kotzilla.sdk.analytics.koin.analytics
class NiaApplication : Application() {
	
    override fun onCreate() {
    super.onCreate()

        startKoin {
            androidContext(this@NiaApplication)

            // Kotzilla SDK setup for Android apps
            analytics()
            ...
        }
    }
}

Step 4. Verify the Kotzilla SDK configuration​

Now that the SDK is configured, you can build and run the NowInAndroid app to start capturing data from a first user session.

Once you've stopped the app:

  • Click Check your data to confirm everything is being collected correctly.
  • Then click Go to Dashboard to view your app’s performance and configuration insights.