React Native plugin to allow integration of Pollfish surveys into Android and iOS apps.
Pollfish is a mobile monetization platform delivering surveys instead of ads through mobile apps. Developers get paid per completed surveys through their apps.
- Android SDK 21 or higher using Google Play Services
- iOS 11.0 or higher
- React Native v0.40 or higher
- CocoaPods v1.10.0 or higher
- Create Pollfish Developer account, create a new app and grap it's API key
- Install Pollfish plugin and call init function
- Set to Release mode and release in AppStore and Google Play
- Update your app's privacy policy
- Request your account to get verified from the Pollfish Dashboard
Note: Apps designed for Children and Families program should not be using Pollfish SDK, since Pollfish does not collect responses from users less than 16 years old
Note: Pollfish iOS SDK utilizes Apple's Advertising ID (IDFA) to identify and retarget users with Pollfish surveys. As of iOS 14 you should initialize Pollfish React Native plugin in iOS only if the relevant IDFA permission was granted by the user
To add Pollfish plugin just type:
Using yarn
yarn add react-native-plugin-pollfishUsing npm
npm install react-native-plugin-pollfishAnd for iOS builds
cd ios && pod install && cd ..import RNPollfish from 'react-native-plugin-pollfish';The Pollfish plugin must be initialized with one or two api keys depending on which platforms are you targeting. You can retrieve an API key from Pollfish Dashboard when you sign up and create a new app.
var builder = new RNPollfish.Builder('ANDROID_API_KEY', 'IOS_API_KEY')
.rewardMode(true); // Android & iOSvar builder = new RNPollfish.Builder('ANDROID_API_KEY', null)
.rewardMode(true); // Android onlyvar builder = new RNPollfish.Builder(null, 'IOS_API_KEY')
.rewardMode(true); // iOS onlyYou can set several params to control the behaviour of Pollfish survey panel within your app with the use of the RNPollfish.Builder instance. Below you can see all the available options. Apart from the constructor all the other methods are optional.
| Param | Description |
|---|---|
constructor(String, String) |
Sets Your Android and iOS API Keys (from step 2). |
.indicatorPosition(RNPollfish.Position) |
Sets the Position where you wish to place the Pollfish indicator. There are six different options RNPollfish.Position. |
.indicatorPadding(Int) |
Sets the padding from top or bottom depending on the position of the indicator specified before (if used in middle position, |
.offerwallMode(Boolean) |
Sets Pollfish to offerwall mode. |
.releaseMode(Boolean) |
Choose Debug or Release Mode. |
.rewardMode(Boolean) |
Init in reward mode (skip Pollfish indicator to show a custom prompt). |
.requestUUID(String) |
Sets a unique id to identify a user and be passed through server-to-server callbacks. |
.userProperties(Json) |
Send attributes that you receive from your app regarding a user, in order to receive a better fill rate and higher priced |
.rewardInfo(Json) |
An object holding information regarding the survey completion reward. If set, signature must be calculated in order to |
.clickId(String) |
A pass throught param that will be passed back through server-to-server callback. |
.userId(String) |
A unique id to identify users. |
.signature(String) |
An optional parameter used to secure the rewardConversion and rewardName parameters passed on rewardInfo Json object. |
.placementId(String) |
The id of the placement to load. If skipped the default placement of the ad unit will be loaded. |
Example of Pollfish configuration using all the available options
builder.indicatorPosition(RNPollfish.Position.topLeft)
.indicatorPadding(10)
.offerwallMode(false)
.rewardMode(true)
.releaseMode(false)
.requestUUID('REQUEST_UUID')
.userProperties({
gender: '1',
education: '1',
...
})
.clickId('CLICK_ID')
.userId('USER_ID')
.signature('SINGNATURE')
.placementId('PLACEMENT_ID')
.rewardInfo({
rewardName: 'Points',
rewardConversion: 1.3
});You can use Pollfish either in Debug or in Release mode.
- Debug mode is used to show to the developer how Pollfish will be shown through an app (useful during development and testing).
- Release mode is the mode to be used for a released app (start receiving paid surveys).
Note: Be careful to set the
releaseModeparameter totruewhen you release your app in a relevant app store!!
Setting the
rewardModetofalseduring initialization enables controlling the behavior of Pollfish in an app from the Pollfish panel. Enabling reward mode ignores Pollfish behavior from Pollfish panel. It always skips showing Pollfish indicator (small button) and always force open Pollfish view to app users. This method is usually used when app developers want to somehow incentivize their users before completing surveys to increase completion rates.
Setting the
userIdwill override the default behaviour and use that instead of the Advertising Id, of the corresponding platform, in order to identify a userYou can pass the id of a user as identified on your system. Pollfish will use this id to identify the user across sessions instead of an ad id/idfa as advised by the stores. You are solely responsible for aligning with store regulations by providing this id and getting relevant consent by the user when necessary. Pollfish takes no responsibility for the usage of this id. In any request from your users on resetting/deleting this id and/or profile created, you should be solely liable for those requests.
Last but not least. Build the Params object by invoking .build() on the RNPollfish.Builder instance that you've configured earlier and call RNPollfish.init(params) passing the Params object as an argument.
var params = builder.build();
RNPollfish.init(params);
// OR
RNPollfish.init(builder.build());In this section we will list several options that can be used to control Pollfish surveys behaviour, how to listen to several notifications or how to be eligible to more targeted (high-paid) surveys. All these steps are optional.
You can get notified when a Pollfish survey is received. With this notification, you can also get informed about the type of survey that was received, money to be earned if survey gets completed, shown in USD cents and other info around the survey such as LOI and IR.
Note: If Pollfish is initialized in offerwall mode then the event parameter will be
undefined, otherwise it will include info around the received survey.
RNPollfish.addEventListener(RNPollfish.PollfishSurveyReceivedListener, (event) => {
if (event === undefined) {
console.log("Pollfish Offerwall Received");
} else {
console.log(`Pollfish Survey Received - CPA: ${event.surveyCPA}, IR: ${event.surveyIR}, LOI: ${event.surveyLOI}, Class: ${event.surveyClass}, Reward Value: ${event.rewardValue}, Reward Name: ${event.rewardName}, Remaining Completes: ${event.remainingCompletes}`);
}
});You can get notified when a user completed a survey. With this notification, you can also get informed about the type of survey, money earned from that survey in USD cents and other info around the survey such as LOI and IR.
RNPollfish.addEventListener(RNPollfish.PollfishSurveyCompletedListener, (event) => {
console.log(`Pollfish Survey Completed - CPA: ${event.surveyCPA}, IR: ${event.surveyIR}, LOI: ${event.surveyLOI}, Class: ${event.surveyClass}, Reward Value: ${event.rewardValue}, Reward Name: ${event.rewardName}, Remaining Completes: ${event.remainingCompletes}`);
});You can get notified when a user is not eligible for a Pollfish survey. In market research monetization, users can get screened out while completing a survey beucase they are not relevant with the audience that the market researcher was looking for. In that case the user not eligible notification will fire and the publisher will make no money from that survey. The user not eligible notification will fire after the surveyReceived event, when the user starts completing the survey.
RNPollfish.addEventListener(RNPollfish.PollfishUserNotEligibleListener, (_) => {
console.log("Pollfish User Not Eligible");
});You can be notified when a Pollfish survey is not available.
RNPollfish.addEventListener(RNPollfish.PollfishSurveyNotAvailableListener, (_) => {
console.log("Pollfish Survey Not Available");
});You can be notified when a user has rejected a Pollfish survey.
RNPollfish.addEventListener(RNPollfish.PollfishUserRejectedSurveyListener, (_) => {
console.log("Pollfish User Rejected Survey");
});You can register and get notified when a Pollfish survey panel has opened. Publishers usually use this notification to pause a game until the pollfish panel is closed again.
RNPollfish.addEventListener(RNPollfish.PollfishOpenedListener, (_) => {
console.log("Pollfish Opened");
});You can register and get notified when a Pollfish survey panel has closed. Publishers usually use this notification to resume a game that they have previously paused when the Pollfish panel was opened.
RNPollfish.addEventListener(RNPollfish.PollfishClosedListener, (_) => {
console.log("Pollfish Closed");
});You can manually hide and show Pollfish by calling the functions below, after initialization.
RNPollfish.show();RNPollfish.hide();After you initialize Pollfish and a survey is received you can check at any time if the survey is available at the device by calling the following function.
RNPollfish.isPollfishPresent((isPollfishPresent) => {
console.log(isPollfishPresent ? 'Pollfish is available' : 'Pollfish is not available');
});You can check at any time if the survey panel is open by calling the following function.
RNPollfish.isPollfishPanelOpen((isPollfishPanelOpen) => {
console.log(isPollfishPanelOpen ? 'Pollfish panel is open' : 'Pollfish panel is closed');
});You can read more info on how the Native Pollfish SDKs work on Android and iOS or how to set up properly a React Native environment at the following links:
Pollfish React Native Plugin Documentation
Pollfish Android SDK Integration Guide