Getting Started
Teads delivers in-content video, display, and native recommendations inside publisher content, with banner and interstitial for moments outside the article. This SDK loads those formats in your Android app. You can integrate Teads SDK directly, through a mediation adapter, or with Prebid.
Compatibility and Requirements
| Teads SDK | Requirements |
|---|---|
| Android API | API 21+ (Android 5.0+) |
| Gradle | 8.0+ (required by AGP 8.x) |
| Kotlin compiler | 1.9.0+ (Optional — only required if your app uses Kotlin) |
| Kotlin stdlib (transitive) | Pinned to 2.1.21 — Kotlin's forward-compatibility rule requires consumer compiler version ≤ stdlib version, so any Kotlin compiler ≤ 2.1.x works |
| Java | 8+ (SDK compiled with jvmTarget = 1.8) |
| SDK Size | TeadsSDK adds ~1408.5 KiB to your Android release app. |
| UI Frameworks | XML (Compatible with Composables through Jetpack Compose's interoperability APIs) |
Formats by integration type
These are three different ways to ship Teads. Pick the one that matches how you load ads.
Direct is Teads SDK in your app. Your app requests ads from Teads SDK. No mediator and no Prebid auction sit in front. You get the full format set.
Mediation is Teads as one ad network inside another mediation SDK. Your app requests ads from that mediator. The mediator calls Teads through an adapter, in a waterfall or as a bidding source. You follow that mediator's adapter. The format set depends on the adapter.
Header bidding (Prebid) is Teads as a bidder behind Prebid SDK. Your app requests ads through Prebid SDK and Prebid Server. When the Teads bidder adapter wins, Teads SDK renders the ad.
Direct integration
| Format | What it is | Guide |
|---|---|---|
| Media | In-content slot in the article. Renders video and display ads. | Media |
| Media Native | Same as Media, but you own the layout and surrounding UI. | Media Native |
| Feed | Ready-made content recommendation widget you add to the page. | Feed |
| Recommendations | Same recommendations as Feed, with no Teads UI — you build the list yourself. | Recommendations |
| Banner | Anchored adaptive banner in a fixed slot. Height follows the creative. | Banner |
| Interstitial | Fullscreen ad. Preload it, then show it at a natural transition. | Interstitial |
Mediation
Install the Teads adapter for the mediation SDK you already use. Format meanings are in Direct above; adapters do not all expose the same set.
| Mediation | What it is | Formats | Guide |
|---|---|---|---|
| Google Ad Manager and AdMob | Teads as a custom event in Google’s mediation. | Media, Native, Interstitial, Banner | AdMob |
| AppLovin MAX | Teads as a custom network in MAX. | Media, Native | AppLovin |
| Smart AdServer | Teads as a custom event in Smart. | Media, Native | Smart |
Header bidding (Prebid)
| Kind | What it is | Formats | Guide |
|---|---|---|---|
| Standard | Use Prebid Mobile SDK alongside Teads SDK to add Teads demand to your header bidding auction. | Media (inRead) | Standard Prebid |
| Standalone | Use Teads SDK with your own Prebid Server, without the official Prebid Mobile SDK. | Media (inRead) | Standalone Prebid |
What the ads look like
The tables above are how you request ads. To see the creatives Teads can render, especially in Media, browse the video specifications and display specifications.
Get Teads demand
To serve Teads ads in your app, you need a placement set up by a Teads publisher manager. Reach your publisher manager to start that setup, or contact Teads if you do not have one yet.