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, then Android SDK
A React Native developer	React Native installation
Building your own client or debugging traffic	REST API and the OpenAPI spec
An advertiser or agency	Campaigns and creative specs
Using an AI coding assistant	Build with AI

Packages

Package	Install	Notes
Android core	com.qartvelo.ads:core:0.3.0	JitPack. API client, caching, rendering, events, banner view
Android AdMob adapter	com.qartvelo.ads:admob:0.3.0	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. 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 to show a test ad in about ten minutes.
• Read How it works to understand loading, fallback and events.