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 23 or above.

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

Gradle

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

ProGuard rules

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

Enable ad review

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

Additions to root-level build.gradle file

Additions to app-level build.gradle file

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

Initialize the SDK

Create the SDK initialization configuration

Before you initialize the SDK, create an initialization configuration object for the SDK. This object allows you to configure the properties that the SDK will initialize with. These initialization properties are immutable, except AppLovinSdkSettings which contains mutable properties that can change during the lifetime of the app.

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

Initialize the SDK

Initialize the AppLovin SDK with the initialization configuration object as early as possible (for example, in the onCreate() of the launch activity or Application class). This maximizes how much time the SDK has to cache mediated networks’ ads, which results in a better user experience.

Example

Below is a sample integration:

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.