Skip to main content

Managing user achievements from Admin Portal

Last updated on February 12, 2024

Overview

AccelByte Gaming Services (AGS) allow you to browse and manage user achievements data from the AGS Admin Portal. Managing user achievements data is essential for maintaining accurate and up to date information. Here are some common reasons for these actions:

  • Development phase: If you need to manually lock and unlock your testing user achievement data during integration/development phase
  • Error correction: If there is a technical glitch in the game that prevents the player from unlocking the achievement and you need to manually correct the issue
  • Community engagement: If you need to manually recognize outstanding contributions from your players by giving an achievement

In this guide, you will learn how to browse and manage user achievements data from the Admin Portal.

Goals

This guide will show:

  • how to browse user achievement data
  • how to lock and unlock user achievements

Prerequisites

You must have:

  • access to the AccelByte Admin Portal
  • access to AccelByte Achievement API documentation

Browsing user achievement from Admin Portal

You can browse the list of achievements for a specific user by following the steps below:

  1. Log in to the Admin Portal.

  2. Go to the Game Management section and select Achievements Value under the Achievements menu.

    AGS Admin Portal click Achievement Menu

  3. In the Achievements Value window, under the Search Player section, use Search to find the user you want. You have two options:

    • Email, Display name or Username

      1. Input a keyword. The list of users is displayed.

        AGS Admin Portal Search Player by Email, Display name or Username

      2. Select the user you want to see the achievements they own by clicking on the User ID. The list of achievements for the player is displayed in the Player Achievements page.

        AGS Admin Portal Player Achievement list

    • User ID Input a valid User ID. The list of achievements for the player is displayed in the Player Achievements page.

Unlock a user achievement from the Admin Portal

You can manually add achievement with an unlocked status to a specific user from the Admin Portal by following the steps below:

  1. Search the user for which you want to add an achievement from the Achievements Value page.

  2. In the Player Achievements list, click Add Achievement to add the achievement to the user. The Add Achievement modal is displayed.

    AGS Admin Portal Add Player Achievement

  3. In the Add Achievement modal, input the Achievement Code you want to add.

    note

    The Achievement Configuration that can be added to the user from the Admin Portal is a non-incremental achievement, and does not rely on the player's statistic values.

  4. Click Search after you input the Achievement Code. The Achievement Configuration summary is displayed.

    AGS Admin Portal Add Player Achievement

  5. Click Add to continue. The achievement will be added to the user achievements list.

Lock a user achievement from the Admin Portal

You can manually remove or change the status of an unlocked achievement to locked from the Admin Portal by following the steps below.

  1. Search the user for which you want to add the achievement from the Achievements Value page.

  2. In the Player Achievements list, select the achievement you want to remove or lock from the list by clicking Lock under Action. A confirmation message is displayed.

    AGS Admin Portal Player Achievement Unlocked

  3. Click Lock to continue.

    AGS Admin Portal Lock Player Achievement

    The achievement will no longer be available on the list.