Android product analytics installation

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_API_KEY = "<ph_project_api_key>"
        const val POSTHOG_HOST = "https://us.i.posthog.com"
    }

    override fun onCreate() {
        super.onCreate()

        // Create a PostHog Config with the given API key and host
        val config = PostHogAndroidConfig(
            apiKey = POSTHOG_API_KEY,
            host = POSTHOG_HOST
        )

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

Send events

Optional

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

By default, for backwards compatibility reasons, events are sent with person profile processing enabled. This means a person profile will be created for each user who triggers an event.

If you want to disable person profile processing for certain events, send the event with the following property:

Kotlin
"$process_person_profile": false

Next steps

Recommended

Resource	Description
Capturing events	Learn how to capture custom events beyond autocapture
Identifying users	Associate events with specific users
Creating insights	Build trends, funnels, and retention charts
Group analytics	Track events at the company or account level