- Article
This topic describes how to configure rewards for a title-managed Xbox achievement. This includes granting the player gamerscore, art, or in-app rewards for completing the achievement.
Title-managed Achievements provides more flexibility than event-based Achievements to empower you to run the title as a service by adding value and maintaining player engagement over time.Title-managed Achievements also provides more flexibility of how achievements are unlocked, how and when achievements are added, and the benefits that achievements can deliver to players.
The following diagram illustrates how developers, community managers, and publishers might manage the life cycle of a title over time for goals, prizes, and rewards to drive player behavior.
Flexible options for rewarding achievement
We've expanded the achievement system to support more flexible reward options.Gamerscore remains a valuable reward that tracks a single, common gaming score for the player across the Xbox ecosystem. You—the developer or publisher—can use achievements as a delivery mechanism for a much wider range of rewards, both within your title and outside your title.
You can configure an achievement with multiple rewards, up to one reward of each reward type.You can also configure an achievement with no explicit reward; in such a case, the achievement's icon acts as a visual badge for the player who acquired the achievement.
Xbox services supports the following types of rewards.
- Gamerscore
- Art
- In-app
Gamerscore
We're committed to preserving the integrity of the gamerscore value that has been established with our Xbox players.There's only one gamerscore per player.Any gamerscore that a player earns on existing Xbox services platforms such as Xbox or Windows 10 counts toward a single gamerscore for that player.
When a player unlocks a gamerscore achievement, Xbox services automatically increases the player's gamerscore by the configured amount.
There are restrictions on which titles can offer gamerscore as a reward on their achievements.
Art rewards
Use the art reward to power lush, beautiful experiences in your titles and beyond that your players must earn. For example, you might have interesting concept art that your designers drew early in your title's inception phase; beautiful, high-resolution images that can decorate your hub application when players visit; and support for multiple skins.
You can offer high-resolution concept art, early design drawings, specially created art assets, and other digital art assets as a reward to players for unlocking an achievement.You can display these assets within the Xbox dashboard experience and in companion experiences by querying the Achievements service to retrieve the pertinent metadata.
In-app rewards
In-app rewards give developers much more flexibility and control over the rewards that an achievement offers.In-app rewards enable you to use achievements to deliver custom in-game rewards directly to your players without necessarily updating your title.
Configure the achievement reward with a code, ID, or phrase that your title recognizes. When the player unlocks the achievement, Xbox services sends that information to your title. This informs the title of the reward to deliver to the player.
The reward itself is up to the developer.Reward ideas include the following:
- Extra in-game currency or points
- Access to a special character, weapon, or map
- A temporary experience multiplier
Configuring in-app rewards
Configuring an in-app reward for an achievement is fairly straightforward.The achievement owner must provide a reward name, a reward description, and a reward icon in addition to a reward value.This reward value is determined by the developer and must be something that either the game can interpret and properly handle or the player can enter as part of a title-specific reward redemption experience.
An example of a reward value that the game can interpret might be a 5-digit number or a special string that the game or the game's service knows and maps to a particular in-game item.Developers might want to use the Title-Managed Storage (TMS) service to make it easy to add new reward values over time that the game can read.
An example of a reward value that the player must submit might be a special code or string that they enter into a redemption experience within the title, within a companion app, or on the developer's website.
Redeeming in-app rewards
An in-app reward takes effect when the player redeems the reward within the game.Titles must be aware that a player has unlocked an achievement that is configured with an in-app reward so that the title can properly deliver the reward to the player.To do this, titles should query the Achievements service when the title launches or resumes from suspension to see which unlocked achievements have in-app rewards and get the reward code for each reward. This should always be done to ensure that you catch any achievements that might have been unlocked while the title wasn't running or was running on another console.
To query, you can use either the XblAchievements* APIs or the RESTful Achievements URIs.
