react-native-admob

A react-native module for Google AdMob GADBanner and GADInterstitial (react-native v0.19.0 or newer required).

The banner is implemented as a component while the interstitial has an imperative API.

Installation

With rnpm (recommended)

1. npm i react-native-admob -S
2. rnpm link
3. Add Google AdMob Framework to your Xcode project. This is only needed for iOS and guarantees your app is using the newest admob version.

Manual Installation

iOS

1. npm i react-native-admob -S
2. Add Google AdMob Framework to your Xcode project.
3. Add react-native-admob static library to your Xcode project like explained here. (Step 3 of this guide is not needed)

Android

1. npm i react-native-admob -S
2. Make the following additions to the given files:

android/settings.gradle

include ':RNAdMob', ':app'
project(':RNAdMob').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-admob/android')

android/app/build.gradle

dependencies {
   ...
   compile project(':RNAdMob')
}

MainActivity.java

On top, where imports are:

import com.sbugert.rnadmob.RNAdMobPackage;

Under protected List<ReactPackage> getPackages() {:

  return Arrays.<ReactPackage>asList(
    new MainReactPackage(),
    new RNAdMobPackage()
  );

Usage

import { AdMobBanner, AdMobInterstitial } from 'react-native-admob'

// Display a banner
<AdMobBanner
  bannerSize="fullBanner"
  adUnitID="your-admob-unit-id"
  testDeviveID="EMULATOR"
  didFailToReceiveAdWithError={this.bannerError} />

// Display an interstitial
AdMobInterstitial.setAdUnitID('your-admob-unit-id');
AdMobInterstitial.setTestDeviceID('EMULATOR');
AdMobInterstitial.requestAd(AdMobInterstitial.showAd);

For a full example reference to the example project.

Reference

AdMobBanner

bannerSize property

Corresponding to iOS framework banner size constants

Note: There is no smartBannerPortrait and smartBannerLandscape on Android. Both prop values will map to smartBanner

Events as function props

Corresponding to Ad lifecycle event callbacks

AdMobInterstitials

Methods

For simulators/emulators you can use 'EMULATOR' for the test device ID.
Note: tryShowNewInterstitial() is deprecated as of v1.1.0 and can be replaced by calling requestAd with showAd as callback.

Events

Unfortunately, events are not consistent across iOS and Android. To have one unified API, new event names are introduced for pairs that are roughly equivalent.

Note that interstitialWillLeaveApplication and onAdLeftApplication are not exactly the same but share one event in this library.

TODO

• Support Ad Targeting
• Also use interstitial event names for banner