Liftoff Monetize (formerly Vungle) 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 ironSource SDK Networks Module

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

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 ironSource 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 ironSource 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:

• Click ‘Save‘.  Vungle will then be enabled in the Available Ad Networks table:
• Click on the Liftoff’s Setup button and enter the ‘App ID‘, ‘Reporting API ID‘ and the
  ‘Placement Reference ID‘ under the relevant Ad Unit Settings:
  

• You will then see Liftoff Monetize as Active for Mediation on your Setup Dashboard.
• Verify your integration with the Reporting API; this column will check your integration through the Reporting API and return three possible responses: Verified, Failed, and No Response. Double-check your integration and the information you entered above; then click ‘Retry‘ until you see ‘Verified’.

Step 5. Add the Vungle Adapter to Your Build

Adobe Air Plugin

1. Download the Vungle ANE:
   Add the Vungle Adobe Native Extension to your build. You can find the latest Vungle ANE here.
   Important! Make sure you download both Adapter and SDK files.
2. Add the Vungle ANE to your project:
   
   1. To add the ANE, simply add it to your project by clicking on project properties ➣ Flex build path ➣ NativeExtension tab. Click on ‘add ANE‘ and choose file you have downloaded in the previous step.
3. Make sure to add the following extensions, for Android and iOS:

   <extensionID>com.ironsource.adobeair.vungle</extensionID>
   <extensionID>com.ironsource.adobeair.vunglesdk</extensionID>
   

4. For Android Only
   1. Make sure you mark the ANE to be packaged into your application on Flex Build Packaging ➣ Native Extension Tab, select the checkbox of ‘package‘.
      1. 1. Add the following ANEs to your project. Make sure they are marked as a package only for Android.
            LoggingInterceptor
            VungleMoat
            ConverterGson
            Gson
            OkHttp
            Okio
            Retrofit

   2. Update AndroidManifest
      Manifest Permissions
      Add the following permissions inside the manifest tag but outside the <application> tag:

      <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

      Manifest Activities
      Add the following activities inside the <application> tag on your manifest:
      

      <activity
             android:name="com.vungle.warren.ui.VungleActivity"
             android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode"
             android:launchMode="singleTop"
             android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
      

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