Manage Levels
Create levels to define how users progress along your program's engagement scale. Nitro has one leveling system which applies to all users. You cannot set up different levels per group.
Create a Level
- Open Nitro Studio > Reward > Levels.
- Select your level type:
- Points - Assign levels automatically based on the user's lifetime point balance. When the point balance reaches a certain threshold, the user graduates to the next level. Levels are based on the default point category.
- Custom - Assign levels manually via API calls. You can use custom levels to assign levels based on user achievements.
- Click New level. Or, to edit an existing level, hover over the level and click Edit ().
- Set level properties:
- Click Save.
- For Custom levels, set up your API calls to determine when users achieve new levels.
Field |
Description |
---|---|
Level name |
The name of the level. |
Level points |
The number of points a user needs to earn to reach this level (Points type levels only). |
A description of the level. |
|
The custom phrase to display in events feeds when a user reaches this level. The action phrase supports tokens. |
|
The URL to the image that represents this level. If no image is defined, only the level name displays in relevant messaging. See Program Imagery for recommended image sizing. |
Delete a Level
Note: Deleting levels is not recommended.
When you delete a level from your program, any user currently at that level will return to the last level in their history. For example, Jess is at Level 1 and earns enough points to move to Level 3. If Level 3 is deleted, Jess will return to Level 1. However, if Jess progressed from Level 1 to Level 2 to Level 3 and then Level 3 is deleted, they will return to Level 2.
Display a Level to Users
After creating levels you may want to:
- Retrieve a user's level to display it on the site with the /users/{userId}/levels method.
- Retrieve the next level a user can achieve to show what the user is working toward with the /users/{userId}/levels method.
- Reward a user for reaching a new level. See an example of this mission setup
See also