---
updatedAt: 2025-08-27T00:54:36.000Z
agentTools:
  projectIndex: https://developers.taboola.com/taboolasdk/v3/llms.txt
---

# First Steps

*Android Classic* - First Steps

<Callout icon="⚠️" theme="warn">
  ### Deprecation Notice

  You are viewing the **SDK v3** docs. **SDK v3 will be deprecated on September 30, 2026.**

  We recommend upgrading to [**SDK v4**](https://developers.taboola.com/taboolasdk/docs/welcome) — the latest and actively maintained version. To get started, follow the [**SDK v3 → v4 Migration Guide**](https://developers.taboola.com/taboolasdk/docs/upgrading-from-sdk3-to-sdk4).
</Callout>

***

> ✅ 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).

> 📘
>
> The following steps are common to both Classic *and* Web integrations.

## The Repository URL

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

> 📘
>
> All versions of the **Taboola SDK** are available via **Artifactory**.

### Option I: build.gradle

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

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

allprojects {
    repositories {
        ...
        maven {
            // Taboola:
            url 'https://taboolapublic.jfrog.io/artifactory/mobile-release'
        }
    }
}
```

> 🚧
>
> Add the **Taboola** URL:
>
> 1. In your **top-level** `build.gradle` file.
> 2. **Under** `allprojects` > `repositories`.

### Option II: settings.gradle

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

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

## Dependencies

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

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

// Always required:
implementation 'com.taboola:android-sdk:3.10.11'
  
// 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'
   
}
```

> 🚧 SDK version
>
> 1. As of **August 31, 2023**, Google requires all Android apps to <a href="https://developer.android.com/google/play/requirements/target-sdk" target="_blank">target **Android 13**</a>. As such, you need to use **Taboola SDK`3.8.17`** or higher.
> 2. We recommend using the **latest** [**Taboola SDK version**](https://developers.taboola.com/taboolasdk/docs/android-changelog) - **`3.10.11`**.
>    > **Taboola SDK`3.10.11`** has been tested with **Android 14 (API Level 34)**.

> 📘 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>.

> 📘 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.

## 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"/>
```

> 📘 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**.

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

> 📘 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 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-3x-classic-basic-integration)