# AdMob CMP

> A Kotlin Multiplatform / Compose Multiplatform AdMob SDK. Six ad formats (banner, interstitial, rewarded, rewarded interstitial, app-open, native), UMP consent wired into the initialization flow, mediation, paid/revenue events, and a Gradle plugin that fixes Kotlin/Native iOS test linking. Published to Maven Central as dev.avinya.ads:admob-cmp.

## Coordinates

- Maven coordinate: `dev.avinya.ads:admob-cmp`
- Gradle plugin id: `dev.avinya.ads.admob-cmp`
- Modules: `admob-cmp` (facade), `admob-cmp-core`, `admob-cmp-compose`
- Platforms: Android and iOS. There is no desktop or web ad implementation.
- Licence: Apache-2.0

## Reading order

Start with `/start/what-is-admob-cmp/`, then `/start/quickstart/`.
iOS integrations should read `/start/ios-setup/` and
`/privacy/app-tracking-transparency/` before writing any ad code:
the required ordering is consent, then ATT, then initialize.

## Caveats

The public ABI is frozen and validated in CI. Suggestions that change
a public signature in `admob-cmp-core` or `admob-cmp-compose` will fail
`checkKotlinAbi`.

Not affiliated with or endorsed by Google. AdMob and Google Mobile Ads
are trademarks of Google LLC.

## Documentation Sets

- [Abridged documentation](https://ads.avinya.dev/llms-small.txt): a compact version of the documentation for AdMob CMP, with non-essential content removed
- [Complete documentation](https://ads.avinya.dev/llms-full.txt): the full documentation for AdMob CMP
- [Ad formats](https://ads.avinya.dev/_llms-txt/ad-formats.txt): Every ad format guide: banner, interstitial, rewarded, app-open, native.
- [Privacy and consent](https://ads.avinya.dev/_llms-txt/privacy-and-consent.txt): UMP consent, App Tracking Transparency ordering, and Play Data safety.
- [Setup](https://ads.avinya.dev/_llms-txt/setup.txt): Installation, Android setup, and iOS setup including the Gradle plugin.

## 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

- [GitHub repository](https://github.com/Meet-Miyani/admob-compose-multiplatform): Source, issues, and the AGENTS.md instructions file.
- [Maven Central](https://central.sonatype.com/artifact/dev.avinya.ads/admob-cmp): Published artifacts and the current release version.
- [API reference](https://ads.avinya.dev/api/): Generated Dokka HTML for every public declaration.