Note If using the Fabric IDE plugins, you can skip this article. The Fabric plugin will walk you through setting up the MoPub SDK.

This document details the process of integrating the MoPub SDK with your mobile application. If you have any questions, don't hesitate to email us at support@mopub.com.

Here are the basic integration steps:

1. Download the MoPub SDK
2. Add the SDK to your Xcode project.
3. Create and use a Banner or Interstitial ad.

Download the MoPub iOS SDK

The MoPub SDK is distributed as source code that you must include in your application. MoPub provides two prepackaged archives of source code:

• MoPub Full SDK.zip

  Includes everything you need to serve HTML and MRAID MoPub advertisements and built-in support for three major third party ad networks - iAd, Google AdMob, and Millennial Media - including the required third party binaries.

• MoPub Base SDK.zip

  Includes everything you need to serve HTML and MRAID MoPub advertisements. No third party ad networks are included.

Incorporate the MoPub iOS SDK

These instructions assume that you have downloaded one of the MoPub SDK zip archives.

1. Download and unzip the MoPub iOS SDK.
2. Drag the MoPubSDK folder into your Xcode application group (be sure to check the "Copy items into destination group's folder" option).

3. Add the following frameworks to your project. To do this, click on your application's target, then click on Build Phases and expand the Link Binary With Libraries group. The MoPub Base SDK requires the following frameworks:

   • AdSupport.framework†
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • EventKit.framework
   • EventKitUI.framework
   • Foundation.framework
   • MediaPlayer.framework
   • QuartzCore.framework
   • StoreKit.framework†
   • SystemConfiguration.framework
   • UIKit.framework

   In addition, the third party networks bundled into the MoPub Full SDK require

   • AudioToolbox.framework
   • AVFoundation.framework
   • iAd.framework
   • MessageUI.framework
   • MobileCoreServices.framework
   • PassKit.framework†
   • Social.framework†

   † Of these, you can mark AdSupport.framework, Passkit.framework, Social.framework, and StoreKit.framework as optional. This is necessary if you are targeting iOS versions below 6.0.

You should now be ready to implement a Banner or Interstitial ad. To mediate a third party network that is not supported, you can build a Custom Event.

For Applications that use MRC

If your application uses Manual Reference Counting (MRC) you must tell the compiler to build the MoPub iOS SDK source files with ARC. This has no impact on your application and can be done relatively easily:

First, click on your application's target, then click on Build Phases and expand the Compile Sources group. Now select all the MoPubSDK source files. These will be grouped together near the end if you have recently dragged the SDK in.

Once the files are selected scroll down and double click on the last file. You should see a blank popup appear. Enter -fobjc-arc and hit return. This should add the -fobjc-arc flag to all the selected files.

Using the GitHub Repository Source Code

While the bundled zips are the preferred method to install the MoPub SDK you can, instead, clone the git repository:

git clone git://github.com/mopub/mopub-ios-sdk.git

The installation instructions are similar to the ones outlined above for the zip archives. To install the base SDK you must drag in the contents of the MoPubSDK folder.

Using CocoaPods

The MoPub SDK is available through Cocoapods, a popular dependency management system for Objective-C projects.

To download and incorporate the MoPub SDK into your project using Cocoapods, add the following line to your project's podfile:

pod 'mopub-ios-sdk'

After running pod install (if you’re setting up Cocoapods for the first time) or pod update (if you’re adding MoPub to an existing Cocoapods project), your project will be ready to use the base MoPub SDK.

Adding Third Party ad Networks

These instructions apply if you need to support third party ad networks that are not included in the MoPub Full SDK zip archive, or if you have chosen to install MoPub using the base zip archive or from the GitHub repo.

Third party ad networks are supported via custom event plugins. These are in the AdNetworkSupport folder. The iOS MoPub SDK includes custom events for iAd, Chartboost, Google AdMob, Conversant, InMobi, and Millennial Media. To install a custom event you must:

1. Download the desired third party SDK and add the header files and static libraries to your project. (For iAd you simply need to link against the iAd framework, there is nothing to download).

2. Add the desired custom event to your project. You do this by cloning the mopub-ios-sdk repo and dragging the custom event .h and .m files from the relevant SDK folder under AdNetworkSupport.

   Most integrations have two custom events, one for Banner ads and one for Interstitial ads (Chartboost is an exception, it only provides interstitial ads).

More detailed instructions are available. If you want to integrate with an ad network that is not supported, you can write your own custom event.

Third Party Ad Networks and Cocoapods

MoPub maintains custom adapters for several third party networks. A number of them are available through our Cocoapod spec that provides a simple integration experience. To use these subspecs, add the desired subspecs from the list below to your podfile.

pod 'mopub-ios-sdk/iAd'
pod 'mopub-ios-sdk/AdMob'
pod 'mopub-ios-sdk/AdColony'    
pod 'mopub-ios-sdk/Chartboost'

After adding the desired subspecs, the next time pod install or pod update is run Cocoapods will pull in the appropriate MoPub Custom Event classes and third party ad network SDK binaries. Currently we only support subspecs for iAd, Google AdMob, Ad Colony, and Chartboost. For other mediated networks, please follow these instructions for installation. We will certify and update our list of supported third party ad networks as new pods become available.