About this project

React Native Google Mobile Ads is a library from Invertase that lets React Native and Expo applications monetize through Google AdMob or Google Ad Manager. It wraps the native Google Mobile Ads SDKs for iOS and Android rather than reimplementing ad serving in JavaScript. Key characteristics described in the README: - Expo-first installation via `npx expo install`, configured through a bundled config plugin; bare React Native CLI projects are also supported. - Ad formats covered include app open, banner (anchored adaptive, inline adaptive, collapsible, and legacy fixed sizes), native, interstitial, rewarded, and rewarded interstitial, plus Google Ad Manager, consent handling through the User Messaging Platform (UMP), and mediation. - Developer-facing API options include imperative ad classes, React hooks, and preload pools for apps that display many ads. - Written in TypeScript with a generated API reference, and unit and end-to-end tested on both platforms. Platform requirements: version 17 requires React Native 0.86.0 or newer with the New Architecture enabled; the Legacy Architecture is no longer supported. Expo projects need a development build because Expo Go is not supported. Minimum operating systems are iOS 15.1 and Android API level 24. On Android, integrators can choose the classic Google Mobile Ads SDK (default) or the GMA Next-Gen SDK at build time, with the same JavaScript API either way. The README includes a native implementation status table showing which surfaces have been ported to Turbo Modules or Fabric components on each platform. On iOS, SDK methods, banners, full screen ads, native ads, and the User Messaging Platform are marked complete, while the EventEmitter is still to-do. On Android, native ads are complete, banners are partial (multi-format banner ported, standard banner to-do), and SDK methods, full screen ads, the User Messaging Platform, and the EventEmitter remain to-do; those surfaces still run through React Native's interoperability layer without changing the JavaScript API. Documentation links cover getting started, installation for Expo and React Native CLI, ad formats including hooks and Ad Manager, consent and privacy, testing, common reasons ads do not show, use with React Native Firebase, migration to v17, and an API reference. The package also ships an integrator guide for AI coding agents at AGENTS.md, installed into node_modules, intended to be consulted before an agent writes ad code. The project accepts issues and pull requests and publishes contribution guidelines and a code of conduct. License terms are in the repository LICENSE file.