Integration

This page shows you how to download, import, and configure the AppLovin MAX Unity Plugin.

Import the AppLovin MAX Unity Plugin

You may choose to import the AppLovin MAX Unity Plugin via the Unity Package Manager (UPM) or by importing a .unitypackage.

Unity Package Manager

New Integrations

The AppLovin MAX Unity Plugin requires specific registries and dependencies. The plugin installer automatically adds these registries and dependencies to Unity. Download the plugin installer by clicking the Download Installer button below:

Loading…

Import the Installer Into Unity

1. In Unity, select Assets > Import Package > Custom Package…
2. Choose the installer file you downloaded.
3. In the Import Unity Package dialog, click Import.

Existing Integrations

To migrate from a .unitypackage to AppLovin’s scoped registry, follow these steps to migrate the plugin and adapters:

1. Ensure you are using AppLovin Unity Plugin version 8.0.0 or higher.
2. Open AppLovin’s Integration Manager by selecting the menu option AppLovin > Integration Manager.
3. Scroll down to Unity Package Manager Migration and click Upgrade All Adapters and Migrate to UPM.

Import .unitypackage

Download the Latest Unity Plugin

Download the plugin manually by clicking the Download button below:

Loading…

If you want to receive release updates, subscribe to the AppLovin MAX Unity Plugin GitHub repository.

Import the Plugin Into Unity

1. In Unity, select Assets > Import Package > Custom Package….
2. Choose the Unity Plugin file you downloaded.
3. In the Import Unity Package dialog, click Import.

Requirements

• Unity 2018.2 or later (Unity 2019.2 or later for Package Manager support).
• For Android builds, the AppLovin MAX plugin requires that you enable Jetifier. To enable Jetifier, take the following steps:
  1. In Unity, select Assets > External Dependency Manager > Android Resolver > Settings.
  2. In the Android Resolver Settings dialog that appears, check Use Jetifier.
  3. Click OK.
• For iOS builds:
  • Building with bitcode is no longer supported. Apple deprecated Bitcode in Xcode 14.
  • The AppLovin MAX plugin requires CocoaPods. Install CocoaPods by following the instructions at the CocoaPods Getting Started guide.
• Call all AppLovin MAX APIs on the main thread.

Integrate Custom SDK Adapters

AppLovin Exchange (ALX) supports a custom adapter for LinkedIn. Integration instructions are below and more information can be found here.

You can install the adapter through the AppLovin Unity Plugin’s Integration Manager. In Unity, select AppLovin > Integration Manager, then press the Install button for the LinkedIn adapter under AppLovin Micro SDK Partners.

Enable Ad Review

To enable the MAX Ad Review service, add your AppLovin SDK Key in the AppLovin Integration Manager:

1. In Unity, select AppLovin > Integration Manager. The AppLovin Integration Manager dialog appears.
2. Check Enable MAX Ad Review and type your SDK Key in the field labeled AppLovin SDK Key.
3. Close the AppLovin Integration Manager dialog.

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

See also

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

Initialize the SDK

Attach the OnSdkInitializedEvent event handler, then set the SDK key and initialize the SDK as soon as your app launches. The following code sample demonstrates this:

MaxSdkCallbacks.OnSdkInitializedEvent += (MaxSdkBase.SdkConfiguration sdkConfiguration) => {
  // AppLovin SDK is initialized, start loading ads
};

MaxSdk.SetSdkKey("«SDK-key»");
MaxSdk.InitializeSdk();

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 changes that you need to comply with. This section explains how to comply with these changes and thereby avoid a material drop in revenue.

SKAdNetwork

The Unity Plugin automatically updates your app’s Info.plist with network-specific identifiers.

MAX Terms & Privacy Policy Flow

Implement the MAX Terms & Privacy Policy Flow to integrate compliance with the ATT framework and acceptance of your Terms of Service and Privacy Policy.

Consent and Data APIs

You must obtain consent from your users (in applicable jurisdictions) on behalf of AppLovin’s monetization partners. Then you must correctly pass consent flag values to AppLovin. To learn how to do this, review the Privacy–Consent and Data APIs documentation.

iOS 15 Global SKAdNetwork Reporting

Starting with 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) for developers to access the SKAdNetwork data across all their network partners in one place.

Tip

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

This feature is available to you in the MAX Unity plugin, starting with version 4.3.8. If you would like to enable this feature, you can do so in the AppLovin Integration Manager by following these instructions:

1. In Unity, select AppLovin > Integration Manager. The AppLovin Integration Manager dialog appears.
2. Check the Set Advertising Attribution Report Endpoint in Info.plist setting under Other Settings.
3. Close the AppLovin Integration Manager dialog.

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.