Intégrer les statistiques de jeu

Ce document explique comment intégrer les statistiques de jeu à votre jeu à l'aide de la Google Play Console. Il couvre les formats de fichiers CSV et ZIP essentiels, et décrit comment les créer, les importer et les gérer.

Créer des événements

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

  1. Créer le fichier CSV des événements PlayerGameEvent.csv
  2. Dans la Google Play Console, sélectionnez un jeu.
  3. Sur la page Services de jeux Play - Statistiques de jeu (Accroître le nombre d'utilisateurs > Services de jeux Play > Configuration et gestion > Statistiques de jeu), sélectionnez Configurer les événements.
  4. Sur la page Configuration des événements, déposez le fichier CSV à importer.
  5. Une fois que vous avez créé un événement, vous devez configurer les statistiques.

Configurer les statistiques

Une fois l'événement créé, vous devez configurer les statistiques :

  1. Créez le fichier ZIP contenant les fichiers de statistiques, de localisation et d'icônes. Consignes relatives aux fichiers ZIP pour les statistiques
  2. Dans la Google Play Console, sélectionnez un jeu.
  3. Sur la page Services de jeux Play - Statistiques de jeu (Accroître le nombre d'utilisateurs > Services de jeux Play > Configuration et gestion > Statistiques de jeu), sélectionnez Configurer les statistiques.
  4. Sur la page Configuration des statistiques de jeu, déposez le fichier ZIP à importer.
  5. Une fois toutes les statistiques importées, vous pouvez publier votre jeu.

Tester les statistiques de jeu

Pour vérifier que les statistiques de jeu fonctionnent comme prévu, suivez les étapes de test :

  • 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.
  • L'utilisateur du compte de test peut jouer au jeu pour déclencher les événements. Vérifiez la réponse de l'API pour savoir si les événements ont été enregistrés.

Publier les statistiques du jeu

Une fois les tests terminés, vous devez publier votre jeu. Tous les événements et statistiques de votre jeu sont publiés en même temps.

Pour publier votre édition, procédez comme suit :

  1. Dans la Google Play Console, sélectionnez un jeu.
  2. Sur la page Services de jeux Play - Statistiques du jeu (Accroître le nombre d'utilisateurs > Services de jeux Play > Configuration et gestion > Statistiques du jeu), cliquez sur Examiner et publier.
  3. Sur la page Services de jeux Play - Publication (Accroître le nombre d'utilisateurs > Services de jeux Play > Configuration et gestion > Publication), examinez les actions et corrigez les problèmes.
  4. Cliquez sur Publier. Toutes vos statistiques de jeu sont publiées.

Supprimer les statistiques de jeu

Une fois les statistiques de jeu publiées, elles ne peuvent pas être supprimées.

Consignes concernant les fichiers CSV pour les événements

La première ligne du fichier CSV est une ligne d'en-tête. Vous devez importer les événements à l'aide du fichier CSV des événements, par exemple PlayerGameEvent.csv.

Format de PlayerGameEvent.csv

Le fichier CSV contient l'événement déclaré et ses propriétés sous forme de valeurs séparées par une virgule, dans l'ordre suivant :

 Event Name,Property Name,Property Type

Si vous envoyez l'événement progressUpdate pour progressionStat, ajoutez une ligne pour cet événement. Cet événement doit contenir au moins une propriété currentProgress de type INT ou STRING, ainsi que toutes les autres propriétés que vous souhaitez envoyer.

Ces champs sont décrits dans le tableau suivant :

En-têtes des colonnes du fichier CSV Obligatoire ou facultatif Valeurs acceptées
Nom de l'événement Obligatoire 50 caractères maximum

Ne doit contenir que des lettres, des chiffres et des traits de soulignement.

Si le nom d'événement spécial progressUpdate est utilisé, il doit inclure une propriété nommée currentProgress de type INT64 ou STRING.
Nom de la propriété Obligatoire 50 caractères maximum

Ne doit contenir que des lettres, des chiffres et des traits de soulignement.

Unique par événement : les noms de propriétés doivent être uniques au sein d'un même événement.

N'utilisez pas les mots clés réservés suivants : id, count, key, value, where, from, and, or, true ou false.
Type de bien Obligatoire Chaîne d'énumération sensible à la casse correspondant à l'un des types de données acceptés : INT64, DOUBLE, STRING, BOOL

Exigences concernant le fichier PlayerGameEvent.csv :

  • Le fichier peut contenir jusqu'à 20 noms d'événements uniques, avec un maximum de 20 propriétés par événement.
  • Le contenu du fichier ne peut pas être vide et doit comporter au moins une ligne.
Exemple de table
Nom de l'événement Nom de la propriété Type de bien
matchCompleted duration DOUBLE
matchCompleted Ennemis tués INT64
matchCompleted isWinner BOOL
matchCompleted matchType STRING
itemCollected (Article collecté) coinsAmount INT64
itemCollected (Article collecté) weaponType STRING
progressUpdate currentProgress INT64

Consignes concernant les fichiers ZIP pour les statistiques

Vous pouvez importer des statistiques à 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
RepetitiveStatsConfig.csv Obligatoire Une statistique répétitive représente les actions en jeu effectuées régulièrement par les joueurs.
ProgressionStatConfig.csv Obligatoire Une statistique de progression représente la progression d'un joueur dans un jeu.
StatLocalizations.csv Facultatif Fournit des traductions pour les noms et les descriptions des statistiques de jeu.
Fichiers d'icônes Obligatoire Icônes au format PNG, JPEG ou JPG de 512 x 512 px.

Le fichier ZIP doit répondre aux exigences suivantes :

  • Taille limite des fichiers ZIP : la taille totale non compressée ne doit pas dépasser 10 Mo.
  • Nombre maximal de fichiers : le fichier ZIP ne doit pas contenir plus de 53 fichiers au total (3 fichiers CSV et 50 icônes).
  • Limite maximale de statistiques combinées : 50 statistiques au total maximum pour ProgressionStatConfig.csv et RepetitiveStatsConfig.csv.
  • Fichiers CSV acceptés : ProgressionStatConfig.csv, RepetitiveStatsConfig.csv et StatLocalizations.csv (facultatif). Si vous ne souhaitez importer que les statistiques de progression, n'incluez pas le fichier CSV des statistiques répétitives dans le fichier ZIP. Sinon, la console générera une erreur. Il en va de même si vous souhaitez n'importer que des statistiques répétitives.
  • Fichiers image d'icône : PNG (.png) ou JPEG (.jpg, .jpeg).
    • Toutes les icônes référencées dans les fichiers CSV doivent exister à la racine du fichier ZIP.
    • Tous les fichiers image présents dans le fichier ZIP doivent être référencés par au moins une statistique.
  • Structure du répertoire : tous les fichiers doivent se trouver à la racine du fichier ZIP. Les sous-répertoires ne sont pas autorisés.

Format de RepetitiveStatsConfig.csv

Le fichier CSV contient l'événement déclaré et ses propriétés sous forme de valeurs séparées par une virgule, dans l'ordre suivant :

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

Ces champs sont décrits dans le tableau suivant :

En-têtes des colonnes du fichier CSV Obligatoire ou facultatif Valeurs acceptées
ID de la statistique Obligatoire 100 caractères maximum

Ne doit contenir que des lettres, des chiffres et des traits de soulignement. Doit être unique pour toutes les statistiques du jeu.
Nom de la propriété de l'événement Obligatoire 50 caractères maximum
Nom à afficher de la statistique Obligatoire 50 caractères maximum
Nom à afficher par défaut pour la statistique (paramètres régionaux par défaut). Doit être unique pour toutes les statistiques.
Description de la statistique Obligatoire 500 caractères maximum
Description par défaut de la statistique.
Type d'agrégation Obligatoire 50 caractères maximum
SUM, MAX, MIN, COUNT.
Propriété de filtre Facultatif 50 caractères maximum
Doit être un nom de propriété défini dans PlayerGameEvent.csv.
Opérateur de filtre Facultatif =, !=, >, <, >=, <=
Opérateurs de comparaison de filtres.
Valeur du filtre Facultatif Par rapport à la propriété de filtre. La valeur du filtre doit être INT64, DOUBLE, BOOL, STRING.
Est compétitif Obligatoire true, false
Limite minimale Obligatoire lorsque "Is Competitive" est défini sur "true" Score minimal autorisé pour les statistiques sur la concurrence.
Limite maximale Obligatoire lorsque "Is Competitive" est défini sur "true" Score maximal autorisé pour les statistiques sur la concurrence.
Nom de fichier de l'icône Obligatoire Nom de fichier de l'image de l'icône incluse à la racine du fichier ZIP. Ne doit pas entrer en conflit avec les noms de fichiers d'icônes utilisés dans les statistiques répétitives.
Direction de la valeur correcte Obligatoire Indique si les valeurs élevées INCREASING ou les valeurs faibles DECREASING sont préférables.
Unité Facultatif Unité de mesure pour les valeurs numériques brutes ou de durée. Par exemple, KILOMETER, SECOND, PERCENTAGE, UNITLESS.

Si vous ne souhaitez pas utiliser la condition de filtre, laissez la cellule vide.

Exemple de table
ID de la statistique Nom de l'événement Nom de la propriété Agrégation Nom à afficher de la statistique Description de la statistique Propriété de filtrage (facultatif) Opérateur de filtre (facultatif) Valeur du filtre (facultatif) Est compétitif minLimit maxLimit Nom de fichier de l'icône Numéro de séquence Direction de la valeur correcte unité
1 matchCompleted duration MAX Survie de la correspondance la plus longue Il s'agit du temps de survie d'un joueur dans un match. isWinner = TRUE TRUE 0 50 stat1.png 1 En baisse secondes
2 matchCompleted isWinner COUNT Matchs gagnés Indique le nombre de matchs remportés par un joueur. isWinner = TRUE TRUE 0 50 stat3.png 2 En hausse
3 matchCompleted Ennemis tués SUM Ennemis tués en duel Nombre d'éliminations lors de matchs en un contre un matchType = "1-on-1" FAUX stat4.png 4 En hausse
4 itemCollected (Article collecté) coinsAmount SUM Total d'or collecté Un joueur collecte des pièces pendant un match weaponType = "sword" FAUX stat2.png 3 En hausse

Format de ProgressionStatConfig.csv

Le fichier CSV contient l'événement déclaré et ses propriétés sous la forme de valeurs séparées par une virgule, dans l'ordre suivant :

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

La statistique de progression sera la première à s'afficher dans le profil de joueur.

Ces champs sont décrits dans le tableau suivant :

En-têtes des colonnes du fichier CSV Obligatoire ou facultatif Valeurs acceptées
ID de la statistique Obligatoire 100 caractères maximum

Ne doit contenir que des lettres, des chiffres et des traits de soulignement. Doit être unique pour toutes les statistiques du jeu.
Nom de l'événement Obligatoire 50 caractères maximum

Doit faire référence au nom de l'événement défini dans le format PlayerGameEvent.csv.
Nom de la propriété de l'événement Obligatoire 50 caractères maximum

Doit être un nom de propriété défini dans PlayerGameEvent.csv.
Nom à afficher de la statistique Obligatoire Le nom doit être unique.
Description de la statistique Obligatoire 50 caractères maximum
Description par défaut de la statistique.
Nom de fichier de l'icône Obligatoire Nom de fichier de l'image de l'icône incluse à la racine du fichier ZIP. Ne doit pas entrer en conflit avec les noms de fichiers d'icônes utilisés dans les statistiques répétitives.
Direction de la valeur correcte Obligatoire Indique si les valeurs élevées INCREASING ou les valeurs faibles DECREASING sont préférables.
Unité Facultatif Unité de mesure pour les valeurs numériques brutes ou de durée. Par exemple, KILOMETER, SECOND, PERCENTAGE, UNITLESS.
Exemple de table
ID de la statistique Nom de la propriété de l'événement Nom à afficher de la statistique Description de la statistique Nom du fichier d'icône Bon rapport qualité-prix
5 currentProgress Niveau Les joueurs accumulent de l'expérience en jouant des matchs et en passant au niveau supérieur. Level.png en augmentation

Format de StatLocalizations.csv

Le fichier CSV contient l'événement déclaré et ses propriétés sous la forme de valeurs séparées par une virgule, dans l'ordre suivant :

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

Ces champs sont décrits dans le tableau suivant :

En-têtes des colonnes du fichier CSV Obligatoire ou facultatif Valeurs acceptées
ID de la statistique Obligatoire 100 caractères maximum

Ne doit contenir que des lettres, des chiffres et des traits de soulignement. Doit être unique pour toutes les statistiques du jeu.
Nom à afficher de la statistique Obligatoire Le nom doit être unique.
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.
Nom à afficher localisé de la statistique Facultatif 50 caractères maximum. Nom à afficher traduit de la statistique pour les paramètres régionaux spécifiés.
Description localisée de la statistique Facultatif 500 caractères maximum. Description traduite de la statistique pour les paramètres régionaux spécifiés.
Exemple de table
ID de la statistique Nom à afficher de la statistique Language Code Nom de la statistique localisée (UTF-8) Description localisée de la statistique (UTF-8) 1 Survie de la correspondance la plus longue es Survie plus longue dans les matchs Cela indique la durée de survie d'une joueuse dans un match. 1 Survie de la correspondance la plus longue fr Survie du match le plus long Cela indique la durée de survie d'un joueur dans n'importe quel match. 4 Total d'or collecté es Or total collecté La jugadora recoge monedas mientras juega en un partido 4 Total d'or collecté fr Ou total collecté Le joueur collecte des pièces en jouant un match

Fichiers d'icônes

Les icônes que vous référencez dans le fichier .csv doivent exister dans l'archive ZIP actuelle que vous importez.

Voici les règles de validation des icônes :

Propriété de validation Contrainte / règle appliquée
Taille maximale de fichier 1 Mo (1 048 576 octets) maximum par fichier d'icône.
Dimensions 512 x 512 pixels exactement (largeur = 512, hauteur = 512)
Format Strictement 1:1 (format carré)
Formats autorisés PNG (.png) et JPEG (.jpg, .jpeg)
Emplacement dans le fichier ZIP Doit se trouver dans le répertoire racine du fichier ZIP.
Vérification référencée Tous les noms de fichiers d'icônes spécifiés dans les colonnes "Nom du fichier d'icône" doivent exister dans le fichier ZIP.
Vérification des orphelins Tous les fichiers image du fichier ZIP doivent être référencés par au moins une statistique.
Vérification des conflits Les noms de fichiers d'icônes dans ProgressionStatConfig.csv ne doivent pas entrer en conflit avec RepetitiveStatsConfig.csv.
Doublons visuels Les icônes en double sont signalées.

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.

É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é.

Spécification de l'unité

Les colonnes "Unité" contrôlent la façon dont les valeurs brutes des statistiques sont mises en forme et localisées pour les joueurs.

Propriétés des statistiques numériques (INT64, DOUBLE)

Valeur d'unité autorisée Exemple de valeur brute
(Vide) / SANS UNITÉ / AUCUN 1234567
% / POURCENTAGE / POURCENT 0.857
Distance/Longueur : CENTIMÈTRE, MÈTRE, KILOMÈTRE, PIED, POUCE, MILE, YARD, MILLIMÈTRE, NANOMÈTRE 15 (KILOMÈTRE)
Vitesse : KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR 60 (MILE_PER_HOUR)

Propriétés de statistiques non numériques (STRING, BOOL)

Les colonnes d'unités doivent être laissées vides.