Mediate with iOS

Supported networks and media types

This section lists the networks that we provide mediation adaptors for, and the media types that each adaptor supports. For each adaptor, we show whether it supports banners, interstitials, native, or all three.

Adaptor Version Banner Interstitial Native Docs
AdMob and DFP 10.10.0 Yes Yes Yes Google Mobile Ads - iOS Document
SmartAdServer 7.24.2 Yes Yes No SmartAdServer Documentation

Prerequisites

To mediate these networks, you'll need the following:

  • A supported release of our SDK. For instructions on installing our SDK, see Integrate with iOS.

  • The SDK of the network you want to mediate.

  • A mediation adaptor that allows our SDK to communicate with the network's SDK. If you use CocoaPods, use the code below in your project directory's PodFile. You can include as many or as few adaptors as you like from this list:

    platform :ios, '12.0'
    
    target 'SimpleBanner' do
      pod 'AppNexusSDK/GoogleAdapter'
      pod 'AppNexusSDK/SmartAdAdapter'
    end   
    

Instantiate mediation adaptors

If you use the following adaptor, you need to initialize the adaptor's SDK as early as possible in the lifecycle of the application. A perfect place to do this is in the app delegate. The code samples below show how to do this.

AdMob native mediation

Note

The instructions in this section are only needed if you are doing native mediation. Mediating banners and interstitials should not require any initialization code or further work.

To handle AdMob native ads, you need to:

  1. Create a native ad view that inherits from GADNativeAdView:

    #pragma mark - ANNativeAdRequestDelegate
    - (void)adRequest:(ANNativeAdRequest *)request didReceiveResponse:(ANNativeAdResponse *)response
    {
       ...
       if (self.nativeAdResponse.networkCode == ANNativeAdNetworkCodeAdMob) {
        // If ANNativeAdNetworkCodeAdMob, special Steps are there for creating a View which supports Google's MediaView Requirements.
    
        GADNativeAdView *nativeAdView = // Pass your Google Admob View(Step 2)for rendering Native Ad response ;
        ...
        // All the native components will be set as regular Ad  
        // Main Image is automatically added by GoogleSDK in the MediaView
       }else{
         ...
          // If not ANNativeAdNetworkCodeAdMob, create a regular View for all others.
       }
    }
    

    Note

    For SDK v5.3 and higher, you need to specify the GADIsADManagerApp key in the app's info.plist with a boolean YES value.

    <key>GADIsAdManagerApp</key>
     <true/>
    
  2. Set up the custom keyword.

    For passing the content URL to the Google SDK, the content URL needs to be passed as a custom keyword with the requester ad object (BannerAdView, InterstitialAdView, NativeAdRequest). The key to be used is content_url. Here is an example:

    // Add key content_url with a value (www.appnexus.com).
    [adView addCustomKeywordWithKey:@"content_url" value:@"www.appnexus.com"];
    

AdMob banner mediation

Note

The instructions in this section are only needed to load AdMob banner ads in iPads for the apps that support multi-window capability.

To handle AdMob banner ads for the apps that support multi-window capability in iPads, Xandr Mobile SDK provides a public class ANGoogleMediationSettings. This class contains:

  • Boolean method setIPadMultiSceneSupport that needs to be set as YES, if the app supports multi-screen in iPads.

  • Getter method getIPadMultiSceneSupport to fetch the value set for the apps.

    Code Sample (Objective C)

    /**
    Set setIPadMultiScreenSupport to YES if the application will support multiscene in iPad.
    */
    + (void)setIPadMultiSceneSupport:(BOOL)setIPadMultiSceneSupport;
    + (BOOL)getIPadMultiSceneSupport;
    

Additionally, publishers should load the ad from viewDidAppear method instead of viewDidLoad in the app.

Example of use (Objective C)

/**
 Set setIPadMultiScreenSupport to YES if the application will support multiscene in iPad.
 */
[ANGoogleMediationSettings setIPadMultiSceneSupport:YES];

Custom mobile networks

Microsoft Monetize has built-in support for a number of popular mobile ad networks. If you want to mediate a network it doesn't support, you must: