---
updatedAt: 2026-08-03T07:41:35.000Z
agentTools:
  projectIndex: https://developers.taboola.com/taboolasdk/llms.txt
---

# First Steps

*Android Classic* - First Steps

<br />

***

<Callout icon="✅" theme="okay">
  ### Tips

  1. _Classic_ integration is the _preferred_ method of integration.
  2. While reading the documentation, take a look at our [Sample App](https://developers.taboola.com/taboolasdk/docs/sample-code).
</Callout>

<Callout icon="📘" theme="info">
  The following steps are common to both Classic _and_ Web integrations.
</Callout>

## The Repository URL

There are 2 options, depending on how you configure your project repositories.

<Callout icon="📘" theme="info">
  All versions of the **Taboola SDK** are available via **Artifactory**.
</Callout>

### Option I: build.gradle

If you are using `build.gradle` or `build.gradle.kts` to configure your repositories, add the **Taboola URL** in your **top-level** `build.gradle` or `build.gradle.kts` file, under `allprojects` > `repositories`:

```groovy build.gradle (top-level)
buildscript {
    repositories {
        ...
    }
    dependencies {
        ...
    }
}

allprojects {
    repositories {
        ...
        maven {
            // Taboola:
            url 'https://taboolapublic.jfrog.io/artifactory/mobile-release'
        }
    }
}
```
```kotlin build.gradle.kts (top-level)
buildscript {
    repositories {
        ...
    }
    dependencies {
        ...
    }
}

allprojects {
    repositories {
        ...
        maven {
            // Taboola:
            url = uri("https://taboolapublic.jfrog.io/artifactory/mobile-release")
        }
    }
}
```

<Callout icon="🚧" theme="warn">
  ### Add the **Taboola** URL:

  1. In your **top-level** `build.gradle` or `build.gradle.kts` file.
  2. **Under** `allprojects` > `repositories`.
</Callout>

### Option II: settings.gradle

If you are using `settings.gradle` or `settings.gradle.kts` to configure your repositories, add the **Taboola URL** in `settings.gradle` or `settings.gradle.kts`):

```groovy settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            // Taboola:
            url "https://taboolapublic.jfrog.io/artifactory/mobile-release"
        }
    }
}
```
```kotlin settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            // Taboola:
            url = uri("https://taboolapublic.jfrog.io/artifactory/mobile-release")
        }
    }
}
```

## Dependencies

In your **app module** `build.gradle` or `build.gradle.kts` file, add the **Taboola** and **AndroidX Browser** *dependencies*:

```groovy build.gradle (app module)
dependencies {

// Always required:
implementation 'com.taboola:android-sdk:4.0.43'
  
// To open the clicked item in a new *tab*:
implementation 'androidx.browser:browser:1.3.0'

// For projects based on Java 1.7, use this version *instead*: 
// implementation 'androidx.browser:browser:1.0.0'
   
}
```
```kotlin build.gradle.kts (app module)
dependencies {

    // Always required:
    implementation("com.taboola:android-sdk:4.0.43")
    
    // To open the clicked item in a new *tab*:
    implementation("androidx.browser:browser:1.3.0")
    
    // For projects based on Java 1.7, use this version *instead*: 
    // implementation("androidx.browser:browser:1.0.0")
    
}
```

<Callout icon="🚧" theme="warn">
  ### SDK version

  We recommend using the **latest** [**Taboola SDK version**](https://developers.taboola.com/taboolasdk/docs/android-changelog) - `4.0.43`.

  > **Taboola SDK {user.user.androidSDK4Version}** has been tested with `Android 15 (API Level 35)`.
</Callout>

<Callout icon="📘" theme="info">
  ### AndroidX

  As of release **3.3.0**, Taboola SDK requires **AndroidX**.

  > For information about migrating your project to AndroidX, see <a href="https://developer.android.com/jetpack/androidx/migrate" target="_blank">this article</a>.
</Callout>

<Callout icon="📘" theme="info">
  ### AndroidX Browser

  You can _optionally_ install _AndroidX Browser_:

  If present, Taboola SDK will use it to open the clicked item in a new tab.
  If not present, Taboola SDK will use the system browser to open the clicked item in an external window.
</Callout>

## Permissions

In `AndroidManifest.xml`:

1. Make sure that the following permissions are present:

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

<!-- (Recommended) Allows Taboola SDK to use the 'IAB OM SDK': -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
```

<Callout icon="📘" theme="info">
  ### IAB OM SDK

  **Taboola SDK** uses the  <a href="https://iabtechlab.com/standards/open-measurement-sdk/" target="_blank">IAB OM SDK</a> to utilize third-party **viewability providers** and unlock **premium demand**.
</Callout>

2. If your App targets **Android 12** (**API 31**) or higher, add the following permission to access the **Advertising Identifier**:

```xml AndroidManifest.xml
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
```

<Callout icon="📘" theme="info">
  ### AD_ID permission

  Adding the **AD_ID** permission helps optimize business performance.

  For more information about using the **Advertising Identifier**, see [here](https://support.google.com/googleplay/android-developer/answer/6048248?hl=en).

  ***

  Note: **Taboola** adheres to all privacy rules.
</Callout>

<Callout icon="💁🏻" theme="default">
  ### Need a hand?

  Go ahead! Ask a question in our [Support Forum](https://sdk.taboola.com/taboolasdk/discuss).

  **Tip**: Provide as much detail as possible, including your platform and SDK version.
</Callout>

## Next steps

[Basic Integration](https://developers.taboola.com/taboolasdk/docs/android-sdk-classic-basic-integration)