Vungle

Introduction

The purpose of this article is to guide publishers who want to use the Fyber FairBid SDK to load and display ads from Vungle via FairBid mediation.

This is a six-step process:

  1. Create or login to your Vungle Account
  2. Create an app in Vungle
  3. Create a placement for your app
  4. Retrieve the parameters from the Vungle dashboard
  5. Insert the Vungle parameters into the Fyber Console
  6. Add the Vungle SDK to your integration>

Note

Vungle currently supports the following ad formats:

  • Interstitials
  • Rewarded Videos
  • Banner Videos

Refer to Vungle for updates on supported ad formats.

Step 1: Create or login to your Vungle Account

Click here to sign up and create an account with Vungle.  Once you have created your account, click here to login.

Step 2: Create an App in Vungle

Follow these steps to create a new app in Vungle.

  1. Log in to Vungle's platform and go to the All Applications drop-down and then click Add A New Application:

92d33fb-Screen_Shot_2019-04-01_at_13.52.53.png

  1. Enter the settings for your new app:

fcdc051-Screen_Shot_2019-04-01_at_13.56.08.png

Step 3: Create a Placement for your App

  1. Enter the details for the placement in the app:

ccc894c-Screen_Shot_2019-04-01_at_13.58.32.png

  1. When completed, click Continue.

The Vungle SDK Integration window opens, showing the details entered in the previous window:

4adcc9a-Screen_Shot_2019-04-01_at_14.07.08.png

Step 4: Retrieve the Parameters from the Vungle Dashboard

To enable Vungle to work as an Ad Network with Fyber, you must obtain four parameters from your Vungle account and later insert them into the Fyber Console.

Set out below are the details of what parameters are required, how and where to obtain them.

The parameters required depend on whether you are configuring the network at the App Level or Placement Level in the Fyber Console.

Vungle Parameter Description Fyber Placement / App
Vungle App ID A unique identifier of your application in Vungle’s system. Both
Reporting API Key A unique identifier for your Vungle account. Along with the Reporting API ID,
allowing your FairBid Mediation platform to import performance data from
your Vungle account.
Both
Placement Name & Reference ID This is the unique identifier of the ad unit, necessary to differentiate
Rewarded Video from Interstitial ads.
Placement

Alternatively, watch and listen to the video below to find out how to obtain the required parameters:

Once you have retrieved this information, you must configure Vungle’s parameters in your Fyber Account.

 

Retrieving the Vungle App ID and Reporting API ID

To obtain the Vungle App ID, follow these steps:

  1. Click the All Applications dropdown menu
  2. Select your app to display the app settings:

d68ed10-Screen_Shot_2019-04-01_at_14.17.28.png

Retrieving the Reporting API Key

To obtain the Reporting API Key, follow these steps:

  1. From the left-hand menu scroll down and click Reports:

7c91e63-Screen_Shot_2019-04-01_at_14.23.26.png

  1. Click on Reporting API Key on the Reports page:

09c56f0-Screen_Shot_2019-04-01_at_14.25.13.png

Your Reporting API Key is displayed:

dc2482b-Screen_Shot_2019-04-01_at_14.26.50.png

Retrieving the Placement Name and Reference ID

Follow these steps to obtain the Placement Name and Reference ID.

  1. From the left-hand menu scroll down and click Placements:

e2ac36a-Screen_Shot_2019-04-01_at_14.29.37.png

The Placements window opens and all Placement Names and Reference IDs are displayed:

Now that you have obtained the required parameters, you can complete the configuration of Vungle in your Fyber Account.

Step 5: Insert the Vungle Parameters into the Fyber Console

To enter the parameters obtained from Vungle and insert them into the Fyber Console, follow these steps.

  1. Sign-in to your Fyber account.
  2. Select your app from the App Management window.

  1. On the App Management page, click Mediated Networks.

  1. Select Vungle from the list

The Vungle Mediation window opens:

  1. Enter the Vungle app credentials and set the Instance name.

Instance name should be distinguishable in case you have multiple Vungle Instances.

Note

If you are configuring the mediated network at app level, fewer credentials may be required.

  1. Click Save.
  2. To complete the set up, you must associate the network instance that you just created to the relevant Placement set up on the Fyber dashboard. For a detailed guide click here

Step 6: Adding the Vungle SDK to your Integration

To add the Vungle SDK go to the Supported Networks page and follow the guide while selecting the Configuration for Vungle.