Migration Guide: v1.9.x to v1.10.x

This guide covers migrating from Permutive Android SDK v1.9.x to v1.10.x, which introduces contextual cohorts, Dagger dependency injection, and several improvements.

Migration Difficulty: Very Easy | Estimated Time: 15 minutes | Breaking Changes: None

What’s New in v1.10.0

Contextual Cohorts

Content-based segmentation for real-time targeting

Dagger Integration

Internal dependency injection framework (v2.53.1)

Google Ads 2.2.0

Automatic contextual cohort targeting for GAM

AppNexus 1.7.0

Automatic contextual cohort targeting for Xandr

Good news: This release is fully backward compatible with no breaking changes or deprecations.

Migration Steps

Update Dependencies

Update your build.gradle.kts or build.gradle:

Before (v1.9.x)
After (v1.10.0)

dependencies {
    implementation("com.permutive.android:core:1.9.8")
    implementation("com.permutive.android:google-ads:2.1.0")
    implementation("com.permutive.android:appnexus:1.6.1")
}

dependencies {
    implementation("com.permutive.android:core:1.10.0")
    implementation("com.permutive.android:google-ads:2.2.0")  // For GAM contextual
    implementation("com.permutive.android:appnexus:1.7.0")   // For Xandr contextual
}

Sync and Rebuild

./gradlew clean build

Test Your Integration

Your existing code will continue to work without changes. Test to ensure:

Events are still being tracked
Cohorts are being received
Ad targeting is working

Using New Features

Contextual Cohorts

Contextual cohorts are automatically enabled if your workspace has the feature activated. No code changes required!

Accessing Contextual Cohorts

val activations = permutive.currentActivations

// Get Google Ad Manager contextual cohorts
val gamContextual = activations["dfp_contextual"].orEmpty()

// Get Xandr contextual cohorts
val xandrContextual = activations["appnexus_adserver_contextual"].orEmpty()

Automatic Ad Integration

If you’re using our add-on libraries, contextual cohorts are automatically included:Google Ad Manager:

// Contextual cohorts automatically added with key "prmtvctx"
val adRequest = AdManagerAdRequest.Builder()
    .addPermutiveTargeting(permutive)
    .build()

Xandr/AppNexus:

// Contextual cohorts automatically added
adView.addPermutiveTargeting(permutive)

See the Contextual Data Guide for full documentation.

Dagger Integration

v1.10.0 introduces Dagger for internal dependency management. This is an internal implementation detail.

No action required. Dagger is used internally by the SDK and doesn’t require any changes to your code.

Resolving Dagger Conflicts

If your app also uses Dagger and you experience conflicts:

Check your Dagger version matches or is compatible with v2.53.1
Don’t exclude Dagger from the Permutive SDK dependencies:

// Don't do this:
implementation("com.permutive.android:core:1.10.0") {
    exclude(group = "com.google.dagger")  // Will cause issues!
}

Testing Your Migration

1. Verify Events

Enable debug logging and verify events are still being tracked:

permutive.setDeveloperMode(true)

Look for:

D/Permutive: Published events with names (Pageview) (Accepted: 1 / 1)

2. Check Cohorts

Verify behavioral cohorts are still working:

val cohorts = permutive.currentCohorts
Log.d("Migration Test", "Cohorts: ${cohorts.size}")

3. Test Contextual (if enabled)

If contextual is enabled for your workspace:

// Track a page with URL
val pageTracker = permutive.trackPage(
    title = "Test Article",
    url = Uri.parse("https://example.com/test")
)

// Wait a moment for classification
Handler(Looper.getMainLooper()).postDelayed({
    val contextual = permutive.currentActivations["dfp_contextual"]
    Log.d("Migration Test", "Contextual cohorts: $contextual")
}, 2000)

4. Test Ad Integration

Verify ads are still loading with targeting:

val adRequest = AdManagerAdRequest.Builder()
    .addPermutiveTargeting(permutive)
    .build()

adView.loadAd(adRequest)

// Check logs for:
// D/Permutive: Permutive segments appended to Google Ad request: ...

Rollback

If you need to rollback to v1.9.x:

dependencies {
    implementation("com.permutive.android:core:1.9.8")
    implementation("com.permutive.android:google-ads:2.1.0")
    implementation("com.permutive.android:appnexus:1.6.1")
}

Then sync and rebuild.

Requirements

v1.10.0 maintains the same minimum requirements as v1.9.x:

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

Getting Help

Issues

Solutions to common issues

Contextual Data

Full contextual documentation

Google Ad Manager

GAM integration guide

Cohorts & Activations

Understanding segments

Get Started

Products

Deployment

Governance

Migration Guide: v1.9.x to v1.10.x

What’s New in v1.10.0

Contextual Cohorts

Dagger Integration

Google Ads 2.2.0

AppNexus 1.7.0

Migration Steps

Using New Features

Contextual Cohorts

Dagger Integration

Testing Your Migration

Rollback

Requirements

Getting Help

Issues

Contextual Data

Google Ad Manager

Cohorts & Activations

​What’s New in v1.10.0

Contextual Cohorts

Dagger Integration

Google Ads 2.2.0

AppNexus 1.7.0

​Migration Steps

​Using New Features

​Contextual Cohorts

​Dagger Integration

​Testing Your Migration

​Rollback

​Requirements

​Getting Help

Issues

Contextual Data

Google Ad Manager

Cohorts & Activations

What’s New in v1.10.0

Migration Steps

Using New Features

Contextual Cohorts

Dagger Integration

Testing Your Migration

Rollback

Requirements

Getting Help