AppLovin MAX Android Adapter

 

MAX_StackedLogo_Black.jpeg

 

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

NOTES:
  • 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 Start.io Account

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

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

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

 Integrate the Start.io AppLovin Android Mediation Adapter (Beta)

Configure Start.io 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"
    Click_gere_to_add_a_Custom_Network.png

  4. On the "Manage Network" page:

    1. select SDK as the Network Type

    2. Set Custom Network Name to:

      Start.io
      
    3. Set iOS Adapter Class Name to:

      StartioAppLovinAdapter
      
    4. Set Android/Fire OS Adapter Class Name: "
      com.applovin.mediation.adapters.StartAppMediationAdapter
    5. Tap Save
      Screenshot_2022-03-07_at_13.32.36.png
      Start creating your Ad Units.

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

Once Expanded:

  1. Change Status to enabled

  2. IMPORTANT:

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

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

      Screenshot_2022-03-07_at_13.38.28.png

  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 Start.io mediation adapter for AppLovin MAX

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

    Build an example app

    You must put AppLovin SDK Key into local.propertiesbefore build

    applovin.sdk.key=

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

    applovin.ad.banner=
    applovin.ad.mrec=
    applovin.ad.native.small=
    applovin.ad.native.medium=
    applovin.ad.native.manual=
    applovin.ad.interstitial=
    applovin.ad.rewarded=
    applovin.test.devices=

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

    applovin.test.devices=

    Testing

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

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

    StartAppSDK.setTestAdsEnabled(true);
Was this article helpful?
Have more questions? submit a request