Les succès peuvent être un excellent moyen d'augmenter l'engagement utilisateur au sein de votre jeu. Vous pouvez implémenter des succès dans votre jeu pour encourager les joueurs à tester des fonctionnalités qu'ils n'utiliseraient pas normalement ou à jouer à votre jeu d'une manière qui diffère de leurs habitudes. Les succès peuvent également être un moyen amusant pour les joueurs de comparer leurs progrès et de participer à des compétitions bon enfant.
Pour découvrir comment implémenter des succès pour votre plate-forme, consultez Implémentations client.
Attributs
Pour comprendre le fonctionnement des succès, vous devez connaître certains des attributs qui leur sont associés.
Ces éléments de base sont associés à chaque succès :
- id : une chaîne unique générée par la Google Play Console. Cet identifiant unique vous permettra de faire référence au succès dans les clients de votre jeu.
- Name : nom court donné au succès (par exemple, "Pieman"). Il peut compter jusqu'à 100 caractères.
- Description : brève description du succès. En général, cela indique à votre joueur comment obtenir le succès (par exemple, "Préparer une tarte au citron meringuée avant le coucher du soleil"). Elle peut compter jusqu'à 500 caractères.
- Icône : icône carrée associée à votre succès. Pour découvrir les bonnes pratiques à adopter lors de la création d'icônes de succès, consultez la section Consignes relatives aux icônes.
- List order : correspond à l'ordre d'affichage des succès verrouillés lorsqu'un joueur voit les succès associés à votre jeu. Vous pouvez les placer dans l'ordre de votre choix. Les succès déverrouillés apparaissent en haut de la liste, dans l'ordre dans lequel ils ont été déverrouillés.
État
Les succès peuvent être associés à l'un des trois états ci-dessous :
- Un succès hidden (masqué) signifie que le joueur ne peut pas voir les détails qui lui sont associés. Les services de jeux Play fournissent une description et une icône générique pour le succès lorsqu'il est masqué. Nous vous recommandons de masquer un succès s'il contient un spoiler que vous ne souhaitez pas dévoiler trop tôt à propos de votre jeu (par exemple, "Découvrez que vous avez toujours été un fantôme !").
- Un succès revealed (révélé) signifie que le joueur a pris connaissance du succès, mais qu'il ne l'a pas encore déverrouillé. La plupart des succès commencent à l'état "révélé".
- Un succès unlocked (déverrouillé) est un succès que le joueur a obtenu. Un succès peut être déverrouillé hors connexion. Lorsque le jeu arrive en ligne, il est synchronisé avec les services de jeux Play pour mettre à jour l'état du succès déverrouillé.
Succès progressifs
Les succès peuvent être standard ou incremental (progressifs). En règle générale, un succès progressif implique une progression graduelle du joueur vers l'obtention du succès sur une période plus étendue. Au fur et à mesure de l'avancement du joueur dans le processus d'obtention du succès progressif, vous pouvez signaler sa progression partielle aux services de jeux Play.
Le service Google Play effectue le suivi des informations de progression, avertit le jeu lorsque le joueur a rempli les critères nécessaires pour déverrouiller ce succès et indique au joueur dans quelle mesure il est proche d'atteindre cet objectif.
Les succès progressifs sont cumulables d'une session de jeu à une autre, et la progression ne peut pas être supprimée ni réinitialisée au sein du jeu. Par exemple, "Remporter 50 parties" est un succès progressif. "Remporter 3 parties d'affilée" n'en serait pas un, car la progression du joueur se réinitialise lorsqu'il perd une partie. "Obtenir 5 000 jetons de poker" n'en serait pas un non plus, car un joueur peut gagner ou perdre des jetons en cours de partie. Pour les deux derniers succès, c'est à vous de suivre l'état des "Parties remportées d'affilée" ou le nombre de jetons et de déverrouiller des succès standard lorsque le joueur les remporte.
Lorsque vous créez un succès progressif, vous devez définir le nombre total d'étapes requises pour le déverrouiller (il doit s'agir d'un nombre compris entre 2 et 10 000). Au fur et à mesure que l'utilisateur se rapproche du déverrouillage du succès, vous devez signaler le nombre d'étapes supplémentaires franchies par l'utilisateur aux services de jeux Play. Lorsque le nombre total d'étapes atteint la valeur de déverrouillage, le succès est déverrouillé (même s'il était masqué). Vous n'avez pas besoin d'enregistrer l'avancée progressive de l'utilisateur.
Points
Les succès sont associés à une valeur en points. Le score du joueur doit être un multiple de 5 et le jeu ne peut jamais avoir un total de plus de 1 000 points pour l'ensemble de ses succès (il peut toutefois en avoir moins). Par ailleurs, un succès ne peut pas offrir plus de 200 points.
Suivre les points d'expérience (XP)
Les joueurs peuvent gagner des niveaux dans leur profil de joueur lorsqu'ils obtiennent des succès dans les jeux compatibles avec Play Jeux. Pour chaque point associé à un succès, le joueur gagne 100 points d'expérience (XP) lorsqu'il l'obtient. Autrement dit :
XP for an achievement = 100 * (point value for the achievement)
Les services de jeux Play suivent les XP gagnés par chaque joueur et envoient une notification à l'application Google Play Jeux lorsque le joueur a gagné suffisamment de points pour passer au niveau supérieur. Les joueurs peuvent consulter leur niveau et leur historique d'XP depuis leur page de profil dans l'application Google Play Jeux.
Nombre minimal de succès
Un jeu qui intègre des succès doit avoir au moins cinq succès avant de pouvoir être publié. Vous pouvez effectuer un test avec moins de cinq succès, mais nous vous recommandons d'en avoir créé au moins cinq avant de publier votre jeu.
Nombre maximal de succès
Le nombre de succès est limité par le nombre et la distribution des points. Avec un nombre maximal de points de 1 000 et 5 points par succès, le nombre maximal de succès est de 200. Toutefois, si plus de points sont attribués à certains succès, le nombre de succès disponibles diminue en conséquence.
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 votre jeu.
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.
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.
Publier votre jeu
Une fois que vous avez testé et publié votre jeu, toutes les réussites associées sont publiées.
Modifier un succès
Pour modifier une réussite que vous avez déjà créée, sélectionnez-la dans l'onglet Réussites de la Google Play Console. À ce stade, le même formulaire que celui utilisé lors de la création de la réussite s'affiche. Vous pouvez modifier tous les champs que vous souhaitez.
Lorsque vous avez terminé de modifier un succès, cliquez sur le bouton Enregistrer comme brouillon. Le nouveau succès passera à l'étape "Prêt pour les tests", et vous pourrez le tester. S'il fonctionne correctement, sélectionnez Publier à nouveau dans la liste déroulante. Votre jeu et tous vos succès mis à jour seront alors publiés à nouveau et seront accessibles au public.
Annuler une modification
Si vous décidez que votre réussite actuelle ne vous convient pas et que vous souhaitez rétablir sa version précédente, sélectionnez Rétablir dans la liste déroulante de la Google Play Console. Toutes vos réussites reviendront à la version précédemment publiée.
Supprimer un succès
Une fois votre succès publié, il ne peut pas être supprimé.
Pour supprimer un succès dont l'état est prépublié, vous devez cliquer sur le bouton Supprimer situé au bas du formulaire correspondant.
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.
- Pour réinitialiser les succès dans la Google Play Console, cliquez sur le bouton Réinitialiser la progression des succès en bas du formulaire de cet événement.
- Pour réinitialiser les données de succès de façon programmatique, appelez les méthodes
Achievementsde l'API Management.
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 de ceux déverrouillés.
Lorsqu'une icône de succès s'affiche dans un toast 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.
La même icône étant utilisée pour tous les paramètres régionaux, nous vous déconseillons d'y inclure du texte ou du contenu localisé.
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
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. Pour en savoir plus, consultez les exigences concernant les icônes.
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 de la réussite, sélectionnez l'onglet d'une langue que vous avez précédemment ajoutée dans l'onglet Détails sur le 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 :