Show Sidebar

VMAX SDK for iOS

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 or Millennial Media Mediation, 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

image05

Add Linker Flags

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

image07

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.                                                          
  3. VMAXSDK-Bridge.h also bridges VMAX Native Ad Adapters Helper libraries which is disabled by default. If you intend to use VMAX Native Helper libraries in your application, then define the Preprocessor Macro VMAX_USING_NATIVE_ADS in your application Build Setting as shown below. This will include the header files of VMAX Native helper libraries.

 

Step 3: 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

MyCustomViewController.m

  1. Header paths for the integrated mediation frameworks / VMAX SDK.
  2. 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.

Using Swift

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

Note:

From SDK Version 3.6.10 and onwards there are some delegate changes.

Next Steps

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