# 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.

BO: List of levels and summary of their configuration

### **"Core" configuration** 1. 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. 2. Write a **description** for the level 3. 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. 4. Level **status**\ Levels should be drafted when they are not completely configured. Once they are published, the users will start to progress. 5. 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. 6. **Required Points**\ The number of points required by a user to collect to enter this level. {% hint style="warning" %} **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. {% endhint %}

### Additional settings 1. **Custom data field**\ This field is exposed through the Public API, enabling integration into tailored gamified UI components. 2. **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. 3. **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	Required Points	Visible >= Points
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

{% hint style="info" %} See “[*Points Collection*](/welcome/products/gamification-basics/points.md#points-collection)” for more information. {% endhint %} ### Level System Configuration Each label supports a single level system, shared across all associated brands. This means the number of levels and their structure will be identical for every brand under the label. For example, if one brand has 5 levels, all others will also have 5. Also you cannot run multiple systems (e.g., points-based and performance-based) simultaneously. Only one level system can be active per label at a time. ## 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. You can also target the specific action of leveling up or down, rewarding users who level up with bonuses or minigames, and encouraging those who level down with a motivational message to keep them engaged. The payload event property is called “level direction”, and it’s included in the level change event, which you can use in the condition builder where you can set it as Up or Down. For more details check how to [build campaign with custom event properties](https://help.smartico.ai/welcome/products/crm-automation/segmentation/query-builder#event-evaluation-in-query-builder).

BO: Example of segmentation of users who have leveled up

### 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. {% hint style="info" %} Example: You might observe that this week saw a 70% increase in users upgrading to Level 7 compared to the previous week, while Level 3 experienced a drop in user count. These insights help you understand how users are progressing, where they may be getting stuck, and which levels are driving the most engagement. {% endhint %} 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.

BO: Visualisation of level distribution in Data Studio

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. ## Level logic 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 the last 30 days" and "Betting amount for the last 30 days" for the Casino product, or the number of bets in the Sports product, the number of Lottery tickets, the number of open positions, or the total volume in the Forex. {% hint style="info" %} See different scenarios of the behavioral levels in the [Levels based on players behavior](/welcome/products/gamification-basics/levels/levels-based-on-players-behavior.md) {% endhint %} When such components are defined, every level should have thresholds for each component.

BO: Levels configuration with additional components "Deposit amount for last 30 days" & "Betting amount for the last 30 days"

Based on the example above, the user will upgrade to level 'Lone Bandit' when he collects 650 points, deposits a total of 650 EUR in the last 30 days, and places the same amount on bets. Because the Deposit and Bets components are counted over a sliding window of the last 30 days, a user can be downgraded to a lower level if they don't meet the deposit/bet requirements to retain the current level or to upgrade to a higher one. It is important to note that level upgrades and downgrades do not occur in real time, and the recalculation frequency should be coordinated with the Smartico support team. Consequently, if a user’s progress bypasses a level (e.g., jumping from Level 2 directly to Level 4), rewards for the skipped level will not be triggered. In the gamification widget, the user can see their 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.

Gamification: Level popup showing 3 goals and their respective progress

Enabling components should be performed by Smartico support upon the operator's request. 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 set up in the translations, like in the example below.

BO: Adding translations for new components

## Level logic with manual control of level upgrades and downgrades The last option for changing the levels is not based on points or any other measurable user activity. With this logic, you can upgrade or downgrade the levels from Campaigns, Automation rules, Mini-games, rewards for missions, or even sell them in the Store. A new Activity type, called ‘Change Level’, was added, where you can choose the level you want to change for the user.

BO: Flow builder showing use of "Change level" activity

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.)

BO: Level configuration of Levels with Manual control

## 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.

Gamification: Level progress restricted to show only name and no points

Gamification: Level popup restricted to show only name and no points

You can also choose to display progress as a percentage, allowing you to hide point values while still visualizing how much progress has been made.

Gamification: Displaying level completion in percentage

## 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 the level map with Liquid, check:\ --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.smartico.ai/welcome/products/gamification-basics/levels.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.