react-native-ad-manager

A react-native module for Google Ad Manager Banners, Interstitials and Native ads.

The banner types are implemented as components while the interstitial and rewarded video have an imperative API.

Native ads are implemented as wrapper for a native view.

Installation

You can use npm or Yarn to install the latest beta version:

Getting started

npm:

npm i --save @freddixx/react-native-ad-manager

Yarn:

yarn add @freddixx/react-native-ad-manager

Mostly automatic installation

$ react-native link @freddixx/react-native-ad-manager

Alternatively for iOS you can install the library with CocoaPods by adding a line to your Podfile;

pod 'react-native-ad-manager', path: '../node_modules/@freddixx/react-native-ad-manager'

iOS

For iOS you will have to add the Google Mobile Ads SDK to your Xcode project.

Android

On Android the Ad Manager library code is part of Play Services, which is automatically added when this library is linked.

But you still have to manually update your AndroidManifest.xml, as described in the Google Mobile Ads SDK documentation.

Usage

import {
  Banner,
  Interstitial,
  PublisherBanner,
  NativeAdsManager,
} from "@freddixx/react-native-ad-manager";

// Display a DFP Publisher banner
<Banner
  adSize="fullBanner"
  adUnitID="your-ad-unit-id"
  testDevices={[PublisherBanner.simulatorId]}
  onAdFailedToLoad={(error) => console.error(error)}
  onAppEvent={(event) => console.log(event.name, event.info)}
/>;

// Display an interstitial
Interstitial.setAdUnitID("your-ad-unit-id");
Interstitial.setTestDevices([Interstitial.simulatorId]);
Interstitial.requestAd().then(() => Interstitial.showAd());

// Native ad
import NativeAdView from "./NativeAdView";
const adsManager = new NativeAdsManager("your-ad-unit-id", [
  Interstitial.simulatorId,
]);
<NativeAdView
  targeting={{
    customTargeting: { group: "user_test" },
    categoryExclusions: ["media"],
    contentURL: "test://",
    publisherProvidedID: "provider_id",
  }}
  style={{ width: "100%" }}
  adsManager={adsManager}
  validAdTypes={["native", "template"]}
  customTemplateIds={["your-template-id-1", "your-template-id-2"]}
  onAdLoaded={(ad) => {
    console.log(ad);
  }}
  onAdFailedToLoad={(error) => {
    console.log(error);
  }}
/>;