iOS

Current SDK Version: 3.66.1

DT FairBid and DT Offer Wall are integrated through the same SDK: the DT FairBid SDK.

Prerequisites

• Xcode 14.1 or later

• iOS 13 orlater

Integration

There are three frameworks required to incorporate into your app:

• FairBid SDK

• FMPAdapter.framework

• IASDKCore.framework

Digital Turbine supports both CocoaPods and manual downloads to integrate the SDK.

CocoaPods

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

Ruby

pod 'FairBidSDK', '~ 3.66.1'

Manual Download

↓ iOS SDK 3.66.1

1. Download and extract the DT FairBid SDK.

2. Drag and drop FairBidSDK.xcframework to your project. The Choose options for adding these files window appears:

1. In the Action drop-down list, select Copy files to destination and click Finish.

1. Download the DTX iOS SDK FMPAdapter.

2. Drag and drop the FMPAdapter.xcframework to your project. The Choose options for adding these files window appears:

3. In the Action drop-down list, select Copy files to destination and click Finish.

1. Retrieve the IASDKCore.framework from Integrating the iOS SDK and download the SDK manually.

2. From DTExchangeSDK/iOS/IASDKCore/IASDKCore.xcframework, drag and drop the IASDKCore.xcframework to your project. The Choose options for adding these files window appears:

3. In the Action drop-down list, select Copy files to destination and click Finish.

1. From the General tab of your Xcode project's target settings page, ensure DT FairBidSDK, FMPAdapter, and IASDKCore frameworks are embedded into your app under Embed & Sign.

Configuring Your Xcode Project

Configuration of the Xcode projects involves the following steps.

1. Import System Frameworks.

2. Disable Multitasking.

3. Disable the Linked Products Build Flag.

4. App Transport Security.

Importing System Frameworks

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

Swift

#import <FairBidSDK/FairBidSDK.h>

Objective-C

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

• AdSupport

• CoreGraphics

• CoreLocation

• CoreTelephony

• MediaPlayer

• MessageUI

• MobileCoreServices

• QuartzCore

• Security

• StoreKit

• SystemConfiguration

Disable Multitasking

Select the Requires full-screen checkbox from the General tab of your Xcode project's target settings page. This disables multitasking support, which must be disabled for ads to be able to set the orientation of their views:

Disable the Linked Products Build Flag

By default, Xcode strips libraries linked to the project. This may result in symbols missing for some ad networks, and subsequently, 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

App Transport Security (ATS) Settings is an Apple security feature that enforces HTTPS connections. Make sure you disable this by setting the Allow Arbitrary Loads property to Yes so that you get the HTTP traffic as well. For more information, see ATS Configuration for DT Exchange SDK.

Adding Third-Party SDKs

In addition to integrating the DT FairBid SDK you must integrate chosen third-party networks' SDKs into their app.

• Set up your app in the network's dashboard and in the DT Console. For more information, see Setting Up DT FairBid.

• Download the relevant network's SDK. For more information about supported networks and their SDKs, see Supported Networks.

  • You must add additional configurations for each third-party network.

  • These entries are found by selecting your third-party networks in the table.

The DT FairBid SDK automatically detects and initializes SDKs from third-party networks.

Once you've added all third-party SDKs and set up your app in the console, you can initialize the DT Fairbid SDK.

The SKAdNetwork ID list may change over time. To ensure you have the most current information, DT recommends integrating the SKAdNetwork ID Auto Updater Tool into your build.