Enable MoPub Mediation on iOS v.6.5.3 and Lower

Use this guide to add Vungle iOS SDK into your app, using MoPub as your main advertising mediation layer.

Contents:

• Before You Begin
• Step 1. Set Up Vungle as a Network
• Step 2. Add Vungle as a Third-Party Ad Network
• Optional Advanced Settings

Before You Begin

Requirements

• The MoPub iOS adapter 6.5.3.0 is compatible with Vungle iOS SDK 6.5.3.
• The Vungle iOS adapter 6.5.3 has been tested with MoPub iOS SDK 5.11.0.
• The MoPub Dashboard does not yet include Vungle placements; check your placement-level performance using our Reporting API for Publishers.
• MoPub must be set up in your app before starting this tutorial. For a step-by-step guide, refer to MoPub’s Getting Started Guide for iOS.
• Refer to our MoPub integration documentation on integrating MoPub with your app.
  • Interstitial: https://developers.mopub.com/docs/ios/interstitial/
  • Rewarded Video: https://developers.mopub.com/docs/ios/rewarded-video/
  • Banner (320 x 50), Leaderboard (728 x 90), MREC (300 x 250): https://developers.mopub.com/publishers/ios/banner/
• Set up the application with the correct XCode and iOS SDK version, as detailed in our iOS integration instructions.

Integrate the Vungle iOS SDK and the MoPub Adapter Framework

1. Download the Vungle SDK for iOS.
2. Follow our integration instructions. 
3. Download the Vungle MoPub iOS Adapter Framework 6.5.3 and follow MoPub's instructions to integrate it.

Step 1. Set Up Vungle as an SDK Network or as a Custom Native Network

You can set up Vungle either as an SDK network or as a custom network with MoPub.

Option 1. Set Up Vungle as an SDK Network

1. Log in to the MoPub dashboard and select Networks from the main navigation panel.
2. Click New network.
   
   
   
   and select Vungle.
   
   
3. In the Network Settings section, if you Enable reporting access, enter your Reporting API Key from the Vungle Dashboard.
   
   
4. In App & Ad Unit Setup, enter the Vungle Application ID and Placement Reference IDs.
   
   

Option 2. Set Up Vungle as a Custom Network

To ensure that the MoPub servers recognize the integrated Vungle Adapters, set up Vungle as a custom network in the MoPub dashboard.

1. Log into the MoPub dashboard, and navigate to Networks by the main navigation bar.
2. Click New Network button on the top right.
   
   
   and select Vungle from the list.
3. After creating Vungle as a Network, click on the name from the list of Networks. In the Set Up Your Inventory section, for each ad unit that will use the Vungle SDK to present video ads, ensure that the MoPub SDK can find the network adapter used to interact with the Vungle SDK:

• If you are using MoPub Rewarded Video​ for an Ad Unit, add VungleRewardedVideoCustomEvent under the Custom Event Class​ section.
• If you are using Interstitial for an Ad Unit, add VungleInterstitialCustomEvent under the Custom Event Class.
• If you are using MREC for an Ad Unit, add VungleBannerCustomEvent under the Custom Event Class.
• If you are using Banner (320 x 50), Leaderboard (728 x 90) or Medium (300 x 250)​ for an ad unit, add VungleBannerCustomeEvent under the Custom Event Class section.
• Add your Vungle App ID, placement reference ID of the placement to be called from the ad unit, and all placement reference IDs in JSON format under the Custom Event Class Data.
• Set the placement reference ID you want to link to the MoPub Ad Unit for pid.
• Make sure to link a placement that is set to rewarded type at Vungle dashboard to the MoPub Ad Unit that is set to Rewarded Video​; and link a placement that is set to interstitial type at Vungle dashboard to the MoPub Ad Unit that is set to Fullscreen (320 x 480).
  

  {
  "appId":"59208865950e6d380100001f", 
  "pid":"DEFAULT07430"
  }

  
  Note: The Vungle SDK will cache an ad automatically for the placement selected to be Cache Optimized​ in the Vungle Dashboard. Please reach out to your Account Manager for more information.

Step 2. Add Vungle as a Third-Party Ad Network

To add the Vungle iOS SDK into your app using MoPub mediation:

1. Add all the Vungle-related adapter files to /AdNetworkSupport/Vungle/ and make sure to include .m files in the project's Build Phases → Compile Sources.
   

   VungleAdapterConfiguration.h
   VungleAdapterConfiguration.m         
   VungleBannerCustomEvent.h
   VungleBannerCustomEvent.m    
   VungleInstanceMediationSettings.h
   VungleInstanceMediationSettings.m
   VungleInterstitialCustomEvent.h
   VungleInterstitialCustomEvent.m
   VungleRewardedVideoCustomEvent.h
   VungleRewardedVideoCustomEvent.m
   VungleRouter.h
   VungleRouter.m

2. Copy the VungleSDK.framework folder into /AdNetworkSupport/Vungle/SDK/.
   
   
   • Make sure the project's Build Settings → Framework Search Path includes the framework. For example:

     $(PROJECT_DIR)/AdNetworkSupport/Vungle/SDK/VungleSDK.framework

   • Make sure the framework is included in the project's Build Phases → Link Binary With Libraries.
3. Follow the instructions in the “Add Other Required Frameworks“ section of our integration instructions to add the necessary frameworks.
4. Follow the instructions in the “Add the “-ObjC” Linker Flag“ section of our integration instructions to add the linker flag.
5. Follow the instructions in the “Remove the iOS Status Bar“ section of our integration instructions to remove the status bar.
6. Call the MPInterstitialAdController’s showFromViewController method (or, for rewarded ads, call the MPRewardedVideo's presentRewardedVideoAdForAdUnitID method) when you want to present a Vungle video ad! (No need to call the Vungle iOS SDK methods directly. The MoPub SDK will do it.)

Banner Ad Size

Vungle supports following banner ad sizes: Banner, MREC, Leaderboard. Use an ad container that is no smaller than the specified size, and use the corresponding size configuration when requesting for banner ads.

Sample code: 

self.adView = [[MPSampleAppInstanceProvider sharedProvider] buildMPAdViewWithAdUnitID:self.info.ID size:MOPUB_MEDIUM_RECT_SIZE];

Optional Advanced Settings

Early SDK Initialization (Recommended)

MoPub iOS SDK 5.5.0 and higher allows you to early initialize ad network SDK when MoPub SDK completes initialization. We strongly recommend you to use this feature as it will allow additional time for Vungle SDK to pre-cache an ad and have it ready to play at display opportunity.

Sample code:

MPMoPubConfiguration * sdkConfig = [[MPMoPubConfiguration alloc]
initWithAdUnitIdForAppInitialization:@"MOPUB_AD_UNIT_WITH_VUNGLE_PLACEMENT"];

NSMutableDictionary *configDictionary = [NSMutableDictionary dictionaryWithDictionary:@{ @"appId" : @"YOUR_VUNGLE_APP_ID" }];
 
[sdkConfig setNetworkConfiguration:configDictionary forMediationAdapter:@"VungleAdapterConfiguration"];

[[MoPub sharedInstance] initializeSdkWithConfiguration:sdkConfig
   completion:^{
  NSLog(@"SDK initialization complete");
}];

Memory Settings

Starting from Vungle SDK v6.4.0, you can prevent the SDK from downloading, requesting ads, or even initializing if the storage of your iOS device falls below a predefined threshold.

These are the option keys available:

Sample code:

NSMutableDictionary *configDictionary = [NSMutableDictionary dictionaryWithDictionary:@{ @"appId" : @"YOUR_VUNGLE_APP_ID" }];

[[NSUserDefaults standardUserDefaults] setValue:@(50) forKey:@"vngMinSpaceForInit"];
[[NSUserDefaults standardUserDefaults] setValue:@(50) forKey:@"vngMinSpaceForAdLoad"];
 
[sdkConfig setNetworkConfiguration:configDictionary forMediationAdapter:@"VungleAdapterConfiguration"];

Restrict Collection of IDFV

Starting with Vungle iOS SDK 6.4.3, you can restrict the SDK from passing IDFV when Limit Ad Tracking option is enabled on user's devices. Import VungleRouter.h to access this API and use it in your AppDelegate before Vungle SDK is initialized.

Sample code:

#import "VungleRouter.h"

// Invoke setShouldCollectDeviceId before initialization of Vungle SDK
[VungleRouter.sharedRouter setShouldCollectDeviceId:NO];

Customize Rewarded Ads

You can use VungleInstanceMediationSettings to customize rewarded ad experience.

These are the option keys available:

Customize Interstitial Ads

Starting with MoPub adapter 6.4.5.1, you can use localExtras to pass customization options for interstitial ads.

These are the option keys available:

Sample code:

NSNumber *orientations = [NSNumber numberWithInt:1];
NSString *ordinal = @"10";
NSNumber *muted = [NSNumber numberWithBool:YES];

NSDictionary *localExtras = @{@"ordinal" : ordinal ?: @"",
                              @"muted" : muted ?: @"",
                              @"orientations" : orientations ?: @""};
    
self.interstitial.localExtras = localExtras;