Android SDK

The Clippr Android SDK provides deep linking and mobile attribution for native Android apps built with Kotlin or Java.

Features

  • App Link handling
  • Deferred deep linking (attribution after install)
  • Deterministic matching via Install Referrer (100% accuracy)
  • Probabilistic matching via device fingerprinting
  • Event and revenue tracking
  • Programmatic short link creation
  • Kotlin coroutines and Java callback APIs
  • Debug mode for development

Requirements

  • Android API 21+ (Android 5.0 Lollipop)
  • Kotlin 1.9+ or Java 8+
  • Gradle 8.0+

Quick Start

kotlin 
import xyz.useclippr.sdk.Clippr
import xyz.useclippr.sdk.models.ClipprLink

// Initialize in Application class
class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Clippr.initialize(
            context = this,
            apiKey = "YOUR_API_KEY",
            debug = BuildConfig.DEBUG
        )
    }
}

// Handle deep links in Activity
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Handle App Link that opened this activity
        Clippr.handle(intent)

        // Get initial link (direct or deferred)
        lifecycleScope.launch {
            Clippr.getInitialLink()?.let { link ->
                handleDeepLink(link)
            }
        }

        // Listen for runtime links
        Clippr.onLink = { link ->
            handleDeepLink(link)
        }
    }

    private fun handleDeepLink(link: ClipprLink) {
        Log.d("Clippr", "Path: ${link.path}")
        Log.d("Clippr", "Campaign: ${link.attribution?.campaign}")
    }
}

Documentation

Installation

Add the SDK via Maven or JitPack

Quick Start

Get up and running in 5 minutes

App Links

Configure Android App Links

Handling Links

Handle deep links in your app

Creating Links

Create short links programmatically

Event Tracking

Track events and revenue

API Reference

Complete API documentation

Java Support

The SDK is fully compatible with Java:

java 
import xyz.useclippr.sdk.Clippr;

// Initialize
Clippr.initialize(context, "YOUR_API_KEY", true);

// Get initial link
Clippr.getInitialLink(link -> {
    if (link != null) {
        Log.d("Clippr", "Path: " + link.getPath());
    }
});

// Listen for links
Clippr.setOnLink(link -> {
    handleDeepLink(link);
});

Source Code

The Android SDK is open source and available on GitHub:

github.com/nexlabstudio/clippr-android-sdk

Support