1. Documentation
  2. Leaderboards
  3. How users are ranked on a leaderboard

How users are ranked on a leaderboard

As described on the Configuring a leaderboard page, you can set any points type, achievement type or rank type as metrics to track.

But how users will be ranked based on this different types? A quick explaination is:

For achievement types, the metric tracked is the number of achievements earned of this type.
For points types, the metric tracked is the current balance of points of this type.
For rank types, the metric tracked is the priority value of current rank of this type earned.

Let’s to see a example leaderboard with achievements, points and ranks as metrics:

On this leaderboard users are ranked by the number of Quests (achievement type) they earned, their current Credits (points type) balance and their current Grade (rank type) priority.

To meet the rank priorities, there is a quick explanation of our Grade priority setup:

Grade S – Priority 3
Grade A – Priority 2
Grade B – Priority 1
Grade C – Priority 0

Let’s to see how internally Leaderboards add-on ranks this users:

1 – GamiPress has earned 32 quests, has 500 credits and is on grade S -> 32 + 500 + 3 (rank priority) = 535
2 – Ruben has earned 12 quests, has 400 credits and is on grade A -> 12 + 500 + 2 = 514
3 – Anthony has earned 5 quests, has 300 credits and is on grade A -> 5 + 300 + 2 = 307
4 – Irene has earned 7 quests, has 200 credits and is on grade B -> 7 + 200 + 1 = 208
5 – Jhon has earned 7 quests, has 200 credits and is on grade C -> 7 + 200 + 0 = 207

The rank priority could be decisive to determine the user position, look at lowest positions where 2 users has got the same number of achievements and points but one of them got a higher rank.

Playing with the rank priority

In the above example you saw how the rank priority can affect to users positions, but you can make a rank be more decisive with the priority field.

Previously you see that grades are differentiated by 1 (1,2,3, etc) so users on a higher rank just sum 1 internally. But if you define your ranks with a differentiation of 100 like:

Grade S – Priority 300
Grade A – Priority 200
Grade B – Priority 100
Grade C – Priority 0

With a setup like that, an user with lower quests earned and points could reach a higher position thanks to his rank priority:

1 – User 1 has 10 quest, has 100 credits and is on grade S (300) -> 10 + 100 + 300 = 410
1 – User 2 has 20 quest, has 200 credits and is on grade B (100) -> 20 + 200 + 100 = 320

Was this article helpful to you? Yes No

How can we help?