Rewards

Our team has built a comprehensive and customizable reward system. It is utilized all across the system. Quests, game rules, perks, and levels all rely on it. While talking about rewards, we are not talking about redemption options

You can reward your users with

1. Perks
2. Tokens
3. Status Points
4. Collectibles
5. Active perk slots
6. Quests
7. Custom reward you created

Reward Visibility

Control how these rewards are displayed to your users using Reward Visibility. This allows you to tailor the reward experience, from keeping rewards completely hidden to prominently showcasing them. We offer three distinct levels of visibility:

1. Hidden 🙈
   Rewards are completely invisible to users. They are not displayed anywhere, whether in widgets, pop-ups, or any other user-facing interface.
2. Visible in Widget 🎯 (default)
   Rewards are visible within relevant widgets. This means users will see these rewards displayed as part of the feature they're associated with, such as Quests, Assignments, Levels, Polls, etc.
3. Promoted 🎉
   The rewards receive the highest level of visibility. They are not only displayed within widgets but are also showcased through Reward Pop-ups. These pop-ups are designed to grab users' attention and prominently display the reward they've earned. To add Reward Pop-ups for a specific page, you can use the widget editor.

Reward distribution

Starting with version v1.13.0, we've introduced a new, more flexible system for configuring how rewards are distributed and how their amounts are determined. These updates bring greater control, structure, and variety to your reward logic—allowing for more engaging user experiences.

🚧

Breaking Changes

The reward system has been completely restructured in this version. The way rewards are configured and assigned has changed significantly.
Please consult the Migration Guide to update your existing setups and ensure compatibility with the new system.

New Distribution Modifiers

Modifiers define how rewards are given to users. This new system replaces the older, fixed method with a more flexible and modular approach. There are currently two main modifier types:

• Choose Any: This lets users pick one or more rewards from a predefined set. It introduces an element of choice and unpredictability that can increase engagement.
• Give Random: Automatically gives the user one or more random rewards from a defined bundle. This simplifies setup while adding variety to the rewards users receive.

If no reward modifiers are added, users will receive all rewards simultaneously, as was the case prior to this update.

📘

Note

To enable user interaction with rewards (e.g., selection), be sure to include the Reward Selector Popup in your Widget Configurator.

Reward amount

The new reward system supports multiple ways to configure reward values, giving you flexibility depending on the context:

• Constant – Set a fixed amount for the reward, such as a specific number of tokens or points.
• Range – Define a range for the reward amount (e.g., 10–200 tokens), and the system will randomly assign a reward amount within that range.
• Template Fields – For certain use cases like Polls, Quests, Reward Rules, and Perks, you can use template fields to dynamically set the reward amount based on other factors or data.

Dynamic values

🚧

Math.js

Your dynamic value expression must be a valid math.js, which will return a single number. Read more about it here: https://mathjs.org/.

Every reward has a form that you need to fill out. For example, when you want to give a user a token, you must fill out a form asking how many tokens you want to share. In most other systems, you can specify a static value there, but we can make rewards dynamic based on the event that triggered it or the user.

Every dynamic value must be linked to an appropriate event property, becoming the “value” for the emotional value. However, thanks to our integration with math.js, you can transform that value with advanced math written with simple syntaxis https://mathjs.org/.

Calculated based on percentage by level or segment

This can customize rewards based on the user level or segment he is in. Every value represents a % of the value of the event property you selected.

Advanced Raw Expressions

Raw expressions enable advanced customization by allowing dynamic calculations and configurations. Here’s how you can use them:

1. Random. Instead of giving a reward for sure, you can give it a chance. Use the random() function to get a random number from 0 to 1.
2. Accessing external data. You can reference and manipulate your event properties or user properties.

For more details on using expressions, refer to the documentation.

Available Rewards

You can choose your rewards from the library of pre-defined reward options or create additional rewards using user properties.

Token

Represents the value of internal to in your system. Tokens are worth nothing unless you create a redeem option for them. You can enable inflation if you want the price of your token to inflate. This feature is helpful if you want your users to exchange your tokens for real money.

Specific Perk

Give specific perks to users. You can reward even perks that are disabled. This way, you can create exclusive bonuses not visible to other users.

Random Perk

Give a random enabled perk to the user. All perks that are valid and allowed will be subject to the unexpected.

Perk Slots

As you may know, only a limited number of perks can be active, and usually, this number is between one and three. You can reward your user his first perk slow from the quest and then reward the rest from leveling up.

You also have the power to reset perk slots and set a specific number of them.

Gold Trophy

The Gold Trophy is a predefined user property you can use as a collectible. The typical use case is to reward your users with gold Trophies for completing quests.

Featured Trophy

The Featured Trophy is another predefined user property designed to serve as an exclusive collectible. These trophies are typically awarded for extraordinary achievements, milestones, or participation in unique events. Their rarity and exclusivity make them a coveted item among users, encouraging engagement and continuous involvement in the system.

Quests

Quests are a powerful tool for engaging users and guiding them through the system. You can reward users with quests, which will appear in their quest backlog. This can be a great way to introduce new users to the system or to encourage existing users to explore new features.

Quest as a reward bypass all the quest requirements. This way, you can reward your users with a quest that is not available to them yet. Also, you can create a unique journey for each user by rewarding them with different or random quests.

External

External rewards refer to incentives that exist outside the immediate digital environment. This could include physical merchandise, gift cards, or other tangible rewards. While managing these rewards requires additional logistics, they can effectively motivate users, especially in community-driven or promotional events.

While giving an external reward, you can save in the user profile that he claimed this reward. To do that, you need to configure the property's name to update. You can also customize the description, which users will see when they receive this reward or see it in the backlog.

User Property

User Stats are a versatile reward type that directly influences the user's profile or game statistics. This could be anything from increasing a user's level of magic, enhancing specific abilities, or unlocking new features within the system. User Stats are a powerful way to personalize the user experience and make the journey more engaging and rewarding.

You can select which user property to modify and choose from 3 available operations: ADD, SUBSTRACT, and SET.

None

Opting for 'None' as a reward might seem counterintuitive, but it has strategic applications. It can be used in scenarios where the mere participation in an event or completion of a quest is the primary goal, without any tangible reward. This approach can be practical in situations where intrinsic motivation is being promoted or for events that are preliminary qualifiers for more significant rewards.

UI customization

We support user-facing customization for rewards, which means even though you can’t customize how pre-defined properties like Gold Trophy will be named on your dashboard, you have total control over their icon and name across the user-facing widget.