Integration

This page shows you how to download, import, and configure the AppLovin MAX SDK.

Download the Latest SDK

You can download the SDK through Gradle as a dependency. If you prefer to integrate manually, follow the instructions here.

The SDK requires the minSdkVersion to be 16 or above.

To receive release updates, subscribe to the AppLovin-MAX-SDK-Android GitHub repository.

Gradle

Add the following to your app-level build.gradle file:

Groovy

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation 'com.applovin:applovin-sdk:+'
  ⋮
}

Kotlin

repositories {
  google()
  mavenCentral()
  ⋮
}
dependencies {
  implementation("com.applovin:applovin-sdk:+")
  ⋮
}

ProGuard Rules

If you use ProGuard, note that the AppLovin MAX SDK and adapters come bundled with the required ProGuard rules in the AARs. Therefore, you do not need to add any additional ProGuard rules to your project.

Note

The SDK collects the Google Advertising ID. This requires the Android Advertising ID (AAID) module (com.google.android.gms:play-services-ads-identifier). See Google Play services dependencies.

Add the SDK Key

Add the following <meta-data> element to your AndroidManifest.xml. Place it inside the <application> element:

<meta-data android:name="applovin.sdk.key" android:value="«sdk-key»"/>

You can find your SDK key in the Account > General > Keys section of the AppLovin dashboard.

Enable Ad Review

See also

“How to Build Superior User Experience with MAX’s Ad Review” from AppLovin’s Blog.

To enable the MAX Ad Review service, add the following to your build.gradle files:

Additions to Root-Level build.gradle File

Groovy

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

Kotlin

buildscript {
  repositories {
    maven { url = uri("https://artifacts.applovin.com/android") }
  }
  dependencies {
    classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+")
  }
}

Additions to App-Level build.gradle File

Groovy

apply plugin: 'applovin-quality-service'
applovin {
  apiKey "«ad-review-key»"
}

Kotlin

plugins {
  id("applovin-quality-service")
}
applovin {
  apiKey = "«ad-review-key»"
}

You can find your Ad Review Key in the Account > General > Keys section of the AppLovin dashboard.

Initialize the SDK

Caution

This method of initializing the SDK is deprecated. See New SDK Initialization API to learn how to initialize the SDK in versions 12.4.0 and higher.

Initialize the SDK by calling the initializeSdk() method. Pass that method a context. Do this as soon as possible after your app starts, for example in the onCreate() method of your launch Activity.

Ad assets that are fully cached result in a better user experience. For this reason, always initialize the AppLovin SDK on startup. This gives mediated networks the maximum amount of time to cache ads. This is especially important with video ads.

Java

public class MainActivity extends Activity
{
  protected void onCreate(Bundle savedInstanceState)
  {
    // Make sure to set the mediation provider value to "max" to ensure proper functionality
    AppLovinSdk.getInstance( context ).setMediationProvider( "max" );
    AppLovinSdk.initializeSdk( context, new AppLovinSdk.SdkInitializationListener() {
      @Override
      public void onSdkInitialized(final AppLovinSdkConfiguration configuration)
      {
        // AppLovin SDK is initialized, start loading ads
      }
    } );
  }
}

Kotlin

class MainActivity : Activity()
{
  override fun onCreate(savedInstanceState: Bundle?)
  {
    // Make sure to set the mediation provider value to "max" to ensure proper functionality
    AppLovinSdk.getInstance( context ).setMediationProvider( "max" )
    AppLovinSdk.getInstance( context ).initializeSdk({ configuration: AppLovinSdkConfiguration ->
      // AppLovin SDK is initialized, start loading ads
    })
  }
}