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.
If you want the challenge to be available and visible to only a certain group of people you choose based on any criteria, you can create a label to tag these people with, then you can configure challenges only for them. Read about Group your players by tags
Challenge Name: It is the internal name of the challenge, this name won't be displayed on Gameball player widget.
Examples: Referral badge for Q1 2019, Upselling placing fashion orders Jan 2019.. etc
Challenge Badge: This is the challenge image/badge that the player on Gameball player widget will see.
Displayed Name: the name of the challenge which will be displayed on Gameball player widget.
Examples: The Reviewer, The Shopaholic, The Networker.. etc
Displayed Description: the description of the challenge that will be displayed on Gameball player widget.
Define how you want to reward your player after achieving this challenge. You can reward your player with the below options:
Score (if you have chosen score as your leveling up method. Learn more)
Control how do you want to display the challenge inside Gameball Player Profile. You have 3 options:
Always Visible: The challenge will be always visible in the player profile before and after achieving it
Not Visible: The challenge won’t be visible in the player profile before and after achieving it
Visible If Achieved: The challenge will be visible in the player profile only after achieving it
Define how many times your player can achieve this challenge. Every challenge with these settings can have two options:
Unlimited: It can be achieved with unlimited times, with no capping
Limited: It can be achieved based on a predefined cap
Define the level your players should be on to have this challenge unlocked. Every challenge with these settings can have 2 options:
Always On: It will be available for all players at all levels
Based On Level: It will be available for all players on a specific level or higher
Choose if you want your players to get notified after achieving the challenge, or when they take an action (event) that takes them one step closer to completing the challenge. You choose from the following options:
Notifications on: Players will receive a notification after completing an event or challenge.
Notifications off: Players will not receive any notifications after completing an event or challenge.
Global settings: Notifications will be sent based on the predefined notification settings you configured on the notifications section. Read more about Sending real-time notifications for challenge and missions program.
Choose if you want your players to get a celebrative email after achieving the challenge. You can choose from the following options:
Emails on: Players will receive an email after completing the challenge.
Emails off: Players will not receive an email after completing an event or challenge.
Global settings: Emails will be sent based on the predefined email settings you configured on the notifications section. Read more about Sending Players Emails Celebrating Achievements.
When you switch the Use custom email toggle, you will be able to customize the email's content and design. To learn how to use our email, read about Email Components
Note: If you put the email settings to on, but did not customize an email for the challenge, Gameball will follow the pre-defined email settings in the notifications section.
After choosing tags for your players, naming the challenge, and assessing the settings, you must configure the event settings. Where it helps you choose a certain event, its frequency, and adding any rules if any.
❗️❗️ Important note: Before starting using the events engine, 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.
To specify and name the certain action that the player took, you will need to choose the event that took place like; viewing page, placing an order, scrolling down..etc.
After choosing an event to reward your players for doing, you will have to specify the frequency. Which is the number of times that action has to take place in order to gain the prize.
A rule is set to make things more specific and unique. This rule is relevant to the previously chosen event. For example; if you choose an event of "placing an order" the rules corresponding to it all will be only relevant to this event, like the category the item is from, or number of items in that order.
Next, you must select an operator like; equals, equals or greater than, or accumulative total. And finally, the chosen rule and operator have to be set to a certain value. Learn more about the event key operators.
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.
To learn more about how to use the events engine, read Guide to use the events engine.