Fonctionnalités des services de jeux Google Play

Les services de jeux Google Play vous permettent d'ajouter des fonctionnalités multijoueurs et de réseaux sociaux attrayantes à vos jeux.

Sélectionnez une fonctionnalité ci-dessous pour en connaître les bases et consulter la documentation relative à la mise en œuvre des services de jeux Google Play.

Premiers pas

Intégrer le SDK des services de jeux Google Play

Pour savoir comment intégrer le SDK des services de jeux Google Play et obtenir des instructions ainsi que des exemples qui vous aideront à vous lancer, consultez le site Google Developers.

Créer une fiche de jeu

Pour utiliser les services de jeux Google Play, vous devez créer une fiche de jeu dans la Play Console. Votre fiche de jeu est différente de la fiche Play Store de votre application.

Pour ajouter une fiche de jeu :

1. Ouvrez la Google Play Console.
2. Accédez à Configuration > Projets de jeu.
3. En haut à droite, cliquez sur Ajouter un jeu.

Fonctionnalités

Réussites

Avec les réussites, vous pouvez contribuer à fidéliser les joueurs en leur attribuant des récompenses lorsqu'ils atteignent des objectifs fixés dans votre jeu. Les joueurs peuvent obtenir des points d'expérience (XP) lorsqu'ils remportent des réussites dans votre jeu.

Consultez le site Google Developers pour en savoir plus sur les réussites.

Remarque : Une fois publiées, les réussites ne peuvent pas être supprimées.

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.

Remarque : Utilisez des API pour débloquer des réussites pour le joueur connecté. Cela révèlera les réussites cachées au joueur, le cas échéant.

Créer une réussite

Pour créer une réussite pour un nouveau jeu non publié, procédez comme suit dans la Google Play Console :

1. Dans la Google Play Console, sélectionnez un jeu.
2. 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.
3. Sur la page Ajouter des réussites, remplissez le formulaire.
4. 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 :

1. Dans la Google Play Console, sélectionnez un jeu.

2. Sur la page Services de jeux Play - page 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 :

1. Créez un fichier ZIP contenant vos réussites.

1. 1 Importez le fichier.

Pour en savoir plus sur le fichier ZIP, consultez les exigences concernant les fichiers ZIP.

Pour importer des réussites :

1. Dans la Google Play Console, sélectionnez un jeu.
2. Sur la page Services de jeux Play - page Réussites (Croissance > Services de jeux Play > Configuration et gestion > Réussites), sélectionnez Importer des réussites.
3. Sur la page Importer des réussites, cliquez sur Importer.
4. Sélectionnez le fichier ZIP à importer.
5. Cliquez sur Enregistrer comme brouillon.
6. 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 une réussite

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 une réussite, cliquez sur le bouton Enregistrer comme brouillon. La réussite mise à jour passera à l'étape "Prête pour les tests", et vous pourrez la tester. Si elle fonctionne correctement, sélectionnez Publier à nouveau dans la liste déroulante. Votre jeu et toutes vos réussites mises à jour seront alors publiés à nouveau et accessibles au public.

Remarque : Une fois qu'une réussite est publiée, son état initial (masquée ou révélée) et son type (progressif ou standard) sont fixes et ne peuvent pas être modifiés.

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 une réussite

Une fois votre réussite publiée, elle ne peut pas être supprimée.

Pour supprimer une réussite dont l'état est "prépubliée", vous devez cliquer sur le bouton Supprimer situé au bas du formulaire correspondant.

Réinitialiser une réussite

Vous ne pouvez réinitialiser les données de progression des joueurs que pour les réussites à l'état de brouillon.

• Pour réinitialiser les réussites dans la Google Play Console, cliquez sur le bouton Réinitialiser la progression des réussites en bas du formulaire de cet événement.
• Pour réinitialiser les données de réussites de façon programmatique, appelez les méthodes de l'API Management qui concernent les réussites.

Exigences 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 ensuite 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 réussites révélées de celles déverrouillées.

Lorsqu'une icône de réussite 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.

Exemple d'icône de réussite.

Étant donné que la même icône est utilisée pour tous les paramètres régionaux, nous vous déconseillons d'y inclure du texte ou du contenu localisé.

Exigences 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 de fichier	Obligatoire ou facultatif	Valeurs acceptées
AchievementsMetadata.csv	Obligatoire	Métadonnées de chaque réussite. Voir 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.
• Le fichier CSV ne doit pas comporter de ligne d'en-tête.
• La taille de chaque fichier doit être inférieure à 1 Mo.
• Le nombre total de fichiers ne doit pas dépasser 203.
• 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 la valeur "Valeur incrémentielle" est définie sur "True".	Nombre (sans fraction ni décimale)
État initial	Obligatoire	Masquée ou révélée
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 "Nom" et "Description" sont utilisés comme paramètre régional par défaut.
• Le champ "Nom" doit être unique parmi toutes les réussites.
• Les champs suivants ne doivent pas contenir de virgules : "Nom" et "Description".

Exemple de fichier AchievementsMetadata.csv :

Achievement1,,True,100,Hidden,5,20

Achievement2,,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 "Nom" du fichier 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 "Nom" du fichier 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 réussites

Vous pouvez ajouter vos propres traductions pour les réussites associées à votre jeu. Assurez-vous simplement d'avoir d'abord suivi les étapes décrites 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 :
  1. Dans la Google Play Console, ouvrez l'onglet Réussites de votre jeu, puis sélectionnez une réussite existante.
  2. 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.
  3. Sur la page d'informations de la réussite pour cette langue, ajoutez vos traductions au formulaire.
  4. Cliquez sur Enregistrer pour enregistrer la traduction des informations concernant la réussite.

Classements

Les classements permettent aux joueurs de votre jeu de comparer leurs scores avec leurs amis et de se mesurer aux meilleurs joueurs.

Remarque : Vous ne pouvez pas réinitialiser les scores des classements, mais vous pouvez supprimer ou masquer les classements à tout moment.

Pour masquer des scores suspects dans les classements, vous pouvez activer la protection contre la falsification des classements sur la page Classements de votre jeu dans la Play Console.

Créer un classement

Pour créer un classement pour un nouveau jeu non publié, procédez comme suit :

1. Dans la Google Play Console, sélectionnez un jeu.
2. Accédez à Croissance > Services de jeux Play > Configuration et Gestion > Classements, puis cliquez sur le bouton Créer un classement.
3. Fournissez les informations requises pour ce classement.
4. Cliquez sur Enregistrer comme brouillon pour que votre classement soit disponible à l'état "Brouillon".
5. Une fois votre jeu publié, tous les classements du jeu le sont également.

Créer un classement pour un jeu publié

Si vous souhaitez créer un classement supplémentaire pour un jeu qui a déjà été publié, suivez la même procédure que ci-dessus. Pour découvrir comment tester une version mise à jour d'un jeu, consultez la section Publier les modifications apportées à votre jeu.

Une fois que vous avez testé votre classement et qu'il vous convient, vous pouvez publier à nouveau votre jeu avec les nouveaux classements, qui seront ensuite accessibles à tous.

Modifier un classement

Pour modifier un classement que vous avez déjà créé, cliquez sur celui-ci dans l'onglet Classements de la Google Play Console. À ce stade, le même formulaire que celui utilisé lors de la création du classement s'affiche. Vous pouvez modifier tous les champs que vous souhaitez.

Lorsque vous avez fini de modifier un classement, cliquez sur le bouton Enregistrer comme brouillon. Le nouveau classement passera à l'état "Brouillon", ce qui vous permettra de le tester.

Si tout fonctionne comme prévu, sélectionnez Publier les modifications en haut du formulaire de classement. Vous pourrez alors publier à nouveau le jeu, ainsi que tous les classements mis à jour.

Annuler une modification

Si vous n'aimez pas le classement que vous venez de modifier, et que vous souhaitez revenir à sa version précédente, il vous suffit de sélectionner Rétablir en haut du formulaire de classement. La version déjà publiée du classement sera alors rétablie.

Supprimer un classement

Vous pouvez supprimer les classements qui sont à l'état "Brouillon", ainsi que ceux qui ont déjà été publiés. Pour supprimer un classement dans la Google Play Console, accédez au formulaire correspondant, puis cliquez sur Supprimer le classement en haut du formulaire.

Vous pouvez également appeler Players.hide pour masquer le classement d'un joueur dans l'application.

Réinitialiser un classement

Vous ne pouvez réinitialiser les données de progression des joueurs que pour les classements à l'état de brouillon.

• Pour réinitialiser les classements dans la Google Play Console, cliquez sur Réinitialiser la progression en haut du formulaire.
• Pour réinitialiser les données du classement de façon programmatique, appelez les Scoresmethods de l'API Management.

Ajouter des traductions pour les classements

Vous pouvez ajouter vos propres traductions pour les classements associés à votre jeu. Assurez-vous simplement d'avoir d'abord suivi les étapes décrites dans la section Ajouter des traductions pour votre jeu. Vous devez également avoir créé un ou plusieurs classements pour votre jeu.

Afin d'ajouter vos propres traductions pour les classements, ouvrez l'onglet Classements de votre jeu dans la Google Play Console, puis sélectionnez un classement existant. Sur sa page d'informations, cliquez sur 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 du classement pour cette langue, ajoutez vos traductions au formulaire. Cliquez sur Enregistrer pour enregistrer la traduction des informations à propos du jeu.

Masquer les scores d'un classement

Les services de jeux Google Play fournissent une fonctionnalité de protection contre la falsification des classements. Celle-ci recherche les scores potentiellement trompeurs et les masque automatiquement. Cette fonctionnalité n'est disponible que pour les jeux Android.

La protection contre la falsification est activée par défaut pour les classements que vous créez pour votre jeu Android, mais elle est désactivée pour les classements existants. Si vous souhaitez l'activer pour les classements qui ont déjà été publiés, procédez comme suit :

1. Dans la Google Play Console, ouvrez l'onglet Services de jeux, puis sélectionnez votre jeu dans la liste.
2. Ouvrez l'onglet Classements, puis sélectionnez le classement pour lequel vous souhaitez activer la protection contre la falsification.
3. Activez l'option Activer la protection contre la falsification des classements.
4. Cliquez sur Save.
5. Publiez votre jeu.

Une fois que la protection contre la falsification est activée pour un classement dans la Google Play Console, un délai de 24 heures peut être nécessaire pour qu'elle entre en vigueur. Les scores envoyés avant l'activation de la protection contre la falsification ne sont pas masqués rétroactivement.

Dans certains cas, vous pouvez désactiver la protection contre la falsification (par exemple, si votre jeu s'exécute également sur le Web en plus d'Android et que ses classements sont partagés sur ces plates-formes).

Jeux enregistrés

Avec le service de jeux enregistrés, les joueurs peuvent facilement enregistrer leur progression dans le jeu. Leur progression ainsi que des métadonnées sont synchronisées sur tous les appareils utilisant les services de jeux Google Play.

Consultez le site Google Developers pour savoir comment implémenter le service Jeux enregistrés.

Activer le service Jeux enregistrés

Pour activer le service Jeux enregistrés, procédez comme suit dans la Play Console :

1. Dans la Google Play Console, sélectionnez un jeu.
2. Sur la page Services de jeux Play - Configuration (Croissance > Services de jeux Play > Configuration et gestion > Configuration), sélectionnez Modifier les propriétés.
3. Activez l'option Jeux enregistrés.
4. Cliquez sur Enregistrer.

Une fois les étapes ci-dessus terminées, l'activation du service Jeux enregistrés par les services de jeux Google Play peut prendre jusqu'à 24 heures. Si vous souhaitez tester le service Jeux enregistrés immédiatement, effacez manuellement les données de l'application Services Google Play sur votre appareil de test.

Pour effacer les données mises en cache sur Android, ouvrez les Paramètres > Applications > Services Google Play, cliquez sur Gérer l'espace, puis sur Effacer toutes les données.

Pour en savoir plus sur le service Jeux enregistrés, consultez le guide des jeux enregistrés.

Ajouter des traductions

Vous pouvez ajouter vos propres traductions des informations à propos du jeu, y compris le nom à afficher, la description du jeu et les assets graphiques. Vous pouvez également ajouter vos propres traductions des réussites et des classements associés à votre jeu.

Pour ajouter vos propres traductions des informations à propos du jeu :

1. Dans la Google Play Console, sélectionnez un jeu.
2. Accédez à la page Services de jeux Play - Configuration (Croissance > Services de jeux Play > Configuration et gestion > Configuration).
3. Sélectionnez Modifier les propriétés.
4. Sélectionnez Gérer les traductions > Gérer vos traductions.
5. Sélectionnez les langues pour lesquelles vous allez fournir des traductions, puis cliquez sur Appliquer pour confirmer votre choix. Sur la page Propriétés, les langues que vous avez sélectionnées deviennent disponibles dans le sélecteur de langue.
6. Sélectionnez la langue que vous souhaitez modifier dans le sélecteur de langue, puis modifiez le formulaire avec vos traductions pour le nom à afficher, la description et les assets graphiques.
7. Cliquez sur Enregistrer les modifications pour enregistrer la traduction des informations à propos du jeu.

Pour en savoir plus sur l'ajout de traductions pour les réussites et les classements, consultez les guides concernant les réussites et les classements.

Lors de l'affichage des chaînes correspondant aux informations à propos du jeu, aux classements et aux réussites, la langue compatible avec le jeu la plus proche de la langue demandée par le joueur est sélectionnée par les services de jeux Play. Par exemple, si les préférences de langue de l'appareil sont définies sur le français (Canada) (fr-CA), mais que le jeu n'accepte que l'anglais (États-Unis) (en-US) et le français (France) (fr-FR), les services de jeux Play affichent les chaînes fr-FR, car il s'agit de la langue la plus proche.

Accorder des droits de modification aux utilisateurs

Pour modifier les paramètres des services de jeux Play dans la Play Console, vous devez vous assurer que votre équipe dispose des autorisations nécessaires pour gérer les services de jeux Play. Pour en savoir plus sur les autorisations dans la Play Console, consultez Ajouter des utilisateurs à un compte de développeur et gérer les autorisations.

API Google Play Game Services Publishing

Pour automatiser la configuration de l'application et intégrer les releases dans les outils et les processus automatisés existants, vous pouvez utiliser l'API Google Play Games Services Publishing. Voici comment activer l'accès à l'API Google Play Games Services Publishing dans la Play Console :

1. Ouvrez la Google Play Console.
2. Accédez à Configuration Accès à l'API.
3. Créez un projet associé, si ce n'est déjà fait.
4. À côté de l'option "API Games Configuration", cliquez sur le bouton Activer.

Gérer plusieurs utilisateurs

Si plusieurs utilisateurs gèrent des jeux depuis votre compte de développeur, vous devez gérer les autorisations à partir de la page Utilisateurs et autorisations de la Play Console.