Skip to main content
En este tutorial, explicamos el concepto de control de versiones para las estadísticas. Hay varios casos en los que queremos tener diferentes versiones de una estadística determinada. Por ejemplo, si un juego tiene temporadas, lo más probable es que restablezca las estadísticas cuando comience la nueva temporada. Continuamos con el ejemplo de Creación de una estadística básica. Imagine que nuestro juego de disparos se está volviendo muy popular. Por lo tanto, se introduce el concepto de temporadas. Cada mes, el juego lanza una nueva temporada temática para toda la base de jugadores. Así que queremos mantener estadísticas independientes por temporada.

Creación de una definición de estadística para el control de versiones

En el ejemplo anterior, al crear una definición de estadística, se dio una pista sobre la importancia del parámetro VersionConfiguration para el control de versiones. Aquí, detallamos cómo usarlo y cómo funciona.
La principal diferencia de este ejemplo con respecto a la estadística básica es el parámetro VersionConfiguration. Este parámetro nos permite definir una configuración de MaxQueryableVersions, que especifica cuántas versiones de la misma estadística podemos consultar. En este caso, lo establecemos para consultar 12 versiones. El parámetro ResetInterval define la frecuencia con la que se produce el proceso de restablecimiento. Este proceso implica crear una estadística con la misma configuración que antes pero sin ningún valor, y el parámetro de versión cambia de la siguiente manera: N = N + 1, con N = 0 en el momento de la creación de la definición de estadística. Por ejemplo, supongamos que tenemos una estadística con el parámetro de versión igual a dos con un valor determinado. Ahora incrementamos la versión de esa estadística; el resultado va a ser una nueva estadística con el parámetro de versión igual a tres sin ningún valor. Mientras tanto, la estadística anterior permanece en el sistema para poder consultarse. ResetInterval puede funcionar de varias maneras. En este ejemplo, es mensual, pero se puede cambiar según las necesidades del desarrollador. En este caso concreto, significa que la tabla de clasificación se va a restablecer automáticamente cada mes desde el momento en que se configuró. Admitimos las siguientes estrategias de restablecimiento:
  • Day
  • Hour
  • Manual
  • Month
  • Week
Referencia de API para la creación de una estadística

Incremento de la versión de una estadística

Con esta nueva configuración, podemos tener varias versiones de la misma estadística para diferentes temporadas. Pero ¿qué sucede si necesitamos restablecer manualmente la tabla de clasificación debido a un problema y volver a empezar la temporada? En esos casos, podemos realizar un restablecimiento manual mediante la API. Aquí tiene un ejemplo con el SDK:
Ahora estamos preparados para afrontar cualquier desafío con el control de versiones de las estadísticas. Un aspecto importante aquí es que el número de definiciones de estadísticas que decidamos conservar como versiones se va a medir, ya que usan almacenamiento dentro del servicio. Vea más sobre esto aquí:

Conclusiones

En este tutorial, aprendimos a realizar las siguientes operaciones:
  • Crear una estadística con la estrategia de restablecimiento adecuada
  • Incrementar la versión de una estadística

Consulte también

Última modificación el 28 de agosto de 2026