You are here: Developers > OpenX Mobile iOS SDK > Integrating the SDK with your app

Integrating the SDK with your app

Last updated on August 23, 2017

Note: Please make sure you are using the latest version of Xcode.

To manually integrate the SDK with your Xcode project:

  1. In Xcode, open your project and remove any previously installed versions of OpenXSDKCore.

  2. If you have any existing code integrating the SDK, compare the code samples and instructions in this documentation for each ad type to determine what you must change.

  3. Expand the zip file.

  4. Drag OpenXSDKCore.framework from the expanded zip file into your project.

  5. Verify that the Copy items into destination's group folder option is selected and click OK.

  6. Open your project's target settings.

  7. Remove the frameworks from Linked Frameworks and Libraries. Then, drag the SDK frameworks into Embedded Binaries. The frameworks should appear only once in the Linked Frameworks and Libraries and only once in Embedded Binaries.

  8. Select the Build Settings tab.

  9. Search for Embedded Content Contains Swift Code or Always Embed Swift Standard Libraries and change the value to Yes.

  10. In the Deployment Info section of the General tab, set Deployment Target for your app to 8.0 or higher. (iOS 8 is the minimum supported iOS release for the SDK.)

  11. For MRAIDMobile Rich Ad Interface Definitions, a type of API framework for interfacing between an ad creative and native mobile capabilities. ads, you should include all orientations you wish to support in your app’s info.plist file.

Initialize the SDK

  1. Initialize the SDK using OXMSDKConfiguration.


    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {


    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    	[OXMSDKConfiguration initializeSDK];
  2. Set up OXMAdView in Interface Builder.
  3. Now you are ready to integrate banner or interstitial ads into your app.

    See also ATS support in iOS SDK.

Feedback form