Skip to main content

Introduction to Challenge

Last updated on March 5, 2024


The AccelByte Gaming Services (AGS) Challenge service elevates the gaming experience for your players across various genres by enabling you to create and tailor challenges based on your game's immersive story or strategic gameplay. The Challenge services enables you to provide your players a set of objectives for them to achieve, which enhances player retention. You can also use challenges to drive revenue opportunities for your platform or game.

This article provides a high-level summary of how the service works and a deep dive into the key concepts of the Challenge service.

How it works

You can create challenges in your publisher and game namespace. When you create a challenge, you must also create its goals for it. Each goal can have its own active period within the active period of the challenge. Each goal that you create must contain requirements and rewards. Requirements may be tasks or activities that players must meet or complete in order to accomplish the goal to which it belongs. Requirements may vary from players unlocking achievements in-game to linking or upgrading their accounts in your platform. You can rotate the active period of goals as needed and assign them to players manually or rely on the Challenge service to assign them randomly. When a player accomplishes all the requirements in a goal, they will be rewarded with entitlements or statistics that you defined for the goal.

Key concepts

This section contains a deeper dive into the concepts and use cases of the Challenge service.

Challenge basic information

You must provide the following basic information when creating or configuring a challenge.

  • Challenge name: UI-friendly name of the challenge, which is visible to your players in-game. For example:

    • Winter Challenge
    • Sunrise Sign-in
    • Daily Missions
  • Challenge description: (optional) provides more information or describes a challenge. For example:

    • Log in every day to unlock exclusive rewards.
    • Embrace the chill with winter weekly missions! Only this winter!
  • Challenge code: unique human-readable identifier that your developers can use to retrieve a specific challenge from the game. For example:

    • winterchallenge
    • sunrisesignin

Challenge period

You can set the period of the challenge that you configure. There are two options that you can choose for the challenge period.

  • Time-based: you can schedule the challenge to only be active in a specific period of time. This restricts players to only make progress, complete challenge goals, and claim rewards within the specified time frame. For example:

    • Winter Challenge starts on December 24, 2023 at 12:00 A.M. UTC and ends on February 28, 2024 at 12:00 A.M. UTC.
    • Sunrise Sign-in Challenge starts on March 1, 2023 and ends on Dec 31, 2023
  • Always active: the challenge will run without ending or will always be available in your game, unless you disable or delete it. This allows players can make progress, complete challenge goals, and claim rewards at any time.

Goals rotation

You can set specific rotation rules for each goal in a challenge as follows:

  • Rotation type

    • With rotation: goals will be rotated based on your specified rotation. The available options are Daily, Weekly, Monthly, and Custom number of days. For example, a daily rotation sets your goals to be rotated everyday, which means that in the following day, your players will have new goals to complete. Players are encouraged or required to complete it within a 24-hour period. After that, the goals will be reset or replaced with other goals.
    • None: the challenge goals are fixed and can be completed by players at any time within the challenge's active period.
  • Rotation repetition: you can configure the repetition of the rotation, allowing you to repeat the same cycle again after a period of time. This is applicable to the following sample scenarios:

    • As a game developer, I want to have a daily mission, in which each day of the week, the players will have different goals to complete, and the goals cycle will reset to the beginning after a week.
    • As a game developer, I want to have a Seasonal Challenge with a fixed weekly schedule that will be looped every month.

Goals assignment

Assignment rules only apply to goals that are in a challenge with rotation (see Goals rotation). With this option, you have to set the assignment period of goals when you create or edit them. You can set the assignment of your goals as follows:

  • Fixed assignment: you need to manually select which goals to assign to players in each rotation period or cycle. For example:

    • Daily login: a fixed goal that runs for seven days which is looped every week.
  • Randomized assignment: you will rely on the Challenge service to randomly select which goals to assign to players in each rotation period of rotation or cycle. With this option, you will only need to add the goals into the challenge. Sample scenarios:

    • You've created 33 goals in a challenge and you want the Challenge service to randomly select three goals to assign to players each week.
    • You've created 100 goals in a challenge and you want the Challenge service to randomly select two goals to assign to players each day.

Goals and rewards

Goals are tasks or activities that players are expected to accomplish in order to claim the associated reward. You can add multiple goals in a single challenge and assign to a specific time period or rotation only if you configure a challenge with rotation. When creating goals, you have to set the following:

  • Requirements: each goal configuration will have requirements for the player to complete. Requirements will use player attributes or actions for the data that will be compared with the target value that is set. The Challenge service supports various conditions such as player attributes (user statistics value, achievement, etc.) or player action (player login activity, purchase activity, player publish UGC, etc). For example:

    • Kill 10 enemies.
    • Get three headshots and two assist.
    • Kill seven monsters or destroy three towers.
    • Log in at least once a day.

    For a full list of the available requirements that you can use in AGS, see Supported requirements for challenge goals.

  • Rewards: each goal configuration must also have at least one reward associated with it, which can be entitlements or statistics. Once a player completes the goal, they can obtain the associated reward. For example:

    • Two Purple Berry and 250 XP
    • One Wizard Mushroom
    • Five Iron Ore and Three Steel

What's next?

Learn how to create and configure challenges in the AGS Admin Portal. See Create and configure challenges.