1.0.3 • Published 3 years ago

react-native-yieldlove-v2 v1.0.3

Weekly downloads
10
License
MIT
Repository
github
Last release
3 years ago

react-native-yieldlove

Yieldlove SDK for React Native

Installation

Using npm

$ npm install react-native-yieldlove-v2 --save

Using yarn

$ yarn add react-native-yieldlove-v2

Linking

react-native >= 0.60.0

iOS

The package is automatically linked when building the app. All you need to do is:

$ cd ios && pod install

Android

Add maven { url 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/android'} do your gradle settings.

react-native <= 0.59.x

iOS & Android

$ react-native link react-native-yieldlove-v2
$ cd ios && pod install

IMPORTANT

If you have issues linking your iOS project check out this StackOverflow thread on how to fix it.

If you don't want to use the methods above, you can always link the library manually.

Usage

import { Yieldlove, YieldloveBannerAd } from 'react-native-yieldlove-v2';

// before using any other method from Yieldlove and/or rendering YieldloveBannerAd you have to set the application name
Yieldlove.setApplicationName(APPLICATION_NAME);

// loading & showing interstitial ad
Yieldlove.loadInterstitial({
  publisherSlotName: PUBLISHER_SLOT_NAME,
  onAdLoaded: () => {
    Yieldlove.showInterstitial().catch(error => console.log(error));
  }
});

// rendering banner ad
<YieldloveBannerAd/>

On iOS if you receive a crash on application start with message The Google Mobile Ads SDK was initialized incorrectly. it means that you probably forgot to add the GADIsAdManagerApp key with a <true/> value to your app's Info.plist.

API

YieldloveBannerAd component API

PropMandatoryDescription
onAdInitfalseEvent handler function for "onAdInit" event. The event is triggered on starting to load banner ad.
onAdLoadedfalseEvent handler function for "onAdLoaded" event. nativeEvent contains width: number and height: number of the loaded ad.
onAdFailedToLoadfalseEvent handler function for "onAdFailedToLoad" event.nativeEvent contains code: string and message: string describing the error.
onAdOpenedfalseEvent handler function for "onAdOpened" event.
onAdClosedfalseEvent handler function for "onAdClosed" event.
onAdLeftApplicationfalseEvent handler function for "onAdLeftApplication" event.
stylefalseStyle attributes for the view, as expected in a standard View.

Yieldlove API

setApplicationName: (applicationName: string) => void

Set this at the start of your app to initialize Yieldlove SDK.

setDebug: (isDebugModeEnabled: boolean) => void

Enable debug logs from native libraries.

setCustomTargeting: (customTargeting: CustomTargetingOptions) => void

Set custom targeting.

loadInterstitial: (options: LoadInterstitialOptions) => void

Load interstitial ad. Available options:

PropMandatoryDescription
publisherSlotNametrueValid publisher slot name string.
onAdInitfalseCallback function for "onAdInit" event. The event is triggered on starting to load banner ad.
onAdLoadedfalseCallback function for "onAdLoaded" event.
onAdFailedToLoadfalseCallback function for "onAdFailedToLoad" event. Expects single argument object which contains code: string and message: string describing the error.
onAdOpenedfalseCallback function for "onAdOpened" event.
onAdClosedfalseCallback function for "onAdClosed" event.
onAdLeftApplicationfalseCallback function for "onAdLeftApplication" event.

showInterstitial: () => Promise<void>

Present loaded interstitial ad. Can reject with an error if the ad could not be presented (e.g. when trying to call showInterstitial before ad was actually loaded).