Ctrlk
DT Employee Sign-In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

iOS

Current SDK Version: 3.68.0

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

Prerequisites

  • Xcode 26.0 or later

  • iOS 15 or later

Integration

There are three frameworks required to incorporate into your app:

Digital Turbine supports CocoaPods, Swift Package Manager, 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.68.0'

Swift Package Manager

The DT FairBid SDK can be integrated using Swift Package Manager as an alternative to CocoaPods. The SPM package delivers FMPAdapter and IASDKCore automatically, so you don't need to add them separately.

  1. In Xcode, open your project and go to File→Add Package Dependencies….

  2. In the Search/URL field, paste the FairBid package URL:

  1. Set the Dependency Rule to Up to Next Minor Version starting from the version you want to integrate (for example, 3.68.0), and click Add Package.

  2. When prompted, select the FairBidSDK library product, add it to your app target, and click Add Package.

  3. Select your app target and go to Build Settings. For Other Linker Flags (OTHER_LDFLAGS), add the -ObjC linker flag.

This flag is required for every project, Swift and Objective-C alike. Swift Package Manager doesn't pass linker flags to your app target automatically. Without it, your app may crash at runtime.

  1. Configure your Xcode project as described in Configuring Your Xcode Project.

Manual Download

iOS SDK 3.68.0

  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:

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.

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.

Last updated