Show Sidebar


Sorry, this entry is only available in English. For the sake of viewer convenience, the content is shown below in the alternative language. You may click the link to switch the active language.

Step 1: Download the SDK

Before proceeding, ensure that you have the latest version of the VMAX SDK for iOS.

The minimum requirements for VMAX SDK for iOS are Xcode 8.0 and iOS version 8.0. If you wish to use Google AdMob the minimum requirements are Xcode 8.0 and iOS version 9.0.

Step 2: Set up the SDK

Extract all the files from the SDK archive into a separate folder.

Add support for iOS 9

Currently the VMAX SDK and all the Mediation Adapters do not support Bitcode So if you are using Xcode 8 or higher then in Build Settings set “Enable Bitcode” setting to NO. Also add -lxml2 and -ObjC to Linker Flags.

Enable Bitcode Setting to No


Add Linker Flags

Add -lxml2, -fobjc-arc, -lstdc++ and -ObjC to Linker Flags.


Support for iOS 9

iOS 9 supports only HTTPS communication. To override this behaviour set the below dictionary in your application info.plist.

Additional Steps for Swift

  1. Add VMAXSDK-Bridge.h to your Xcode Swift project.
  2. Go to the Xcode Build settings. Set Objective C Bridging Header setting to VMAXSDK-Bridge.h relative path from your Xcode project file.

Step 3: Setup Viewability SDK

Viewability is a metric for ensuring that an ad has the opportunity to be seen. For an ad to be considered viewable, the ad content must be within the viewport of App for a minimum period of time.
Advertisers these days are always careful about viewability metrics for ads and ensure that if they have been actually viewed by their valued targeted audience and not by Bots. viewability measurement has became necessary requirement for many Big brands and advertiser.
To measure viewability for In-App environment, your App needs to incorporate SDKs of viewability partners. MOAT & IAS are leading viewability vendors which advertiser and publisher use in Industry.
Advertiser are willing to pay premium price for viewable ad inventory. App publishers who don’t integrate viewability SDK may miss out on ad spending of premium brand & advertiser who’s prerequisite is viewable ad inventory. Hence We strongly recommend to use viewblity SDK to inccrease your revenue. To integrate viewability SDK follow the below steps.

  1. Add the file “VMXMoatMobileAppKit.framework” in project workspace at path “Adapter/lib/..”
  2. The Moat SDK requires the following system frameworks to be included in your app:
    1. AdSupport.framework
    2. WebKit.framework (may be marked as optional)
  3. Add VMax Moat Adapter.
    In project directory add MOAT Adapter on path Adapter/..

Custom Player Integration for MOAT to track VMAP:

If the Ad playback is done by some other SDK and needs to be tracked by MOAT, app publisher needs to make use of below mentioned API’s. This guide is customized especially for ads played using Google IMA.

Note: Copy Adapter/Custom Player-IMA folder into your workspace.

  1. API to dispatch ad progress event

It will track the ad’s playback progress. Ads SDK will notify MOAT for  ad progress events and MOAT will internally track events like STARTED, FIRST_QUARTILE, MIDPOINT, THIRD_QUARTILE, PAUSED, SKIPPED, COMPLETED

  1. It takes object of type IMAAdEvent, reference to the view where the ad is rendered and current position of player in milliseconds.

    Following is the usage of the API

    Objective CSwift

  2.  API to track volume change events

    If the player has a custom volume control, such as a mute or un-mute button, please notify the tracker about player volume changes with the following API.

Objective CSwift

  • Step 4: Integrate the SDK

    Using Objective-C

    Import Header Files

    Confirm Your Class

    You need to confirm your class to VMaxAdDelegate protocol to be able to receive the SDK Callbacks. For the MyCustomViewController integration class, the signature is shown below:

    SDK Calls


    You need to confirm your class to VMaxAdDelegate protocol to be able to receive the SDK Callbacks. For the MyCustomViewController  integration class, the signature is shown below:

    Objective CSwift

    Header paths for the integrated mediation frameworks / VMAX SDK.

    Library search paths for the integrated frameworks / VMAX SDK i.e. ‘libVMaxAdSDK.a’ file.

    Note: For the header and library paths ensure that you manually specify the paths relative to your project if Xcode does not do this automatically.

    Next Steps

    Once you’re done with these preliminary steps, read more on how to request ads.