Bonus Bar
The Bonus Bar is a recurring, gamified reward that drives repeat engagement. Players fill a progress bar by completing surveys and unlock rewards as they reach milestones. The bar resets on a schedule (for example, weekly), so it's a repeatable loop rather than a one-time bonus.
How it works
- A player sees a progress bar with one or more milestones, each with a completion threshold and a reward.
- Each qualifying survey completion advances the player's progress within the current reset window.
- When their completion count reaches a milestone's threshold, the player earns that milestone's reward in your in-app currency.
- At the end of the window the bar resets, and the player can earn the rewards again in the next window.
Bonus Bar rewards are delivered just like any other reward in your integration — through your normal server-to-server reward callback — so there's nothing extra to build.
Setting it up
Configure the Bonus Bar in the Supplier Dashboard → App Settings → Bonus bar tab. Create one or more configs; each config defines a bonus bar for a set of players.
Config settings
| Setting | Description |
|---|---|
| Currency | The in-app currency milestone rewards are paid in. Required — pick (or create) a currency before saving. |
| Schedule | Weekly (recurring) — the bar resets every week on a day and time you choose. One-time event — the bar runs once between a start and end date. |
| Reset day & time (weekly) | The day of the week and time the bar resets each week. |
| Start & end (one-time) | The window during which a one-time bar is active. |
| Audience | Apply the config to all players, or target a specific player cohort. You can have one config per cohort plus a default for everyone else. |
Milestones
Each config has an ordered list of milestones. For each milestone you set:
- Completes — the number of qualifying completions required to unlock it. Must be a positive whole number, and each milestone's threshold must be unique within the config.
- Reward — the amount of your in-app currency the player earns when they reach the threshold. Must be a positive whole number.
Add as many milestones as you like. For example:
| Completes | Reward |
|---|---|
| 3 | 100 |
| 6 | 250 |
| 10 | 600 |
A milestone reward doesn't have to be flat currency — it can also unlock a currency-sale-style multiplier (for example, 2× for a set period). TapResearch sets this up on the backend, so reach out if you'd like a milestone to reward a multiplier instead of (or alongside) a currency amount.
Things to know
- A currency is required. Each config pays out in one of your app's currencies.
- One config per audience. Target different cohorts with different bonus bars, plus a default config for everyone else.
- What counts as a "complete." Only qualifying survey completions during the current window advance a player's progress.
- Reward amounts are whole numbers. Milestone rewards are paid as whole units of your currency.
- Availability. The Bonus Bar is available across all four integration paths.