Liftoff Monetize integration guide

This guide will instruct you step-by-step on how to set Liftoff Monetize (formerly Vungle) live as an ad network on Unity LevelPlay. To use Liftoff Monetize, you need to install the Vungle SDK.

Step 1. Create a Liftoff Monetize Account

1. Create an account with Liftoff Monetize. You can do so here
2. Once your account has been verified, you can log in at their partner login here

Step 2. Create an Application in Liftoff Monetize

Once you log in, go to the Applications tab on the left side menu drop-down in the upper-left corner and click Add Application:

Step 3.  Add a Placement

Click on the relevant app from the application list and on the app’s dedicated page, click ‘Add Placement‘:

Then input the necessary details to create a Liftoff placement and click Continue, then the Sounds Good button:

Banner Placement
When creating Banner ad placement, it’s recommended to disable the “Ad Refresh” option. You can later control the refresh rate on Unity LevelPlay.

Step 4. Activate Liftoff Monetize on LevelPlay SDK Networks Module

There are 4 pieces of data from your Liftoff account that need to be inserted into your LevelPlay Network Setup Module in order for Liftoff to work correctly in connection with LevelPlay:

Once you obtain this information, you must configure Liftoff’s parameters in Unity LevelPlay. By adding the above information correctly, you will be able to take full advantage of Liftoff’s ad inventory and reporting data on Unity LevelPlay.

1. Reporting API Key

   Go to the My Account in the upper-right corner of the screen you will then see the Reporting API Key:

2. Liftoff Monetize Application ID

   Go to the Applications tab on the left side menu and click on the application you would like to configure on LevelPlay dashboard. You will then see Liftoff App ID:

   

3. Reporting API ID

   Go to the Applications tab on the left side menu and click on the application you would like to configure on LevelPlay dashboard. You will then see Liftoff Reporting API ID:

   

4. Placement Reference ID

   Go to the Placements tab on the left side menu and choose the application’s placements you would like to configure on LevelPlay dashboard:
   

Activate Liftoff Monetize on Unity LevelPlay

Once you’ve collected all necessary parameters, log in to your LevelPlay account.

• Go to ‘Monetize‘ ➣ ‘Setup‘ ➣ ‘SDK Networks‘:
• Select Liftoff from the list of Available Ad Networks and enter the Liftoff ‘Reporting API Key‘. This step will be required only once:

• To activate the auto-setup feature, toggle on the Liftoff Monetize auto-setup tool. This will enable you to automatically create an app and bidder placement on the Liftoff Monetize platform and allow LevelPlay to retrieve placement details from Liftoff Monetize once you’ve toggled on the auto-setup tool and enter the Secret Token found on the Overview page on the Liftoff Monetize platform. Then, click Save
• Click ‘Save‘.  Liftoff will then be enabled in the Available Networks table

Bidder setup

There are two ways to set up the Liftoff Monetize bidder on LevelPlay:

1. Auto-setup – Automatically create a new app and placements on the Liftoff Monetize dashboard and populate all the necessary settings on LevelPlay
2. Manual – Manually enter the necessary app details on the LevelPlay and Liftoff Monetize platforms

Auto-setup

• Select the app where you’d like to run interstitial, rewarded video, or banner ads from Unity Ads. Then click the define icon in the Liftoff row.
• Click the Add bidder button to automatically create new app and bidding placements on the Liftoff Monetize platform, and import the relevant information into LevelPlay. 
• Click Save to approve and accept all configurations. If you close the module without saving, the assets will be created on the Liftoff Monetize platform without importing the data onto the LevelPlay platform.

Manual setup

• Select the app where you’d like to run banner, interstitial or rewarded video ads from liftoff Monetize

• Select Liftoff from the Setup list of Ad Networks, click on the define icon, and insert the Reporting API Key, App ID and Reporting API ID. Then  under the relevant ad unit settings, add the Placement Reference ID.
• Click Save

Now you’ll see Lifotff as active for the ad units of choice in your account.

Step 6. Add the Vungle Adapter to Your Build

Android

ironSource supports both Gradle dependencies and manual download mechanisms.

Gradle

1. Make sure the following Maven URL exist in your build.gradle script of your app module. (should appear only once for all the adapters)

   repositories {
       maven {
           url "https://android-sdk.is.com/"
       }
       maven {
           url "https://jitpack.io"
       }

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

   implementation 'com.ironsource.adapters:vungleadapter:4.3.27'
   implementation 'com.vungle:vungle-ads:7.4.2'

Manual Download

1. Download the Vungle Adapter:
   Add the Vungle Adapter to your build. You can find the latest Vungle Adapter here.
2. Download the Vungle AAR file
   1. You can find the latest Vungle AAR here.
   2. If using Eclipse: Import the AAR file as a library project.
   3. If using Android Studio, download the Vungle AAR file and add as a dependency to your own module. Go to File ➣ New ➣ New Module ➣ Import AAR and navigate to the location where the Vungle AAR file has been downloaded.
      
3. Make sure you add the following to your Gradle build file under the dependencies section:
   

   implementation 'com.ironsource.adapters:vungleadapter:4.3.27'
   implementation 'com.vungle:vungle-ads:7.4.2'

For Proguard Users Only

If you are using ProGuard with the Vungle adapter, you must add the following code to your ProGuard file (Android Studio: proguard-rules.pro or Eclipse: proguard-project.txt):

# Vungle
-keep class com.vungle.warren.** { *; }
-dontwarn com.vungle.warren.error.VungleError$ErrorCode
# Moat SDK
-keep class com.moat.** { *; }
-dontwarn com.moat.**
# Okio
-dontwarn org.codehaus.mojo.animal_sniffer.IgnoreJRERequirement
# Retrofit
-dontwarn okio.**
-dontwarn retrofit2.Platform$Java8
# Gson
-keepattributes Signature
-keepattributes *Annotation*
-dontwarn sun.misc.**
-keep class com.google.gson.examples.android.model.** { *; }
-keep class * implements com.google.gson.TypeAdapterFactory
-keep class * implements com.google.gson.JsonSerializer
-keep class * implements com.google.gson.JsonDeserializer
# Google Android Advertising ID
-keep class com.google.android.gms.internal.** { *; }
-dontwarn com.google.android.gms.ads.identifier.**

Step 6. Liftoff Additional Settings

COPPA User status

Unity LevelPlay lets publishers communicate Vungle COPPA settings directly to the Liftoff network. This feature is enabled using ironSource SDK 7.1.12+, Vungle Android Adapter 4.3.15+. Read more about Vungle COPPA API here.

Use the following syntax, to update Vungle’s COPPA User Status with the parameter “True”:

 IronSource.setMetaData("Vungle_coppa","true");

Use the following syntax, to update Vungle’s COPPA User Status with the parameter “False”:

 IronSource.setMetaData("Vungle_coppa","false");

Done!
You are now all set to deliver Liftoff Monetize Ads within your application!