Getting Started with the Android SDK

Getting started with the Taboola Android SDK

Welcome to the Taboola Android SDK Quick Start Guide for displaying Taboola in your app.

Step 1: Add the library dependency to your project

Latest version: 2.2.1 (Released on May 12th, 2019)

//Include the Taboola SDK binary
implementation 'com.taboola:android-sdk:2.2.1'

//Include Chrome custom tabs (mandatory)
implementation 'com.android.support:customtabs:27.+'
  
//Note: It is advised to use the same version for Custom Tabs
//and your project's compileSdkVersion. For example: 
//For 'compileSdkVersion' 27 use 'com.android.support:customtabs:27.+'

Important

  • Taboola SDK supports Android API 14 and above
  • The SDK size is 261.57 KB

Step 2: Verify the AndroidManifest.xml

Include this line in your app’s AndroidManifest.xml to allow Internet access and read the network state

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

Step 3: Proguard rules

Please make sure to add the following Proguard rules

For SDK versions 2.1.1 and above:

###---------- Begin: proguard configuration for Taboola Android SDK 2.1.1 and above  ----------

-dontwarn com.taboola.android.api.**
-keepnames class com.taboola.android.integration_verifier.testing.tests.proguard_stub.ProguardVerificationStub

###---------- End: proguard configuration for Taboola Android SDK  ----------

For all Android SDK versions before 2.1.0:

###---------- Begin: proguard configuration for Taboola Android SDK  ----------

-keep class com.taboola.android.monitor.** {*;}
-dontwarn com.taboola.android.api.**
-dontwarn com.google.gson.annotations.**
-dontwarn com.taboola.android.mediation.DfpCustomEventBanner
-dontwarn com.taboola.android.mediation.MoPubCustomEventBanner

###---------- End: proguard configuration for Taboola Android SDK  ----------

Step 4: Stay-up-to-date

We encourage developers to use the latest SDK version. To stay up-to-date, we suggest to touch base with your account manager. We highly recommend updating to the latest SDK version once a quarter.


What's Next

Choose the type of Taboola asset you would like to integrate

Taboola Widget
Taboola Feed

Getting Started with the Android SDK


Getting started with the Taboola Android SDK

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.