Installation

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

Requirements

Requirement	Version
Android API	21+ (Android 5.0 Lollipop)
Compile SDK	34+
Java	8+ (JVM target 1.8)
Kotlin	1.6+ (if using Kotlin)

You’ll also need your Workspace ID and API Key from your Permutive dashboard.

Latest Versions

Package	Version
Core	1.12.1
Google Ads	2.2.0
AppNexus	1.7.0

For API documentation, see the Javadocs.

Add the Repository

Ensure you have Maven Central in your project’s settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}

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.12.1")

    // 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
}

dependencies {
    // Core SDK (required)
    implementation "com.permutive.android:core:1.12.1"

    // 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
}

Sync Gradle

Sync your project with Gradle files to download the dependencies.

Optional Add-Ons

Google Ads
Xandr/AppNexus

The Google Ads add-on provides:

Automatic AAID (Android Advertising ID) identification
Helper methods for Google Ad Manager targeting
Automatic contextual cohort integration (v2.2.0+)

implementation("com.permutive.android:google-ads:2.2.0")

Requirements:

Google Play Services Ads dependency (included transitively)
AD_ID permission for Android API 31+

Google Ad Manager Integration

Learn how to integrate with Google Ad Manager

The AppNexus add-on provides:

Helper methods for Xandr/AppNexus ad targeting
Automatic impression tracking
Automatic contextual cohort integration (v1.7.0+)

implementation("com.permutive.android:appnexus:1.7.0")

Requirements:

Xandr SDK dependency (must be added separately)

Xandr Integration

Learn how to integrate with Xandr/AppNexus

Version Compatibility

Android API Levels

SDK Version	Minimum Android API	Target Android API
1.11.x	21 (Android 5.0)	34 (Android 14)
1.10.x	21 (Android 5.0)	34 (Android 14)
1.8.0 - 1.9.x	21 (Android 5.0)	34 (Android 14)
1.7.x and below	16 (Android 4.1)	33 (Android 13)

Add-On Compatibility

Add-On	Minimum Core Version	Notes
google-ads 2.2.0	1.10.0	Contextual cohorts support
google-ads 2.1.0	1.8.0	Minimum API 23 required
appnexus 1.7.0	1.10.0	Contextual cohorts support
appnexus 1.6.x	1.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

Gradle cannot find the Permutive SDK

Cause: Maven Central repository not configured.Solution: Add Maven Central to your settings.gradle.kts:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}

Duplicate class errors

Cause: Multiple SDK versions in dependencies.Solution: Force version resolution:

configurations.all {
    resolutionStrategy {
        force("com.permutive.android:core:1.12.1")
        force("com.permutive.android:google-ads:2.2.0")
    }
}

Check dependencies with: ./gradlew app:dependencies

ProGuard/R8 stripping required classes

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

Get Started

Products

Deployment

Governance

Installation

Requirements

Latest Versions

Installation

Optional Add-Ons

Google Ad Manager Integration

Xandr Integration

Version Compatibility

Android API Levels

Add-On Compatibility

ProGuard / R8

Troubleshooting

Next Steps

Initialize the SDK

Quick Start Guide

Verification

Issues

​Requirements

​Latest Versions

​Installation

​Optional Add-Ons

Google Ad Manager Integration

Xandr Integration

​Version Compatibility

​Android API Levels

​Add-On Compatibility

​ProGuard / R8

​Troubleshooting

​Next Steps

Initialize the SDK

Quick Start Guide

Verification

Issues

Requirements

Latest Versions

Installation

Optional Add-Ons

Version Compatibility

Android API Levels

Add-On Compatibility

ProGuard / R8

Troubleshooting

Next Steps