Vungle Mediation 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. 

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

  1. Once you log in, go to the Pub/Management drop-down in the upper-left corner.
    Select ‘Management’ and scroll down the page till you see the below module. Select ‘Add New Application’:
    Vungle integration with Supersonic Mediation - 01
  2. Define the settings of your app:
    Vungle integration with Supersonic Mediation - 02

    1. Platform – iOS or Android
    2. Application Name – Enter the name of your application. If it is live in the AppStore or Google Play, Vungle will automatically import most of the settings and auto-fill the form on your behalf.
    3. Category – You can select the application Category.
    4. Type – Select Free or Paid.
    5. Orientation – Select Landscape.
  3. Define Ad Customization
    Here you can define custom settings for the controls of your video ads from Vungle:

    1. Frequency Cap – We recommend 0 cap. This can be controlled for ALL Mediated Networks via your ironSource platform.
    2. Force View – We recommend keeping the ‘Force View’ settings. These improve conversion and eCPM.
    3. Maximum Ad Duration – We recommend 60+. This increases the amount of available video inventory Vungle can serve and increases total revenue potential.
    4. Callback URL – Leave this empty. If you choose to use server-to-server callbacks this will be handled directly by the ironSource SDK for all Mediated Networks.
  4. Select ‘Submit’ to finish:

Vungle integration with Supersonic Mediation - 03

Note: You will need a unique Vungle application per platform (iOS + Android) just like you do with your ironSource account.

Step 3. Activate Vungle on ironSource SDK Networks Module

There are 3 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.

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

    Select ‘Details‘ from the top Navigation panel. You will see your ‘Account Stage‘. Select your account and the app that you want to run Vungle Ads on through ironSource‘s Mediation:
    Vungle integration with Supersonic Mediation - 04You will be redirected to the specific app’s page where you will be able to collect your ‘Vungle Application ID‘:
    Vungle integration with Supersonic Mediation - 05

  2. Reporting API ID

    Just below your  ‘Vungle Application ID‘, you will find your ‘Reporting API ID‘.

  3. Reporting API Key

    Select ‘Details‘ from the top Navigation panel once again. You will see your ‘Account Stage‘. Scroll to the bottom of this page and you will spot the ‘Users‘ section. Here you can view the ‘Reporting API‘:
    Vungle integration with Supersonic Mediation - 06

 

Configure Vungle’s Parameters into ironSource Account

Vungle does not permit the simultaneous activation of Rewarded Video and Interstitial. If you activate Rewarded Video on the ironSource dashboard, you will have to deactivate Interstitials and vice versa.
  • Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.ironsource-platform-mediation-network-setup
  • Select Vungle from the list of Available Ad Networks and enter the Vungle ‘API Key‘.
    ironsource-platform-vungle-network-setup
  • Click ‘Save‘.  Vungle will then be enabled in the Available Ad Networks table.
    ironsource-platform-ad-network-activated-vungle
  • Select the app on which you’d like to run ironSource’s Interstitial Mediation with Vungle.
    ironsource-platform-select-app-vungle
  • Select Vungle from the Setup list of Ad Networks and click on ‘Define‘. Insert the App ID‘ and the ‘Reporting API ID‘ for Rewarded Video or Interstitial in the relevant fields. Set status to Active and click ‘Save’.
    Note: Vungle only allows the activation of one type of ad unit at a time, either Rewarded Video or Interstitial.
    ironsource-platform-app-settings-vungle
  •  You will then see Vungle as Active on your Setup Dashboard.
    ironsource-platform-active-ad-unit-vungle
  • New! 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 4. 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"
    }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
    compile 'com.ironsource.adapters:vungleadapter:3.2.0@jar'
    }
  3. Manually download dagger-x.x.x.jar and javax.inject-x.jar.
    Add the dagger-x.x.x.jar and javax.inject-x.jar  to your project under App/Libs. Alternatively, you can add the below to your Gradle build file:

    compile 'com.google.dagger:dagger:2.7'
    compile 'javax.inject:javax.inject:1'
    compile 'com.google.android.gms:play-services-base:8.4.0'

Manual Download

  1. Download the Vungle Adapter:
    Add the Vungle Adapter to your build. You can find the latest Vungle Adapter here.
    Important! The Vungle Adapter also contains the Vungle jar. You DON’T need to additionally add the Vungle jar directly.
  2. Add the Vungle Adapter to your Project:
    After you download the Adapter; drop the Vungle Adapter jar into the libs folder in your Android project.
  3. Download dagger-x.x.x.jar and javax.inject-x.jar. Add the dagger-x.x.x.jar and javax.inject-x.jar to your project under App/Libs.
    Important! The zip you have downloaded from Vungle will also include the main vungle_publisher_adaptive_id_xxx.jar. This jar is already included within the ironSource Vungle Adapter. Do NOT add it to your build manually. It will cause duplicate symbol errors when you compile.
    Vungle integration with Supersonic Mediation - 08
    Note: Vungle also requires support-v4-[version].jar to be included in your application. If it’s not already included, please make sure to add it as well.
  4. Make sure you add the following to your Gradle build file under the dependencies section:

    compile files('libs/vungleadapter:3.2.0@jar')
    compile files('libs/com.google.dagger:dagger:2.7')
    compile files('libs/javax.inject:javax.inject:1')

Step 5. Update AndroidManifest.xml

Manifest Permissions
Add the following permissions inside the manifest tag but outside the <application> tag:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="18"/>
<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.publisher.VideoFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen"/>
<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
android:configChanges="keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize"
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"/>

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

-dontwarn com.vungle.**
-keep class com.vungle.** { *; }  // omitted public
-keep class javax.inject.*

 

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