nacika-ins / react-native-dfp

A react-native bridge for Google Mobile Ads' DFP libraries

react-native-dfp

Unofficial fork from Simon Bugert's react-native-admob, but only implementing Google Mobile Ads' DFP libraries.

Getting started

$ npm install react-native-dfp --save

Mostly automatic installation

$ react-native link react-native-dfp

Manual installation

iOS

1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-dfp and add RNDfp.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNDfp.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)<

Android

1. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.reactlibrary.RNDfpPackage; to the imports at the top of the file
• Add new RNDfpPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

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

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

     compile project(':react-native-dfp')
   

Windows

Read it! :D

1. In Visual Studio add the RNDfp.sln in node_modules/react-native-dfp/windows/RNDfp.sln folder to their solution, reference from their app.
2. Open up your MainPage.cs app

• Add using Com.Reactlibrary.RNDfp; to the usings at the top of the file
• Add new RNDfpPackage() to the List<IReactPackage> returned by the Packages method

Usage

Display a banner

import { RNBanner } from 'react-native-dfp';

// To display a banner
<RNBanner
  style={this.state.style}
  onSizeChange={this.onSizeChange.bind(this)}
  onAdViewDidReceiveAd={this.props.adViewDidReceiveAd}
  onDidFailToReceiveAdWithError={(event) => didFailToReceiveAdWithError(event.nativeEvent.error)}
  onAdViewWillPresentScreen={this.props.adViewWillPresentScreen}
  onAdViewWillDismissScreen={this.props.adViewWillDismissScreen}
  onAdViewDidDismissScreen={this.props.adViewDidDismissScreen}
  onAdViewWillLeaveApplication={this.props.adViewWillLeaveApplication}
  onAdmobDispatchAppEvent={(event) => admobDispatchAppEvent(event)}
  customTargeting={customTargeting}
  adSizes={adSizes}
  dimensions={dimensions}
  testDeviceID={testDeviceID}
  adUnitID={adUnitID}
  bannerSize={bannerSize} />

Properties:

/**
 * DFP library banner size constants
 * (https://developers.google.com/mobile-ads-sdk/docs/dfp/android/banner#banner_sizes)
 * banner (320x50, Standard Banner for Phones and Tablets)
 * largeBanner (320x100, Large Banner for Phones and Tablets)
 * mediumRectangle (300x250, IAB Medium Rectangle for Phones and Tablets)
 * fullBanner (468x60, IAB Full-Size Banner for Tablets)
 * leaderboard (728x90, IAB Leaderboard for Tablets)
 * smartBannerPortrait (Screen width x 32|50|90, Smart Banner for Phones and Tablets) (default)
 * smartBannerLandscape (Screen width x 32|50|90, Smart Banner for Phones and Tablets)
 *
 * banner is default
 */
 bannerSize: PropTypes.string,

 /**
  * Custom banner size (instead of using bannerSize)
  */
 dimensions: PropTypes.shape({
   height: PropTypes.number,
   width: PropTypes.number,
 }),

 /**
  * Array of some combination of bannerSize and dimensions that are valid for the ad
  * Example: ['mediumRectangle', { width: 320, height: 400 }, 'smartBannerPortrait']
  */
 adSizes: PropTypes.array,

 /**
  * Custom targeting params to be sent along with the ad request
  */
 customTargeting: PropTypes.object,

 /**
  * DFP ad unit ID
  */
 adUnitID: PropTypes.string,

 /**
  * Test device ID
  */
 testDeviceID: PropTypes.string,

 /**
  * DFP iOS (?) library events
  */
 adViewDidReceiveAd: PropTypes.func,
 didFailToReceiveAdWithError: PropTypes.func,
 adViewWillPresentScreen: PropTypes.func,
 adViewWillDismissScreen: PropTypes.func,
 adViewDidDismissScreen: PropTypes.func,
 adViewWillLeaveApplication: PropTypes.func,
 admobDispatchAppEvent: PropTypes.func,

Display an Interstitial

import { Interstitial } from 'react-native-dfp';

// Initialize your interstitial (usually during start of game.. etc.)
Interstitial.loadAdFromAdUnitId('{adUnitId}');

// Then on your trigger function (e.g. game over page) or desired callback, call this.
Interstitial.showAd();