Get Started with Android

Before You Begin 🔗

• Sign up for a Chartboost Mediation account.
• Add apps to the Mediation platform. (See Import Apps)
• Set up Ad Placements in the Mediation platform. (See Manage Placements)
• Review our Android sample app.
• Set up the Chartboost Core SDK.

Current SDK version: 5.0.0
↗ Open Source
↗ SDK API Reference

Minimum Supported Development Tools 🔗

Chartboost Core Android SDK is required for Chartboost Mediation 5.x+ initialization and is designed to manage and facilitate different modules for your Android application/game. Each module can be individually initialized with metrics collected and reported to offer detailed insights into the module’s performance and potential issues.

For more information, review our Chartboost Core SDK documentation.

Gradle 🔗

Add the Chartboost Core SDK and the Chartboost Mediation SDK to your build.gradle.

repositories {
    maven {
      name "Chartboost Mediation's maven repo"
      url "https://cboost.jfrog.io/artifactory/chartboost-mediation"
    }
    maven {
      name "Chartboost Core's maven repo"
      url "https://cboost.jfrog.io/artifactory/chartboost-core"
    }
}
dependencies {
    implementation("com.chartboost:chartboost-mediation-sdk:5.0.0")
}
}

Add 3rd-Party Dependencies 🔗

implementation("androidx.lifecycle:lifecycle-common:2.6.2")
implementation("androidx.lifecycle:lifecycle-extensions:2.2.0")
implementation("com.jakewharton.retrofit:retrofit2-kotlinx-serialization-converter:1.0.0")
implementation("org.jetbrains.kotlin:kotlin-reflect:1.8.10")
implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.9.21")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1")
implementation("com.squareup.okhttp3:logging-interceptor:4.11.0")
implementation("com.squareup.okhttp3:okhttp:4.11.0")
implementation("com.squareup.retrofit2:converter-scalars:2.9.0")
implementation("com.squareup.retrofit2:retrofit:2.9.0")

Add Google Play Services 🔗

Add the Google Play Services Library as a dependency of your project. For detailed instructions, reference the official integration instructions for Google Play Services.

Instead of referencing the entire Google Play Services package, you only need play-services-base, play-services-ads-identifier, and play-services-appset:

implementation 'com.google.android.gms:play-services-base:18.1.0'
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
implementation 'com.google.android.gms:play-services-appset:16.0.2'

OPTIONAL: Mediation Android Sample App 🔗

The Chartboost Mediation Demo App is available on our public GitHub repo.