Show Sidebar

AdColony Integration using iOS SDK

Current AdColony Version: 3.0.5
Supported Ad Formats: The VMAX SDK supports Interstitials, Interstitial Video Ads, and Rewarded Video Ads from AdColony.

You will need

  1. an active AdColony account
  2. User Credentials
  3. your Api Key
  4. the App ID
  5. the Zone ID
  6. the All Zone ID (for Incent video ads)

In AdColony

  1. From the AdColony dashboard, choose your app. Your App ID will be labeled as “AdColony App ID” on this page.
  2. From the AdColony dashboard, choose your app. Select an existing Zone to view its ID, or create a new zone by choosing “Setup New Ad Zone” and selecting the “Interstitial” or “Value Exchange/V4VC” zone type.
  3. Your API key will be labeled as “Read-Only API Key” on this page.

Further Integration

Step 1: Integrate the VMAX Library Adapters VMaxAdColonyInterstitialAdapter.h and VMaxAdColonyInterstitialAdapter.m from the Adapters .zip folder.

Step 2: Integrate the main framework file AdColony.framework.

Step 3: Integrate the dependent framework files to Target > Build Phases > Link Binary With Libraries:

    • libz.1.2.5.tbd
    • AdColony.framework
    • AdSupport.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CoreTelephony.framework
    • EventKit.framework
    • JavaScriptCore.framework (Set to Optional)
    • MessageUI.framework
    • Social.framework
    • StoreKit.framework
    • SystemConfiguration.framework
    • WatchConnectivity.framework (Set to Optional)
    • WebKit.framework (Set to Optional)

Step 4: Add the following linker flag to Target > Build Settings > Linking > Other Linker Flags:

Step 5: Add the following exceptions to Info.plist file

Step 6: Add following entry for configuring url schemes

Step 7: Add following entry for privacy control

Please note that adding these keys is not necessary if your app is compiled with Xcode 7 (iOS 9 SDK).

Note : 

AdColony will throw an error if your application’s supported orientations have no common orientations with the AdColony framework. For instance, if you have a portrait only app then you should enable all orientations in the app and then individually for each controller, define which orientation it supports, this will enable views that require landscape support for ad networks like AdColony to display ads in portrait as well as landscape.
Not doing so can result in exceptions such as the following:

Terminating app due to uncaught exception ‘UIApplicationInvalidInterfaceOrientation’, reason: ‘Supported orientations has no common orientation with the application, and [ADCContainer shouldAutorotate] is returning YES’

What would you like to do next?