1. Home
  2. Project Setup

Project Setup

These are a few quick steps that must be taken prior to integrating Tapsell ads in your application.

Step 1: Setup Tapsell SDK

In order to add the Tapsell SDK to your project you can either download the SDK and add it to your Libs directory, or use Maven Repository.

Method 1

Download Tapsell SDK
You can download our SDK from the following url:


Add Tapsell SDK to your Project:

Add the downloaded jar files to libs folder in your project. Then add the following to your module’s build.gradle file under dependencies:

dependencies {
    implementation fileTree (include:['*.aar'], dir:'libs')
    /**Other dependencies here*/


Method 2

if you want to use Maven, you can add the following code snippet to your build.gradle files.

Add the following code to project’s build.gradle file :

maven {
    url 'https://dl.bintray.com/tapsellorg/maven'

Then add this code snippet to application’s build.gradle’s dependencies:

// Android Studio 3.0 and above
implementation 'ir.tapsell.sdk:tapsell-sdk-android:4.0.5'

// Older Android Studio
compile 'ir.tapsell.sdk:tapsell-sdk-android:4.0.5'


Step 2: Update Manifest

Set the following permissions AndroidManifest.xml of your project before the application tag:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" /><!--optional-->
<uses-permission android:name="android.permission.VIBRATE" /><!--optional-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/><!--optional-->

As shown in the code above, ACCESS_COARSE_LOCATION permission is optional. However, adding this line would help Tapsell show targeted ads to your users.

Add the following activity definition within the application tag:

<activity android:name="ir.tapsell.sdk.TapsellAdActivity" 
          android:configChanges="keyboardHidden|orientation|screenSize" >


Step 3: Proguard Configuration

Add the following to your ProGuard configuration file:

-keepattributes Signature
-keepattributes *Annotation*
-keepattributes EnclosingMethod
-keep class sun.misc.Unsafe { *; }
-keepclassmembers enum * { *; }
-keep class **.R$* { *; }
-keep interface ir.tapsell.sdk.NoProguard
-keep class * implements ir.tapsell.sdk.NoProguard { *; }
-keep interface * extends ir.tapsell.sdk.NoProguard { *; }




Please let us know whether this document was helpful and what complications you faced while using Tapsell Android SDK.



Next: Integrating Interstitial/Rewarded Video and Interstitial Banner Ads in Android Project


Was this article helpful?