Integration

This page shows you how to download, configure, and initialize the AppLovin MAX Cordova Plugin.

Download the Latest Plugin

Download the AppLovin MAX Cordova plugin through npm by issuing the following command:

cordova plugin add cordova-plugin-applovin-max

To receive release updates, subscribe to the AppLovin MAX Cordova Plugin GitHub repository.

Integrate Custom SDK Adapters

AppLovin Exchange (ALX) supports a custom adapter for LinkedIn. Follow the instructions below to integrate the adapter on Android or iOS. More information can be found here.

Android Instructions

To install the adapter, add the following to your app-level build.gradle file:

Groovy

dependencies {
  implementation 'com.applovin.dsp:linkedin-adapter:+'
}

Kotlin

dependencies {
  implementation ("com.applovin.dsp:linkedin-adapter:+")
}

iOS Instructions

To install the adapter:

1. Add the following line to your Podfile:

   pod 'AppLovinDSPLinkedInAdapter'

2. Run the following on the command line:

   pod install --repo-update

Enable Ad Review

To enable the MAX Ad Review service, follow the instructions below for Android or iOS:

See also

“How to Build Superior User Experience with MAX’s Ad Review” from AppLovin’s Blog.

Android Instructions

Add the following at the end of your build.gradle files:

Additions to Root-Level build.gradle File

Groovy

buildscript {
  repositories {
    maven { url 'https://artifacts.applovin.com/android' }
  }
  dependencies {
    classpath "com.applovin.quality:AppLovinQualityServiceGradlePlugin:+"
  }
}

Kotlin

buildscript {
  repositories {
    maven { url = uri("https://artifacts.applovin.com/android") }
  }
  dependencies {
    classpath ("com.applovin.quality:AppLovinQualityServiceGradlePlugin:+)
  }
}

Additions to App-Level build.gradle File

Groovy

apply plugin: 'applovin-quality-service'
applovin {
  apiKey "«your-ad-review-key»"
}

Kotlin

plugins {
  id("applovin-quality-service")
}
applovin {
  apiKey = "«your-ad-review-key»"
}

You can find your Ad Review Key in the Account > General > Keys section of the AppLovin dashboard.

iOS Instructions

Download AppLovinQualityServiceSetup-ios.rb and move it into your project folder. Open a terminal window, cd to your project directory, and run:

ruby AppLovinQualityServiceSetup-ios.rb

Initialize the SDK

Add the code snippet below into your app’s main home screen:

var AppLovinMAX = cordova.require('cordova-plugin-applovin-max.AppLovinMAX');

⋮

AppLovinMAX.initialize("«SDK-key»", function (configuration) {
  // SDK is initialized, start loading ads
});

You can find your SDK key in the Account > General > Keys section of the AppLovin dashboard.

Ad assets that are fully cached result in a better user experience. For this reason, always initialize the AppLovin SDK on startup. This gives mediated networks the maximum amount of time to cache ads. This is especially important with video ads.

iOS 14 Support

In iOS 14, Apple introduced global privacy policy changes. Apple requires applications to comply with these new policies. If you fail to comply, you may lose revenue. This section explains how to comply.

SKAdNetwork

Update your app’s Info.plist with network-specific identifiers. See the SKAdNetwork documentation for instructions.

Consent and Data APIs

You must obtain consent from your users in certain jurisdictions on behalf of AppLovin’s monetization partners. You must also correctly pass consent values to AppLovin. To learn how to do these things, review the Privacy–Consent, Age-Related Flags, and Data APIs documentation.

iOS 15 Global SKAdNetwork Reporting

Starting in iOS 15, Apple allows developers to send a copy of their SKAdNetwork install postbacks to an endpoint of their choice. MAX provides a Global SKAdNetwork Report (MAX > Mediation > Analyze > Global SKA Report) with which developers can access the SKAdNetwork data across all their network partners in one place.

To leverage the MAX Global SKAdNetwork Report, enable iOS 15 SKAdNetwork reporting. You can do this by using the app’s config.xml:

1. In your app’s config.xml, create a new key named NSAdvertisingAttributionReportEndpoint of type String.
2. Give that key the value: https://postbacks-app.com.

The final result should look something like this:

⋮
<iPhone>
  <InfoAdditions>
    <![CDATA[
      ⋮
      <key>NSAdvertisingAttributionReportEndpoint</key>
      <string>https://postbacks-app.com</string>
      ⋮
    ]]>
  </InfoAdditions>
</iPhone>

Tip

You can check the value of your app’s SKAdNetwork endpoint by using the Mediation Debugger.

Note

Contact your account team if you want to forward the SKAdNetwork postbacks to one or more third-party endpoints of your choice. Independently of this Apple feature, AppLovin automatically sends a copy of all SKAdNetwork postbacks to the relevant campaign attribution MMP.