Estadísticas de la comunidad

Las estadísticas de la comunidad son una potente herramienta para aumentar la interacción y fomentar la inversión de los jugadores en su juego. Al agregar estadísticas a nivel del título del juego, los desarrolladores pueden crear objetivos y desafíos compartidos que fomentan la colaboración entre los jugadores. Este enfoque transforma las acciones de los jugadores individuales en contribuciones a objetivos de toda la comunidad, impulsando una interacción sostenida a medida que los jugadores trabajan juntos para lograr hitos colectivos. Los jugadores sienten que sus contribuciones individuales importan a la comunidad en general, lo que refuerza su conexión tanto con el juego como con los demás jugadores. Por ejemplo, imagine implementar una batalla contra un jefe global en la que toda la base de jugadores debe conseguir colectivamente 10 millones de eliminaciones en una semana para desbloquear un evento especial dentro del juego. A medida que los jugadores ven avanzar la barra de progreso de la comunidad con cada una de sus contribuciones, se sienten motivados para ayudar a alcanzar el objetivo. Este comportamiento crea un potente bucle de retroalimentación de inversión y participación, especialmente cuando se combina con actualizaciones de progreso en tiempo real y recompensas por hitos a lo largo del camino. Con PlayFab, puede administrar fácilmente las estadísticas de la comunidad definiendo dos estadísticas: una a nivel de jugador (origen de agregación) y otra a nivel de título o de grupo (destino de agregación). Las actualizaciones realizadas en las estadísticas de los jugadores se agregan automáticamente a la estadística de destino. Para recuperar la puntuación actual de la comunidad, se leen las estadísticas de la entidad de destino. PlayFab admite dos tipos de estadísticas de la comunidad:

A nivel de título: agrega todas las actualizaciones de los jugadores en una única estadística de todo el título. Ideal para objetivos globales compartidos por toda la base de jugadores.
A nivel de grupo: agrega las actualizaciones de los jugadores en una estadística de entidad de grupo. Ideal para desafíos de clanes, objetivos de gremios u objetivos por equipos en los que subconjuntos de jugadores trabajan hacia una meta compartida.

Estadísticas de la comunidad a nivel de título

Creación de la definición de estadística de origen

Primero, cree una definición de estadística para los jugadores, que actúa como origen de agregación:

// 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);

Creación de la definición de estadística de destino

A continuación, cree una definición de estadística para el título, que actúa como destino de agregación. Especifique la definición de estadística del jugador como origen de agregación para la definición de estadística del título:

// 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);

NOTA: Establezca

EntityType en title y AggregationSources para hacer referencia a la estadística definida a nivel de jugador. Después de crear la estadística de la comunidad, cualquier actualización realizada a nivel de jugador comienza a agregarse a nivel de título. El sistema solo agrega las actualizaciones nuevas. Si la estadística de origen existe desde hace tiempo, el sistema no reintegra esos valores históricos a nivel de título.

Lectura de las estadísticas de la comunidad del título

Para obtener las puntuaciones actuales de la estadística a nivel de título, lea las estadísticas de la entidad de título:

// 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); 

Estadísticas de la comunidad a nivel de grupo

Las estadísticas de la comunidad a nivel de grupo le permiten agregar las acciones de los jugadores dentro de un grupo específico, como un clan o un gremio. Esta agregación es útil para escenarios como un desafío de clan en el que los miembros trabajan colectivamente hacia un objetivo compartido.

Creación de la definición de estadística de destino

Cree una definición de estadística con EntityType establecido en group. Especifique la definición de estadística del jugador como origen de agregación:

// 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 definición de estadística de origen (a nivel de jugador) es la misma que la que se usa para las estadísticas de la comunidad a nivel de título. Puede reutilizar una definición de estadística de origen existente.

Actualización de la estadística de origen

Al actualizar la estadística de origen de un jugador para la agregación a nivel de grupo, especifique la entidad de grupo de destino en la propiedad AggregationTargetEntityKeys del objeto StatisticUpdate. Esta propiedad indica a PlayFab a qué entidad de grupo agregar la actualización.

// 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);

Para las estadísticas de la comunidad a nivel de título, AggregationTargetEntityKeys no es necesario porque el título es el destino de agregación predeterminado. Para las estadísticas de la comunidad a nivel de grupo, debe especificar la clave de la entidad de grupo. Actualmente, solo puede especificar una clave de entidad en AggregationTargetEntityKeys.

Lectura de las estadísticas de la comunidad del grupo

Para obtener las puntuaciones actuales de la estadística de la comunidad del grupo, lea las estadísticas de la entidad de grupo:

// 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);

Restricciones

Solo puede especificar un origen de agregación para la estadística de la comunidad.
No puede especificar la configuración de versiones para la estadística de la comunidad. La configuración de versiones que especifique para la estadística de origen también se aplica a la estadística de la comunidad.
El EntityType de la estadística de la comunidad debe ser title o group.
No puede usar la agregación Last en ninguna de las columnas.
Solo puede especificar una clave de entidad en AggregationTargetEntityKeys al actualizar la estadística de origen.

XBOX Services

PlayFab

Estadísticas de la comunidad a nivel de título

Creación de la definición de estadística de origen

Creación de la definición de estadística de destino

Lectura de las estadísticas de la comunidad del título

Estadísticas de la comunidad a nivel de grupo

Creación de la definición de estadística de destino

Actualización de la estadística de origen

Lectura de las estadísticas de la comunidad del grupo

Restricciones

Consulte también

​Estadísticas de la comunidad a nivel de título

​Creación de la definición de estadística de origen

​Creación de la definición de estadística de destino

​Lectura de las estadísticas de la comunidad del título

​Estadísticas de la comunidad a nivel de grupo

​Creación de la definición de estadística de destino

​Actualización de la estadística de origen

​Lectura de las estadísticas de la comunidad del grupo

​Restricciones

​Consulte también

Estadísticas de la comunidad a nivel de título

Creación de la definición de estadística de origen

Creación de la definición de estadística de destino

Lectura de las estadísticas de la comunidad del título

Estadísticas de la comunidad a nivel de grupo

Creación de la definición de estadística de destino

Actualización de la estadística de origen

Lectura de las estadísticas de la comunidad del grupo

Restricciones

Consulte también