React Native Google Mobile Ads (Next-Gen Android fork)
Fork notice —
@javascriptcommon/react-native-google-mobile-adsmigrates the Android native layer to the GMA Next-Gen SDK (ads-mobile-sdk). iOS is unchanged (classic GMA SDK). On Android only banner / interstitial / app-open / consent are implemented; native ads and rewarded are not. Same JS API as upstream.
React Native Google Mobile Ads allows you to monetize your app with AdMob; a React Native wrapper around the native Google-Mobile-Ads SDKs for both iOS and Android.
React Native Google Mobile Ads is built with three key principals in mind;
- 🧪 Well tested
- the module is extensively tested to >95% coverage (getting there after moving from react-native-firebase!)
- 👁 Well typed
- first class support for Typescript included
- 📄 Well documented
- full reference & installation documentation alongside detailed guides and FAQs
Ad formats
App open
App open ads are a special ad format intended for publishers wishing to monetize their app load screens.
Banner
Banner ad units display rectangular ads that occupy a portion of an app's layout. They stay on screen while users are interacting with the app, either anchored at the top or bottom of the screen or inline with content as the user scrolls. Banner ads can refresh automatically after a certain period of time.
Anchored adaptive
A dynamically sized banner that is full-width and auto-height. Anchored adaptive banners are expected to be always on-screen, locked to the screen’s top or bottom.
Inline adaptive
Inline adaptive banners are larger, taller banners compared to anchored adaptive banners. They are of variable height, and can be as tall as the device screen. They are intended to be placed in scrolling content.
Collapsible
Collapsible banner ads are intended to improve performance of anchored ads that are otherwise a smaller size.
Fixed size (legacy)
The Google Mobile Ads SDK supports fixed ad sizes for situations where adaptive banners ads don't meet your needs. Banner (320x50), Large banner (320x100), Medium rectangle (300x250), full banner (468x60) and leaderboard (728x90).
Native
Native ads allow you to customize the look and feel of the ads that appear in your app. You decide how and where they're placed, so the layout is more consistent your app's design.
Interstitial
Interstitial ad units show full-page ads in your app. Place them at natural breaks & transitions in your app's interface, such as after level completion in a gaming app.
Rewarded
AdMob rewarded ad units allow you to reward users with in-app items for interacting with video ads, playable ads, and surveys.
Rewarded Interstitial
Rewarded interstitial is a type of incentivized ad format that allows you offer rewards for ads that appear automatically during natural app transitions. Unlike rewarded ads, users aren't required to opt-in to view a rewarded interstitial.
Migrating to the New Architecture Status (backwards compatible)
This package can be used in both The Old and The New Architecture. When using The New Architecture, some legacy code will still be used though. See status below:
| Platform | Feature | Status |
|---|---|---|
| iOS | Mobile Ads SDK Methods (Turbo Native Module) | ✅ Complete |
| iOS | Banners (Fabric Native Component) | ✅ Complete |
| iOS | Full Screen Ads (Turbo Native Module) | ✅ Complete |
| iOS | Native Ads (Turbo Native Module, Fabric Native Component) | ✅ Complete |
| iOS | User Messaging Platform (Turbo Native Module) | ✅ Complete |
| iOS | EventEmitter (Turbo Native Module) | ⏳ To-Do |
| iOS | Revenue Precision Constants (Turbo Native Module) | ✅ Complete |
| Android | Mobile Ads SDK Methods (Turbo Native Module) | ⏳ To-Do |
| Android | Banners (Fabric Native Component) | ⏳ To-Do |
| Android | Full Screen Ads (Turbo Native Module) | ⏳ To-Do |
| Android | Native Ads (Turbo Native Module, Fabric Native Component) | ✅ Complete |
| Android | User Messaging Platform (Turbo Native Module) | ⏳ To-Do |
| Android | EventEmitter (Turbo Native Module) | ⏳ To-Do |
| Android | Revenue Precision Constants (Turbo Native Module) | ⏳ To-Do |
Documentation
Contributing
License
- See LICENSE
Built and maintained by Invertase.