npm package: @gurukumparan/react-native-dfp
Description: React Native bridge for Google DFP
Author: Bub Javier
Latest version: 0.2.3

[![npm version](https://badge.fury.io/js/react-native-dfp.svg)](https://badge.fury.io/js/react-native-dfp)

# react-native-dfp

Unofficial fork from Simon Bugert's [react-native-admob](https://github.com/sbugert/react-native-admob/tree/980386052d780e42042bf8127cd1048549fe7773), 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](https://github.com/ReactWindows/react-native)

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

```javascript
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)}
  testDeviceID={testDeviceID}
  adUnitID={adUnitID}
  dimensions={dimensions}
  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: React.PropTypes.string,

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

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

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

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

### Display an Interstitial

```javascript
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();
```