Android Product Analytics installation

Install with the wizard

Run this command in your project directory to add PostHog to your Android project. The wizard detects your framework, installs the SDK, and sets up your first events.

Learn more

Or set it up manually by following the rest of this guide.

Install the dependency

Required

Add the PostHog Android SDK to your build.gradle dependencies:

build.gradle
dependencies {
    implementation("com.posthog:posthog-android:3.+")
}

Configure PostHog

Required

Initialize PostHog in your Application class:

SampleApp.kt
class SampleApp : Application() {

    companion object {
        const val POSTHOG_PROJECT_TOKEN = "<ph_project_token>"
        const val POSTHOG_HOST = "https://us.i.posthog.com"
    }

    override fun onCreate() {
        super.onCreate()

        // Create a PostHog Config with the given project token and host
        val config = PostHogAndroidConfig(
            apiKey = POSTHOG_PROJECT_TOKEN,
            host = POSTHOG_HOST
        )

        // Setup PostHog with the given Context and Config
        PostHogAndroid.setup(this, config)
    }
}

Send events

Recommended

Once installed, PostHog will automatically start capturing events. You can also manually send events to test your integration:

Kotlin
import com.posthog.PostHog

PostHog.capture(
    event = "button_clicked",
    properties = mapOf(
        "button_name" to "signup"
    )
)

Next steps