Warning: is_writable(): open_basedir restriction in effect. File(/var/www/clients/client2/web93/web/wp-content/uploads/broken-link-checker/blc-log.txt) is not within the allowed path(s): (/var/www/clients/client1/web15/web:/var/www/clients/client1/web15/private:/var/www/clients/client1/web15/tmp:/var/www/supersonic-knowledge.rtl.co.il/web:/srv/www/supersonic-knowledge.rtl.co.il/web:/usr/share/php5:/usr/share/php:/tmp:/usr/share/phpmyadmin:/etc/phpmyadmin:/var/lib/phpmyadmin) in /var/www/clients/client1/web15/web/wp-content/plugins/broken-link-checker/core/init.php on line 141
Vungle Integration Guide - Supersonic Knowledge Center

Vungle Integration Guide

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

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

Before You Start

Make sure you have correctly integrated Supersonic Rewarded Video into your application. Integration is outlined here.

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 select ‘Management’ from the the top Navigation panel. You will then 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 either Landscape.[]Adam – sentence not clear
  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 Supersonic 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 your Supersonic SDK for ALL Mediated Networks.

When done 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 Supersonic account.

Step 3. Activate Vungle in Your Supersonic Network Setup Module

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

Vungle Application ID This is the unique identifier of your Application in Vungle’s system.
Reporting API ID This is a unique identifier for your Vungle app 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 Supersonic Mediation Platform to import performance data from your Vungle account.

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

  1. Vungle Application ID

    Select ‘Details‘ from the top Navigation panel. You will see your ‘Account Stage‘. Select your account name to view the following application select dialog:
    Vungle integration with Supersonic Mediation - 04Select the relevant application to navigate to the following page and 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‘. Select Request ID and you will be presented with the ‘Reporting API Key‘:
    Vungle integration with Supersonic Mediation - 06

 

Configure Vungle’s Parameters into Supersonic Account

Once you have all of these parameters, log in to your Supersonic account and go to ‘Monetize‘ ➣ ‘Mediation‘ ➣ ‘Network Setup‘.

Select Vungle from the list of available Ad Networks and input the ‘Vungle Application ID‘, ‘Reporting API ID‘ and ‘Reporting API Key‘ in the relevant fields.
Vungle integration with Supersonic Mediation - 07

Step 4. Add the Vungle Adapter to Your Build

Unity Plugin

  1. Download the Vungle SDK & Adapter:
    This will add both the Vungle SDK & Vungle Adapter to your build. You can find the latest Vungle  SDK & Adapter here.
  2. Add the Vungle files to your project:
    1. To add the Adapter, simply double click on the SupersonicVungleAdapter.unitypackage and add all files to your unity project.
    2. Android: Add the dagger-x.x.x.jar, javax.inject-x.jar, nineoldandroids-x.x.x.jarsupport-v4-x.x.x.jar to your project under Assets/Plugins/Android. You can download these .jars here.
      Important – The zip you have downloaded form 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.
      Note: In addition, be sure to follow all the build configurations described in the Android Integration section below as well.
    3. iOS:
      Note: In addition, be sure to follow all the build configurations described in the iOS Integration section below as well.

Android

Supersonic 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/supersonic/android-adapters"
    }
    }
  2. Add the adapter’s Maven name to your build.gradle script of your app module.
    dependencies {
    compile 'com.supersonic.adapters:vungleadapter:1.1.7@jar'
    }
  3. Manually Add the dagger-x.x.x.jar, javax.inject-x.jar, nineoldandroids-x.x.x.jarsupport-v4-x.x.x.jar to your project under Assets/Plugins/Android. You can download these .jar’s here.

 

Manual download:

  1. Download the Vungle Adapter:
    This will 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. Add the dagger-x.x.x.jar, javax.inject-x.jar, nineoldandroids-x.x.x.jarsupport-v4-x.x.x.jar to your project under Assets/Plugins/Android. You can download these .jars here.
    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 Supersonic 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. Update AndroidManifest.xml:
    Manifest activities:

    <activity
    android:name="com.vungle.publisher.FullScreenAdActivity"
    android:configChanges="keyboardHidden|orientation|screenSize"
    android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

iOS

  1. Download the Vungle Adapter:
    This will add the Vungle Adapter to your build. You can find the latest Vungle Adapter here.
  2. Add the Vungle frameworks to Your Project:
    After you download the Adapter; unzip it, and drop both SDK & Adapter frameworks into your Xcode Project.

    1. Drag VungleSDK.embeddedframework into your Xcode project.
      Note: Make sure you mark the option “Create groups” and NOT Create folder reference“).
    2. Drag SUVungleAdapter.framework into your Xcode project.
  3. Adding Required Frameworks:
    Go to Targets ➣ Build Phases ➣ Link Binary With Libraries.
    Click ‘+’ to add the following frameworks:

    AudioToolbox.framework
    libsqlite3.dylib
    MediaPlayer.framework
    UIKit.framework
    WebKit.framework (weak link)
  4. Remove the iOS Status Bar:
    For optimal user experience, Vungle strongly recommends removing the iOS Status bar when their Ad Unit is active for the user.
    To do this, open your Info.pList and add the key “View controller-based status bar appearance” and set it to “No“.

 

Verify Your Ad-Network Integration

The Supersonic SDK provides an easy way to verify that your Rewarded Video Mediation integration was completed successfully. To verify your Supersonic and additional Ad Networks integration, follow this document.


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


 

What’s Next?
To add additional Rewarded Video Ad networks, follow the integration guides on our Supported Ad Networks list.