Passer au contenu principal

Conception > Cloud Data > Statistiques de l'usager

Les statistiques des joueurs [ou des usagers] sont utilisées pour suivre des statistiques simples relatives à un seul usager.

Jason Liang avatar
Écrit par Jason Liang
Mis à jour cette semaine

Les statistiques de l'usager permettent de suivre les statistiques de base relatives à un usager spécifique. Elles sont utiles pour suivre toute mesure par usager dont vous pourriez avoir besoin. Par exemple, vous pouvez savoir où votre usager concentre ses efforts dans votre application, quelles fonctionnalités il utilise le plus (ou le moins) et toute autre statistique à long terme que vous souhaitez suivre.

Les statistiques de l'usager fonctionnent également bien en conjonction avec Conception > ludification > Objectifs pour créer des objectifs progressifs et améliorer la fidélisation des joueurs.
Notez que les statistiques de l'usager ne sont pas automatiquement réinitialisées après un patch. Ainsi, si la conception examine ces statistiques pour valider un changement de comportement après une modification, elles peuvent être réinitialisées à leur valeur initiale pour tous les usagers actifs sur la page des statistiques. Les statistiques peuvent également être ajustées via la surveillance des usagers.

Mise en œuvre

Les statistiques de l'usager sont stockées sur le serveur dans des paires clé + valeur et sont accessibles via un ensemble d'opérations personnalisé pour des performances maximales et une sécurité de concurrence.

Les statistiques de l'usager sont également des éléments clés des fonctionnalités de ludification de brainCloud et peuvent être créées sur le portail brainCloud.

Configuration de vos statistiques de l'usager

  • Cliquez sur le bouton [Créer...] dans le coin supérieur droit de l’écran de liste.

  • Saisissez le nom , la catégorie, la description et le type de statistique. Les statistiques peuvent être de type Long ou Double .

  • Définissez les plages de valeurs minimale et maximale pour votre application. Il est recommandé d'ajouter une plage adaptée à votre application, plutôt que d'utiliser les valeurs théoriques maximale et minimale longues et doubles.

  • Définissez la valeur initiale de la statistique. Cette valeur peut être négative ou supérieure à zéro. Par exemple, si vous aviez une statistique pour suivre la réputation d'un usager, elle pourrait commencer à 1 000 et augmenter ou diminuer au fil du temps.

  • L'action de fusion se produit lorsqu'un usager doit utiliser deux comptes. Par exemple, s'il s'inscrit à votre application par e-mail, puis crée un UniversalId, il pourrait souhaiter fusionner ces deux comptes.

    • takePrimary - Prendra les statistiques du compte principal qui survit à la fusion.

    • additif - Additionnera les deux statistiques et créera une nouvelle valeur.

    Selon votre application et la statistique, il sera plus judicieux de prendre en compte la valeur principale ou la valeur additionnelle. Par exemple, si vous suivez le nombre de kilomètres parcourus par un usager, il serait judicieux d'additionner ces deux valeurs. En revanche, si vous suivez la vitesse de course d'un usager, additionner deux vitesses de course serait peu judicieux. À moins que votre usager final n'ait doublé son allure. 😄

  • N'oubliez pas de cliquer sur [Sauvegarder] !

    • Vous n'avez pas besoin de créer manuellement chaque statistique

    • Sur la page Conception > Info de base de l'app > Réglages avancés, vous trouverez les options "Générer une règle de statistique usager activée" et "Génération de règle de statistiques d'application activée". Une fois activée, cette option vous permet de générer dynamiquement des statistiques depuis l'explorateur d'API et votre application cliente.

Écrire le code

Maintenant que vous avez créé des statistiques usager, vous souhaiterez les incrémenter dans votre application.

Dans votre code client

  • Ajoutez le client brainCloud à votre application.

  • Associez le client au tableau de bord.

  • Authentifiez votre usager dans brainCloud.

  • Demandez les statistiques actuelles avec l'appel API ReadAllUserStats.

  • Augmentez chaque statistique de 5 avec l'appel API IncrementUserStats.

  • Enregistrez les résultats pour le débogage.

private BrainCloudWrapper _bc;
private string _wrapperName = "default";
void Start() {
// Unity
GameObject go = new GameObject();
_bc = go.AddComponent<BrainCloudWrapper>();
_bc.WrapperName = _wrapperName; // optionellement définir un nom de wrapper
_bc.Init(); // des données extra, tel que: _appId, _secret et _appVersion, sont extraites du plugin brainCloud Unity.
DontDestroyOnLoad(go); // conserver l'objet de jeu brainCloud pendant les changements de scène

_bc.AuthenticateAnonymous((response, cbObject) => { ReadUserStats(); });
}

Dictionary<string, object> statList = new Dictionary<string, object>();
private int incrementAmount = 5;
void ReadUserStats() {
_bc.PlayerStatisticsService.ReadAllUserStats((response, cbObject) => {
var jsonMessage =
(Dictionary<string, object>) BrainCloud.JsonFx.Json.JsonReader.Deserialize(response);
var jsonData = (Dictionary<string, object>) jsonMessage["data"];
var statistics = (Dictionary<string, object>) jsonData["statistics"];
foreach (var stat in statistics)
{
statList.Add(stat.Key, (int)stat.Value + incrementAmount);
}

IncrementUserStats();
});
}

void IncrementUserStats()
{
_bc.PlayerStatisticsService.IncrementUserStats(statList, (response, cbObject) =>
{
Debug.Log("Stats Incremented: " + response);
});
}
Avez-vous trouvé la réponse à votre question ?