- Adding support for placement id initialization option
- Updated with Pollfish iOS SDK v6.5.0 and Android SDK v6.5.0
v7.0.5
- Updated with Pollfish iOS SDK v6.4.2
v7.0.4
- Updated with Pollfish iOS SDK v6.4.1
v7.0.3
- Updated with Pollfish Android SDK v6.4.0 and Pollfish iOS SDK v6.4.0
v7.0.2
- Updated with Pollfish Android SDK v6.3.3
v7.0.1
- Updated with Pollfish Android SDK v6.3.2
v7.0.0
- Updated with Pollfish Android SDK v6.3.1 and Pollfish iOS SDK v6.3.1
- Switched for jar to arr for the Pollfish Android bridge library
v6.3.0
- Adding a new configuration option to define a
userIdduring initialization - Fixing issue with missing
PBXProjectreferences on Windows
v6.2.0
- Updated with Pollfish Android SDK v6.2.5 and Pollfish iOS SDK v6.2.7
- Updated External Dependency Manager to 1.2.171
v6.1.8
- Updated with Pollfish Android SDK v6.2.4 and Pollfish iOS SDK v6.2.5
v6.1.7
- Updated with Pollfish iOS SDK v6.2.4
v6.1.6
- Updated with Pollfish Android SDK v6.2.2
v6.1.5
- Updated with Pollfish Android SDK v6.2.1
v6.1.4
- Updated with Pollfish Android SDK v6.2.0
v6.1.3
- Fixed XCode build issues with static linking enabled
v6.1.2
- Updated with Pollfish Android SDK v6.1.6 and Pollfish iOS SDK v6.2.3
v6.1.1
- Updated with Pollfish Android SDK v6.1.5
v6.1.0
- Updated with Pollfish iOS SDK v6.2.2
v6.0.5
- Updated with Pollfish iOS SDK v6.2.1
v6.0.4
- Updated with Pollfish Android SDK v6.1.4 and Pollfish iOS SDK v6.2.0
v6.0.3
- Updated with Pollfish iOS SDK v6.1.0
v6.0.2
- Updated with Pollfish iOS SDK v6.0.3
v6.0.1
- Updated with Pollfish Android SDK v6.1.3 and Pollfish iOS SDK v6.0.2
v6.0.0
- New Event Subscribtion mechanism
- Bug fixes
- New Public interface
v5.7.7
- Updated with Pollfish Android SDK v6.1.2 and Pollfish iOS SDK v6.0.1
v5.7.6
- Updated with Pollfish Android SDK v6.1.1
v5.7.5
- Updated with Android SDK v6.1.0
v5.7.4
- Updated with Android SDK v6.0.4
- Updated with unity-jar-resolver v1.2.165
- Fixed XCode build
Multiple commands produceissue
v5.7.3
- Fixed issue with builds on Windows
v5.7.2
- Updated with Android SDK v6.0.3
v5.7.1
- Fixed issue with empty UserProperties dictionary
v5.7.0
- Update with Android SDK v6.0.2 and iOS SDK v6.0.0
v5.6.3
- Updated with Pollfish iOS SDK v5.5.2
v5.6.2
- Updated Google Jar Resolver.
- Added Pod support for iOS builds.
v5.6.1
- Updated with Pollfish iOS SDK v5.4.1 and Pollfish Android SDK v5.6.0
v5.6.0
- Updated with Pollfish iOS SDK v5.3.0
v5.5.1
- Updated with Pollfish Android SDK v5.5.1 that aligns with the latest Google Play policy changes
v5.5.0
- Updated with Pollfish Android SDK v5.5.0
v5.4.1
- Updated with Pollfish Android SDK v5.4.1
v5.4.0
- Updated with Pollfish Android SDK v5.4.0
v5.3.0
- Added support for Unity 2019.3+
- Updated with the latest External Dependency Manager from Google Ads
- Updated with Pollfish iOS SDK v5.2.5 and Pollfish Android SDK v5.3.0
v5.2.0
- Updated with Pollfish iOS SDK v5.2.0 and Pollfish Android SDK v5.1.0
v5.1.0
- Updated with Pollfish iOS SDK v5.1.0
v5.0.0
- Added support for offerwall
- New Android minimum supported version is 16
- Updated with Pollfish Android and Pollfish iOS SDK v5.0.0
v4.5.1
- Fixed crash issues relevant with with AndroidManifest and UnityPlayerActivity
v4.5.0
- Updated with Pollfish latest Android & iOS SDK v4.5.x
v4.4.0
- Added support for Unity 2018
- Updated with Pollfish latest Android & iOS SDK v4.4.0
- Added user rejected event
- Fixed bugs
v4.3.6
- Updated with Pollfish latest Android & iOS SDK v4.3.4
v4.3.6
- Updated with Pollfish latest iOS SDK v4.2.4 to fix bitcode issue
v4.3.5
- Removed rendering workaround for Unity 5.6 after 5.6.1p4 patch release
v4.3.4
- Added support for sending user attributes during init
- Deprecated setCustomAttributes
- Fixed rendering bug of Unity 5.6
- Updated to latest Google's Unity Jar Resolver
- Updated Android & iOS SDK to the latest
v4.3.3
- Updated iOS SDK to the latest
v4.3.2
- Updated iOS SDK to latest with support for ATS
v4.3.1
- Updated Android SDK to latest on with 3rd party survey providers support
- Updated to jar resolver from Google in order to support Google Play Services
v4.2.0
- New updated iOS and Android SDKs
- Added video, rating, slider, open ended, open ended numerical and description questions support
- Improved performance, bug fixes
- Deprecated shouldQuit events and replaces with function
v4.1.0
- Support of manual set of devMode for android by ignoring key of signing
- Respect and submit of Google Advertising Id
v4.0.0
- Initial Release
- Support for Lollipop
Pollfish Unity plugin, allows integration of Pollfish surveys into Unity 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.
Pollfish Unity Plugin works with:
- Android SDK 21 or higher using Google Play Services
- iOS 11.0 or higher
- Unity 2019 or higher
- CocoaPods version 1.10.0 or higher
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 surveys can work with or without the IDFA permission on iOS 14+. If no permission is granted in the ATT popup, the SDK will serve non personalized surveys to the user. In that scenario the conversion is expected to be lower. Offerwall integrations perform better compared to single survey integrations when no IDFA permission is given
Note: Pollfish does not work on Editor, so please do try only on mobile devices
You can find instructions on how to install ios-support package and request for IDFA permission from a Unity script here
- Create Pollfish Developer account
- Create new apps for each targeting platform (Android & iOS) and grap the API keys
- Install Pollfish plugin and call init function
- Set to Release mode and publish on app store
- Update your app's privacy policy
- Request your account to get verified from Pollfish Dashboard
Note: If you are updating from version v5.x.x to v6.x.x or v6.x.x to v7.x.x we recommend to clean your project from any of Pollfish Unity Plugin files and then import the lastest version. A comparisson between the v5 and v6 public API can be found on the following migration guide
➤ Usage Diff (Click to expand)
|
- |
Pollfish.PollfishInitFunction(apiKey, pollfishParams); |
|
+ |
Pollfish.Init(pollfishParams) |
|
- |
Pollfish.PollfishParams pollfishParams = new Pollfish.PollfishParams();
pollfishParams.OfferwallMode(offerwallMode);
pollfishParams.IndicatorPadding(indicatorPadding);
pollfishParams.ReleaseMode(releaseMode);
pollfishParams.RewardMode(rewardMode);
pollfishParams.IndicatorPosition((int) indicatorPosition);
pollfishParams.RequestUUID(requestUUID);
pollfishParams.UserAttributes(userAttributes); |
|
+ |
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.OfferwallMode(offerwallMode)
.IndicatorPadding(indicatorPadding)
.ReleaseMode(releaseMode)
.RewardMode(rewardMode)
.IndicatorPosition(indicatorPostion)
.RequestUUID(requestUUID)
.UserProperties(userProperties);
Pollfish.Init(pollfishParams); |
|
- |
|
|
+ |
Publishers have the option to subscribe to the listeners of their choice and get notified asynchronously for Pollfish Surveys lifecycle events. Pollfish.SurveyCompletedEvent += SurveyCompleted;
...
public void SurveyCompleted(SurveyInfo surveyInfo)
{
....
} |
Register as a Publisher at www.pollfish.com
Login at www.pollfish.com and click "Add a new app" on Pollfish Developer Dashboard in section "My Apps". Copy then the given API key for this app, in order to use later on, when initializing Pollfish within your code.
Note: If your app supports both Android and iOS it would be better to create 2 different apps on the dashboard and use different API keys for each platform in your Unity code
You can retrieve Pollfish Unity Plugin through
Go to Pollfish Unity Plugin Asset Store page and click Add to my assets. Then you will be able to open that asset in Unity by clicking Open in Unity or locate it in Unity's package manager window. In both cases you will find the asset in package manager. To complete the installation click Download and then Import in the package manager.
Download Pollfish Unity Plugin using the Download button on the top of this page. In Pollfish Unity Plugin .zip file you will find the PollfishUnityPlugin.unitypackage file. You can use this file to easily import plugin’s necessary files.
Open your Unity project and right click on your Assets folder in your Project area or select Assets from the menu and then choose Import Package, then Custom Package and finally select PollfishUnityPlugin.unitypackage
Note: If you want to exlude demo scene please uncheck Assets/Pollfish/Demo folder. Have in mind that in demo folder you will find PollfishDemo.cs file which demonstrates Pollfish Unity Plugin usage within a scene.
Note: Review the package files and then select Import. If you are targeting only Android platform for example you can uncheck the iOS folder and vice versa.
Imported files will be listed in the following directories:
- Assets/ExternalDependencyManager – Files to help with plugin dependencies retrieval using unity-jar-resolver.
If you target iOS
External Dependency Manager will automatically create a Pod XCode workspace with Pollfish SDK dependency.
Note: Make sure that you use the *.xcworkspace and NOT the *.xcodeproj for any additional changes after the iOS project build through Unity.
If you target Android
External Dependency Manager will automatically add Google Play Services in your Android project.
Note: Please have in mind that in order to use Pollfish you have to include Google Play Services in your Unity project. You can easily do that by selecting Assets –> External Dependency Manager -> Android Resolver -> Resolve. If you do not have Google Play Services you can install them through Android SDK Manager.
Note: If you are using gradle templates in your Unity project unity-jar-resolver will not resolve any Android dependencies nor handle class duplications. In such case you will need to handle class duplication by excluding the duplicating group from Pollfish Android SDK gradle dependency.
For example if a class from
com.google.android.gmspackage is duplicated:implementation 'com.pollfish:pollfish-googleplay:6.3.1' { exclude group: 'com.google.android.gms' }
Note: If you do not want to use External Depency Manager you need to manually add the following dependencies to your Android project:
dependencies { ... implementation 'com.pollfish:pollfish-googleplay:6.3.1' }and then include the Pollfish iOS SDK framework in you iOS XCode project in order for Pollfish to work properly. Please visit this guide to download the latest framework version and import it on a XCode project.
Android 12
Apps updating their target API level to 31 (Android 12) or higher will need to declare a Google Play services normal permission in the AndroidManifest.xml file.
Navigate to your exporter Android project's AndroidManifest.xml file, or to your AndroidManifest template file and add the following line just before the
<application>.<uses-permission android:name="com.google.android.gms.permission.AD_ID" />You can read more about Google Advertising ID changes here.
iOS 14+
Request IDFA Permission (Recommended but optional)
Pollfish surveys can work with or without the IDFA permission on iOS 14+. If no permission is granted in the ATT popup, the SDK will serve non personalized surveys to the user. In that scenario the conversion is expected to be lower. Offerwall integrations perform better compared to single survey integrations when no IDFA permission is given. Our recommendation is that you should ask for IDFA usage permission prior to Pollfish initialization.
-
Assets/Pollfish/Plugins/Android – Android Pollfish libraries and resources.
-
Assets/Pollfish/Plugins/iOS – Pollfish bridge file.
-
Assets/Pollfish/Editor – Pollfish C# files that allow communication between Unity and Java for Android and Unity and Objective-C for iOS.
-
Assets/Pollfish/Demo – A simple scene that demonstrates Pollfish plugin integration.
The Pollfish plugin must be initialized with your api key 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.
#if UNITY_ANDROID
public string apiKey = "YOUR_ANDROID_API_KEY";
#elif UNITY_IPHONE
public string apiKey = "YOUR_IOS_API_KEY";
#endif
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.RewardMode(true);You can set several params to control the behaviour of Pollfish survey panel within your app with the use of the Pollfish.Params instance. Below you can see all the available options.
Note: All the params are optional, except the
ReleaseModesetting that turns your integration in release mode prior publishing to the Google Play or App Store.
| No | Description |
|---|---|
| 4.1.1 | .IndicatorPosition(Position) Sets the Position where you wish to place the Pollfish indicator. |
| 4.1.2 | .IndicatorPadding(int) Sets the padding from top or bottom depending on the position of the indicator. |
| 4.1.3 | .ReleaseMode(bool) Sets Pollfish SDK to Debug or Release Mode |
| 4.1.4 | .RewardMode(bool) Initializes in reward mode (skip Pollfish indicator to show a custom prompt) |
| 4.1.5 | .OfferwallMode(bool) Sets Pollfish SDK to offerwall mode |
| 4.1.6 | .RequestUUID(string) Sets a pass-through param to be receive via the server-to-server callbacks |
| 4.1.7 | .UserProperties(Dictionary<string, string>) Send attributes that you receive from your app regarding a user, in order to receive a better fill rate and higher priced surveys. |
| 4.1.8 | .ClickId(string) A pass throught param that will be passed back through server-to-server callback |
| 4.1.9 | .UserId(string) A unique id ised to identify a user |
| 4.1.10 | .RewardInfo(RewardInfo) An object holding information regarding the survey completion reward. |
| 4.1.11 | .Signature(string) An optional parameter used to secure the rewardConversion and rewardName parameters passed on rewardInfo Json object |
| 4.1.12 | .MonitorOrientation(bool) Toggle SDK reinitalization when device orientation changes |
| 4.1.13 | .PlacementId(String) The id of the placement to load |
Sets the Position where you wish to place Pollfish indicator -->
Also this setting sets from which side of the screen you would like Pollfish survey panel to slide in.
Pollfish indicator is shown only if Pollfish is used in a non rewarded mode.
There are six different options available:
Position.TOP_LEFTPosition.BOTTOM_LEFTPosition.MIDDLE_LEFTPosition.TOP_RIGHTPosition.MIDDLE_RIGHTPosition.BOTTOM_RIGHT
If you do not set explicity a position for Pollfish indicator, it will appear by default at Position.TOP_LEFT
Note: If you would like to skip the Pollfish Indicator please set the
rewardModetotrue
Below you can see an example on how you can set Pollfish indicator to slide from top right corner of the screen:
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.IndicatorPosition(Position.TOP_RIGHT);The padding from the top or bottom of the screen according to position of the indicator (small icon) specified above (.TOP_LEFT is the default value)
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.IndicatorPadding(8);Note: if used in MIDDLE position, padding is calculating from the top
Sets Pollfish SDK to Developer or Release mode. If you do not set this param it will turn the SDK to Developer mode by default in order for the publisher to be able to test the survey flow.
You can use Pollfish either in Debug or in Release mode.
- Debug/Developer 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 in AppStore (start receiving paid surveys).
Note: Be careful to set release mode parameter to true prior releasing to Google Play or AppStore!
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.ReleaseMode(true);Initializes Pollfish in reward mode. This means that Pollfish Indicator (section 4.1.1) will not be shown and Pollfish survey panel will be automatically hidden until the publisher explicitly calls Pollfish show function (The publisher should wait for the Pollfish Survey Received Callback). This behaviour enables the option for the publishers, to show a custom prompt to incentivize the users to participate in a survey.
Note: If not set, the default value is false and Pollfish indicator is shown.
This mode should be used if you want to incentivize users to participate to surveys. We have a detailed guide on how to implement the rewarded approach here
Note: Reward mode should be used along with the Survey Received callback so the publisher knows when to prompt the user and call
Pollfish.show()
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.RewardMode(true);Enables Pollfish in offerwall mode. If not specified Pollfish shows one survey at a time.
Below you can see an example on how you can intialize Pollfish in Offerwall mode:
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.OfferwallMode(true);Sets a pass-through param to be receive via the server-to-server callbacks. You can read more on how to retrieve this param through the callbacks here
Below you can see an example on how you can pass a requestUUID during initialization:
Pollfish.Params pollfishParams = new Pollfish.Params(apiKey)
.RequestUUID(true);Passing user attributes to skip or shorten Pollfish Demographic surveys.
If you know upfront some user attributes like gender, age, education and others you can pass them during initialization in order to shorten or skip entirely Pollfish Demographic surveys and archieve better fill rate and higher priced surveys.
Note: You need to contact Pollfish live support on our website to request your account to be eligible for submitting demographic info through your app, otherwise values submitted will be ignored by default.
Note: You can read more on demographic surveys along with a list with all the available options here
An example of how you can pass user demographics can be found below:
Dictionary<string, string> userProperties = new Dictionary<string, string>
{
{ "gender", "1" },
{ "year_of_birth", "1974" },
{ "marital_status", "2" },
{ "parental", "3" },
{ "education", "1" },
{ "employment", "1" },
{ "career", "2" },
{ "race", "3" },
{ "income", "1" }
};
Pollfish.Params pollfishParams = new Pollfish.Params()
.UserProperties(userProperties);A pass through parameter that will be returned back to the publisher through server-to-server callbacks as specified here
Pollfish.Params pollfishParams = new Pollfish.Params()
.ClickId("CLICK_ID");A unique id used to identify the user
Setting the userId will override the default behaviour and use that instead of the Advertising Id, of the corresponding platform, in order to identify a user
You 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.
Pollfish.Params pollfishParams = new Pollfish.Params()
.UserId("USER_ID");An object passing information during initialization regarding the reward settings, overriding the values as speciefied on the Publisher's Dashboard
We strogly advise that you should use the Publisher Dashboard to provide Reward Info if your use case does not require a dynamic value.
public RewardInfo(string rewardName, double rewardConversion)| Field | Description |
|---|---|
rewardName |
Overrides the reward name as specified in the Publisher's Dashboard |
rewardConversion |
Overrides the reward conversion as specified on the Publisher's Dashboard. Conversion is expecting a number matching this function ( 1 USD = X Points ) where X is a Double number. |
RewardInfo rewardInfo = new RewardInfo("Diamonds", 1.1);
ParaPollfish.Params pollfishParams = new Pollfish.Params()
.RewardInfo(rewardInfo);Warning: If a
rewardInfois set, please make sure to calculate and set the correct signature (4.1.11). By skipping this step you will be unable to receive surveys.
An optional parameter used to secure the rewardName and rewardConversion parameters as provided in the RewardInfo object (4.1.10). If rewardConversion and rewardName are defined, signature is required to be calculated and set as well.
This parameter can be used to prevent tampering around reward conversion, if passed during initialisation. The platform supports url validation by requiring a hash of the rewardConversion, rewardName, and clickId. Failure to pass validation will result in no surveys return and firing PollfishSurveyNotAvailable callback.
In order to generate the signature field you should sign the combination of $"{rewardConversion}{rewardName}{clickId}" parameters using the HMAC-SHA1 algorithm and your account's secret_key that can be retrieved from the Account Information section on your Pollfish Dashboard.
Note: Although
rewardConversionandrewardNameare mandatory for the hashing to work,clickIdparameter is optional and you should add them for extra security.
Note: Please keep in mind if your
rewardConversionis a whole number, you have to calculate the signature useing the floating point value with 1 decimal point.
Pollfish.Params pollfishParams = new Pollfish.Params()
.Signature("SIGNATURE");Sample C# (.NET 6) code to generate valid signatures.
This method should work on lower .NET versions as well if you use string concatenation instead of interpolation.
using System.Text;
using System.Security.Cryptography;
string key = "ACCOUNT_SECRET_KEY";
string signData = $"{rewardConversion}{rewardName}{clickId}";
var encoding = new System.Text.UTF8Encoding();
byte[] messageBytes = encoding.GetBytes(signData);
byte[] keyBytes = encoding.GetBytes(key);
byte[] hashMessage = new HMACSHA1(keyBytes).ComputeHash(messageBytes);
string signature = Convert.ToBase64String(hashMessage);An optional parameter used to toggle SDK reinitalization when device orientation changes. By default the SDK initializes when a device orientation changes.
Note: Setting this option to false will force survey panel to render at full screen size on iPad.
Pollfish.Params pollfishParams = new Pollfish.Params()
.MonitorOrientation(false);The id of the placement you wish to load as provided by the publisher dashboard. If not provided, then the default placement of the ad unit will be loaded.
Pollfish.Params pollfishParams = new Pollfish.Params()
.PlacementId("PLACEMENT_ID");Last but not least. Call Pollfish.Init(params) passing the Params object that you've configured earlier as an argument.
public void OnEnable()
{
Pollfish.Init(pollfishParams);
}Add the following paragraph to your App's Privacy Policy:
“Survey Serving Technology
This app uses Pollfish SDK. Pollfish is an on-line survey platform, through which, anyone may conduct surveys. Pollfish collaborates with Publishers of applications for smartphones in order to have access to users of such applications and address survey questionnaires to them. When a user connects to this app, a specific set of user's device data (including Advertising ID, Device ID, other available electronic identifiers and further response meta-data is automatically sent, via our app, to Pollfish servers, in order for Pollfish to discern whether the user is eligible for a survey. For a full list of data received by Pollfish through this app, please read carefully the Pollfish respondent terms located at https://www.pollfish.com/terms/respondent. These data will be associated with your answers to the questionnaires whenever Pollfish sends such questionnaires to eligible users. Pollfish may share such data with third parties, clients and business partners, for commercial purposes. By downloading the application, you accept this privacy policy document and you hereby give your consent for the processing by Pollfish of the aforementioned data. Furthermore, you are informed that you may disable Pollfish operation at any time by visiting the following link https://www.pollfish.com/respondent/opt-out. We once more invite you to check the Pollfish respondent's terms of use, if you wish to have more detailed view of the way Pollfish works and with whom Pollfish may further share your data."
Note: Remember to turn your app in release mode prior publishing to a relevant app store
You can have a look for some integration tips here or if have any question, like why you do not see surveys on your own device in release mode, please have a look in our FAQ page
Note: Please bear in mind that the first time a user is introduced to the platform, when no paid surveys are available, a standalone demographic survey will be shown, as a way to increase the user's exposure in our clients' survey inventory. This survey returns no payment to app publishers, since it is part of the process users need to go through in order to join the platform. Bear in mind that if a paid survey is available at that point of time, the demographic questions will be inserted at the begining of the survey, before the actual survey questions. Our aim is to provide advanced targeting solutions to our customers and to do that we need to have this information on the available users. Targeting by marital status or education etc. are highly popular options in the survey world and we need to keep up with the market. A vast majority of our clients are looking for this option when using the platform. Based on previous data, over 80% of the surveys designed on the platform require this new type of targeting.
 |
 |
In our efforts to include publishers in this process and be as transparent as possible we provide full control over the process. We let publishers decide if their users are served these standalone surveys or not, in 2 different ways. Firstly by monitoring the process in code and excluding any users by listening to the relevant noitifications (Pollfish Survey Received, Pollfish Survey Completed) and checking the Pay Per Survey (PPS) field which will be 0 USD cents. Secondly, publishers can disable the standalone demographic surveys through the Pollfish Developer Dashboard in the Settings area of an app. You can read more on demographic surveys here.
If you know attributes about a user like gender, age and others, you can provide them during initialization as described in section 7.2 to skip or shorten Pollfish Demographic surveys.
After your app is published on an app store you should request your account to get verified from your Pollfish Developer Dashboard.
When your account is verified you will be able to start receiving paid surveys from Pollfish clients.
Pollfish SDK requires minSdk 21. If your app supports a lower minSdk you can still build your app and exlude Pollfish from targets lower than 21 by exporting an Android project from the Unity's Build Settings and adding the following block on the AndroidManifest.xml of the unityLibrary module.
AndroidManifest.xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
... >
<uses-sdk tools:overrideLibrary="com.pollfish.pollfish" />
<application
... >
...
</application>Since Pollfish uses Android back button to close its panel if open, if you want to replicate this behavior you should capture back button event and call Pollfish.ShouldQuit(); to inform the library and act accordingly.
public void Update ()
{
/* handling Android back event */
if (Input.GetKeyDown (KeyCode.Escape)) {
Pollfish.ShouldQuit();
}
}We have included an AndroidManifest.xml file that will work for most of user cases However if you need to include your own AndroidManifest file remember to add the following lines:
<meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="true" />within your Activity that holds the following intent filters:
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>This line enable touch events to pass through Pollfish SDK.
Finally, Pollfish requires Internet permission in order to work, so please do not forget to add the following line if you do not already have it.
<uses-permission android:name="android.permission.INTERNET"/>If you use proguard with your app, please insert the following lines in the proguard configuration file under the unityLibrary module:
-keep class com.pollfish.** { *; }
-keep class com.pollfish_unity.** { *; }
-dontwarn com.pollfish.**
Pollfish uses Advertising Identifier (IDFA) for survey distribution (if permission granted) and therefore when submitting your app to the App you should select the following options as seen in the image below:
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 be eligible to more targeted (high-paid) surveys. All these steps are optional.
You can be 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
null, otherwise it will include info around the received survey.
Pollfish.SurveyReceivedEvent += SurveyReceived;
public void SurveyReceived(SurveyInfo surveyInfo)
{
if (surveyInfo == null)
{
Debug.Log("PollfishDemo: Survey Offerwall received");
}
else
{
Debug.Log("PollfishDemo: Survey was completed - " + surveyInfo.ToString());
}
}You can be 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.
Pollfish.SurveyCompletedEvent += SurveyCompleted;
public void SurveyCompleted(SurveyInfo surveyInfo)
{
Debug.Log("PollfishDemo: Survey was Completed - " + surveyInfo.ToString());
}You can be 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.
Pollfish.UserNotEligibleEvent += UserNotEligible;
public void UserNotEligible()
{
Debug.Log("PollfishDemo: User not eligible");
}You can be notified when a Pollfish survey is not available.
Pollfish.SurveyNotAvailableEvent += SurveyNotAvailable;
public void SurveyNotAvailable()
{
Debug.Log("PollfishDemo: Survey not available");
}You can be notified when a user has rejected a Pollfish survey.
Pollfish.UserRejectedSurveyEvent += UserRejectedSurvey;
public void UserRejectedSurvey()
{
Debug.Log("PollfishDemo: 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.
Pollfish.SurveyOpenedEvent += SurveyOpened;
public void SurveyOpened()
{
Debug.Log("PollfishDemo: Survey was 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.
Pollfish.SurveyClosedEvent += SurveyClosed;
public void SurveyClosed()
{
Debug.Log("PollfishDemo: Survey was closed");
}Please make sure you unsubscribe from Pollfish Event Listeners, preferably on the scene destruction to avoid duplicated events.
public void OnDisable()
{
Pollfish.SurveyCompletedEvent -= SurveyCompleted;
Pollfish.SurveyOpenedEvent -= SurveyOpened;
Pollfish.SurveyClosedEvent -= SurveyClosed;
Pollfish.SurveyReceivedEvent -= SurveyReceived;
Pollfish.SurveyNotAvailableEvent -= SurveyNotAvailable;
Pollfish.UserNotEligibleEvent -= UserNotEligible;
Pollfish.UserRejectedSurveyEvent -= UserRejectedSurvey;
}You can manually hide and show Pollfish by calling the functions below, after initialization.
Pollfish.show();Pollfish.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.
bool isPresent = Pollfish.isPollfishPresent():You can check at any time if the survey panel is open by calling the following function.
bool isOpen = Pollfish.isPollfishPanelOpen();You can read more info on how the Native Pollfish SDKs work on Android and iOS at the following links: