Vungle Integration Guide

This guide will instruct you step-by-step on how to set Vungle live as an ad network on the ironSource Mediation platform.

Before You Start

  • Make sure you have correctly integrated ironSource’s Rewarded Video or Interstitial into your application.
  • The ironSource Mediation platform now supports the simultaneous activation of Vungle’s Rewarded Video or Interstitial for our iOS, Android and Unity SDK 6.6.5+ and Vungle adapter version 3.2.1+.

Step 1. Create a Vungle Account

  1. Create an account with Vungle. 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 Vungle

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‘:
1

Step 3.  Add a Placement

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

2
Then input the necessary details to create a Vungle placement and click the ‘Sound Good‘ button:
1

Step 4. Activate Vungle on ironSource SDK Networks Module

There are d pieces of Data from the Vungle account which need to be inserted into your ironSource Network Setup Module in order for Vungle to work correctly in connection with ironSource:

Vungle App ID This is the unique identifier of your application in Vungle’s system.
Reporting API ID This is a unique identifier for your app in Vungle’s system, used with the Reporting API to track app performance.
Reporting API Key This is a unique identifier for your Vungle account. Along with the Reporting API ID, this will allow your ironSource Mediation Platform to import performance data from your Vungle account.
Placement Reference ID This is the unique identifier of the ad unit, necessary to differentiate Rewarded Video from Interstitial ads.

Once you obtain this information, you must configure Vungle’s parameters in your ironSource Account. By adding the above information correctly, you will be able to take full advantage of Vungle’s ad inventory and reporting data on ironSource‘s Mediation platform.

  1. Vungle 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 Vungle App ID:
    1

  2. 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 Vungle Reporting API ID:
    1

  3. Reporting API Key

    Go to the My Account on the upper-right corner of the screen you will them see the Reporting API Key:
    1

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

Activate Vungle on ironSource Platform

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

  • Go to ‘Monetize‘ ➣ ‘Setup‘ ➣ ‘SDK Networks‘:
    1
  • Select Vungle from the list of Available Ad Networks and enter the Vungle ‘Reporting API Key‘:
    1
  • Click ‘Save‘.  Vungle will then be enabled in the Available Ad Networks table:
    1
  • Click on the Vungle’s Setup button and enter the ‘App ID‘, ‘Reporting API ID‘ and the
    under the relevant Ad Unit Settings:
    1
  • You will then see Vungle 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

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://dl.bintray.com/ironsource-mobile/android-adapters"
        }
        maven {
            url "https://jitpack.io"
        }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
     implementation 'com.ironsource.adapters:vungleadapter:4.1.6@jar'
     implementation 'com.vungle:publisher-sdk-android:6.4.11'
    }

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.
      android-studio-aar-integration
  3. Make sure you add the following to your Gradle build file under the dependencies section:
    implementation files('libs/vungleadapter:4.1.6@jar')
    // Required ThirdParty Dependencies
    implementation files('libs/converter-gson-2.5.0.jar')
    implementation files('libs/gson-2.8.2.jar')
    implementation files('libs/logging-interceptor-3.12.0.jar')
    implementation files('libs/okhttp-3.12.0.jar')
    implementation files('libs/okio-1.15.0.jar')
    implementation files('libs/retrofit-2.5.0.jar')
    

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.**
Done!
You are now all set to deliver Vungle Ads within your application!


What’s Next?

To leverage additional ad networks through ironSource Mediation, integrate the adapters and follow our integration guides