Skip to main content
The Android SDK is comprised of the core SDK, and optional add-on libraries integrating with other 3rd party SDKs.

​
Requirements

RequirementVersion
Android API21+ (Android 5.0 Lollipop)
Compile SDK34+
Java8+ (JVM target 1.8)
Kotlin1.6+ (if using Kotlin)
You’ll also need your Workspace ID and API Key from your Permutive dashboard.

​
Latest Versions

PackageVersion
Core1.11.2
Google Ads2.2.0
AppNexus1.7.0
For API documentation, see the Javadocs.

​
Installation

1

Add the Repository

Ensure you have Maven Central in your project’s settings.gradle.kts:
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
2

Add Dependencies

Add the Permutive SDK to your app module’s build.gradle.kts or build.gradle:
dependencies {
    // Core SDK (required)
    implementation("com.permutive.android:core:1.11.2")

    // Optional add-ons
    implementation("com.permutive.android:google-ads:2.2.0")  // Google Ad Manager
    implementation("com.permutive.android:appnexus:1.7.0")    // Xandr / AppNexus
}
3

Sync Gradle

Sync your project with Gradle files to download the dependencies.

​
Optional Add-Ons

​
Version Compatibility

​
Android API Levels

SDK VersionMinimum Android APITarget Android API
1.11.221 (Android 5.0)34 (Android 14)
1.10.x21 (Android 5.0)34 (Android 14)
1.8.0 - 1.9.x21 (Android 5.0)34 (Android 14)
1.7.x and below16 (Android 4.1)33 (Android 13)

​
Add-On Compatibility

Add-OnMinimum Core VersionNotes
google-ads 2.2.01.10.0Contextual cohorts support
google-ads 2.1.01.8.0Minimum API 23 required
appnexus 1.7.01.10.0Contextual cohorts support
appnexus 1.6.x1.8.0+Compatible with older core versions

​
ProGuard / R8

If you’re using code minification, the SDK includes consumer ProGuard rules automatically. No additional configuration is required.

​
Troubleshooting

Cause: Maven Central repository not configured.Solution: Add Maven Central to your settings.gradle.kts:
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
Cause: Multiple SDK versions in dependencies.Solution: Force version resolution:
configurations.all {
    resolutionStrategy {
        force("com.permutive.android:core:1.11.2")
        force("com.permutive.android:google-ads:2.2.0")
    }
}
Check dependencies with: ./gradlew app:dependencies
Cause: Minification removing SDK classes.Solution: The SDK includes consumer ProGuard rules automatically. If issues persist, contact support.

​
Next Steps

Initialize the SDK

Set up Permutive in your Application class

Quick Start Guide

Track your first page view

Verification

Verify your integration is working

Issues

Solutions to common issues