Setting up the Levels

Intro

Missions or storylines regularly characterize levels, and in most cases, they give the user a sense of progression (for example, in a restaurant-themed gamification, you would have a busboy, dishwasher, cook, head chef, etc.). When you complete one level, you enter the next one, and to proceed to the next level, you probably need to gain more points or succeed in more complicated missions.

In most cases, the levels are themed, as opposed to having a boring Level 1, Level 2, etc. The following level can show an advancement or measure of power inside the gamification theme. The most important part is that the user feels remunerated for accomplishing another achievement.

Basic logic, based on the gamification points

To Level-Up using the Smartico Gamification, the user has to earn the number of points configured to each level. The points can be earned by completing missions, journey accomplishments, winning leaderboards, etc.

How to set levels:

  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 icon You can upload an icon for your level or insert your own URL. The icon size should be 256×256 for optimized visualization.

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

  5. Level status Levels should be drafted when they are not completely configured. Once they are published, the users will start to progress.

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

  7. Required Points The number of points required by a user to collect to enter this level.

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

See “Points Collection” for more information.

Use this matrix for reference; level 6 will be visible when the user is in the middle of completion of Level 4:

LevelRequired PointsVisible >= 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

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 F 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 Smart Icon 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.)

No points are displayed on the gamification widget in the Levels section. There is no progress bar in the upper right corner, only a statement of your next level.

Building a custom UI for the levels

The gamification widget provides basic UI to present levels, for example, on the screenshots above.

You can build a fully custom UI using Smartico API and integrate it into your website.

For more details check Smartico Expo page and Smartico Public API documentation

Last updated

Change request #417: