Overview

Your GameCircle configuration is a set of leaderboards, achievements, testing nicknames, and other GameCircle features. You create the configuration by linking your game to a security profile.

A security profile is a shared group that enables an application's variants (such as a paid and free version) to identify themselves to Amazon. Other mobile developer SDKs at Amazon, including Amazon Device Messaging, use the game's security profile for the same purpose.

After completing your GameCircle configuration, you can move on to Initializing GameCircle in Your Game, and then begin adding GameCircle leaderboards, achievements, and Whispersync for Games to your game.

Step 1. Create a Security Profile and Link it to
Your Game Configuration

A security profile is a shared group that enables each unique binary of a single application (for example, the HD, SD, free, and paid versions of a game) to have a unique API key that will identify the binary to Amazon.

The steps required to create a security profile and link it to your game configuration depend on your
prior activity, if any, in the Amazon Mobile App
Distribution portal. Follow the steps for the case below that describes your situation.

Case 1: I’ve got one or more games in the Mobile App Distribution portal

On the Mobile App Distribution portal, sign in and click the Apps & Services tab, and then click the GameCircle tab to open your Dashboard. If you already have GameCircle-enabled games, the Dashboard displays your games as security profiles.

Note: You must be signed in to the portal in order to use the Apps & Services tab.

Case 2: I’ve never created a security profile

On the Mobile App Distribution
portal, sign in and click the Apps & Services tab, and then click the
GameCircle tab. Finally, click Create a Security
Profile.

Note: You must be signed in to the portal in order to use the Apps & Services tab.

On the Security Profile Management page, enter a Security Profile Name and Security Profile Description. For Security Profile Name, enter the common title of your game (for example, enter Star Game rather than Star Game HD or Star Game Free). The purpose of the Security Profile Description field is to help you organize your security profiles. The description field is optional and may be left blank if you wish.

Click Save.

Click the GameCircle tab, which now displays a GameCircle configuration management page:

In the Game Configuration area, in the Select a Security Profile list, select the security profile that you just created and then click Confirm. This will create a new GameCircle configuration linked to this security profile.

Case 3: I’ve got a security profile for a game, but no GameCircle configuration

Take the Next Step: Initializing GameCircle in Your Game

After initializing GameCircle, you can start adding GameCircle leaderboards, achievements, and Whispersync for Games to your game.

Graphical Representation of Configuration

Here’s a graphical representation of how your GameCircle configuration, security profile and API key
work together:

Share a GameCircle configuration across multiple binaries

You can create multiple API keys within a single security profile, which enables you to share a
GameCircle configuration and the leaderboards and achievements associated with the security profile across
multiple versions of your game.

For example, we have a game named Star Game to which we want to add achievements and leaderboards.
The game has two versions, Star Game HD and Star Game Free, and we want them to share the same leaderboards
and achievements. We create a security profile called Star Game and then create two API Keys, one for Star
Game HD and one for Star Game Free, and embed them in the respective binaries. Finally, we link a game
configuration to the Star Game security profile, and can now create leaderboards and achievements that will
span both games.