All Collections
Levels Program
How Level Expiry works
How Level Expiry works

Understand how Gameball treats every level expiry process and case.

Rana ElGharib avatar
Written by Rana ElGharib
Updated over a week ago

When you create new levels, you get to assign special benefits and gifts for each level so that more loyal players get treated specially. However, if you want your players to keep trying to maintain the level they are on and always try to earn the privileges that come with each level, you might want to change your level expiry system.

❗️Note: The level expiry program is available on Pro and Guru plans only.

There are three options you can choose between:

  1. No Expiry: Once a player levels up, they will always stay on that new level, earn its privileges, and use its benefits until they move to a higher level.

  2. Based on the last 6 months: Gameball will check every player's activity during the past 6 months. If a player has earned enough points that makes them eligible to stay on the same level, they will not be placed on a lower level. But if a player has not been active and did not earn enough points to keep him on that level, they will level down to a lower level according to their progress during the last 6 months.

  3. Based on the last 12 months: Same as with the previous process. Gameball will check every player's activity during the past year and relocate players accordingly.

  4. Based on the last 24 months: Gameball will check every player's activity during the past 2 years and relocate players accordingly.

How to Assign an Expiry Date for All Levels?

1. Click the Edit Icon next to "Levels Settings"

2. Click Edit Icon under Level Expiry

3. Choose between the following 4 options for your level expiry system.

4. Click Save

Here are some questions and answers that elaborate on how the level expiry system works and how it affects the whole levels program.

What Happens When The User Changes The Level Expiry System?

  • From lifetime to 6 or 12 months system: Gameball checks each players’ progress during the past 6 or 12 months and resettles them based on their activity during these last months only.

  • From 6 or 12 months to lifetime system: Gameball will calculate where players should be if there was never an expiry system, checking each player's total score/points earned throughout their lifetime since they joined your platform and relocates them accordingly.

  • Changing level expiry from 6 months to 12 months: Gameball will re-check their activity during the past year and relocate players based on that time. (some players might level up)

  • Changing level expiry from 12 months to 6 months: Gameball will re-check their activity during the past 6 months only and relocate players based on that time. (more players will level down)

What Happens When Changing The Leveling up Method?

  • In case of 6 or 12 months expiry: Every time the user changes the leveling up method, Gameball goes through two steps:

  1. Calculating players’ levels based on the new method’s key value: Gameball will first calculate every player's level based on the new leveling-up method. For example, if the old leveling-up method was based on “Amount spent” and then was changed to be based on “points”, Gameball will check each player’s points and relocate them accordingly. However, this will not necessarily be the players’ final level, as it might change during the second step.

  2. Calculating each player’s level based on their activity during the last 6 or 12 months: After having known where every player should be based on the new leveling-up method, Gameball then calculates where they should be according to their last 6 or 12 months' activity. As per the last example, this means if a player has enough points to get them on level 3; however, during the last 6 months, their activity was not high enough to keep them on that level, they might be relocated to a lower level.

  • If however, a user changed the leveling-up method and the expiry plan on the same day, When changing the leveling-up method, some players will get relocated to different levels based on their newly calculated score value. Once they resettle, Gameball will start counting a new 6 or 12 months from the day the level expiry system has been changed.

  • In case of a lifetime: If the leveling expiry system was set to lifetime, and you only changed the leveling up method. Gameball will only calculate every player's level based on the new leveling-up method and will measure their progress from the day they joined your platform till today, In other words, Gameball will only apply the first step mentioned above.

What Happens When Changing The Level's Achievement Range?

  • If you changed the third level's range to be achieved by players who have points between 1000-2000 instead of 2000-3000. Players who have points between 1000-2000 will resettle to their new level, However, their expiry date will not be reset. Gameball will keep on counting their 6 or 12 months expiry from the day the level expiry system has been set or last changed.

What Happens When Adding or Removing Levels?

  • This case is similar to the previous case, “changing a level’s achievement range”. This means that even when some of the players jump from the level, they are on to a higher or a lower level. Gameball, however, will not reset the expiry dates and will keep on counting the 6 or 12 months expiry from the day the level expiry system has been set or last changed.

What Happens When You Manually Add a Player to a Level?

  • The date is reset for that player only, and Gameball starts counting the 6 or 12 months from the day the manual adding took place.

What Happens When Changing Plans from Pro or Guru?

  • When you downgrade from a Pro or Guru plan, you lose the option of setting a level expiry; hence, the level expiry system will change to a lifetime. As mentioned above, when the system changes from 6 or 12 months to a lifetime, Gameball calculates each player’s progress from the time they joined until the day of the downgrade and resettles them accordingly. This means that you may find that some players have been relocated to higher levels.

  • If you change the plan from Pro to Guru or vice versa, nothing will change as both plans support the level expiry feature.


Did this answer your question?