Current SDK Version: 2.3.0

This guide is intended for developers who are integrating the with an Android app. After you have integrated the SDK, you must choose the relevant ad format and follow the steps for implementing that format.

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

Fyber supports both Gradle dependencies or manual download to integrate our SDK:

Gradle

Add Fyber's maven repository and dependencies to your gradle build script:

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

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

allprojects {
  repositories {
    maven {
        url  "https://fyber.bintray.com/maven" 
    }
  }
 ...
}

2. Save your file
3. Add the following to your app’s app level build.gradle file inside the dependencies section:

dependencies {
 ...
     implementation 'com.fyber:fairbid-sdk:2.3.0'
 ...
 }

4. Save your file

Manual Download

1. Download the
2. Extract inner zip file
3. Import the aar packages into your project.
4. Add Gson into your project. A detailed guide can be found here.

The Google Play Services SDK must be added to your project. Follow Google's documentation on integrating the Google Play Services SDK into your app.

Only the Ads and Location APIs are included. If you are using a Gradle build system with Android Studio adding the following to build.gradle is sufficient:

1. Add the following to your app’s build.gradle:

implementation 'com.google.android.gms:play-services-ads:17.1.1' //11.x and onwards is supported
//Optionally, add the location services - 
implementation 'com.google.android.gms:play-services-location:11.+'

2. Modify your Android Manifest
3. Add the following to your app’s manifest.xml within the <application> tag:

<!-- Google Play Services -->
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version"/>

1. Add the following attribute to the <application> tag to enable hardware acceleration:

<application android:hardwareAccelerated="true" ...>

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:

<!-- 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" />

In addition to integrating the , publishers who are using , must integrate chosen 3rd-party networks' SDKs into their app.

1. Set up your app in the network's dashboard and in the . A step-by-step guide can be found here.
2. Download the relevant network's SDK. Supported networks and their SDKs can be found here.
3. Add additional manifest modifications

Targeting Android P

When targeting Android P and using video ads, you must add an exception rule to 'localhost' found in your apps Network Security Configuration.

1. Make the Network Security Configuration xml with the code below:

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
   <base-config cleartextTrafficPermitted="true">
       <trust-anchors>
           <certificates src="system" />
       </trust-anchors>
   </base-config>
   <domain-config cleartextTrafficPermitted="true">
       <domain includeSubdomains="true">127.0.0.1</domain>
   </domain-config>
</network-security-config>

2. Modify your manifest of your app to point to this file.
   The following code is an example of how to create this entry:

<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
    <application android:networkSecurityConfig="@xml/network_security_config"
                    ... >
        ...
    </application>
</manifest>

More information can be found here.