iOS SDK Integration


Current SDK Version: 3.35.0


This guide is intended for developers who are integrating the DT FairBid SDK with an iOS app. After you have integrated the SDK, choose the relevant ad format and follow the steps for implementing that format.


  • Xcode 14.1+
  • iOS 11+

Step 1: Integration

Digital Turbine supports both CocoaPods and manual download to integrate our SDK:


Add the following line to your Podfile and run the pod install command

pod 'FairBidSDK', '~> 3.35.0'


Manual Download

  1. Download the DT FairBid SDK
  2. Extract it.
  3. Drag and drop FairBidSDK.framework to your project. Ensure Copy items if needed checked.

  1. From the General tab of your Xcode project's target settings page, ensure the DT FairBidSDK framework is embedded into your app.

Step 2: Configuring Your Xcode Project

The next step in the process is to configure your Xcode Project.

Importing System Frameworks

If the option Enable Modules (CLANG_ENABLE_MODULES) is active in the project's Build Settings, there's no need to import any frameworks manually. All you have to do is to import the DT FairBid framework umbrella header in your code, for example in the AppDelegate class:

Objective-C Swift
#import <FairBidSDK/FairBidSDK.h>

If you cannot enable modules, you might need to add these frameworks to the Frameworks, Libraries and Embedded Content section in Xcode:













Disable Multitasking

From the General tab of your Xcode project's target settings page, check the box labeled Requires full screen (this disables multitasking support, which must be disabled for ads to be able to set the orientation of their views):

Strip Linked Products Build Flag

By default, Xcode strips libraries linked to the project. This may result in symbols missing for some ad networks. The DT FairBid SDK may not behave as expected.

To avoid this, set Strip Linked Products (STRIP_INSTALLED_PRODUCT) build flag to No:

App Transport Security

iOS 9 added App Transport Security (ATS), which requires apps to use HTTPS for all networking. As of 2017, Apple requires that all apps use ATS unless they state a reason they are unable to do so.

All of the 3rd networks that can be used with DT FairBid fully support ATS, and do not require any additional configuration.


Starting from the iOS 10.0, if there are two keys present in the info.plist - both NSAllowsArbitraryLoadsInWebContent and NSAllowsArbitraryLoads, the NSAllowsArbitraryLoads has no effect.

If you require global permission, keep only the NSAllowArbitraryLoads with YES in your .plist file, and delete the NSAllowArbitraryLoadsInWebContent key. Otherwise, it doesn't work since the NSAllowArbitraryLoadsInWebContent cancels out the previous one.

The same applies for the following keys:

  • NSAllowsArbitraryLoadsForMedia
  • NSAllowsLocalNetworking

In addition, it is important to understand, that the NSAllowsArbitraryLoadsForMedia does not exclude the VAST videos, in terms of ATS. It does not have any effect on the DT Exchange SDK and only overrides the global NSAllowsArbitraryLoads key, which results in a secure request, even it was not intended to do so.

Enabling Global Permissions

To enable a global permission to a non-secured HTTP request, add the following to your Info.plist file:

Add the key and value to the file Info.plist if you open the file as property list.

Property list

App Transport Security Settings
Allow Arbitrary Loads


Alternatively, if you want to add directly to the source code of the file - Info.plist.




After adding the ATS to the file - Info.plist.

Step 3: Privacy Enhancements and MRAID (optional)

You may statically declare your app’s intended usage of protected data classes by including the appropriate purpose string keys in your Info.plist file.

  • Search for the following code in your Info.plist:

Privacy Enhancements and MRAID

“Privacy - Calendars Usage Description” 
“Privacy - Photo Library Additions Usage Description” 
“Privacy - Photo Library Usage Description” 

Step 4: Adding 3rd Party SDKs

In addition to integrating the DT FairBid SDK, publishers who are using DT FairBid Mediation, must integrate chosen 3rd-party networks' SDKs into their app.

  1. Set up your app in the network's dashboard and in the DT Console. A step-by-step guide can be found here
  2. Download the SDK of the relevant network.
    Supported networks and their SDKs can be found here.

Back to Top ⇧