Statistiques communautaires

Les statistiques communautaires sont un outil puissant pour accroître l’engagement et favoriser l’investissement des joueurs dans votre jeu. En agrégeant les statistiques au niveau du titre de jeu, les développeurs peuvent créer des objectifs et des défis partagés qui encouragent la collaboration entre les joueurs. Cette approche transforme les actions individuelles des joueurs en contributions à des objectifs communautaires, ce qui favorise un engagement durable à mesure que les joueurs collaborent pour atteindre des étapes collectives. Les joueurs ont le sentiment que leurs contributions individuelles comptent pour l’ensemble de la communauté, ce qui renforce leur lien avec le jeu et avec les autres joueurs. Par exemple, imaginez la mise en place d’un combat de boss mondial dans lequel l’ensemble de la base de joueurs doit cumuler 10 millions d’éliminations en une semaine pour débloquer un événement spécial en jeu. En voyant la barre de progression de la communauté avancer à chacune de leurs contributions, les joueurs sont motivés pour contribuer à atteindre l’objectif. Ce comportement crée une puissante boucle de rétroaction d’investissement et de participation, en particulier lorsqu’elle est associée à des mises à jour de la progression en temps réel et à des récompenses d’étape en cours de route. Avec PlayFab, vous pouvez facilement gérer les statistiques communautaires en définissant deux statistiques : l’une au niveau du joueur (source d’agrégation) et l’autre au niveau du titre ou du groupe (destination d’agrégation). Les mises à jour apportées aux statistiques des joueurs sont automatiquement agrégées dans la statistique de destination. Pour récupérer le score communautaire actuel, vous lisez les statistiques de l’entité de destination. PlayFab prend en charge deux types de statistiques communautaires :

Au niveau du titre : agrège toutes les mises à jour des joueurs dans une seule statistique à l’échelle du titre. Idéal pour les objectifs mondiaux partagés par l’ensemble de la base de joueurs.
Au niveau du groupe : agrège les mises à jour des joueurs dans une statistique d’entité de groupe. Idéal pour les défis de clan, les objectifs de guilde ou les objectifs d’équipe, dans lesquels des sous-ensembles de joueurs travaillent à un objectif commun.

Statistiques communautaires au niveau du titre

Création de la définition de statistique source

Commencez par créer une définition de statistique pour les joueurs, qui sert de source d’agrégation :

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "sourceStat",
    AuthenticationContext = context,
    EntityType = "title_player_account",
    VersionConfiguration = new VersionConfiguration()
    {
        MaxQueryableVersions = 1,
        ResetInterval = ResetInterval.Manual,
    },
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

Création de la définition de statistique de destination

Créez ensuite une définition de statistique pour le titre, qui sert de destination d’agrégation. Spécifiez la définition de statistique des joueurs comme source d’agrégation de la définition de statistique du titre :

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "communityStat",
    AuthenticationContext = context,
    EntityType = "title",
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
    AggregationSources = new string[] { "sourceStat" };
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

REMARQUE : Définissez

EntityType sur title et AggregationSources pour qu’il référence la statistique définie au niveau du joueur. Une fois la statistique communautaire créée, toutes les mises à jour effectuées au niveau du joueur commencent à être agrégées au niveau du titre. Le système agrège uniquement les nouvelles mises à jour. Si la statistique source existe depuis un certain temps, le système ne reporte pas ces valeurs historiques au niveau du titre.

Lecture des statistiques communautaires du titre

Pour obtenir les scores actuels de la statistique au niveau du titre, lisez les statistiques de l’entité de titre :

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

GetStatisticsRequest request = new GetStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<title id in hex>",
        Type = "title"
    },
};

PlayFabResult<GetStatisticsResponse> result = await statsAPI.GetStatisticsAsync(request); 

Statistiques communautaires au niveau du groupe

Les statistiques communautaires au niveau du groupe vous permettent d’agréger les actions des joueurs au sein d’un groupe spécifique, comme un clan ou une guilde. Cette agrégation est utile pour des scénarios tels qu’un défi de clan, dans lequel les membres travaillent collectivement à un objectif commun.

Création de la définition de statistique de destination

Créez une définition de statistique avec EntityType défini sur group. Spécifiez la définition de statistique des joueurs comme source d’agrégation :

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);
CreateStatisticDefinitionRequest statDefinitionRequest = new CreateStatisticDefinitionRequest()
{
    Name = "groupCommunityStat",
    AuthenticationContext = context,
    EntityType = "group",
    Columns = new List<StatisticColumn>()
    {
        new StatisticColumn()
        {
            Name = "Eliminations",
            AggregationMethod = StatisticAggregationMethod.Sum,
        },
    },
    AggregationSources = new string[] { "sourceStat" }
};

PlayFabResult<PlayFab.LeaderboardsModels.EmptyResponse> createStatDefResult = await statsAPI.CreateStatisticDefinitionAsync(statDefinitionRequest);

La définition de statistique source (au niveau du joueur) est la même que celle utilisée pour les statistiques communautaires au niveau du titre. Vous pouvez réutiliser une définition de statistique source existante.

Mise à jour de la statistique source

Lors de la mise à jour de la statistique source d’un joueur pour une agrégation au niveau du groupe, spécifiez l’entité de groupe cible dans la propriété AggregationTargetEntityKeys de l’objet StatisticUpdate. Cette propriété indique à PlayFab l’entité de groupe dans laquelle agréger la mise à jour.

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

UpdateStatisticsRequest request = new UpdateStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<player entity id>",
        Type = "title_player_account"
    },
    Statistics = new List<StatisticUpdate>()
    {
        new StatisticUpdate()
        {
            Name = "sourceStat",
            Scores = new List<string> { "5" },
            AggregationTargetEntityKeys = new List<PlayFab.LeaderboardsModels.EntityKey>()
            {
                new PlayFab.LeaderboardsModels.EntityKey()
                {
                    Id = "<group entity id>",
                    Type = "group"
                }
            }
        }
    }
};

PlayFabResult<UpdateStatisticsResponse> result = await statsAPI.UpdateStatisticsAsync(request);

Pour les statistiques communautaires au niveau du titre, AggregationTargetEntityKeys n’est pas requis, car le titre est la cible d’agrégation par défaut. Pour les statistiques communautaires au niveau du groupe, vous devez spécifier la clé de l’entité de groupe. Actuellement, vous ne pouvez spécifier qu’une seule clé d’entité dans AggregationTargetEntityKeys.

Lecture des statistiques communautaires du groupe

Pour obtenir les scores actuels de la statistique communautaire du groupe, lisez les statistiques de l’entité de groupe :

// Use the PlayFabAuthenticationContext to call the API
PlayFabProgressionInstanceAPI statsAPI = new PlayFabProgressionInstanceAPI(context);

GetStatisticsRequest request = new GetStatisticsRequest()
{
    AuthenticationContext = context,
    Entity = new PlayFab.LeaderboardsModels.EntityKey()
    {
        Id = "<group entity id>",
        Type = "group"
    },
};

PlayFabResult<GetStatisticsResponse> result = await statsAPI.GetStatisticsAsync(request);

Restrictions

Vous ne pouvez spécifier qu’une seule source d’agrégation pour la statistique communautaire.
Vous ne pouvez pas spécifier de configuration de version pour la statistique communautaire. La configuration de version que vous spécifiez pour la statistique source s’applique également à la statistique communautaire.
L’EntityType de la statistique communautaire doit être title ou group.
Vous ne pouvez pas utiliser l’agrégation Last pour aucune des colonnes.
Vous ne pouvez spécifier qu’une seule clé d’entité dans AggregationTargetEntityKeys lors de la mise à jour de la statistique source.

XBOX Services

PlayFab

Statistiques communautaires au niveau du titre

Création de la définition de statistique source

Création de la définition de statistique de destination

Lecture des statistiques communautaires du titre

Statistiques communautaires au niveau du groupe

Création de la définition de statistique de destination

Mise à jour de la statistique source

Lecture des statistiques communautaires du groupe

Restrictions

Voir aussi

​Statistiques communautaires au niveau du titre

​Création de la définition de statistique source

​Création de la définition de statistique de destination

​Lecture des statistiques communautaires du titre

​Statistiques communautaires au niveau du groupe

​Création de la définition de statistique de destination

​Mise à jour de la statistique source

​Lecture des statistiques communautaires du groupe

​Restrictions

​Voir aussi

Statistiques communautaires au niveau du titre

Création de la définition de statistique source

Création de la définition de statistique de destination

Lecture des statistiques communautaires du titre

Statistiques communautaires au niveau du groupe

Création de la définition de statistique de destination

Mise à jour de la statistique source

Lecture des statistiques communautaires du groupe

Restrictions

Voir aussi