Levels
Levels are a core mechanic in gamification, marking a user’s advancement. Each level should feel purposeful, with increasing complexity and clear goals that drive engagement.
In Smartico Gamification, leveling up requires earning a set number of points configured for each level. These points can be gained by completing missions, achieving journey milestones, winning leaderboards, and more. Every level should feel rewarding - reinforcing achievement and motivating users to keep pushing forward.
"Core" configuration
Choose a name for your level This name will appear on the client side. You can choose a name for each language if your brand supports different languages.
Write a description for the level
Upload Level image You can upload an icon for your level or insert your own URL. The icon size should be 256×256 for optimized visualization.
Level status Levels should be drafted when they are not completely configured. Once they are published, the users will start to progress.
Set as Default level The level configuration requires having one level as a default, so newly created users will be assigned this level automatically upon registration. There could only be one default level.
Required Points The number of points required by a user to collect to enter this level.
Note: Adding or removing levels, or modifying level requirements, requires submitting a JIRA ticket to trigger a rebuild and sync the changes across user accounts.
Additional settings
Custom data field This field is exposed through the Public API, enabling integration into tailored gamified UI components.
Integration parameter This optional parameter can be used in the Journey Builder to report 3rd party APIs with the change of level. For example, the user entered level Bitten -> The 3rd party will be updated in a reverse integration about the change of VIP/Level.
Visibility Points You can set visibility points to hide more advanced levels from beginner-level users. i.e., Level 2 requires 1000 points, and Level 5 requires 5000 points. You can set level 5 with 4000 visibility points so users on level 2 will not see level 5, as it is an advanced level.
Visibility Points - Example matrix
In the matrix below, Level 6 will be visible when the user is in the middle of completion of Level 4
Level 1
0
0
Level 2
50
0
Level 3
100
0
Level 4
200
0
Level 5
400
0
Level 6
800
150
Level 7
1000
600
User Level data
Level property
User progression through gamification levels is fully trackable via the Data Warehouse (DWH). Each user's current level is stored under the property ach_level_current_id, which represents the ID of the level they’ve reached within the gamification system.
This allows you to run targeted queries to analyze user engagement, segment audiences based on their progress, or trigger personalized campaigns depending on their level status. For example, you might filter users who are at a specific level to offer tailored rewards, or identify those who haven’t progressed recently to re-engage them.
Level Analytics
You can monitor and analyze user progression through gamification levels directly in Data Studio. The platform allows you to track level changes over time, compare performance across different timeframes, and visualize trends in user engagement.
Additionally, you can view level distribution across your user base (e.g. such as 1 million users currently on Level 1, 2,000 on Level 2, and so on. This data is invaluable for identifying bottlenecks, optimizing level design, and tailoring incentives.
Data Studio supports a variety of visualization formats, including line charts, bar charts, tables, and more—giving you full flexibility to present the data in the way that best suits your analysis or reporting needs.
Levels with multiple components for progress
In addition to the gamification points, levels can depend on up to 2 additional components calculated in a specific time window. For example, these could be "Deposit amount for last 30 days" and "Betting amount for the last 30 days" for the Casino product, or number of bets in the Sports product, number of Lottery tickets, number of open positions, or total volume in the Forex.
When such components are defined, every level should have defined thresholds for each of the components.
Based on the example above, the user will upgrade to level 'Lone Bandit' when he collects 650 points, does 650 EUR total deposit amount in the last 30 days, and the same amount in the bets.
Because Deposit and Bets components are counted in a sliding window of the last 30 days, a user can be downgraded to lower levels if he doesn't meet the requirements of deposits/bets to retain the current level or upgrade to a higher one.
It is important to note that level upgrades and downgrades are not happening in real-time, and the periodicity of recalculation should be aligned with the Smartico support team.
In the gamification widget, the user can see his progress to the next levels in 2 places. The main header shows combined progress for all components (in our case, points, deposits, and bets).
The level details popup lets the user see progress in each component split.
Enabling components should be done by Smartico support based on a request from the operator. It's possible to have only one component to count (e.g., Deposit) or two components (e.g., Deposits and Bets).
Additionally operators should provide visual names for each component and translations for all needed languages, they should be setup in the translations, like on the example below.
Logic with manual control of levels upgrade and downgrade
The last option for changing the levels is not based on points or any other measurable activity of the user.
With this logic, you can upgrade or downgrade the levels from the Campaigns, Automation rules, Mini-games, rewards of missions, or even sell them in the Store.
A new Activity type was added called ‘Change Level’, where you can choose the level you want to change for the user.
For example, if you have levels like Bronze, Silver, and Gold, you can set up a real-time campaign where the user is currently on level Bronze and has made a deposit, after which the total deposit amount is 500EUR, to upgrade him to Silver.
You can also schedule an automation rule to downgrade the level, for example, if the user is currently on level Gold, but hasn’t logged in for 30 days, change the level to ‘Silver’.
When creating the levels in the Levels section in BO, you have the ‘Set as Default level’ setting and ‘Level Number’ field.
‘Set as Default level’ - when enabled, the level will be set as Default one.
‘Level Number’ - defining the order of the levels (1st level, 2nd level, 3rd level, etc.)
Display Configurations
You can customize how Level functionalities appear to users through the label settings. In this configuration, the gamification widget in the Levels section is set to hide point values entirely. Instead of showing a progress bar in the upper right corner, users simply see a message indicating their next level.
Build Level Map with Liquid
You have full flexibility to design your own Level Map using Liquid. You can define how levels are positioned, customize the visual style, and tailor the experience across desktop and mobile. Whether it's adjusting colors, adding background images, or modifying how level names and pop-ups appear, Liquid gives you the control to shape the map exactly as you envision it.
To find more details about Level map with Liquid check: https://help.smartico.ai/welcome/products/gamification-basics/liquid-section#templates
Last updated
Was this helpful?