Updated leaderboard!
We recently released a new, improved leaderboard feature. Here are some important things to pay attention to, following the update:
Leaderboard entry limitation (one v. multiple entries) is automatically controlled by the same identifier that is used as registration limit ID (default is email)
"Old" leaderboard versions will not be included when copying a campaign. The leaderboard must be reconfigured.
On all new campaigns or campaigns that don’t already have a leaderboard, the feature must be configured via the new approach
You can CREATE max. 3 leaderboards with different conditions. You can INCLUDE the leaderboards as many times you want in a campaign.
Most of the configuration process remains the same, but this article will guide you on how to set up a leaderboard following the new approach.
With a leaderboard you can display a list of a campaigns best performing players. A player's rank, player alias and score will be displayed relative to others.
Why use a leaderboard?
A leaderboard can be an effective tool to:
encourage players to engage with your game (challenge them before they play)
encourage players to engage more than once (challenge them to get a better result)
increase awareness of your game (at an event or on your owned media channels)
A leaderboard ranking cannot be used to determine who should win a prize. Instead, think of the leaderboard as a way to increase the fun and competition in your campaign.
Game types that support leaderboard
Gametypes
The leaderboard is available on the following gametypes:
Drop game
Shoot it
Hit the Target
Snake
Quiz
Slice it
Bounce battle
Hit a mole
Tapping
Personality test
Sudoku
Video quiz
Flowpages and sections
You can add the leaderboard to any flow page or section. You can also add leaderboards to several flowpages, for example:
on the presentation page to encourage a player to start the game
on the winner page to show how a player has performed after they complete the game
Leaderboard examples
 |  |  |
Leaderboard settings:
| Leaderboard settings:
| Leaderboard settings:
|
How to add a leaderboard
In order to add a leaderboard to your campaign, the leaderboard must first be created in the backend settings and then you can add the leaderboard as an addon in the campaign builder.
Backend configuration
In order to add a leaderboard to your campaign, you must first configure the leaderboard in backend.
You can create maximum 3 leaderboards with different conditions, but you can add the leaderboards several times in the campaigns.
In the backend settings you control:
the conditions for entering the leaderboard
For example, a player must gain 100 points to get onto the leaderboard
what a player's rank is based on
fastest time, highest score, or (for quiz only) a combination of the two
whether the same player can earn more than one entry
In the below example, all players who gain 100 or more points will be entered into the leaderboard.
Important!
The 'player alias' is the player name displayed in the leaderboard. This is a required field, and you can use any field from the registration form.
If you are not collecting any unique user information, you need to allow multiple entries.
A a point-based game might not have any "winners", so it may not make sense to use this condition — read more here
Frontend configuration
In the campaign builder, you can add a leaderboard as an addon. When adding a leaderboard to your campaign, you will be able to select a leaderboard that you have configured in backend.
In the content tab, you can also control:
How many rows should be included in the leaderboard
How often the leaderboard should refresh
What the header labels should be called
How often should the leaderboard refresh?
Per default, the leaderboard will refresh when you refresh the page.
In the leaderboard settings, you have the option to decide how often the leaderboard should refresh. This could be relevant for example, if you are displaying it at an event or on the presentation page of the game. By enabling this setting you can decide how often the leaderboard should update automatically.
Customize the leaderboard's appearance
There are several ways to customize your leaderboard's appearance. For example, you can control:
if you want to include player badges
the look and feel of the leaderboard
if the leaderboard should be animated
Leaderboard design and styling
The leaderboard's basic design is set under the "Style" tab.
You can define the colors and fonts for the header and the different rows, including if the rows should have alternate colors and if the current player should be highlighted in a different color.
In the Content tab, you can:
add badges to show next to the 1st, 2nd, and 3rd place players as well as the current player
animate the points
animate the leaderboard rows
make the top 3 placements bigger
You can play with these settings in the editor and see your changes reflected immediately.
The width of the leaderboard is determined by the width of the section or page it is in. We recommend you set the width on the section or page rather than on the row, column, or addon. Read more about width here.
Player data in the leaderboard
Score display
To be displayed in the leaderboard, a player must:
complete the game
register with a unique identifier (typically email) and a name (or other public identifier)
meet the conditions you have set for entering the leaderboard
Score management
The entries in the leaderboard can be monitored and managed in backend under Advanced > Leaderboard:
A score can be deleted from this list so that it will not be shown in the campaign. You may want to delete a score for several reasons, for example:
inappropriate display name
suspicion of cheating
inadmissible player (e.g. employee or family member)
If the score has been posted to more than one leaderboard, you will have to remove the score in each leaderboard it appears. You can also delete the associated registration to remove all scores.
Registration data
The player's score in the leaderboard is linked to their registration. You can find the registration by clicking on the player's name.
If you delete a score from the leaderboard, it will not delete the associated registration.
If you delete a player's registration, it will also delete their score from the leaderboard. This process may take a moment, and you may have to refresh the page.
Player names
When setting up your leaderboard, you need to decide which field from the registration form should be used to identify players.
If your leaderboard is internal, you may choose to use the player's real name. However, if the leaderboard is public, it's best to allow players to define their own display name or player alias. This way, they can choose a name that doesn't reveal their real identity.
You can include an additional input field on your registration form, apart from the name field. This can be utilized as the display field in your leaderboard. This will help you collect the actual information of players for your database while allowing them to display a different name publicly.
Re-using a leaderboard
Reusing a leaderboard within the same campaign
If you want to use the same leaderboard several places in a campaign, you can easily copy a leaderboard. This way, the styling and configuration will be maintained.
Copying a campaign with a leaderboard
If you copy a campaign that contains a leaderboard, the leaderboard will only be included in the new campaign, if the new campaign type matches the original game type.
If you copy the campaign into a new gametype, the leaderboard will not be included, and you must then reconfigure the leaderboard.