Integration

This page shows you how to download, import, and configure the AppLovin Godot plugin.

If you want to receive release updates or report issues, subscribe to the AppLovin MAX Godot plugin GitHub repository.

Download and Import the Latest Plugin

To access the plugin you can either download the asset package from the Godot Asset Library (see instructions below) or manually import the plugin after downloading the source code from the AppLovin-MAX-Godot repository.

If you run into any difficulties, please file an issue in the AppLovin-MAX-Godot repository.

To download an import the AppLovin MAX Godot plugin, follow these steps:

  1. Open your Godot project and open AssetLib in the Godot editor.
  2. Enter “AppLovinMAX” in the search bar. When the AppLovinMAX plugin appears, verify that the publisher is correct (“AppLovin Mobile Engineering”) and then click Download.
    AppLovinMAX: Tools: AppLovin Mobile Engineering: M.I.T.
  3. When the plugin finishes downloading, select Project > Project Settings in the Godot editor.
  4. Under Plugins > Installed Plugins find “AppLovinMAX” and check its ☑Enable checkbox.
    Plugins: Installed Plugins: AppLovinMAX: 1.0.0, AppLovin, ☑Enable

Initialize the SDK

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

var init_listener = AppLovinMAX.InitializationListener.new()
init_listener.on_sdk_initialized = func(sdk_configuration : AppLovinMAX.SdkConfiguration):
  # AppLovin SDK is initialized, start loading ads
    
AppLovinMAX.initialize(SDK-key, init_listener)

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. Therefore, always initialize the AppLovin SDK on startup so as to give mediated networks the maximum amount of time to cache ads. This is especially important with video ads.

Do not use different network app IDs for the same network across different ad units. If you use different app IDs for the same network and app package name without using selective init you will break the network initialization process.

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. To leverage the MAX Global SKAdNetwork Report, enable iOS 15 SKAdNetwork reporting by using the app’s Info.plist:

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

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

To forward the SKAdNetwork postbacks to one or more third-party endpoints of your choice, please contact your account team. Note that independent of this Apple feature, AppLovin automatically sends a copy of all SKAdNetwork postbacks to the relevant campaign attribution MMP.