AppLovin integration

Prerequisites

• Ensure that you correctly integrate Rewarded ads, Interstitial ads, or Banner ads into your application. Refer to the following guides for integration instructions:

  Integration guides

  • Rewarded ads
  • Interstitial
  • Banner
• If you're working with Applovin SDK 12.4.3+, adapter version 4.3.43+ make sure to remove the applovin.sdk.key from the AndroidManifest.

Step 1. Create an AppLovin Account

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

Step 2. Retrieve Your AppLovin SDK and Report Keys

• 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 LevelPlay Mediation SDK to Init the AppLovin adapter for your apps.

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 select 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 ads, and Banner) you want to monetize with through Applovin. Select your preferred ad format and select Add instance at the bottom of the page. Enter the required info and then then select Save.
  

Step 4. Add the AppLovin Adapter to Your Build

Android

Gradle

1. Make sure the following Maven URL exists in your build.gradle script of your app module.

   repositories {	mavenCentral()}

2. Add the adapter's Maven name to your build.gradle script of your app module.

   dependencies {   implementation 'com.unity3d.ads-mediation:applovin-adapter:5.2.0'   implementation 'com.applovin:applovin-sdk:13.5.1'}

Manual Download

1. Download the AppLovin Adapter Add the AppLovin Adapter and SDK to your build. You can find the latest AppLovin files here. **Important!**The AppLovin Adapter does not contain the AppLovin SDK. You need to add the AppLovin SDK directly.
2. Add the AppLovin Adapter to Your Project After you download the Adapter; drop the AppLovinAdapter SDK into the libs folder in your Android Project.
   
3. Make sure you add the following to your Gradle build file under the **dependencies section:

   dependencies {   implementation 'com.unity3d.ads-mediation:applovin-adapter:5.2.0'   implementation 'com.applovin:applovin-sdk:13.5.1'}

Update AndroidManifest.xml

Manifest Permissions

<application>

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

<application>

<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"/>

For Proguard Users Only

-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.**{ *; }

Step 5. Configure Rewarded ads in AppLovin's 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 ads section and set the following toggles:
   1. Frequency Capping - Do not frequency cap Rewarded ads
   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. When finished hit ‘Save’

Step 6. AppLovin Additional Settings

Set Age Restriction

LevelPlay.setMetaData("AppLovin_AgeRestrictedUser", "true");

LevelPlay.setMetaData("AppLovin_AgeRestrictedUser", "false");

• Verify your ad network integration with our Integration Helper. The LevelPlay SDK provides a tool to ensure you've successfully integrated our SDK as well as any additional network adapters.
• Manage the debug logs for your integrated mediation ad networks with this boolean

  LevelPlay.setAdaptersDebug(true);

  When set to TRUE, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units! Supported for SDK versions 6.5.2 and up.

Next steps