While creating a challenge with type Based on Event(s) (see Gameball Challenges Library), you will use Gameball Events Engine which will allow you to define one or multiple events to be completed by your player to achieve the challenge. Also, the engine will allow you to add one or multiple rules per event.

Before continuing this article, read more about Player Events through Understand your players' events

Event Creation Elements


This is per event not per each key inside event metadata. The frequency to define how many time this event should be completed by the player to accomplish this challenge


The events list should be added by the user through the Events Settings of the Gameball dashboard, then while adding the challenge based on events, you will find all events listed.

Key Operator

For every chosen key in case of using metadata of an event, you will find multiple operators based on the data type:

  • [String] Equals to the received data from the player for this key should equal to a specific value (not cases sensitive)
  • [String] Different Values: This will allow the user to configure the event to be completed in case Gameball received X number of different data of this key
    Example: User-defined key: Category to receive 3 different values, the player will complete this event if Gameball received Fashion, Electronics, and Accessories
  • [Numeric] Greater Than or Equals: The received number from the player for this key should be greater than or equals to a specific value
  • [Numeric] Accumulative to the player should reach a predefined number in one or multiple events for this key and Gameball will store the received numbers till reaching the predefined number

Event Time Limit

After defining the events of a challenge, you will be able to add a time limit the events should happen within the time limit, otherwise the system will ignore old records based on the time limit.

Important Note!

Before starting using events, you must configure the events you will send on the Gameball dashboard, read this article for more information on how to configure events, Manage your players' events

Did this answer your question?