AppLovin MAX Android Adapter




This guide is directed to Publishers interested in integrating the (Formerly StartApp) Android SDK using AppLovin as the mediating network.

  • Feel free to take a look at our Sample Project to help you during the integration process.
  • The code samples in this document can be copy/pasted into your source code
  • If you have any questions, contact us here.

Prerequisite for adapter integration:

AppLovin is set as your mediation network

The following manual takes under assumption that you are already familiar with the AppLovin Mediation Network and have already integrated the AppLovin Android SDK into your application with at least one Ad Unit. Otherwise, please start by reading the following articles for a walk-through explanation of what mediation is, how to use the AppLovin Mediation UI, and instructions on how to add AppLovin mediation code into your app.

Your application is defined in your Account

At this point we assume that you have already added your application to your (Formerly StartApp) account. In case you haven't, please follow the steps:

  1. Login into your Publisher's account
  2. Add your application and get its App IDv

For any questions or difficulties during this process, please contact us here.

 Integrate the AppLovin Android Mediation Adapter (Beta)

Configure on your Mediation Settings

  1. Login into your AppLovin account
  2. On the left menu expand "MAX->Mediation->Networks"Screenshot_2022-03-07_at_13.23.16.png

  3. Scroll down and select "Click here to add a Custom Network"

  4. On the "Manage Network" page:

    1. select SDK as the Network Type

    2. Set Custom Network Name to:
    3. Set iOS Adapter Class Name to:

    4. Set Android/Fire OS Adapter Class Name: "
    5. Tap Save
      Start creating your Ad Units.

Navigate to Mediation -> Manage -> Ad Units, select the Ad Unit to which you would like to add 
Now in the Ad Unit waterfall you should see "Custom Network (SDK) -" under "Custom Networks & Deals" section. 

Once Expanded:

  1. Change Status to enabled


    1. Setingt your AppID in corresponding field is mandatory for custom adapter

    2. You will have to use the same AppID as provided by the for all Ad Units related to the same App.


  3. Advanced configuration of Ad Units

    You can pass the following non mandatory plain JSON string into the field Custom Parameters for advanced configuration (note that you can also leave it as "default" if advanced configurations are not needed):

        "adTag": "string", // Can be used to pass the Line Item ID or a meaningfull string of your choosing
        "interstitialMode": "string", // one of "overlay", "video", "offerwall"
        "minCPM": "number",
        "is3DBanner": "boolean", // applicable only for banner 320x50
        "nativeImageSize": "string", // one of "72x72", "100x100", "150x150", "340x340", "1200x628"
        "nativeSecondaryImageSize": "string" // one of "72x72", "100x100", "150x150", "340x340", "1200x628"

    Setup project

    Add dependency on mediation adapter for AppLovin MAX

    dependencies {
        // noinspection GradleDependency
        implementation 'com.startapp:applovin-mediation:1.+'

    Build an example app

    You must put AppLovin SDK Key into local.propertiesbefore build


    You should put an appropriate Ad Unit ID into in order to test specific placement

    You should put comma-separated list of advertising IDs into in order to receive test ads



    Important: currently mediation doesn't work with test mode.

    You can force to display the test ad by adding the following line somewhere in your code:

Was this article helpful?
Have more questions? submit a request