AppLovin MAX Mediation SDK (Android)

Overview

The Appier Mediation Adapter for AppLovin MAX enables seamless integration between Appier's ad solutions and the AppLovin MAX monetization platform. This guide provides step-by-step instructions to help you configure and implement the mediation adapter, ensuring optimal ad delivery and performance.

Before continuing, create an AppLovin account.

Supported ad formats

• Banner (320 x 50 dp)
• MREC (300 x 250 dp)
• Interstitial
• Native
  • Small Template
  • Medium Template
  • Manual

SDK version requirements

Refer to the table below to see the compatible versions of the Appier Ads and AppLovin MAX Mediation SDK.

1. Create an AppLovin MAX custom network and ad unit

Log in to the AppLovin console and complete the following:

1. Create a custom network
2. Create an ad unit

1. Create a custom network

1. Go to MAX > Meditation > Manage > Networks and add a custom network.

2. Configure the following network settings:
   1. Custom Network Name: "Appier"
   2. Android/Fire OS Adapter Class Name: :"com.appier.ads.applovin.AppierMediationAdapter"

2. Create an ad unit

1. Go to MAX > Meditation > Manage > Ad Units and click + Create Ad Unit.

2. Enter a name, set the platform to Android, and select the ad type you want to create.

3. If your app isn’t live yet, manually add it to MAX.

4. Enter your application's name or package name in the input box and select it from the dropdown menu that appears.

5. Under Custom Networks, you'll see "Custom Network (SDK)—Appier". This is the custom network you created earlier. Configure the following settings:
   1. Enable the Status toggle.
   2. App ID (Optional): Enter your app's package name.
   3. Placement ID: Enter the placement ID provided by Appier.
   4. CPM Price: This value determines how adapters are traversed in the waterfall.

2. Configure your Android project

Next, configure your Android project's settings.

1. Set your app's minSDKVersion.
2. Add dependencies.
3. (Recommended) Enable the GDRP consent prompt

1. Set your app's minSDKVersion

The Appier Ads SDK requires a minSDKVersion or 18 or later.

2. Add dependencies

1. Add the AppLovin MAX SDK and Appier Ads SDK to your Gradle file.

repositories {
  google()
  mavenCentral()
  ...
}
dependencies {
  implementation 'com.applovin:applovin-sdk:13.0.1'
  implementation 'com.appier:ads-android:2.1.0'
  ...
}

2. Add the following permissions to your app's manifest file.

<manifest ...>
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  <!--  Required for displaying floating window  -->
  <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
  <application
    ...
    android:networkSecurityConfig="@xml/network_security_config">
  </application>
</manifest>

3. In /resources, add xml/network_security_config.xml with the following configuration:

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <base-config cleartextTrafficPermitted="true" />
</network-security-config>

3. (Recommended) Enable the GDRP consent prompt

The Appier Ads SDK doesn't request permission to track data by default. To comply with GDPR regulations, we strongly recommend enabling the data collection prompt by calling Appier.setGDPRApplies(true).

This only needs to be done once, ideally at app launch and before initializing the Appier Ads SDK.

import com.appier.ads.Appier;
public class MainActivity extends AppCompatActivity {
  	@Override
    protected void onCreate(Bundle savedInstanceState) {
      	// ...
      	Appier.setGDPRApplies(true);
    }
}

4. Initialize the AppLovin Android SDK

Initialize the AppLovin SDK as shown below:

class MainActivity : Activity()
{
  override fun onCreate(savedInstanceState: Bundle?)
  {
    // Create the initialization configuration
    val initConfig = AppLovinSdkInitializationConfiguration.builder("<APPLOVIN_SDK_KEY>", this)
                     .setMediationProvider(AppLovinMediationProvider.MAX)
                     .build()

    // Initialize the SDK with the configuration
    AppLovinSdk.getInstance(this).initialize(initConfig) { sdkConfig ->
      // Start loading ads
    }
  }
}

👍

For detailed instructions on initializing the AppLovin SDK, see New SDK Initialization API.

3. Implement AppLovin MAX Ads

Follow the guides provided by AppLovin to implement different ad formats. Refer to the table below for features and ad types that aren't supported by the Appier Ads SDK.