Vungle Integration Guide
This guide will instruct you step-by-step on how to set Vungle live as an ad network on the ironSource Mediation platform.
If you would like to add Vungle as a bidding network, please reach out to your Vungle representative and/or fill in additional details via this form and a Vungle rep will get back to you.
The Vungle iOS SDK v.6.8.0+ (Vungle adapter 4.3.6+) supports Xcode 12 or higher. Building on Xcode 11 or below is not supported.
Step 1. Create a Vungle Account
- Create an account with Vungle. You can do so here.
- Once your account has been verified you can log in at their partner login here.
Step 2. Create an Application in Vungle
Once you log in, go to the Applications tab on the left side menu drop-down in the upper-left corner and click ‘Add Application‘:
Step 3. Add a Placement
Click on the relevant app from the application list and on the app’s dedicated page, click ‘Add Placement‘:
When creating Banner ad placement, it’s recommended to disable the “Ad Refresh” option. You can later control the refresh rate on the mediation platform.
Step 4. Activate Vungle on ironSource SDK Networks Module
There are d 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:
|Vungle App ID||This is the unique identifier of your application in Vungle’s system.|
|Reporting API ID||This is a unique identifier for your app in Vungle’s system, 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 ironSource Mediation Platform to import performance data from your Vungle account.|
|Placement Reference ID||This is the unique identifier of the ad unit, necessary to differentiate Rewarded Video from Interstitial ads and Banner ads.|
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.
Vungle Application ID
Go to the Applications tab on the left side menu and click on the application you would like to configure on ironSource dashboard. You will then see Vungle App ID:
Reporting API ID
Go to the Applications tab on the left side menu and click on the application you would like to configure on ironSource dashboard. You will then see Vungle Reporting API ID:
Reporting API Key
Go to the My Account on the upper-right corner of the screen you will them see the Reporting API Key:
Placement Reference ID
Go to the Placements tab on the left side menu and choose the application’s placements you would like to configure on ironSource dashboard:
Activate Vungle on ironSource Platform
Once you’ve collected all necessary parameters, log in to your ironSource account.
- Go to ‘Monetize‘ ➣ ‘Setup‘ ➣ ‘SDK Networks‘:
- Select Vungle from the list of Available Ad Networks and enter the Vungle ‘Reporting API Key‘:
- Click ‘Save‘. Vungle will then be enabled in the Available Ad Networks table:
- Click on the Vungle’s Setup button and enter the ‘App ID‘, ‘Reporting API ID‘ and the
under the relevant Ad Unit Settings:
- You will then see Vungle as Active for Mediation on your Setup Dashboard.
- 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 5. Add the Vungle Adapter to Your Build
ironSource supports both Cocoapods and Manual download mechanisms.
To integrate the Vungle SDK with Cocoapods, enter the following line in your podfile and you’re good to go!
- Download the Vungle Adapter:
Add the Vungle Adapter and SDK files to your build. You can find the latest Vungle files here.
Important! The Vungle Adapter does not contain the Vungle SDK. You need to add the Vungle SDK as well.
- Add the Vungle XCframeworks to your Project:
After you download and unzip the Adapter and SDK files, drop the XCframework files into your Xcode project.
- Remove the iOS Status Bar
For optimal user experience, Vungle strongly recommends removing the iOS Status bar when their ad unit is served to your users. To do this, open your Info.pList, add the key “View controller-based status bar appearance” and set it to “No“.
Evaluate Your Ad Network Integration When set to YES, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units! Supported for SDK versions 6.5.2 and up.
Evaluate Your Ad Network Integration
When set to YES, this line of code will enable debug logs to help you troubleshoot issues with all of your mediation ad networks. Remove this code before your app goes live with our ad units! Supported for SDK versions 6.5.2 and up.
Step 6. Vungle Additional Settings
COPPA User status
ironSource’s mediation lets publishers communicate Vungle COPPA settings directly to the Vungle network. This feature is enabled using ironSource SDK 7.2.2+, Vungle Android Adapter 4.3.20+. Read more about Vungle COPPA API here.
Use the following syntax, to update Vungle’s COPPA User Status with the parameter “Yes”:
[IronSource setMetaDataWithKey:@"Vungle_coppa" value:@"Yes"];
Use the following syntax, to update Vungle’s COPPA User Status with the parameter “No”:
[IronSource setMetaDataWithKey:@"Vungle_coppa" value:@"No"];
You are now all set to deliver Vungle Ads within your application!
To leverage additional ad networks through ironSource Mediation, integrate the adapters and follow our integration guides