Android SDK Integration

0e05303-Android_icon.png

This is one of four guides that walk you through integrating the DT FairBid SDK with an Android app:

  1. Android SDK Integration (this guide)
  2. Setting-Up DT Fairbid (in the DT Console)
  3. Initializing the SDK
  4. Android Ad Formats (adding the ads to your app)

Current SDK Version

  • 3.49.1

Note that since version 3.41.0, DT FairBid and DT Offer Wall are integrated through the same SDK - the DT FairBid SDK.

Prerequisites

  • Android 4.1 (API Level 16)+
  • Google Play Services 11.4.0+

Integration

DT supports both Gradle dependencies and manual download to integrate our SDK:

Gradle

Add DT's maven repository and plugins to your gradle build script:

  • Add the following to your project’s root level build.gradle file inside the repositories section:

In root level build.gradle there are usually two repositories sections - one for buildscript and one for allprojects. Add the entry in allprojects.

allprojects {
   repositories {
       mavenCentral()
  }
  ...
}
  • Add the following to your project’s app level build.gradle file inside the plugins section (further documentation):
plugins {
    ...
    id 'com.fyber.fairbid-sdk-plugin' version '3.49.1'
    ...
}
  • If you support Android SDK below 26, you must add the following snippet to the Android section (for Java Version Compatibility):
android {
    ...
    compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
    }
  ...
}

Manual Download

 
  • Download the DT FairBid SDK
  • Extract it
  • 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:

Optional Permissions

<!-- 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 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.

  • Set up your app in the network's dashboard and in the DT Console. A step-by-step guide can be found here.
  • Download the relevant network's SDK. Supported networks and their SDKs can be found here.
    • You must add additional configurations for each third party network.
    • These entries are found by selecting your third party networks in the table.

Important

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

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

Back to Top ⇧