npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

react-native-yieldlove

v2.5.0

Published

Yieldlove SDK bridge for React Native

Downloads

391

Readme

react-native-yieldlove

Yieldlove SDK for React Native (2.5.0)

Change log

[2.5.0] (01.October.2024)

  • Backfill feature is not supported.

[2.4.2] (12.September.2024)

  • Fixed the issue causing the initial advertisement loading to fail.

[2.4.1] (6.September.2024)

  • Added privacy manifest file for IOS (If you don't want to update library check the appendix part)

[2.4.0] (4.September.2024)

  • Added a BackFill feature.
  • Java version is updated (17)

Installation

Using npm

$ npm install react-native-yieldlove --save

Using yarn

$ yarn add react-native-yieldlove

Configuring

react-native >= 0.73.0

iOS

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

$ cd ios && pod install

If you don't want use Cocoapods, you can always link the library manually.

Android

Add our ad-integration SDK into your app's build.gradle file:

allprojects {
	repositories {
	  ...
		maven { url 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/android' }
	}
}

Usage

Contact to your account manager to obtain your application name (APPLICATION_NAME) and call strings (INTERSTITIAL_CALL_STRING and BANNER_CALL_STRING). Each call string represents a single slot.

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

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

// optional global custom targeting
Yieldlove.setCustomTargeting({fruit: 'apple', colour: 'pink'});

// optional global content url
Yieldlove.setContentUrl("https://www.example.com/content/global.html")

// loading & showing interstitial ad
Yieldlove.loadInterstitial({
  callString: INTERSTITIAL_CALL_STRING,
  options: {
    contentUrl: 'https://www.example.com/content/interstitial.html',
    customTargeting: {
      fruit: 'banana',
      day: 'saturday'
    }
  },
  onAdLoaded: () => {
    Yieldlove.showInterstitial().catch(error => console.log(error));
  }
});

// rendering banner ad
// ...
<YieldloveBannerAd
  callString={BANNER_CALL_STRING}
  options={{
    customTargeting: {
      fruit: 'orange',
      day: 'monday'
    },
    contentUrl: 'https://www.example.com/content/banner.html'
  }}
  onAdLoaded={({nativeEvent}) => {
    // can use to change the style
    const { width, height } = nativeEvent;
    this.setState({ width, height });
  }}
/>

API

YieldloveBannerAd

| Prop | Mandatory | Description | |------------------------|------------|--------------------------------------------------------------------------------------------------------------------------------| | callString | true | Valid call string. | | options | false | See AdOptions API below | | | | onAdLoaded | false | Event handler function for "onAdLoaded" event. nativeEvent contains width: number and height: number of the loaded ad. | | onAdFailedToLoad | false | Event handler function for "onAdFailedToLoad" event. | | onAdOpened | false | Event handler function for "onAdOpened" event. Not supported on iOS. | | onAdClosed | false | Event handler function for "onAdClosed" event. Not supported on iOS. | | onAdClicked | false | Callback function for "onAdClicked" event. | | onAdImpression | false | Callback function for "onAdImpression" event. | | style | false | Style attributes for the view, as expected in a standard View. |

Yieldlove

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: { [key: string]: string }) => void

Set global (default) custom targeting.

setContentUrl: (contentUrl: string) => void

Set global (default) content URL for targeting purposes.

clearConfigurationCache: () => void

For each application name, extended configuration is downloaded and cached on the user's device for a period of time. This function clears the cache. As a result, the next call to setApplicationName will always download a new copy of the configuration.

loadInterstitial: (options: LoadInterstitialParams, ) => void

Load interstitial ad. Available options:

| Prop | Mandatory | Description | |------------------------|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| | callString | true | Valid call string. | | options | false | See AdOptions below | | | | onAdLoaded | false | Callback function for "onAdLoaded" event. | | onAdFailedToLoad | false | Callback function for "onAdFailedToLoad" event. Expects single argument object which contains code: string and message: string describing the error. |

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).

AdOptions

| Prop | Mandatory | Type | Description | |-------------------|-----------|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | contentUrl | false | string | Content URL for targeting purposes. Will override the global content URL. | | customTargeting | false | { [key: string]: string } | An object containing key-value pairs used for custom targeting. Will merge with global custom targeting. A key redefined here take precedence over the globally defined one. |

Error Events

The nativeEvent for the onAdFailedToLoad event handler contains code: number and message: string describing the error. Any error means no ad was delivered and rendered.

See ErrorCode enum to see the current list of supported codes. More may be added in future releases.

ErrorEvent

The nativeEvent implements the following interface:

| Name | Type | Description | |-----------|----------------------|-----------------------------------------------------| | code | ErrorCode (number) | Platform independent code that classifies the error | | message | string | Message describing the error |

ErrorCode enum

| Name | Value (number) | Description | |------------------------------|----------------|---------------------------------------------------------------------------------------------------| | UNKNOWN | 1 | The error is unknown or unclassified | | AD_SERVER_INTERNAL_REQUEST | 2 | Something happened internally; for instance, an invalid response was received from the ad server. | | AD_SERVER_INVALID_REQUEST | 3 | The ad request was invalid; for instance, the ad unit ID was incorrect. | | AD_SERVER_NETWORK_ERROR | 4 | The ad request was unsuccessful due to network connectivity. | | AD_SERVER_NO_FILL | 5 | The ad request was successful, but no ad was returned due to lack of ad inventory. |

Enabling BackFill (only available in v2.4.2)

To enable the BackFill feature, install the react-native-yieldlove library using one of the following commands:

Using npm

$ npm install [email protected] --save

Using yarn

$ yarn add [email protected]

For more detailed information, refer to the Development Document Link

Testing ads

Please contact your account manager to get your test configuration.

Troubleshooting

My application crashes on start

The Google Mobile Ads SDK may be initialized without an application ID.

Ad Manager

iOS: Update your Info.plist. Android: Get Started

AdMob

iOS: Update your Info.plist. Android: Get Started