Vungle New Integration Guide for Rewarded Video

This document will guide you through the process of adding Vungle as an ad network to your Fyber integration.

Setting Up Your App in the Vungle Dashboard

Warning! If you are adding an Ad network that you've previously integrated into your app without Fyber mediation, please set up a new app in the relevant Demand Partner dashboard to get a new set of credentials to be used with Fyber.
Please do not reuse your previous Ad network credentials, as this will cause reporting discrepancies and affect optimization.

The first step is to login to the Vungle dashboard and create a new app. To do so, go to https://v.vungle.com/dashboard/ and log in with your credentials.

1. Add new app

In the beginning of the applications list within the Management section of the dashboard you will see a link to add a new app.

image

2. Select your platform: Android / iOS

3. Fill the form with the app details

You’ll see a form with the app details to be filled. Confirm all information is correct and click on Submit.

You should see a confirmation and a new page with your application details.

App details in the Vungle Dashboard

In the application details page you’ll these parameters:

  • 1. Vungle Application ID: This tells our SDK what is the correspondent Vungle App that we need to get ads for.

  • 2. Reporting API ID: This parameter will be used later in the integration setup to make sure we pull data for the correct app.

image

Warning! If your app runs both in Android and iOS, you will need to create two apps on Vungle’s dashboard, as well as two apps on Fyber side.

Warning! Please note that you need to enable your app after you have it in the store.

Integrating the Vungle bundle into your App

After you have set the app on Vungle’s dashboard, you can integrate the Vungle ANE into your app.

Import the .ane File into your project

1. Right click on your project in the Package Explorer:

image

2. Select Properties:

image

3. Next, select Flex Build PathNative Extensions.

image

4. Click to add your .ane file. Make sure to select Update AIR Application Descriptor to avoid any extra work or build issues.

5. Next, set up your Native Extensions by selecting the Package to be used for your selected platform:

image

This will add the .ane to your project.

Configure your application’s Manifest file for Vungle:

Add the following entries in your application’s manifest file

	<manifest android:installLocation="auto">

		[...]

	    <!-- permissions to download and cache video ads for playback -->
	  	<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" />

        <application>

			[...]

			<meta-data android:name="com.google.android.gms.version"
				android:value="@integer/google_play_services_version" />

			<!--
			  Required Activity for playback of Vungle video ads
			-->
			<activity android:name="com.vungle.publisher.FullScreenAdActivity"
				android:configChanges="keyboardHidden|orientation|screenSize"
				android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
			/>

		</application>

	</manifest>

Note: If you are using several ad networks, please consult the Build settings overview for a list of frameworks and linker flags to be added for each ad network.

Making the Fyber SDK aware of your Vungle integration

  1. Copy the newest adapters.info (available here) matching the Fyber SDK version that you’re using into the root of your src/assets folder in your application.

  2. You can configure the networks directly from the Dashboard, by going to Ad Networks → Vungle, and filling in the necessary values. For your convenience, the relevant fields are labeled the same as in the current adapters.config. If you do not want to use the Dashboard, make sure to fill out the adapters.config as below.

  3. If you don’t already have an adapters.config file, you can download it here. Copy the file into the root of your src/assets folder in your application.

Important: The default adapters.config file contains templates for all supported adapters. Please delete all the entries that you are not currently using.

  1. Make sure that your adapters.config contains the following information:
{
	"adapters":[

	[…]

		{
			"name":"Vungle",
			"settings":
			{
				"app.id":"**Vungle App ID**",
				"comment":"optional configurations starting below",
				"sound.enabled": BOOLEAN,
				"auto.rotation.enabled": BOOLEAN,
				"back.button.enabled": BOOLEAN,
				"incentivized.mode": BOOLEAN,
				"cancel.dialog.title": "** customized cancel dialog title **",
				"cancel.dialog.text": "** customized cancel dialog text**",
				"cancel.dialog.button": "** customized cancel button**",
				"keep.watching.text": "** keep watching text **"
			}
		}
	]
}
  1. You are now ready to run video ads from Vungle. You can set the test mode for your application on the Vungle dashboard to see test videos.

Find the Reporting API Credentials in the Vungle Dashboard

Note: To get access to Vungle’s reporting API you need to contact your Vungle Account Manager directly. You should do this before following these steps.

To enable Reporting for Vungle, you’ll need the following values from the Vungle Dashboard:

  • Reporting API ID
  • Reporting API Key

Where to find the Parameters

You can find Reporting API ID parameter in the application details of Vungle’s dashboard. Go to Management, then click on the required application to reach the page.

In order to get your Reporting API Key, you need to contact tech-support@vungle.com.

image

Setting up Vungle mediation in the Fyber Dashboard

As the last step in your integration you need to enable the ad network in the Fyber Dashboard.

Before this, make sure you:

  • Have everything set up on Vungle side
  • Have fully integrated the SDK

IMPORTANT: In the next step you’ll need to fill ‘Appid’ and ‘Key’ in the Fyber Dashboard. Fill these in according to the following mapping:

  • In the Appid field in the Fyber dashboard, enter the Reporting API ID from Vungle.
  • In the Key field in the Fyber dashboard, enter the Reporting API Key from Vungle.

Example: