# Introduction

> What Qartvelo Ads is, who it is for, and how the pieces fit together.

Source: https://developers.qartvelo.com/get-started/introduction

Qartvelo Ads is a direct-sold ad network for Android apps in Georgia. Local advertisers buy CPM campaigns that run inside publishers' apps as banners, interstitials and rewarded videos. Publishers integrate one SDK and earn a revenue share on every Qartvelo Ads impression, while unfilled requests go to their **own** AdMob account so no inventory is wasted.

```
Your app ──> Qartvelo Ads SDK ──> Qartvelo Ads ad available?
                                   yes │            │ no / timeout / error
                              Qartvelo Ads ad     AdMob adapter ──> your AdMob ad unit
```

## Who this documentation is for

| You are | Start here |
|---|---|
| An Android developer (Kotlin or Java) | [Quickstart](/get-started/quickstart/), then [Android SDK](/android/installation/) |
| A React Native developer | [React Native installation](/react-native/installation/) |
| Building your own client or debugging traffic | [REST API](/api/overview/) and the [OpenAPI spec](/openapi.yaml) |
| An advertiser or agency | [Campaigns](/advertisers/campaigns/) and [creative specs](/advertisers/creatives/) |
| Using an AI coding assistant | [Build with AI](/ai/overview/) |

## Packages

| Package | Install | Notes |
|---|---|---|
| Android core | `com.qartvelo.ads:core:0.3.1` | JitPack. API client, caching, rendering, events, banner view |
| Android AdMob adapter | `com.qartvelo.ads:admob:0.3.1` | Optional. Depends on Google's `play-services-ads` |
| React Native | `npm install @qartvelo/react-native-ads` | Android only for now; iOS calls reject with `unsupported_platform` |

The SDK source is MIT-licensed at [github.com/Qartvelo-com/ads](https://github.com/Qartvelo-com/ads). The production API is `https://ads.qartvelo.com/`, which is also the SDK's default base URL.

## Key concepts

- **App**: an Android application registered in the publisher dashboard by its package name. Each app gets a public **app key** (`app_` + 24 characters) that you put in your code.
- **Placement**: an ad slot in your app, identified by a short **code** such as `home_banner`, `game_end` or `reward_coins`. A placement has one format: `banner`, `interstitial` or `rewarded`. Your code only ever uses the placement code.
- **Fallback**: when Qartvelo Ads cannot serve a placement (no eligible campaign, timeout, error, kill switch), the SDK shows your AdMob ad unit for that placement instead.
- **Test mode**: a switch in the SDK options that serves built-in test creatives that are never billed, and makes AdMob use Google's public test units.
- **Session**: a short-lived signed token the backend issues at start-up. It carries a random id, never a user or device identifier.

## Platform support

| Platform | Status |
|---|---|
| Android, native (Kotlin/Java) | Supported, minSdk 23 |
| Android, React Native 0.79+ (New Architecture) | Supported, minSdk 24 |
| iOS | Not yet. The React Native API is platform-neutral so iOS can be added without API changes |

## Next steps

- Follow the [Quickstart](/get-started/quickstart/) to show a test ad in about ten minutes.
- Read [How it works](/get-started/how-it-works/) to understand loading, fallback and events.