AppLovin Integration Guide

This guide will instruct you step-by-step on how to set AppLovin live as an Ad Network on Unity LevelPlay.

Step 1. Create an AppLovin Account

1. Create an account with AppLovin. You can do so here.
2. Once your account has been verified you can login at their partner login here.

Step 2. Retrieve Your AppLovin SDK and Report Keys

There are 2 pieces of data from the AppLovin account which need to be inserted into your ironSource Network Setup Module in order for AppLovin to work correctly in connection with ironSource:

• Report Key: This is a unique identifier for your AppLovin account, which allows Unity LevelPlay to import performance data from your AppLovin account to use in reporting & optimization.
• SDK Key: This is a unique identifier for your AppLovin account. This is used by the ironSource Mediation SDK to Init the AppLovin Adapter for your apps.

Once you obtain this information, you must configure the AppLovin parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of AppLovin’s ad inventory and reporting data on ironSource’s Mediation platform.

1. Report Key

   To find the ‘Report Key‘, go to the ‘Account‘ tab and select ‘Keys‘ from the left side menu.
   

2. SDK Key

   To find the ‘SDK Key‘, go to the ‘Account‘ tab and select ‘Keys‘ from the left side menu.

   

Step 3. Activate AppLovin on LevelPlay

• Log into your LevelPlay account and go to the LevelPlay side nav bar ➣ Setup ➣ Networks
• Select AppLovin from the list of available ad networks on the Manage Networks page. Then enter the Report Key on the Ad network setup page, and click Save 
• Next, go to the Instances page from the left side nav bar. At the top of the Instances page, select the app on which you’d like to run Unity LevelPlay’s Mediation with AppLovin.
• Select Applovin from the setup list of ad networks
• On the App settings page, insert the SDK key you retrieved in Step 2. Then, create an instance for each ad format (Interstitial, Rewarded, and Banner) you want to monetize with through Applovin. Click on your preferred ad format and click Add instance at the bottom of the page. Enter the required info and then then click Save.

Your app is now monetizing through the AppLovin ad network.

Step 4. Add the AppLovin Adapter to Your Build

LevelPlay Network Manager  (Recommended)

Once you’ve completed SDK integration, you can download AppLovin Adapter, using the LevelPlay Network Manager.

In your Unity Development platform, go to Ads Mediation > Network Manager

If you already have the latest version of the adapters, the action button will be changed to “Updated”, and will be disabled.

Android (Manual Resolve)

To apply your changes, make sure you use the “Resolve” process. This will download all relevant artifacts, according to your choices. For detailed information see instructions here. 

iOS

As of Applovin SDK 12.4.1+, Adapter version 4.3.48+, Applovin XCFramework is required to be “Embed & Sign”.

Add the Post-Process script to your Unity Project, under the relevant folder: 

• SDK Version 8.0.0+:  Assets/LevelPlay/Editor 
• SDK Version <8.0.0: Assets/IronSource/Editor 

You can download the script from here.

For Proguard Users Only (Android) 

If you are using ProGuard with the AppLovin adapter, you must add the following code to your ProGuard configuration (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

-keepattributes Signature,InnerClasses,Exceptions,Annotation
-keep public class com.applovin.sdk.AppLovinSdk{ *; }
-keep public class com.applovin.sdk.AppLovin* { public protected *; }
-keep public class com.applovin.nativeAds.AppLovin* { public protected *; }
-keep public class com.applovin.adview.* { public protected *; }
-keep public class com.applovin.mediation.* { public protected *; }
-keep public class com.applovin.mediation.ads.* { public protected *; }
-keep public class com.applovin.impl.*.AppLovin { public protected *; }
-keep public class com.applovin.impl.**.*Impl { public protected *; }
-keepclassmembers class com.applovin.sdk.AppLovinSdkSettings { private java.util.Map localSettings; }
-keep class com.applovin.mediation.adapters.** { *; }
-keep class com.applovin.mediation.adapter.**{ *; }

Android Plugin Manual Integration

1. Download the AppLovin Adapter:
   Download the adapter and AppLovin SDK (AAR) from here.
2. Add the AppLovin files to your Unity project:
   Import adapter file into Assets/Plugins/Android.
   

Update AndroidManifest.xml

As of AppLovin Android adapter version 4.3.13+ (Android SDK Version 6.17.0), AppLovin adapter will be released as AAR. Only if you intend to keep your Jar integration, please add the manifest.

Manifest Permissions
Add the following permission outside the <application> tag:

<uses-permission android:name="android.permission.INTERNET"/>

Manifest Activities
Add the following activities inside the <application> tag on your manifest:

 <!-- AppLovin -->
            <activity
            android:name="com.applovin.adview.AppLovinInterstitialActivity"
            android:configChanges="orientation|screenSize|smallestScreenSize|screenLayout|uiMode"
            android:hardwareAccelerated="true"
            android:screenOrientation="behind"/>
            <activity
            android:name="com.applovin.adview.AppLovinFullscreenActivity"
            android:configChanges="keyboard|keyboardHidden|locale|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
            android:exported="false"
            android:hardwareAccelerated="true"
            android:launchMode="singleTop"
            android:screenOrientation="behind"/>
            <activity
            android:name="com.applovin.sdk.AppLovinWebViewActivity"
            android:configChanges="keyboardHidden|orientation|screenSize|uiMode"/>

iOS Plugin Manual Integration

1. Download the AppLovin Adapter and SDK Files: 
   Download the adapter and SDK from here.
2. Add the AppLovin Adapter file to your Unity project
   Import the adapter file into Assets/Plugins/iOS.
3. Add the SDK to your Xcode project:
   As Unity3D does not support XCFrameworks, please add the SDK XCFrameworks directly to your Xcode project.

Step 5. Configure Rewarded Video in Applovin’s Admin

Once the AppLovin Adapter has been added to your build, you need to enable the Rewarded Video functionality in the AppLovin Admin.

1. In the AppLovin Admin, go to ‘Manage Apps’  and select the specific app you want to configure:
   
2. Scroll down to the ‘Rewarded Video’ section and set the following toggles:
   1. Frequency Capping – Do not frequency cap Rewarded Videos
   2. Virtual Currency Details – The Unity LevelPlay Mediation Adapter will set this, so you can leave the default values
   3. Display Pre-Video Modal – NO
   4. Display Post-Video Modal – NO
   5. Callback Options – Client-side callbacks only
      
3. Once finished hit ‘Save’

Step 6. AppLovin Additional Settings

Set Age Restriction

ironSource’s mediation platform lets publishers communicate AppLovin age-restriction settings directly to the AppLovin network.
This feature is enabled using ironSource SDK 6.17.1+, AppLovin Unity Adapter 4.3.18+.

Use the following syntax, to set AppLovin setIsAgeRestrictedUser with the parameter True:

 IronSource.Agent.setMetaData("AppLovin_AgeRestrictedUser","true");

Use the following syntax, to set AppLovin setIsAgeRestrictedUse with the parameter False:

 IronSource.Agent.setMetaData("AppLovin_AgeRestrictedUser","false");

To learn more about age-restrictions settings Under AppLovin network visit here.

Done!
You are now all set to deliver AppLovin Ads within your application!