Reward Rules

Write global rules for your in-game economy.

Reward rules define how users earn or lose rewards based on their actions. These rules determine the actions that are rewarded or punished, and those that are relevant or irrelevant.

Examples of Reward Campaigns

  1. Receive 1% cashback on orders over $200.
  2. Earn $10 for each new user you invite who deposits at least $1.
  3. Gain 10 experience points every time someone reacts to your message in Discord with an emoji. πŸ”₯
  4. With a 1% chance, win a $100 voucher for any purchase from the promoted section.

Capabilities of Reward Rules

  1. Define advanced conditions to filter events eligible for rewards.
  2. Create rewards based on specific events and user data.
  3. Customize rewards according to user levels and segments.
  4. Display widgets to users to inform them about applicable rules.

Event Filtering

Link the event to one of the data types you've previously created or a pre-existing system game event. Our global event filtering system lets you set conditions that events must meet to trigger a reward rule.

To gain a deeper understanding of how event function, explore the Introduction to Events section


Quests are integrated into a global rewards framework, enabling a flexible and customizable selection of rewards. This system allows for personalization at both the individual user and segment levels. Detailed information on the variety of rewards is available in the rewards section of our documentation. Transaction histories will reflect the quest and the bonus earned, enhancing transparency and user engagement.

For doing action which qualified for the reward rule you can reward your users everything that global rewards framework supports including:

  1. Tokens
  2. Perks
  3. Status Points
  4. etc.


Dynamic Rewards

With dynamic rewards, you can tailor rewards based on properties from the qualifying event. For instance, users can be rewarded with 1% cashback based on their deposits.

UI Customization

Reward rules can be categorized as public or private. Private rules are typically used internally or for testing, while public ones can be accessed via our public API and displayed through widgets.

Reward Rule Banner

Utilize the widget to inform users about ongoing promotions or new opportunities to earn rewards. This feature allows dashboard admins to update rules without needing developer intervention, even if you choose to build a custom UI.

Creating a Reward Rule

Creating a reward rule involves several steps:

Step 1: Design the Reward Rule

Decide the action for which you want to reward your users. Example rules include:

  • Earn 1 coin for every $1 wagered
  • Earn 1 coin for every mile traveled
  • Earn 1 coin for every dollar spent
  • Earn 1 coin for every ad viewed

These rules are beneficial as they are simple, achievable, and directly contribute to company revenue.

Other example rules that are achievable only once might include:

  • Complete app onboarding
  • Make the first deposit
  • Verify your account

These can be part of a larger reward program.

Step 2: Create the Reward Rule

  1. Navigate to Ways To Earn > Reward Rules and click Create.
  2. Select the event type for the reward rule.
  3. (Optional) Add filters to the rule, such as by sport, league, or bet type.
  4. Set the reward, e.g., 10 coins for every bet placed.
  5. Name and save the rule.

Step 3: Test the Reward Rule

Send a test event with the event type selected for the reward rule. Afterwards, you can verify the user's reward balance in the Users section of the admin panel.