Ce document explique comment intégrer des succès à votre jeu à l'aide de la Google Play Console ou des appels d'API. Il couvre les éléments et états essentiels des succès, et explique comment les créer, les importer et les gérer.
Avant de commencer
Consultez les consignes Concevoir des succès de haute qualité.
Consultez la terminologie dans Principes de base des succès.
Créer ou importer des succès
Pour implémenter des succès à partir de zéro, procédez comme suit :
Ajouter des réussites
Il existe deux manières de créer des réussites pour la première fois dans la Google Play Console :
- Créer une réussite : ajoutez les définitions et les métadonnées d'une réussite après l'autre.
- Importer des réussites : importez les définitions et d'autres métadonnées de plusieurs réussites en une seule fois.
Créer un succès
Pour créer une réussite pour un nouveau jeu non publié, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Créer une réussite.
- Sur la page Ajouter des réussites, remplissez le formulaire.
- Cliquez sur Enregistrer comme brouillon.
- Une fois votre réussite créée, vous devez publier vos réussites.
Importer des réussites
Pour ajouter plusieurs réussites en même temps à votre jeu, procédez comme suit :
- Créez un fichier ZIP contenant vos réussites.
- Importez le fichier.
Pour en savoir plus sur le fichier ZIP, consultez les exigences concernant les fichiers ZIP.
Pour importer des réussites :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Importer des réussites.
- Sur la page Importer des réussites, cliquez sur Importer.
- Sélectionnez le fichier ZIP à importer.
- Cliquez sur Enregistrer comme brouillon.
- Une fois que vous avez importé des réussites, vous devez publier votre jeu.
Consignes concernant les fichiers ZIP
Vous pouvez importer plusieurs réussites à la fois à l'aide d'un fichier ZIP. Reportez-vous au tableau pour connaître les noms de fichiers exacts à utiliser dans votre fichier ZIP :
| Nom du fichier | Obligatoire ou facultatif | Valeurs acceptées |
|---|---|---|
AchievementsMetadata.csv
|
Obligatoire | Métadonnées de chaque réussite. Consultez la section Attributs. |
AchievementsLocalizations.csv
|
Facultatif | Fournit des traductions pour les noms et les descriptions des réussites. |
AchievementsIconMappings.csv
|
Facultatif | Fait correspondre les réussites à leurs fichiers d'icônes. |
| Fichiers d'icônes | Facultatif | Icônes au format PNG, JPEG ou JPG. |
Exigences concernant les fichiers ZIP :
- Aucun sous-répertoire.
- Noms de fichiers uniques.
- Fichiers au format CSV, PNG, JPEG ou JPG uniquement.
- Les fichiers CSV ne doivent pas comporter de ligne d'en-tête.
- La taille de chaque fichier doit être inférieure à 1 Mo.
- Le fichier ZIP ne doit pas contenir plus de 203 fichiers.
- La taille totale du fichier ZIP ne doit pas dépasser 200 Mo.
Format d'AchievementsMetadata.csv
Le fichier AchievementsMetadata.csv contient les métadonnées de chaque réussite. Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order
Ces champs sont décrits dans le tableau suivant :
| En-têtes des colonnes du fichier CSV | Obligatoire ou facultatif | Valeurs acceptées |
|---|---|---|
| Nom | Obligatoire | 100 caractères maximum |
| Description | Facultatif | 500 caractères maximum |
| Valeur incrémentielle | Facultatif | True ou False
|
| Étapes nécessaires | Obligatoire si Incremental Value est défini sur True.
|
Nombre (sans fraction ni décimale) |
| État initial | Obligatoire | Hidden ou Revealed
|
| Points | Obligatoire | Multiple de 5, compris entre 5 et 200 |
| Ordre dans la liste | Facultatif | Nombre (supérieur à zéro, sans fraction ni décimale) |
Exigences concernant le fichier AchievementsMetadata.csv :
- Chaque ligne doit comporter sept valeurs. Si vous souhaitez omettre une valeur, ne la renseignez pas.
- Les champs
NameetDescriptionsont utilisés comme paramètre régional par défaut. - Le champ
Namedoit être unique parmi toutes les réussites. - Les champs suivants ne doivent pas contenir de virgules :
NameetDescription.
Exemple de fichier AchievementsMetadata.csv :
Achievement1,Achievement One,True,100,Hidden,5,20 Achievement2,Achievement Two,False,,Revealed,10,30
Format d'AchievementsLocalizations.csv
Le fichier AchievementsLocalizations.csv est un fichier facultatif qui configure toutes les données nécessaires pour décrire chaque réussite aux utilisateurs dans différentes langues. Les réussites sont traduites en fonction des langues spécifiées pour le jeu.
Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Name, Localized name, Localized description, locale
Ces champs sont décrits dans le tableau suivant :
| En-têtes des colonnes du fichier CSV | Obligatoire ou facultatif | Description | Valeurs acceptées |
|---|---|---|---|
| Nom | Obligatoire | Doit correspondre à la colonne Name de AchievementsMetadata.csv.
|
100 caractères maximum |
| Nom localisé | Obligatoire | Nom localisé de la réussite. | 100 caractères maximum |
| Description localisée | Facultatif | Description localisée de la réussite dans le paramètre régional spécifié. | 500 caractères maximum |
| Paramètres régionaux | Obligatoire | Code des paramètres régionaux, par exemple en-US.
|
Ajoutez des traductions pour votre jeu avant de spécifier un paramètre régional. Notez que vous ne pouvez pas spécifier le paramètre régional par défaut.
Vous trouverez les codes des paramètres régionaux compatibles dans la liste des langues disponibles. |
Exigences concernant le fichier AchievementsLocalizations.csv :
- Les noms des réussites d'un jeu doivent être uniques au sein d'un même paramètre régional.
Si un jeu est compatible avec les paramètres régionaux en-US et fr-FR, une réussite nommée "Achievement1" pour en-US peut également être nommée "Achievement1" pour fr-FR.
- Chaque ligne doit comporter quatre valeurs. Si vous souhaitez omettre la valeur de la description localisée, ne la renseignez pas.
Exemple de fichier AchievementsLocalizations.csv :
Achievement1,Achievement One,This is the description of achievement one in English.,en-US Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR Achievement2,Achievement Two,Description of achievement two.,en-US Achievement2,Logro Dos,Descripción del logro dos.,es-ES Achievement3,Achievement Three,,en-US Achievement3,Erfolg Drei,,de-DE
Format d'AchievementsIconMappings.csv
Le fichier AchievementsIconMappings.csv est un fichier facultatif qui permet de faire correspondre vos réussites avec les icônes correspondantes. Il doit inclure les informations sous la forme de valeurs séparées par une virgule et dans l'ordre suivant :
Name, icon filename
Ces champs sont décrits dans le tableau suivant.
| En-têtes des colonnes du fichier CSV | Obligatoire ou facultatif | Description |
|---|---|---|
| Nom | Obligatoire | Doit correspondre à la colonne Name de AchievementsMetadata.csv.
|
| Nom de fichier de l'icône | Obligatoire | Nom de votre fichier d'icône. |
Exigences concernant le fichier AchievementsIconMappings.csv :
- Chaque ligne doit comporter deux valeurs.
- Les fichiers d'icônes peuvent être au format PNG ou JPEG.
Exemple de fichier AchievementsIconMappings.csv :
Valid Achievement,valid-achievement-icon.png Incremental Achievement,incremental-achievement-icon.jpeg No Description,no-description-icon.png Hidden Initial State,hidden-initial-state-icon.png Large Point Value,large-point-value-icon.jpeg
Directives concernant les icônes
Les icônes doivent être créées sous forme de fichiers PNG, JPEG ou JPG de 512 x 512 px. Il vous suffit de nous fournir l'icône de la réussite déverrouillée. Nous générerons automatiquement une version en nuances de gris pour l'icône révélée. C'est pourquoi nous vous recommandons d'inclure dans vos icônes des éléments de couleur, afin que vos utilisateurs puissent distinguer facilement les succès révélés des succès déverrouillés.
Lorsqu'une icône de succès s'affiche dans un [toast][a] Android, elle est recouverte d'un cercle, et ses coins extérieurs sont masqués. Veillez à ce que l'icône s'affiche toujours correctement dans ces circonstances.
Étant donné que la même icône est utilisée dans tous les paramètres régionaux, nous vous déconseillons d'y inclure du texte ou du contenu localisé.
Fichiers d'icônes
Les icônes que vous référencez dans le fichier AchievementsIconMappings.csv doivent exister dans l'archive ZIP actuelle que vous importez.
Mettre à jour des jeux avec des succès existants
Vous pouvez ajouter des succès à un jeu et modifier ceux qui existent déjà dans la Google Play Console.
Ajouter d'autres réussites
Si vous avez déjà des réussites et que vous souhaitez en ajouter :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Ajouter des réussites.
Modifier les réussites
Si vous avez déjà des réussites et que vous souhaitez les modifier :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez une réussite.
- Vous pouvez modifier n'importe quel champ.
- Cliquez sur Enregistrer comme brouillon.
- Sur la page Services de jeux Play - Réussites, la réussite modifiée est à l'état "Disponible pour les testeurs".
- Une fois le succès testé, cliquez sur Examiner et publier.
Votre jeu et toutes vos réussites mises à jour seront alors publiés à nouveau.
Supprimer un succès
Une fois votre succès publié, il ne peut pas être supprimé. Vous ne pouvez supprimer une réussite que si son état est "prépubliée".
- Sur la page Services de jeux Play - Réussites, sélectionnez une réussite.
- Pour supprimer le succès, cliquez sur Supprimer le succès.
Réinitialiser un succès
Vous ne pouvez réinitialiser les données de progression des joueurs que pour les succès à l'état de brouillon.
- Sur la page Services de jeux Play - Réussites, sélectionnez une réussite.
- Pour réinitialiser les succès, cliquez sur Réinitialiser la progression.
- Pour réinitialiser les données de succès de façon programmatique, appelez les méthodes
Achievementsde l'API Management.
Ajouter des traductions pour les succès
Vous pouvez spécifier vos propres traductions pour les succès associés à votre jeu. Avant de commencer, assurez-vous de suivre la procédure décrite dans la section Ajouter des traductions pour votre jeu.
Vous pouvez ajouter des traductions pour votre jeu de deux manières :
Vous pouvez utiliser l'option Importer des réussites pour importer les traductions de plusieurs nouvelles réussites à la fois. Vous ne pouvez pas utiliser cette option pour importer des traductions pour des réussites existantes.
Vous pouvez ajouter des traductions pour chaque réussite de votre jeu. Pour ajouter votre propre traduction pour chaque réussite :
- Dans la Google Play Console, ouvrez l'onglet Succès de votre jeu, puis sélectionnez un succès existant.
- Sur la page d'informations du succès, sélectionnez l'onglet d'une langue que vous avez précédemment ajoutée dans l'onglet Détails du jeu.
- Sur la page d'informations de la réussite pour cette langue, ajoutez vos traductions au formulaire.
- Cliquez sur Enregistrer pour enregistrer la traduction des informations concernant la réussite.
Implémentations client
Pour découvrir comment implémenter des succès pour votre plate-forme, consultez les ressources suivantes :
Tester les réussites
Pour vérifier que les succès fonctionnent comme prévu, suivez les étapes pour les tester :
- Configurez un canal de test interne.
- Ajoutez des comptes de test à votre projet de jeu pour les testeurs.
- Créez un profil Services de jeux Play pour l'un des comptes de test à l'aide de l'application Play Jeux.
- Ouvrez le jeu avec le même compte de test pour lequel vous avez créé le profil des services de jeux Play.
- Vérifiez que le message "Bienvenue" des services de jeux Play s'affiche à l'écran pour confirmer l'authentification automatique réussie au lancement du jeu.
- Jouez au jeu et suivez les étapes requises pour débloquer les succès.
Pour vérifier les réussites :
Vérifiez que la fenêtre pop-up "Réussite déverrouillée" s'affiche à l'écran lorsque la réussite est terminée.
Ouvrez l'application Play Store et vérifiez que la section des succès de l'onglet Vous affiche les succès terminés et en cours (avec des détails sur la progression).
Suivre les performances des succès dans la Play Console
Pour obtenir des statistiques rapides sur des réussites individuelles, procédez comme suit :
- Dans la Google Play Console.
- Accédez à Paramètres> Projets de jeu.
- Sélectionnez un jeu.
- Dans le menu de gauche, cliquez sur Réussites.
- Sur la page Réussites, vous trouverez des statistiques qui vous permettront de savoir si vos joueurs débloquent les réussites. Pour les utilisateurs dont les succès ne sont pas masqués, vous pouvez voir le pourcentage de ceux qui les débloquent. Pour les premiers niveaux de réussite, le pourcentage de déblocage est généralement plus proche de 100 %.
Vous pouvez également suivre les performances des séries temporelles des réussites sur la page Croissance > Services de jeux Play > Statistiques du jeu.
Publier les réussites
Une fois les tests terminés, vous devez publier votre jeu. Toutes les réussites associées à votre jeu sont publiées. La publication des succès est une étape obligatoire pour qu'ils fonctionnent correctement.
Pour publier votre édition, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- Sur la page Services de jeux Play - Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), cliquez sur Examiner et publier.
- Sur la page Services de jeux Play - Publication (Croissance > Services de jeux Play > Configuration et gestion > Publication), examinez les actions et corrigez les problèmes.
- Cliquez sur Publier.
Toutes les réussites de votre jeu sont publiées.
Erreurs courantes à éviter
Ces points mettent en évidence les erreurs courantes à éviter lors de l'implémentation de succès dans un jeu. Ils soulignent l'importance des éléments suivants :
Dans la Play Console, accédez à Croissance > Services de jeux Play > Configuration et gestion > Réussites.
- Avant de publier, vérifiez que les succès configurés dans la Play Console ne sont pas à l'état "Brouillon".
- N'ajoutez pas les valeurs d'ID de succès de la Play Console au code du jeu. Utilisez plutôt les implémentations clientes.
Assurez-vous d'avoir également implémenté la logique de déverrouillage sur votre client.
- Les joueurs ne peuvent pas ignorer l'étape de déclenchement où l'API de déverrouillage est appelée. Par exemple, terminer le tutoriel est un succès, mais les joueurs peuvent ignorer le tutoriel lui-même.