Integration

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

Download the Latest SDK

You can download the SDK through CocoaPods as a dependency. If you prefer to integrate manually, follow the instructions here. If you prefer to integrate using Swift Package Manager, follow the instructions here.

The SDK requires the minimum iOS deployment target to be iOS 11.0 or above. It also requires Xcode version 15 or above.

To receive release updates, subscribe to the AppLovin-MAX-SDK-iOS GitHub repository.

Swift Compatibility

To ensure your build is compatible with artifacts that contain Swift, set Build Settings > Always Embed Swift Standard Libraries to YES.

If you use Swift and build for iOS 12.2.0 or earlier, add /usr/lib/swift to Build Settings > Runpath Search Paths. This prevents issues with libswiftCore.dylib.

CocoaPods

To integrate the AppLovin SDK through CocoaPods:

1. Add the following line to your Podfile:

   pod 'AppLovinSDK'

2. Run the following on the command line:

   pod install --repo-update

Add the SDK Key

1. Open your Project Settings.
2. Select Info.
3. Click on one of the rows of Custom iOS Properties and click + to add a new row.
4. Set the key in the new row to AppLovinSdkKey and set its value to your SDK key.

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

Integrate Custom SDK Adapters

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

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, you must log in to your AppLovin account. Then download AppLovinQualityServiceSetup-ios.rb and move it into your project folder. Open a terminal window, cd into your project folder and run:

ruby AppLovinQualityServiceSetup-ios.rb

See also

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

Initialize the SDK

Caution

This method of initializing the SDK is deprecated. See “New SDK Initialization API” to learn how to initialize the SDK in versions 12.3.0 and higher.

Initialize the SDK in your app delegate’s application:applicationDidFinishLaunching: method.

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.

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  // Set the mediation provider value to @"max" to ensure proper functionality
  [ALSdk shared].mediationProvider = @"max";

  [[ALSdk shared] initializeSdkWithCompletionHandler:^(ALSdkConfiguration *configuration) {
    // Start loading ads
  }];

  ⋮

Swift

import AppLovinSDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate
{
  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
  {
    // Set the mediation provider value to "max" to ensure proper functionality
    ALSdk.shared().mediationProvider = "max"

    ALSdk.shared().initializeSdk { (configuration: ALSdkConfiguration) in
      // Start loading 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 with iOS 15, Apple allows developers to send a copy of their SKAdNetwork install postbacks to an endpoint of their choice. MAX includes a Global SKAdNetwork Report (MAX > Mediation > Analyze > Global SKA Report). You can use this to access the SKAdNetwork data across all of your network partners in one place.

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.