Pollfish provides an Offerwall mode where users are allowed to complete multiple survey offers within the same session. Pollfish Offerwall is similar to any other ad offerwall, however it focuses exclusively on surveys and market research.
With Pollfish Offerwall solution, users can choose and complete multiple surveys and get rewarded for their opinions. The flow that a user has to follow while using the Offerwall is as described below:
Users in order to be able to participate to surveys on the very first time the will get introduced to the platform they will have to answer a small set of Demographic questions to unlock surveys. After all demographic questions are filled users can start completing surveys.
| Note: If a publisher knows the demographic info of the users upfront, he can pass them during initialization in code and skip those questions from being rendered to users
Once a user ulocked surveys from the previous step, he can choose from a variety of different surveys to participate.
If no surveys are available for that user, an empty state screen will be rendered to the user to inform him to check back later for survey opportunities.
Users will get rewarded for every succesfully completed survey on the Offerwall after it passes validation from the real-time anti-fraud mechanism. Users can visit the history section of the Offerwall at any time to get more info on surveys succesfully completed or surveys that they got screened out and learn more about the reasons (this level of transparency can decrease complains from the users as they can check the status of their responses on their own)
Below, you can see a list of all the logical steps needed, in order to show Pollfish Offerwall under a rewarded placement:
In the App Settings area of your Dashboard, you should create an Offerwall Placement and set your preferred settings.
You can customize the following settings:
Reward Settings
- Name of virtual reward shown on the wall
- Exhange rate. How much does your currency worth compared to one USD?
Logo
- You can upload your own logo that will be displayed on the top of the wall
Theme
- You can customize the primary colours of the wall and the background.
In the Survey settings of an Offerwall Placement you can customize the type of surveys you would like to see within the offerwall. You can enable or disable providers, set price floors per network, maxiumum length of survey, minimum aceptable conversion rate and even filter out surveys based on keywords!
You should initialize Pollfish SDK in reward and offerwall mode. With this mode, Pollfish indicator will be skipped and Pollfish survey panel will stay hidden when the Offerwall is ready.
To sum up, initialize with the following in mind:
- rewardMode: true
- offerwallMode: true
You should register and listen for Pollfish Survey Received notification/listener. If you receive a survey received notification you can prompt your users with a custom prompt in order to enter the Offerwall.
Pollfish Survey Received notification should be used from publishers to check if the offerwall is available and has any surveys to be completed. No further information are available through the notification and therefore no further parsing should be made to the notification object.
When you receive a notification that a survey was received on the device you can show a custom prompt, or a button to prompt your users to to enter the Offerwall and earn some sort of a virtual currency (As specified in step 1).
Below you can see an example of a custom prompt created by a publisher of the platform:
If a user chose to get into the Offerwall (by clicking on your custom prompt for example) you should call Pollfish show function in order to open Pollfish survey panel to the user, to start completing surveys.
You can register and listen for Pollfish survey completed notifications/listener. Through the Survey Completed notification, you can easily find more detailed information on each survey completed including:
- Money to be earned in USD cents
- Survey Incidence Rate
- Survey Length of Interview
- Survey Class
- Reward Name
- Reward Value
Note: It is strongly adviced that you do not reward users directly on survey completion notification within the SDK. You should register on Pollfish Dashboard to receive server-to-server callbacks as described in step 8 and reward your users upon the receival of that callbacks.
In order to avoid user fraud it is strongly adviced to register a server-to-server callback on Pollfish Developer Dashboard in order to receive a relevant notification on your server side upon survey completion. Once this notification is received you can reward your users.
You can find detailed information on how to set up server-to-server callbacks here
Since Pollfish is a survey platform, some times users maybe screened out once a survey is started. Having that said, you can register and listen for Pollfish User Not Eligible notification/listener. If this event is fired you will not earn any money from that survey and you should not reward your users either.
If you want to pass a custom user param on your server side during survey completion you should follow the steps below:
a) Pass your custom param during Pollfish initialization (check for requestUUID param in docs)
b) Set your server-to-server callback as described in step 8
c) Receive custom param on your server side during a survey completion
This approach is usually followed by publishers when looking to send over a unique identification of a user (as it is saved on publisher's side) to their server side through Pollfish SDK to associate that completion with a specific user.
You can find examples in code on how to implement the Offerwall approach in the links below:
If you are using a different platform or engine please follow the logical steps as described above in order to archieve the desired behaviour.