Android (Kotlin)

Maven Central

// app/build.gradle.kts
dependencies {
    implementation("sh.postback:sdk:2.0.1")
}

Sync Gradle after adding the dependency. The SDK already declares INTERNET, ACCESS_NETWORK_STATE, and com.google.android.gms.permission.AD_ID, so you do not need to add them to your manifest.

Published on Maven Central. Always use the latest version.

import sh.postback.sdk.Postback
import sh.postback.sdk.PostbackConfig

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

        Postback.shared(applicationContext).configure(
            PostbackConfig(apiKey = "pb_android_live_xxxxx")
        )
    }
}

Non-blocking. configure() returns immediately; install registration and device-info collection run off the main thread on the SDK's executor. The lifecycle observer is registered automatically.

// Standard event
val postback = Postback.shared(applicationContext)
postback.sendEvent(PostbackEventType.LOGIN)

// Revenue event. Currency must be exactly three ASCII letters.
postback.sendEvent(
    PostbackEventType.PURCHASE,
    params = mapOf("revenue" to 9.99, "currency" to "USD")
)

// Custom event with parameters
postback.sendEvent(
    PostbackEventType.CUSTOM,
    name = "level_complete",
    params = mapOf("level" to 5, "score" to 1200)
)

• Custom events require a trimmed, non-empty name of 1-255 UTF-16 code units with no U+0000 character. Invalid custom events are not queued.
• For standard event types, an invalid optional name is omitted and the event is still queued.
• Currency must be exactly three ASCII letters. Lowercase values are normalized to uppercase; an invalid currency field is omitted and the event is still queued.

Once install registration completes, the SDK caches the attribution result from the install response. Native iOS and Android expose synchronous getters; React Native and Flutter bridge calls are asynchronous.

val attr = postback.getAttribution()
println(attr?.source)         // "apple_ads", "tracking_link", or "organic"
println(attr?.isAttributed)   // Boolean
println(attr?.campaignName)   // Campaign name when available
println(attr?.link?.name)

Send a test event to confirm end-to-end delivery. You should see it in the Postback dashboard within seconds.

val result = postback.sendTestEvent()
println("${result.success} — ${result.message}")