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

How to create an event challenge?

On your Gameball dashboard, go to Programs > Challenges. On the top right of the challenges program page, click Create a New Challenge, select type Event-based, then click Next.

Event Creation Elements


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


This is per event not per each key inside event rules. Set a frequency to define how many times this action should be completed by the player to accomplish this challenge.

Key Operator

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

  • [String] Equals

    The received data from the player for this key should equal a specific value (not case sensitive).

  • [String] Different Values

    This will allow you 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] Equals or Greater Than

    The received number from the player for this key should be greater than or equals to a specific value.

  • [Numeric] Equals

    The received data from the player for this key should equal a specific value in numbers.

  • [Numeric] Accumulative total:

    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.

  • [String] Includes

    Include will be triggered if the key-value contains the added rule value, the player's event should satisfy the included value. For example, if your rule is to reward players when they buy a certain type of product like "Summer shirts", "Summer accessories", you can just select all products that include the word “Christmas”.

  • [String] Repeated value

    When using this operator, you are prompted to enter a string value for the key selected then the number of repeated times at which this challenge is won. This challenge will be achieved only when the customer meets the configured criteria for the number of repeated times indicated.

    By default, each new rule is set to be won for 1 time until the user changes it. The repeated number of times can be within the same event or accumulative.

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

Adding Multiple Events

You can add more than one event to the same challenge by clicking on Add New Event. before configuring the new event, you will have to decide the type of relation between the new event with the previous one.

There are two types of relations:

  • And: When using AND relation between events, the player will have to complete every event to win the challenge.

  • OR: When using OR relation between events, the player will have to complete one of the configured events to win the challenge.

Note: The AND relation will be applied to any newly added events, which means that you can have for example 3 events, the first event will have to be completed by the players, while new events can have AND/OR relations.

Did this answer your question?