Android SDK

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}

dependencies {
    implementation("com.github.AppAgentic:apprefer-android-sdk:0.4.1")
}

import androidx.appcompat.app.AppCompatActivity
import androidx.lifecycle.lifecycleScope
import com.apprefer.sdk.AppRefer
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        lifecycleScope.launch {
            val attribution = AppRefer.configure(
                context = this@MainActivity,
                apiKey = "pk_live_your_key_here",
                debug = BuildConfig.DEBUG,
            )

            if (attribution != null) {
                Log.i("AppRefer", "Network: ${attribution.network}")
                Log.i("AppRefer", "Match type: ${attribution.matchType}")
            }
        }
    }
}

import com.apprefer.sdk.AppRefer;
import com.apprefer.sdk.AppReferCallback;
import com.apprefer.sdk.models.Attribution;

AppRefer.configure(
    this,
    "pk_live_your_key_here",
    /* userId */ null,
    /* debug */ false,
    /* logLevel */ 1,
    new AppReferCallback<Attribution>() {
        @Override public void onResult(Attribution attribution) {
            // handle attribution (nullable)
        }
        @Override public void onError(Throwable error) {
            // Won't normally fire — the SDK swallows failures by design.
        }
    }
);

lifecycleScope.launch {
    AppRefer.trackEvent(
        eventName = "tutorial_complete",
        properties = mapOf("level" to 3, "time_spent" to 42),
    )

    // With revenue
    AppRefer.trackEvent(
        eventName = "purchase",
        revenue = 9.99,
        currency = "USD",
    )
}

lifecycleScope.launch {
    AppRefer.setAdvancedMatching(
        email = "user@example.com",
        phone = "+15551234567",
        firstName = "Jane",
        lastName = "Doe",
    )
}

lifecycleScope.launch {
    val attribution = AppRefer.configure(context, apiKey = "pk_live_...")

    // REQUIRED: link AppRefer device ID to RevenueCat
    AppRefer.getDeviceId()?.let { deviceId ->
        Purchases.sharedInstance.setAttributes(mapOf("appreferId" to deviceId))
    }

    // Optional: mirror RevenueCat user ID back to AppRefer
    AppRefer.setUserId(Purchases.sharedInstance.appUserID)
}

import androidx.appcompat.app.AppCompatActivity
import androidx.lifecycle.lifecycleScope
import com.apprefer.sdk.AppRefer
import com.revenuecat.purchases.Purchases
import kotlinx.coroutines.launch

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Configure RevenueCat
        Purchases.configure(PurchasesConfiguration.Builder(this, "rc_public_key").build())

        lifecycleScope.launch {
            // 1. Initialize AppRefer and resolve attribution
            val attribution = AppRefer.configure(
                context = this@MainActivity,
                apiKey = "pk_live_your_key_here",
            )
            Log.i("AppRefer", "Network: ${attribution?.network ?: "organic"}")

            // 2. CRITICAL: link AppRefer device ID to RevenueCat
            //    Without this, purchases CANNOT be attributed to ad campaigns.
            AppRefer.getDeviceId()?.let { deviceId ->
                Purchases.sharedInstance.setAttributes(
                    mapOf("appreferId" to deviceId)
                )
            }

            // 3. Mirror the RevenueCat user ID back to AppRefer
            AppRefer.setUserId(Purchases.sharedInstance.appUserID)
        }
    }

    // Later, after the user signs up...
    fun onUserSignup(email: String, firstName: String) {
        lifecycleScope.launch {
            // 4. Advanced matching (hashed on-device)
            AppRefer.setAdvancedMatching(email = email, firstName = firstName)

            // 5. Track the signup event
            AppRefer.trackEvent("signup")
        }
    }
}