This is one of four guides that walk you through integrating the DT FairBid SDK with an Android app:
- Android SDK Integration (this guide)
- Setting-Up DT Fairbid (in the DT Console)
- Initializing the SDK
- Android Ad Formats (adding the ads to your app)
Current SDK Version
- 3.45.0
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.45.0' ... }
- 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 inner zip file
- 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.