Create and Configure Player Custom Challenges

Learn how to customize and create your own challenge from scratch.

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

Table of Contents


Challenges are the core of Gameball gamified experience which you can integrate on your platform. You can easily create challenges from Gameball challenges library so that it is seen and achieved by your customers.

You can access the challenges section of your Gameplan experience in the Gameball dashboard through Ways to Earn > Add ways to earn

When you click Add ways to earn, you will be taken to the Challenges Cataloge page, where you can create any type of challenges using the existing templates.

If, however, you can not find the type of challenge from the challenge cataloged, you can always customize your own challenge according to your preference.

How to create custom challenge

After landing on the Challenge Cataloge page, click Create custom challenge.

Below a brief about challenge configuration attributes. Not all the below attributes are valid for all challenge types, so based on the chosen challenge type, attributes will be different. Follow these steps to configure a challenge:

Challenge internal name

This name will not be shown to players. Type down a name so you can distinguish this challenge from other configured challenges on the dashboard.

Now, you can start with the main challenge details.

A. Details

  • Challenge Name: it is the external name of the challenge. This name will be displayed to Gameball players through the widget or notifications.
    Examples: The Reviewer, The Achiever, etc.

  • Challenge Description: write down a brief description about what this challenge is about and how it could be achieved.

  • Challenge Icon: this is the challenge image/badge which will be seen by the player on Gameball player widget.

    choose between:

    • From Library: Gameball library of icons.

    • Upload Image: upload a customized image.

  • Add a redirection link: add a link to the landing page a player will be redirected to when clicking on the challenge from through the Gameball widget.

B. Trigger

You will need to configure the rule that grants a player the challenge reward once achieved. Learn more

Use Gameball's event-based engine to create a sequence of rules a player has to follow in order to win the challenge's reward. Learn how to use Gameball's Event engine.

C. Reward

Define the type and value of your player's reward if they achieved the challenge. Click Add Reward.

You will go to the player reward configuration page.

  • In order to choose the type of reward you want to give to players, use the drop down list under Reward Type.

  • Under Reward Type, choose one of the following reward types:

    • Points

    • Free Product

    • Free Shipping

    • Fixed Amount

    • Percentage Based Discount

  • After choosing the reward type, write down the value of the player's reward under Reward Value.

The following is a list of information you will need to fill when choosing each of the reward types:

  • Product name: type down the name of the free product that will be given to the player. this name will be seen by players.

  • Reward Value: type down the value of the reward you want to grant to players.

  • Reward Expiry (optional): decide if you want to put an expiry date so that players redeem the reward before that day.

  • Minimum Order Value Required (optional): decide if the player should Redeem this (already won reward) only if the order value they want to redeem it with exceed a certain amount.

    For example: this reward will be redeem with an order that exceeds 50 USD.

  • Maximum Reward Usage: decide how many times this reward could be used (redeemed). By default, Gameball allows the players to redeem a gift only one time. However, you can let the reward be redeemable multiple times.

  • Coupon Combination: allow the reward to be redeemed along with other types of coupons. By default, Gameball does not allow the redemption of multiple coupons at once.

  • Applies to: applicable only for the fixed amount coupon and the percentage-based discount. Choose if the coupon can be applied on specific collections only.

  • After being done with creating the players' reward, click Save.

D. Eligible Customers

If you want the challenge to be available and visible to only a 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

E. Advanced Settings

By clicking the Edit Icon under Advanced Settings, you can configure the following:

1. General Settings

Activation

Define when should this challenge will be active. Every challenge with these settings can have 2 options:

  • Always Active: The challenge will always be active

  • Specific Time: The challenge will have a start and end date for when the challenge will be automatically activated

Challenge Visibility

Control how do you want to display the challenge inside Gameball Player Profile. You have 3 options:

  • Always Visible: The challenge will always be visible in the player profile before and after achieving it

  • Not Visible: The challenge will not 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

Repeatability

Define how many times your player can achieve this challenge. Every challenge with these settings can have three options:

  • Unlimited: It can be achieved with unlimited times, with no capping.

  • Limited: It can be achieved based on a predefined cap.

  • Add limit per player: Limit the number of times for which a player can win this challenge within a time interval.

Unlocking

Define the level your players should be on to have this challenge unlocked. Every challenge with these settings can have 3 options:

  • All levels: It will be available for all players at all levels

  • Starting from level: It will be available for all players on a specific level or higher

  • Locked on level: It will be available for all players on a specific level only

2. In-app Notifications

Achievement Notification

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 can 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 program

Event Notification

Exists with event-based and high-score challenges only. Choose whether to notify players after every completed action that leads one step closer to achieving the challenge.

3. Email Notifications

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 at the notifications section.

You can send a test email to an email address you use before applying and deploying a challenge.

Once you are done with configuring the entire challenge, click Apply.

You will then be able to see the newly configured challenge on the main Ways to Earn page.


What else?

Did this answer your question?