# Qartvelo Ads

> Qartvelo Ads is a direct-sold ad network for Georgian Android apps. Publishers integrate the Kotlin SDK (`com.qartvelo.ads:core`) or the React Native plugin (`@qartvelo/react-native-ads`); Qartvelo Ads campaigns are served first and the SDK falls back automatically to the publisher's own AdMob ad units.

Important notes for code generation:

- Android only today. The Kotlin package is `com.qartvelo.sdk`; the entry point is the `QartveloAds` object. The React Native API rejects with `unsupported_platform` on iOS.
- Current version: 0.3.0. Gradle coordinates `com.qartvelo.ads:core:0.3.0` and optional `com.qartvelo.ads:admob:0.3.0` from JitPack (`https://jitpack.io`).
- Ads are addressed by placement **code** (for example `game_end`) created in the publisher dashboard, never by numeric id.
- The app key (`app_` + 24 characters) is public and goes in the app. The SDK secret must never be embedded in an app.
- Use `testMode = true` (Kotlin) / `testMode: __DEV__` (React Native) in debug builds; test ads are never billed.
- Grant rewards only from `onReward` (Kotlin) or `result.rewarded` (React Native), exactly once.
- `AdSource` values are `QARTVELO` and `ADMOB` (React Native: `qartvelo` and `admob`). The banner XML attribute is `app:qartvelo_placementId`.

## Documentation Sets

- [Abridged documentation](https://developers.qartvelo.com/llms-small.txt): a compact version of the documentation for Qartvelo Ads, with non-essential content removed
- [Complete documentation](https://developers.qartvelo.com/llms-full.txt): the full documentation for Qartvelo Ads
- [Android SDK](https://developers.qartvelo.com/_llms-txt/android-sdk.txt): Complete Kotlin SDK documentation
- [React Native](https://developers.qartvelo.com/_llms-txt/react-native.txt): Complete React Native plugin documentation
- [REST API](https://developers.qartvelo.com/_llms-txt/rest-api.txt): The HTTP API used by the SDKs, for custom integrations

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [OpenAPI specification](https://developers.qartvelo.com/openapi.yaml): Machine-readable description of the SDK REST API
- [Agent skill](https://developers.qartvelo.com/skills/qartvelo-ads/SKILL.md): Integration instructions packaged for AI coding agents