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 ou importer des événements
Il existe deux manières d'ajouter des événements pour la première fois dans la Google Play Console :
- Créer un événement : ajoutez un événement à la fois.
- Importer des événements : importez plusieurs événements.
Créer un événement
Pour créer un événement pour un jeu, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- 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 Ajouter un événement > Créer un événement.
- Sur la page Créer un événement, remplissez le formulaire.
- Cliquez sur Enregistrer les modifications.
Importer des événements
Pour ajouter plusieurs événements en même temps à votre jeu, procédez comme suit :
- Créez le fichier CSV d'événements PlayerGameEvent.csv.
- Dans la Google Play Console, sélectionnez un jeu.
- 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 Ajouter un événement > Importer via un fichier CSV.
- Sur la page Configuration des événements, déposez le fichier CSV à importer.
- Après avoir créé un événement, configurez les statistiques.
Créer ou importer des statistiques
Il existe deux manières d'ajouter des statistiques pour la première fois dans la Google Play Console :
- Créer une statistique : ajoutez une statistique à la fois.
- Importer des statistiques : importez plusieurs statistiques.
Créer une statistique
Pour créer une statistique pour un jeu, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- 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 Ajouter une statistique > Créer une statistique.
- Sur la page Créer une statistique, remplissez le formulaire.
- Cliquez sur Enregistrer les modifications.
- Après avoir créé une statistique, publiez votre jeu.
Importer des statistiques
Pour importer des statistiques, procédez comme suit :
- Créez le fichier ZIP contenant les statistiques, les localisations et les fichiers d'icônes conformément aux consignes relatives aux fichiers ZIP pour les statistiques.
- Dans la Google Play Console, sélectionnez un jeu.
- 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 Ajouter une statistique > Importer via un fichier ZIP.
- Sur la page Configuration des statistiques de jeu, déposez le fichier ZIP à importer.
- Une fois que vous avez importé toutes les statistiques, publiez votre jeu.
Tester les statistiques de jeu
Pour vérifier que les statistiques de jeu fonctionnent comme prévu, suivez les étapes pour les tester :
- Ouvrez l'application Google Play Store.
- Connectez-vous à votre profil Play Jeux dans l'application Google Play Store.
- Consultez vos statistiques de jeu dans votre profil de joueur.
Afficher les journaux sur votre appareil
Pour vérifier que les statistiques de jeu fonctionnent comme prévu, activez les journaux sur votre appareil :
Activez le débogage adb sur votre appareil et exécutez les commandes suivantes dans un terminal :
adb shell setprop log.tag.Games INFO adb logcat -s "PlayGamesServices[GameStatsAgent]:I"
Vérifiez qu'un message de journal de réussite s'affiche, comme illustré dans l'exemple suivant :
Successfully uploaded batch of X events.
Remarque : Comme l'API accepte les importations partielles, ce journal d'informations indique que le lot a été traité. Si un événement individuel du lot échoue à la validation du schéma, un journal d'erreurs précédera ce message.
Si la validation d'un événement envoyé échoue, un message d'erreur détaillant l'échec s'affiche :
BatchRecordEvents validation failed for X event(s): ...
Publier les statistiques de 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, procédez comme suit :
- Dans la Google Play Console, sélectionnez un jeu.
- 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), cliquez sur Examiner et publier.
- 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.
- Cliquez sur Publier. Toutes vos statistiques de jeu sont publiées.
Modifier les statistiques de jeu
Si vous avez déjà des statistiques de jeu et que vous souhaitez les modifier :
- Dans la Google Play Console, sélectionnez un jeu.
- Accédez à 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).
- Pour modifier un événement :
- Dans la section Configuration des événements, sélectionnez un événement.
- Vous pouvez ajouter ou supprimer des propriétés d'événement.
- Vous ne pouvez pas modifier le nom de l'événement.
- Cliquez sur Enregistrer les modifications.
- Pour modifier une statistique :
- Dans la section Configuration des statistiques de jeu, sélectionnez une statistique.
- Vous pouvez modifier les champs Nom de la statistique, Description de la statistique et Nom du fichier d'icône.
- Vous ne pouvez pas modifier l'ID de statistique ni la Direction de la progression. Unité de statistique et Détails de l'événement associé.
- Cliquez sur Enregistrer les modifications.
- Sur la page services Play Games - Statistiques de jeu, la statistique modifiée est à l'état Disponible pour les testeurs.
- Après avoir testé la statistique, cliquez sur Vérifier et publier. Votre jeu et toutes vos statistiques mises à jour seront alors publiés à nouveau.
Supprimer les statistiques de jeu
Une fois les statistiques de jeu publiées, elles ne peuvent pas être supprimées.
Vous pouvez supprimer un événement ou une statistique à l'état Disponible pour les testeurs.
- Dans la Google Play Console, sélectionnez un jeu.
- Accédez à 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).
- Pour supprimer un événement :
- Dans la section Configuration des événements, sélectionnez un événement.
- Cliquez sur Supprimer l'événement.
- Pour supprimer une statistique :
- Dans la configuration des statistiques de jeu, sélectionnez la statistique que vous souhaitez supprimer.
- Cliquez sur Supprimer la statistique de jeu.
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 d'é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 Il ne doit contenir que des lettres, des chiffres et des traits de soulignement. Si le nom d'événement spécial |
| Nom de la propriété | Obligatoire | 50 caractères maximum Il ne doit contenir que des lettres, des chiffres et des traits de soulignement. Uniques par événement : les noms de propriété doivent être uniques au sein d'un même événement. N'utilisez pas les mots clés réservés suivants : |
| 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 accepte un maximum de 20 noms d'événements uniques, avec jusqu'à 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 | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
Consignes concernant les fichiers ZIP pour les statistiques
Vous pouvez importer plusieurs 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 des actions de 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 :
- Limite de taille du fichier ZIP : la taille totale non compressée ne doit pas dépasser 10 Mo.
- Nombre maximal de fichiers : 53 fichiers au maximum (3 CSV et 50 icônes) dans l'archive ZIP.
- Limite maximale de statistiques combinées : 50 statistiques au maximum pour
ProgressionStatConfig.csvetRepetitiveStatsConfig.csv. - Fichiers CSV compatibles :
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvetStatLocalizations.csv(facultatif). Si vous ne souhaitez importer que des statistiques de progression, n'incluez pas le fichier CSV de statistiques répétitives dans le fichier ZIP. Sinon, la console génère une erreur. Il en va de même si vous ne souhaitez importer que des statistiques répétitives. - Fichiers d'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 Il ne doit contenir que des lettres, des chiffres et des traits de soulignement. Il doit être unique parmi 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 au format PlayerGameEvent.csv. |
| Nom de la propriété d'événement | Obligatoire | 50 caractères au 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). Il 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. |
| Filtrer la propriété | 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é "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 de compétition. |
| Limite maximale | Obligatoire lorsque "Is Competitive" est défini sur "true" | Score maximal autorisé pour les statistiques de compétition. |
| Nom de fichier de l'icône | Obligatoire | Nom du fichier de l'image d'icône inclus à 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 du bon rapport qualité-prix | Obligatoire | Indique si des valeurs plus élevées INCREASING ou plus faibles DECREASING sont préférables.
|
| Unité | Facultatif | Unité de mesure pour les valeurs numériques ou de durée brutes. 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é du filtre (facultatif) | Opérateur de filtre (facultatif) | Valeur du filtre (facultatif) | Est compétitif | minLimit | maxLimit | Nom de fichier de l'icône | Direction du bon rapport qualité-prix | unité |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | duration | MAX | Survie du match le plus long | Il s'agit de la durée de survie d'un joueur dans un match. | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | 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 | En hausse | |
| 3 | matchCompleted | ennemis tués | SUM | Éliminations en match 1 contre 1 | Nombre de kills effectués lors de matchs en 1 contre 1 | matchType | = | "1-on-1" | FAUX | stat4.png | En hausse | |||
| 4 | itemCollected | coinsAmount | SUM | Total d'or collecté | Un joueur collecte des pièces pendant un match | weaponType | = | "sword" | FAUX | stat2.png | En hausse |
Format de ProgressionStatConfig.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 Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
La statistique de progression sera la première statistique affichée 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 Il ne doit contenir que des lettres, des chiffres et des traits de soulignement. Il doit être unique parmi toutes les statistiques du jeu. |
| Nom de la propriété d'événement | Obligatoire | 50 caractères maximum Il doit s'agir d'un nom de propriété défini dans le fichier 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 du fichier de l'image d'icône inclus à 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 du bon rapport qualité-prix | Obligatoire | Indique si des valeurs plus élevées INCREASING ou plus faibles DECREASING sont préférables.
|
| Unité | Facultatif | Unité de mesure pour les valeurs numériques ou de durée brutes. Par exemple, KILOMETER, SECOND, PERCENTAGE, UNITLESS. |
Exemple de table
| ID de la statistique | Nom de la propriété d'événement | Nom à afficher de la statistique | Stat Description | Nom du fichier d'icône | Bon rapport qualité-prix |
|---|---|---|---|---|---|
| 5 | currentProgress | Niveau | Les joueurs accumulent de l'XP en jouant des matchs et en montant de niveau. | Level.png | augmentation |
Format de StatLocalizations.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,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 Il ne doit contenir que des lettres, des chiffres et des traits de soulignement. Il doit être unique parmi 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 localisé de la statistique à afficher | Facultatif | 50 caractères maximum. Nom à afficher de la statistique traduit pour les paramètres régionaux donnés. |
| Description localisée de la statistique | Facultatif | 500 caractères maximum. Description traduite de la statistique pour les paramètres régionaux indiqués. |
Exemple de table
| ID de la statistique | Nom à afficher de la statistique | Code de langue | Nom localisé de la statistique (UTF-8) | Description localisée de la statistique (UTF-8) |
|---|---|---|---|---|
| 1 | Survie du match le plus long | es | Survie la plus longue dans les matchs | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. |
| 1 | Survie du match le plus long | 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 | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido |
| 4 | Total d'or collecté | fr | Or 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.
Les règles de validation des icônes sont les suivantes :
| 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 | Exactement 512 × 512 pixels (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 peuvent 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 avec un arrière-plan transparent.
É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 formatées 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) / UNITLESS / NONE | 1234567 |
| % / POURCENTAGE / POUR CENT | 0,857 |
| Distance/Longueur : CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER | 15 (KILOMÈTRE) |
| Vitesse : KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
Propriétés des statistiques de durée (DURATION)
| Format Category Value | Valeurs d'unité autorisées | Exemple de valeur brute | Exemple de sortie mise en forme |
| UNIT_BASED / DURATION | Obligatoire : SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR | 5 400 secondes (HEURE) | 1h30 |
| COMPONENT_NUMERIC / HH:MM:SS / CLOCK | Précision (facultatif, WHOLE_SECONDS par défaut) : WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS | 3 661 secondes | 01:01:01 |
| COMPONENT_TEXT / TEXT | Unité la plus petite (facultatif, SECONDS par défaut) : SECONDS, MINUTES, HOURS, DAYS, MONTHS, YEARS | 90 000 secondes | 1 j 1 h |
Propriétés de statistiques non numériques (STRING, BOOL)
Les colonnes d'unités doivent être laissées vides.