Manual Download for MAX Mediation Networks

Starting from Pangle iOS adapter version 4.9.1.0.0, Pangle is no longer available in Chinese Mainland. If you wish to monetize Chinese Mainland traffic, please set up the CSJ network and add the CSJ adapter. For global traffic excluding Chinese Mainland, you can continue to use Pangle for monetization.

Swift Build Settings

To support Swift for iOS versions below 12.2, in the main target of your Xcode project select File > Build Settings and set Always Embed Swift Standard Libraries to Yes.

App Delegate window Property

Do not remove the window property of your App Delegate file as this might crash InMobi’s SDK.

• @property (nonatomic, strong) UIWindow *window;

• var window: UIWindow?

Meta Audience Network Data Processing Options

If you do not want to enable Limited Data Use (LDU) mode, pass SetDataProcessingOptions() an empty array:

• #import <FBAudienceNetwork/FBAudienceNetwork.h>
  ⋮
  [FBAdSettings setDataProcessingOptions: @[]];
  ⋮
  // Initialize MAX SDK

• import FBAudienceNetwork
  ⋮
  FBAdSettings.setDataProcessingOptions([])
  ⋮
  // Initialize MAX SDK

To enable LDU for users and specify user geography, call SetDataProcessingOptions() in a form like this:

• #import <FBAudienceNetwork/FBAudienceNetwork.h>
  ⋮
  [FBAdSettings setDataProcessingOptions: @[@"LDU"] country: 1 state: 1000];
  ⋮
  // Initialize MAX SDK

• import FBAudienceNetwork
  ⋮
  FBAdSettings.setDataProcessingOptions(["LDU"], country: 1, state: 1000)
  ⋮
  // Initialize MAX SDK

Meta Audience Network Data Processing Options for Users in California

For information about how to implement Meta Audience Network’s “Limited Data Use” flag in California, visit the Meta for Developers documentation.

Meta Preparing for iOS 14.5 and Above

Audience Network SDK 6.2.1 was released on January 11, 2021. This version has these important requirements:

• Implement the setAdvertiserTrackingEnabled flag, irrespective of the use of mediation, to inform Meta whether to use the data to deliver personalized ads.
• Add the SKAdNetwork IDs that Meta suggests to the Xcode project’s Info.plist in order for advertisers to measure the success of ad campaigns. Refer to the SKAdNetwork documentation for integration instructions.

• [sdk initializeSdkWithCompletionHandler:^(ALSdkConfiguration *sdkConfiguration)
  {
     if ( @available(iOS 14.5, *) )
     {
       // Note that App transparency tracking authorization can be checked via `sdkConfiguration.appTrackingTransparencyStatus`
       // 1. Set Meta ATE flag here, THEN
     }
  
     // 2. Load ads
  }];

• sdk.initializeSdk { (sdkConfiguration: ALSdkConfiguration) in
  
    if #available(iOS 14.5, *)
    {
      // Note that App transparency tracking authorization can be checked via `sdkConfiguration.appTrackingTransparencyStatus`
      // 1. Set Meta ATE flag here, THEN
    }
    
    // 2. Load ads
  }

Add Your Google AdMob / Google Ad Manager App ID

In your app’s Info.plist, add a GADApplicationIdentifier key with a String value of your AdMob / Google Ad Manager App ID.

Use the latest Amazon Publisher Services adapter version to avoid reporting discrepancies.

Initialize the Amazon SDK

The Amazon Publisher Services SDK requires that you initialize it outside of MAX SDK:

[[DTBAds sharedInstance] setAppKey: appId];
DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName: DTBADNETWORK_MAX];
[DTBAds sharedInstance].mraidCustomVersions = @[@"1.0", @"2.0", @"3.0"];
[[DTBAds sharedInstance] setAdNetworkInfo: adNetworkInfo];
[DTBAds sharedInstance].mraidPolicy = CUSTOM_MRAID;

Load a Banner Ad from Amazon’s SDK

To integrate Amazon banner ads into MAX, you must load the Amazon ad first, then pass the DTBAdResponse or DTBAdErrorInfo into the instance of MAAdView by calling -[MAAdView setLocalExtraParameterForKey:value:] before you load the MAX ad.

For auto-refreshing banner ads you only need to load the ad once.

• @interface ExampleViewController ()<DTBAdCallback>
  ⋮
  @end
  
  @implementation ExampleViewController
  
  - (void)viewDidLoad
  {
    [super viewDidLoad];
  
    NSString *amazonAdSlotId;
    MAAdFormat *adFormat;
  
    if ( UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad )
    {
      amazonAdSlotId = @"Amazon-leader-slot-ID";
      adFormat = MAAdFormat.leader;
    }
    else
    {
      amazonAdSlotId = @"Amazon-banner-slot-ID";
      adFormat = MAAdFormat.banner;
    }
  
    CGSize rawSize = adFormat.size;
    DTBAdSize *size = [[DTBAdSize alloc] initBannerAdSizeWithWidth: rawSize.width
                                                            height: rawSize.height
                                                       andSlotUUID: amazonAdSlotId];
  
    DTBAdLoader *adLoader = [[DTBAdLoader alloc] init];
    [adLoader setAdSizes: @[size]];
    [adLoader loadAd: self];
  }
  
  - (void)onSuccess:(DTBAdResponse *)adResponse
  {
    // 'adView' is your instance of MAAdView
    [self.adView setLocalExtraParameterForKey: @"amazon_ad_response" value: adResponse];
    [self.adView loadAd];
  }
  
  - (void)onFailure:(DTBAdError)error dtbAdErrorInfo:(DTBAdErrorInfo *)errorInfo
  {
    // 'adView' is your instance of MAAdView
    [self.adView setLocalExtraParameterForKey: @"amazon_ad_error" value: errorInfo];
    [self.adView loadAd];
  }
  
  @end

• import AppLovinSDK
  import DTBiOSSDK
  
  class ExampleViewController: UIViewController
  {
    override func viewDidLoad()
    {
      super.viewDidLoad()
  
      let amazonAdSlotId: String
      let adFormat: MAAdFormat
  
      if UIDevice.current.userInterfaceIdiom == .pad
      {
        amazonAdSlotId = "Amazon-leader-slot-ID"
        adFormat = MAAdFormat.leader
      }
      else
      {
        amazonAdSlotId = "Amazon-banner-slot-ID"
        adFormat = MAAdFormat.banner
      }
  
      let rawSize = adFormat.size
      let size = DTBAdSize(bannerAdSizeWithWidth: Int(rawSize.width),
                           height: Int(rawSize.height),
                           andSlotUUID: amazonAdSlotId)!
  
      let adLoader = DTBAdLoader()
      adLoader.setAdSizes([size])
      adLoader.loadAd(self)
    }
  }
  
  extension ExampleViewController: DTBAdCallback
  {
    func onSuccess(_ adResponse: DTBAdResponse!)
    {
      // 'adView' is your instance of MAAdView
      adView.setLocalExtraParameterForKey("amazon_ad_response", value: adResponse)
      adView.loadAd()
    }
  
    func onFailure(_ error: DTBAdError, dtbAdErrorInfo: DTBAdErrorInfo!)
    {
      // 'adView' is your instance of MAAdView
      adView.setLocalExtraParameterForKey("amazon_ad_error", value:dtbAdErrorInfo)
      adView.loadAd()
    }
  }

Load an MREC Ad from Amazon’s SDK

To integrate Amazon MRECs into MAX, you must load the Amazon ad first, then pass the DTBAdResponse or DTBAdErrorInfo into the instance of MAAdView by calling -[MAAdView setLocalExtraParameterForKey:value:] before you load the MAX ad.

• @interface ExampleViewController ()<DTBAdCallback>
  ⋮
  @end
  
  @implementation ExampleViewController
  
  - (void)viewDidLoad
  {
    [super viewDidLoad];
  
    NSString *amazonAdSlotId;
    DTBAdLoader *adLoader = [[DTBAdLoader alloc] init];
    [adLoader setAdSizes: [[DTBAdSize alloc] initBannerAdSizeWithWidth: 300
                                                            height: 250
                                                       andSlotUUID: amazonAdSlotId]];
    [adLoader loadAd: self];
  }
  
  - (void)onSuccess:(DTBAdResponse *)adResponse
  {
    // 'adView' is your instance of MAAdView
    [self.adView setLocalExtraParameterForKey: @"amazon_ad_response" value: adResponse];
    [self.adView loadAd];
  }
  
  - (void)onFailure:(DTBAdError)error dtbAdErrorInfo:(DTBAdErrorInfo *)errorInfo
  {
    // 'adView' is your instance of MAAdView
    [self.adView setLocalExtraParameterForKey: @"amazon_ad_error" value: errorInfo];
    [self.adView loadAd];
  }
  
  @end

• import AppLovinSDK
  import DTBiOSSDK
  
  class ExampleViewController: UIViewController
  {
    override func viewDidLoad()
    {
      super.viewDidLoad()
  
      let amazonAdSlotId: String
  
      let adLoader = DTBAdLoader()
      adLoader.setAdSizes([DTBAdSize(bannerAdSizeWithWidth: 300,
                           height: 250,
                           andSlotUUID: amazonAdSlotId)!])
      adLoader.loadAd(self)
    }
  }
  
  extension ExampleViewController: DTBAdCallback
  {
    func onSuccess(_ adResponse: DTBAdResponse!)
    {
      // 'adView' is your instance of MAAdView
      adView.setLocalExtraParameterForKey("amazon_ad_response", value: adResponse)
      adView.loadAd()
    }
  
    func onFailure(_ error: DTBAdError, dtbAdErrorInfo: DTBAdErrorInfo!)
    {
      // 'adView' is your instance of MAAdView
      adView.setLocalExtraParameterForKey("amazon_ad_error", value:dtbAdErrorInfo)
      adView.loadAd()
    }
  }

Load an Interstitial Ad from Amazon’s SDK

To integrate Amazon interstitial ads into MAX, you must load the Amazon ad first, then pass the DTBAdResponse or DTBAdErrorInfo into the instance of MAInterstitialAd by calling -[MAInterstitialAd setLocalExtraParameterForKey:value:] before you load the MAX ad.

You must load and pass the Amazon DTBAdResponse or DTBAdErrorInfo into the MAInterstitialAd instance only once per session.

• #import <AppLovinSDK/AppLovinSDK.h>
  #import <DTBiOSSDK/DTBiOSSDK.h>
  
  @interface ExampleViewController ()<DTBAdCallback>
  ⋮
  @end
  
  @implementation ExampleViewController
  static MAInterstitialAd *interstitialAd;
  static BOOL isFirstLoad;
  
  + (void)initialize
  {
    [super initialize];
  
    interstitialAd = [[MAInterstitialAd alloc] initWithAdUnitIdentifier: @"MAX-inter-ad-unit-ID"];
    isFirstLoad = YES;
  }
  
  - (void)loadAd
  {
    // If first load - load ad from Amazon's SDK, then load ad for MAX
    if ( isFirstLoad )
    {
      isFirstLoad = NO;
  
      DTBAdLoader *adLoader = [[DTBAdLoader alloc] init];
      [adLoader setAdSizes: @[
        [[DTBAdSize alloc] initInterstitialAdSizeWithSlotUUID: @"Amazon-inter-slot-ID"]
      ]];
      [adLoader loadAd: self];
    }
    else
    {
      [interstitialAd loadAd];
    }
  }
  
  - (void)onSuccess:(DTBAdResponse *)adResponse
  {
    // 'interstitialAd' is your instance of MAInterstitialAd
    [interstitialAd setLocalExtraParameterForKey: @"amazon_ad_response" value: adResponse];
    [interstitialAd loadAd];
  }
  
  - (void)onFailure:(DTBAdError)error dtbAdErrorInfo:(DTBAdErrorInfo *)errorInfo
  {
    // 'interstitialAd' is your instance of MAInterstitialAd
    [interstitialAd setLocalExtraParameterForKey: @"amazon_ad_error" value: errorInfo];
    [interstitialAd loadAd];
  }
  
  @end

• import AppLovinSDK
  import DTBiOSSDK
  
  class ExampleViewController: UIViewController
  {
    private static var interstitialAd = MAInterstitialAd(adUnitIdentifier: "MAX-inter-ad-unit-ID")
    private static var isFirstLoad = true
  
    func loadAd()
    {
      // If first load - load ad from Amazon's SDK, then load ad for MAX
      if Self.isFirstLoad
      {
        Self.isFirstLoad = false
  
        let adLoader = DTBAdLoader()
        adLoader.setAdSizes([DTBAdSize(interstitialAdSizeWithSlotUUID: "Amazon-inter-slot-ID")!])
        adLoader.loadAd(self)
      }
      else
      {
        Self.interstitialAd.load()
      }
    }
  }
  
  extension ExampleViewController: DTBAdCallback
  {
    func onSuccess(_ adResponse: DTBAdResponse!)
    {
      // 'interstitialAd' is your instance of MAInterstitialAd
      Self.interstitialAd.setLocalExtraParameterForKey("amazon_ad_response", value: adResponse)
      Self.interstitialAd.load()
    }
  
    func onFailure(_ error: DTBAdError, dtbAdErrorInfo: DTBAdErrorInfo!)
    {
      // 'interstitialAd' is your instance of MAInterstitialAd
      Self.interstitialAd.setLocalExtraParameterForKey("amazon_ad_error", value: dtbAdErrorInfo)
      Self.interstitialAd.load()
    }
  }

Load a Video Interstitial Ad from Amazon’s SDK

To integrate Amazon interstitial ads into MAX, you must load the Amazon ad first, then pass the DTBAdResponse or DTBAdErrorInfo into the instance of MAInterstitialAd by calling -[MAInterstitialAd setLocalExtraParameterForKey:value:] before you load the MAX ad.

You must load and pass the Amazon DTBAdResponse or DTBAdErrorInfo into the MAInterstitialAd instance only once per session.

• #import <AppLovinSDK/AppLovinSDK.h>
  #import <DTBiOSSDK/DTBiOSSDK.h>
  
  @interface ExampleViewController ()<DTBAdCallback>
  ⋮
  @end
  
  @implementation ExampleViewController
  static MAInterstitialAd *interstitialAd;
  static BOOL isFirstLoad;
  
  + (void)initialize
  {
    [super initialize];
  
    interstitialAd = [[MAInterstitialAd alloc] initWithAdUnitIdentifier: @"MAX-inter-ad-unit-ID"];
    isFirstLoad = YES;
  }
  
  - (void)loadAd
  {
    // If first load - load ad from Amazon's SDK, then load ad for MAX
    if ( isFirstLoad )
    {
      isFirstLoad = NO;
  
      DTBAdLoader *adLoader = [[DTBAdLoader alloc] init];
  
      // Switch video player width and height values(320, 480) depending on device orientation
      [adLoader setAdSizes: @[
        [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth: 320 height: 480 andSlotUUID:@"Amazon-video-inter-slot-ID"]
      ]];
      [adLoader loadAd: self];
    }
    else
    {
      [interstitialAd loadAd];
    }
  }
  
  - (void)onSuccess:(DTBAdResponse *)adResponse
  {
    // 'interstitialAd' is your instance of MAInterstitialAd
    [interstitialAd setLocalExtraParameterForKey: @"amazon_ad_response" value: adResponse];
    [interstitialAd loadAd];
  }
  
  - (void)onFailure:(DTBAdError)error dtbAdErrorInfo:(DTBAdErrorInfo *)errorInfo
  {
    // 'interstitialAd' is your instance of MAInterstitialAd
    [interstitialAd setLocalExtraParameterForKey: @"amazon_ad_error" value: errorInfo];
    [interstitialAd loadAd];
  }
  
  @end

• import AppLovinSDK
  import DTBiOSSDK
  
  class ExampleViewController: UIViewController
  {
    private static var interstitialAd = MAInterstitialAd(adUnitIdentifier: "MAX-inter-ad-unit-ID")
    private static var isFirstLoad = true
  
    func loadAd()
    {
      // If first load - load ad from Amazon's SDK, then load ad for MAX
      if Self.isFirstLoad
      {
        Self.isFirstLoad = false
        let adLoader = DTBAdLoader()
  
        // Switch video player width and height values(320, 480) depending on device orientation
        adLoader.setAdSizes([DTBAdSize(videoAdSizeWithPlayerWidth: 320, height: 480, andSlotUUID: "Amazon-video-inter-slot-ID")!])
        adLoader.loadAd(self)
      }
      else
      {
        Self.interstitialAd.load()
      }
    }
  }
  
  extension ExampleViewController: DTBAdCallback
  {
    func onSuccess(_ adResponse: DTBAdResponse!)
    {
      // 'interstitialAd' is your instance of MAInterstitialAd
      Self.interstitialAd.setLocalExtraParameterForKey("amazon_ad_response", value: adResponse)
      Self.interstitialAd.load()
    }
  
    func onFailure(_ error: DTBAdError, dtbAdErrorInfo: DTBAdErrorInfo!)
    {
      // 'interstitialAd' is your instance of MAInterstitialAd
      Self.interstitialAd.setLocalExtraParameterForKey("amazon_ad_error", value: dtbAdErrorInfo)
      Self.interstitialAd.load()
    }
  }

Load a Rewarded Video Ad from Amazon’s SDK

To integrate Amazon rewarded videos into MAX, you must load the Amazon ad first, then pass the DTBAdResponse or DTBAdErrorInfo into the instance of MARewardedAd by calling -[MARewardedAd setLocalExtraParameterForKey:value:] before you load the MAX ad.

You must load and pass the Amazon DTBAdResponse or DTBAdErrorInfo into the MARewardedAd instance only once.

• #import <AppLovinSDK/AppLovinSDK.h>
  #import <DTBiOSSDK/DTBiOSSDK.h>
  
  @interface ExampleViewController ()<DTBAdCallback>
  ⋮
  @end
  
  @implementation ExampleViewController
  static MARewardedAd *rewardedAd;
  static BOOL isFirstLoad;
  
  + (void)initialize
  {
    [super initialize];
  
    rewardedAd = [MARewardedAd sharedWithAdUnitIdentifier: @"MAX-rewarded-ad-unit-ID"];
    isFirstLoad = YES;
  }
  
  - (void)loadAd
  {
    // If first load - load ad from Amazon's SDK, then load ad for MAX
    if ( isFirstLoad )
    {
      isFirstLoad = NO;
  
      DTBAdLoader *adLoader = [[DTBAdLoader alloc] init];
  
      // Switch video player width and height values(320, 480) depending on device orientation
      [adLoader setAdSizes: @[
        [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth: 320 height: 480 andSlotUUID:@"Amazon-video-rewarded-slot-ID"]
      ]];
      [adLoader loadAd: self];
    }
    else
    {
      [rewardedAd loadAd];
    }
  }
  
  - (void)onSuccess:(DTBAdResponse *)adResponse
  {
    // 'rewardedAd' is your instance of MARewardedAd
    [rewardedAd setLocalExtraParameterForKey: @"amazon_ad_response" value: adResponse];
    [rewardedAd loadAd];
  }
  
  - (void)onFailure:(DTBAdError)error dtbAdErrorInfo:(DTBAdErrorInfo *)errorInfo
  {
    // 'rewardedAd' is your instance of MARewardedAd
    [rewardedAd setLocalExtraParameterForKey: @"amazon_ad_error" value: errorInfo];
    [rewardedAd loadAd];
  }
  
  @end

• import AppLovinSDK
  import DTBiOSSDK
  
  class ExampleViewController: UIViewController
  {
    private static var rewardedAd = MARewardedAd.shared(withAdUnitIdentifier: "MAX-rewarded-ad-unit-ID")
    private static var isFirstLoad = true
    func loadAd()
    {
      // If first load - load ad from Amazon's SDK, then load ad for MAX
      if Self.isFirstLoad
      {
        Self.isFirstLoad = false
  
        let adLoader = DTBAdLoader()
  
        // Switch video player width and height values(320, 480) depending on device orientation
        adLoader.setAdSizes([DTBAdSize(videoAdSizeWithPlayerWidth: 320, height: 480, andSlotUUID: "Amazon-video-rewarded-slot-ID")!])
        adLoader.loadAd(self)
      }
      else
      {
        Self.rewardedAd.load()
      }
    }
  }
  
  extension ExampleViewController: DTBAdCallback
  {
    func onSuccess(_ adResponse: DTBAdResponse!)
    {
      // 'rewardedAd' is your instance of MARewardedAd
      Self.rewardedAd.setLocalExtraParameterForKey("amazon_ad_response", value: adResponse)
      Self.rewardedAd.load()
    }
  
    func onFailure(_ error: DTBAdError, dtbAdErrorInfo: DTBAdErrorInfo!)
    {
      // 'rewardedAd' is your instance of MARewardedAd
      Self.rewardedAd.setLocalExtraParameterForKey("amazon_ad_error", value: dtbAdErrorInfo)
      Self.rewardedAd.load()
    }
  }

Testing Amazon Publisher Services

AppLovin recommends that you enable test mode for Amazon’s SDK to receive test ads. You can do this with the following calls:

• [[DTBAds sharedInstance] setLogLevel: DTBLogLevelAll];
  [[DTBAds sharedInstance] setTestMode: YES];

• DTBAds.sharedInstance().setLogLevel(DTBLogLevelAll)
  DTBAds.sharedInstance().testMode = true

To filter your waterfalls to contain only Amazon ads, navigate to Select Live Network in the Mediation Debugger and select the Amazon network.

Enable Google Ad Manager

In your app’s Info.plist, add a GADIsAdManagerApp key with the Boolean value of YES.

Disable App Transport Security

Disable App Transport Security (ATS) by adding NSAppTransportSecurity to your app’s Info.plist. Then add the key NSAllowsArbitraryLoads and set it to YES. Make sure this is the only key present.

SKAdNetwork

Refer to the SKAdNetwork documentation for integration instructions.