Manage GameOn Competitions

Use the GameOn Console to create and manage your GameOn competitions.

Login to the GameOn portal

Use your Amazon login credentials to log in to the GameOn Portal

Create a competition

General fields

  1. From the Your Competitions tab, select a game for the new competition.
  2. Select Single-player Competitions from the Competition Type drop-down menu.
  3. Click the Create Competition button.
  4. Enter data for the mandatory fields:
    • Competition Name - the name is visible to the players.
    • Start Date and End Date - times are displayed in local time zone.
  5. (Optional) In Leaderboard Rules, change the default scoring criteria:
    • By default, the highest score wins. For a game such as Golf, select Lowest score wins.
    • By default, in a game with multiple attempts, the best score wins. As an alternative, you can select Sum of all scores wins
  6. (Optional) In Countries, you can limit the geographical reach of your competition.
    • By default, your competition is available world-wide.
    • If you click Targeted Countries/Regions, you can select multiple countries and/or marketplaces for your competition. For details, see Country Restrictions.

Add prize bundles to the competition

After you use the GameOn Console or the Admin API to create prizes, use the GameOn Console to add prize bundles to the competition.

A prize bundle specifies the rank (or range of ranks) of the players that are eligible to win this prize bundle. The prize bundle also defines the prize or prizes that the eligible players will win.

To create a prize bundle, enter the following fields:

  • Rank From - the highest rank in the leaderboard that is eligible for this prize bundle
  • Rank To - the lowest rank in the leaderboard that is eligible
  • Bundle Title - enter a title for this prize bundle.
  • Prize Type - select In-App Prizes or Real-World Prizes
  • Prizes - select one or more of the prizes from the list, and click Add Prize.
Add prizes

Note: You can add a Real World Prize to the competition only if it expires at least 2 days after the competition ends.

The GameOn Console displays a list of prize bundles below the Add Prize form. Optionally, you can add an image URL or a description for each prize bundle. These fields are included in the prize information that the Game API sends to the game.

Advanced Options

Note: Some configuration options are currently not available in the GameOn Console. For example, you need to use the Admin API to define Requirement Groups. After that, you can use the GameOn Console to filter the competition player lists using Requirement Groups.

Enter additional information about the competition.

  1. In the Advanced options panel, expand Additional information.
  2. Enter text for the following fields as desired. These fields are sent to the game in the response to the Get Tournament Details API call:
    • Subtitle: Subtitle for the competition.
    • Description: Description of the competition.
    • Image URL: URL for an icon or image that the game will display.
    • Metadata: Additional text, such as rules or disclaimers.

Filter Competition Players

Use the Admin API to define Requirement Groups. After that, your requirement groups will be available in the GameOn Console. Use your groups to filter the players that can enter (and/or view) your competition.

Customize the players who can enter the competition

Create a requirement group to define the players who can enter:

  1. In the Advanced options panel, expand Customizations.
  2. Select Custom in the Entry Requirements drop-down list. The Add Group button becomes visible.
  3. Click Add Group. The system opens a pop-up form.
    • Choose one of the Preset GPS locations from the Geographic Parameters list.
    • Choose one or more of the Preset custom parameters from the Custom Parameters list.
  4. Click Save.

Customize the players who can see the competition

To choose the same Requirements Group as the players who can enter the competition, select Same as entry in the drop-down list.

You can create a different requirement group to filter the players who can see the competition. Use the same steps 1-4 above to define a requirement group.

Other advanced options

  1. In the Advanced options panel, expand Customizations.
  2. Change the following selections as desired:
    • Maximum players - maximum number of players that can enter the competition.
    • Maximum attempts per player - maximum number of game attempts per player.
    • Number of Leaderboards - The default is one leaderboard. You can create up to 50 leaderboards, each with a maximum of 50 players.
    • Password Protected - By default, the competition is open to all players. You can create a password to restrict entry to the competition.
    • Prize Release - By default, prizes are released automatically at the end of the competition. If you set the prize release to manually, you need to release the prizes explicitly from the Leaderboard page of the GameOn Console. This option allows you to review the leaderboard before releasing prizes.

Create a series of competitions

  1. Create a competition, using the steps described above.
  2. In the Advanced options panel, expand Customizations.
  3. Under the Recurrence heading, click the pencil icon.
  4. In the pop-up form:
    • Select whether to repeat the competition daily or weekly
    • For weekly, select one or more days of the week to hold the competition
    • Enter an end date, or the maximum number of occurrences for the recurring competition.

List the competitions for a game

  1. From the Your Competitions tab, select a game from the drop-down list.
  2. If required, select Single-player Competitions from the type of competition drop-down menu.

View team competition details

  1. Select a competition to view the competition leaderboard.
  2. In the left menu, click Competition Details to view other information about the competition.