Event Key Operators

Understand the meaning and function of each parameter you might need to apply while using our event engine.

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

Key Operators:

When creating an event rule using the event engine in our challenges program, referral program, or while creating a message, you will find multiple operators you can apply based on your goal.

  • [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 if Gameball received X number of different data of this key.
    Example: User-defined key: Category to receive three 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 equal 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 particular type of product like "Summer shirts," "Summer accessories," you can 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 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 one time until the user changes it. The repeated number of times can be within the same event or accumulative.

You can also create multiple events. These are the relations you can set between those various events:

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


Did this answer your question?