> ## Documentation Index
> Fetch the complete documentation index at: https://docs.permutive.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Android SDK
> Integrate Permutive into your Android application for user segmentation, personalization, and ad targeting
export const SDKKeyConcepts = () =>
- **Cohorts**: All segments a user belongs to
- **Activations**: Cohorts configured for specific ad platforms
- **Behavioral**: Based on user history (e.g., "sports enthusiast")
- **Contextual**: Based on current content (e.g., viewing sports article right now)
Multiple identifiers (email, user ID, ad ID) linked to single user profile for cross-device tracking.
;
## Overview
The Permutive Android SDK enables user segmentation, personalization, and ad targeting in your Android application. Track user behavior, manage identities across devices, and deliver targeted advertising through integrations with major ad platforms.
## Getting Started
New to the Permutive Android SDK? Start here.
Get up and running with your first page view in minutes
Detailed installation and dependency setup
SDK initialization patterns and configuration
Verify your integration is working correctly
## Core Concepts
Understand the fundamental concepts of the Permutive SDK.
Track users across devices and sessions
Structure and validate event data
Understanding user segmentation
Content-based real-time targeting
## Features
Detailed guides for specific SDK features.
Track pageviews and user engagement (recommended approach)
Track custom events
Track video content viewing
Track video advertisement engagement
React to cohort changes in real-time
## Integrations
Connect Permutive with ad platforms and other services.
Google Ad Manager, Xandr, and more
Automatic advertising ID tracking
## Common Tasks
**PageTracker is the recommended approach** for tracking user interactions as it integrates with Permutive's standard events and provides richer insights.
```kotlin theme={"dark"}
class ArticleActivity : AppCompatActivity() {
private lateinit var pageTracker: PageTracker
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
pageTracker = permutive.trackPage(
title = "Article Title",
url = Uri.parse("https://example.com/article"),
eventProperties = EventProperties.from(
"category" to "sports",
"author" to "John Doe"
)
)
}
override fun onPause() {
super.onPause()
pageTracker.pause()
}
override fun onResume() {
super.onResume()
pageTracker.resume()
}
override fun onDestroy() {
super.onDestroy()
pageTracker.close()
}
}
```
```kotlin theme={"dark"}
val emailHash = hashEmail(userEmail)
permutive.setIdentity(
listOf(
Alias.create("email_sha256", emailHash, priority = 0),
Alias.create("internal_id", userId, priority = 1)
)
)
```
```kotlin theme={"dark"}
val trigger = triggersProvider.triggerAction("premium_user") { isInCohort ->
if (isInCohort) {
showPremiumFeatures()
}
}
// Don't forget to close!
override fun onDestroy() {
super.onDestroy()
trigger.close()
}
```
```kotlin theme={"dark"}
val adRequest = AdManagerAdRequest.Builder()
.addPermutiveTargeting(permutive)
.build()
adView.loadAd(adRequest)
```
## 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) |
```kotlin theme={"dark"}
dependencies {
// Core SDK (required)
implementation("com.permutive.android:core:1.11.3")
// Optional add-ons
implementation("com.permutive.android:google-ads:2.2.0")
implementation("com.permutive.android:appnexus:1.7.0")
}
```
## Key Concepts
## Additional Resources
Best practices, patterns, and how-tos.
* **[Migration: v1.9.x to v1.10.x](/sdks/mobile/android/guides/migration/v1-9-to-v1-10)** - Upgrade to the latest version
**Coming Soon:** Architecture Patterns, Testing Strategies, GDPR Compliance, and Performance Optimization guides are being developed.
API documentation and technical reference.
* **[Javadocs](https://sdk-docs.permutive.com/)** - Complete API documentation
* **[Sample Apps](https://github.com/permutive/android-sdk-samples)** - Example integrations
**Coming Soon:** Changelog, Minimum Versions, and Event Schema reference documentation.
## FAQ
**PageTracker** is the recommended approach for most use cases. It automatically tracks Pageview events, measures engagement time and scroll depth, and enables contextual cohorts when URLs are provided.
**EventTracker** is for specialized cases where you need to track custom events that don't fit the page model.
Enable developer mode in your code:
```kotlin theme={"dark"}
permutive.setDeveloperMode(true)
```
Or via ADB:
```bash theme={"dark"}
adb shell setprop log.tag.Permutive VERBOSE
adb logcat -s Permutive
```
Use hashed emails (SHA-256), internal user IDs, or mobile advertising IDs. Never send plain text PII. See the [Identity Management](/sdks/mobile/android/core-concepts/identity-management) guide for details.
Events typically appear within 5 minutes. If you see "Accepted: 1 / 1" in your debug logs, the event was successfully sent.
## Getting Help
* **[Troubleshooting Guide](/sdks/mobile/android/troubleshooting/common-errors)** - Solutions to common issues
* **Customer Success Manager (CSM)** - For enabling features and exploring use cases
* **[Technical Services](mailto:technical-services@permutive.com)** - For technical setup and configuration
* **[Support](mailto:support@permutive.com)** - For troubleshooting and help
## Privacy & Compliance
Permutive is designed with privacy in mind: GDPR compliant, CCPA compliant, no PII storage, user consent respected, and transparent data usage.