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 configured reward callback or postback — so there's nothing extra to build.
Setting it up
Configure the Bonus Bar under Settings → Bonus bar in the Publisher Dashboard. 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 |
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 for SDK, Hosted Link, and Eligibility API integrations.