Android

Current SDK Version: 3.66.1

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

Prerequisites

• Android 4.4 (API Level 19) or later

• Kotlin 2.1.0 or later

• Google Play Services 11.4.0 or later

Tooling

FairBid SDK does not require specific tooling, e.g., Android Studio, Android Gradle Plugin (AGP), Java Development Kit (JDK), and Gradle. However, if you use the following versions of Gradle, use the following versions of AGP and JDK:

• For Gradle 7.5 or later:

  • AGP 7.5. or later

  • JDK 11

• For Gradle 8 or later:

  • AGP 8 or later

  • JDK 17

Compile and Target SDK

FairBid SDK does not require specific compile or target SDK versions for your app. It maintains compatibility by performing runtime checks for APIs that are not available in the minimum supported version (API Level 19). The highest Android API that FairBid directly utilizes is API Level 30.

Integration

DT supports both Gradle dependencies and manual downloads to integrate the SDK.

Gradle

Add DT Maven repository and plugins to your Gradle build script:

1. Add the following to your project's root-level build.gradle file inside the repositories section.

2. At the root level build.gradle file, there are usually two repository sections - one for buildscript and one for allprojects. Add the entry in allprojects:

Gradle

allprojects {
    repositories {
        mavenCentral()
    }
    ...
}

1. Add the following to the project app-level build.gradle file inside the plugins section. For more information, see Types of Gradle Plugins:

Gradle

plugins {
    ...
    id 'com.fyber.fairbid-sdk-plugin' version '3.66.1'
    ...
}

1. If you support Android SDK below 26, add the following snippet to the Android section (for Java Version Compatibility):

Gradle

android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    ...
}

Manual Download

↓ Android SDK 3.66.1

1. Download the DT FairBid SDK.

2. Extract the file.

3. Import the .aar packages into your project.

Optional Permissions

The following permissions are not required for our SDK or 3rd-party SDKs to function, but including them in your AndroidManifest.xml may result in improved eCPM and user experience:

XML

<!-- Optionally used by FairBid -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

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.