App Store Connect Help
Add an app to a group
After you create a group, you can add other apps to the group. The purpose of adding an app is to share leaderboard and achievement data. When you add an app with existing Game Center assets to a group, you decide which of the app’s leaderboards and achievements are retained as part of the group.
If an app has existing leaderboards and achievements, you must decide whether to add or merge the app’s components with those in the group. Added leaderboards and achievements are defined in the group as they were in the app prior to being grouped. Merging your leaderboards and achievements will replace the version in the app with the one you choose from the group. App Store Connect simplifies this process by presenting only compatible assets and available options at each step. The options that App Store Connect presents to you are dependent on your app and group data. Types of assets (for example, leaderboard sets) that the app doesn’t have won't display.
Important: If the group uses leaderboard sets, the app you add to the group must use leaderboard sets. Learn how to configure leaderboard sets. Additionally, apps can only belong to one Game Center group. If you wish to add your app to a new group, it must be removed from any existing groups.
Guidelines for Moving Leaderboards
The choices available when merging leaderboards depend on the type of leaderboard, its property values, and your previous selections. The guidelines for merging leaderboards are:
-
Leaderboards can only merge with a compatible leaderboard. Leaderboards are compatible if the values of the score format type and sort order properties are the same.
-
Leaderboards must be moved in the order App Store Connect presents them.
-
A combined leaderboard can only merge with a combined leaderboard. If a compatible combined leaderboard isn’t available, it must be added to the group instead of merged.
-
An attached leaderboard can merge with an attached leaderboard only if their combined (parent) leaderboards are also being merged with each other.
-
An attached leaderboard can merge with a classic leaderboard. The classic leaderboard is attached to the corresponding group combined leaderboard.
-
A classic leaderboard can merge with a classic leaderboard.
-
A classic leaderboard can merge with an attached leaderboard.
After merging two leaderboards, all of the group’s leaderboard property values remain the same with the exception of these properties:
-
Score Range: If the app’s score range is larger than the group’s score range, the group’s score range expands to include the app’s score range. For example, if the range of the app’s leaderboard is 1–500 and the range of the group’s leaderboard is 1–250, the range of the group’s leaderboard is set to 1–500.
-
Languages: When merging a leaderboard that has more languages than a group, the additional leaderboard languages will be automatically applied to the merged leaderboard. For example, if a grouped leaderboard supports English and the leaderboard being merged supports English and French, the French language will be copied over to the merged leaderboard.
Guidelines for Moving Achievements
There are no restrictions for adding achievements to a group; however, the following remain true:
-
The maximum number of points for each achievement is 100.
-
The total maximum number of points for a single app's achievements is 1000.
-
There are no restrictions on the total points for all group achievements.
After the merge, all of the group’s achievement property values remain the same with the exception of the languages, which follow this rule:
-
When merging an achievement that has more languages than a group, the additional achievement languages will be automatically applied to the merged achievement. For example, if a grouped achievement supports English and the achievement being merged supports English and French, the French language will be copied over to the merged achievement.
Required role: Account Holder, Admin, App Manager, Developer, or Marketing. View role permissions.