Using the Event Engine

Learn how to use the event engine when creating a challenge, referral program, or message.

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

Gameball Events Engine helps you set the challenge of one or more events your player needs to complete. You can also add one or more rules per event with this engine.

The events engine is used in multiple cases like creating messages, referral program, or challenges program. You will need to use the event engine to set the events that a player needs to do to trigger a message or achieve any of the mentioned programs.

For additional information about events, see Understand your players' events, Manage your players' events.

Here are the key operators that you need to understand in order to effectively use the event engine:

Key Operator

For every chosen key in case of using the event rule, you will find multiple operators based on the data type which can be either numeric or string:

  • [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.

You will be using these key operators through 3 different places on Gameball's Dashboard:


Challenges mainly focus on how to reward your players when they take certain actions on your platform. Escpecially if you are creating a custom challenge from scratch.

Referral Program

The referral program motivates your players to spread the word about your platform so you can increase your acquisition and grow faster. when a player refers a friend, the friend has to first complete a specific action before you give rewards. Read more about referral Program.


You can trigger messages based on player action, for example, when a customer visits a certain page on your website, they will receive a message that pushes them to take further action. Read more about player messages.

Did this answer your question?