Vungle Mediation Integration Guide for Unity

This guide will instruct you step-by-step on how to set Vungle live as an Ad Network on the ironSource Mediation platform. The integration process is completed in a few simple steps:

1. Create a Vungle Account
2. Create an Application in Vungle
3. Activate Vungle in Your ironSource Network Setup Module
4. Add the Vungle Adapter to Your Build

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’:
   
2. Define the settings of your app:
   

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.

Step 3. Activate Vungle in Your ironSource Network Setup 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:

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:
   You will be redirected to the specific app’s page where you will be able to collect your ‘Vungle Application ID‘:
   

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

Configure Vungle’s Parameters into ironSource Account

• Once you have all of these parameters, log in to your ironSource account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.
• Select Vungle from the list of Available Ad Networks and enter the Vungle ‘API Key‘.
  
• Click ‘Save‘.  Vungle will then be enabled in the Available Ad Networks table.
  
• Select the app on which you’d like to run ironSource’s Interstitial Mediation with 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: Note: Vungle only allows the activation of one type of ad unit at a time, either Rewarded Video or Interstitial.
  
•  You will then see Vungle as Active on your Setup Dashboard.
  
• 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

Unity Plugin (Android Integration):

1. Download the Vungle Unity Package:
   Add SupersonicVungleAdapter_[version].unitypackage to your build. You can find the latest Vungle Unity package here.
2. Add the Vungle files to your project:
   1. To add the Adapter, simply double click on the SupersonicVungleAdapter_[version].unitypackage and add all files to your unity project.
   2. 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 Assets/Plugins/Android/Supersonic/libs.
      Important! The jar you have downloaded from Vungle will also include the main vungle_publisher_adaptive_id_xxx.jar. This jar is already included within the Supersonic Vungle Adapter. Do NOT add it to your build manually. It will cause duplicate symbol errors when you compile.
3. Update AndroidManifest.xml:
   Manifest permissions:
   Add the following permissions to your Application Descriptor.xmlfile 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 manifestAdditions:

   <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"/>

Unity Plugin (iOS Integration):

1. Download the Vungle Unity Package:
   Import the SupersonicVungleAdapter_[version].unitpackage to your Unity project. You can find the latest Vungle Unity Package here.
2. Add the Vungle files to your Unity project:
   To add the adapter, simply double click on the SupersonicVungleAdapter_[version].unitpackage and add all files to your Unity project.
   
   Note: Note: If you are upgrading from a previous version, please remove Vungle.x.x.x.framework from Assets/Plugins/iOS/Supersonic.

Our Unity Plugin adds the necessary frameworks automatically to your Xcode project.

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