Vungle

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

Before You Start

Make sure you have correctly integrated AdTiming's  Banner, Rewarded Video and Interstitial Ads in your application.

Important! The ADAPTERS for ad networks are modularized, which means that you need to download Not Only the SDK of mediation networks  you choose to work with But Also the adapters for those ad networks. Be sure to follow this Guide to mediation Vungle's Ads.

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 'Application' in the list on the left and select 'Add Application' on the right side of the page.

vungle.png

 

Step 3. Add a Placement

1. Click on the relevant app from the application list and on the app’s dedicated page, click on 'Add Placement'

vungle1.png

 

2. Input the necessary details to create a Vungle placement:

vungle2.png

  • Placement Name: Fill in the name for the placement. Vungle generates a Reference ID based on the placement name and you will not be able to edit this once you click submit.
  • Display End Cards: Select whether you wish to display End Cards for your Ads.
  • Skippable: Only Interstitial and Rewarded have this option.

Step 4. Retrieve Vungle's Parameters

Immediately after you confirm your application, you will be redirected to a summary page open to the 'Monetization Settings' tab. Below parameters from your Vungle account which need to be input into your AdTiming Network Setup Module in order for Vungle to work correctly in connection with AdTiming.

1. Vungle App ID and Reporting API ID

App ID is the unique identifier of your application in Vungle's system and Reporting API ID is a unique identifier for your app in Vungle's system, used with the Reporting API to track app performance.

Just click on your app and you will be redirected to the specific app's page where you will be able to collect your Vungle 'App ID' and 'Reporting API ID'.

vungle3.png

Pease Note: Vungle Reporting API ID is NOT Reporting API Key.

 

2. Vungle API Key
This is a unique identifier for your Vungle account. Along with the Reporting API ID, this will allow your AdTiming Mediation Platform to import performance data from your Vungle account.

To retrieve you Vungle API Key, click on the your account name on the right bar menu, click on 'My Account' and you will be directed to the page of account overview. The Vungle API Key is presented on this page.

vungle4.png

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

Step 5. Configure Vungle’s Parameters into AdTiming Account

1. Once you have both of these parameters, log in to your AdTiming account and go to Placement ->Edit your placement  

2. Click on Instances-> Add Instance. Select Vungle from the list of Available Ad Networks, click 'New Account'

___24.jpg

3. Complete the following parameters below,and click 'Save'.

___25.jpg


Step 6. Add the Vungle SDK&Adapter to Your Build

Android

1.  Add the Vungle SDK

  • Add to your project-level build.gradle file.
  ...
allprojects {
repositories {
...

jcenter()
maven {
url "https://jitpack.io"
}
}
}
  • Add to your application-level build.gradle file.
 dependencies {
implementation 'com.vungle:publisher-sdk-android:6.5.3'
}

 2.  Add the Vungle Adapter

      AdTiming supports both Gradle dependencies and Manual download mechanisms.

       Gradle dependencies

  • Add the following in your project-level build.gradle file.
 ...
allprojects {
repositories {
...

jcenter()
maven {
url "https://dl.adtiming.com/android-sdk"
}
}
}
  • Add the following in your application-level build.gradle file.
 implementation 'com.adtiming.adapters:vungle:3.4.0@aar'

       Manual download

  • Download the Vungle Adapter from here.
  • Add the Vungle Adapter to Your Project
    Move the VungleAdapter-x.x.x.aar to the libs folder in your Android Project.

mceclip0.png

  • Make sure you add the following to your Gradle build file under the dependencies section:
implementation (name:'VungleAdapter-x.x.x', ext:'aar')

3.  Update AndroidManifest.xml

  • Configure Android Manifest.xml to add permissions.
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- Optional permissions to enable better geo-targeting of ads (recommended) -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

4. 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!

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.