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

Capture custom events using the PostHog SDK:

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

Android product analytics installation

Install the dependency

Configure PostHog

Send events

Community questions

Was this page useful?