¿Qué son las Clasificaciones?
Las Clasificaciones son competencias sociales entre usuarios de tu aplicación. Usa clasificaciones para aumentar la participación y fomentar la interacción social.
Tipos de Clasificaciones
En esta sección describimos los diferentes tipos de clasificaciones compatibles con Trophy y cuándo usar cada una.Clasificaciones Perpetuas
Las clasificaciones perpetuas nunca se reinician. Una vez iniciadas, rastrean y clasifican continuamente el progreso de los usuarios a lo largo del tiempo de forma permanente, o hasta la fecha de finalización configurada. Usa clasificaciones perpetuas cuando quieras crear clasificaciones históricas de la actividad de los usuarios.Clasificaciones Recurrentes
Las clasificaciones recurrentes se pueden configurar para reiniciarse después de cualquier número arbitrario de días, meses o años. En Trophy, cada instancia de una clasificación recurrente se llama ‘ejecución’. Por ejemplo, una clasificación mensual tendría 12 ejecuciones en un año, pero una clasificación diaria tendrían ejecuciones en un mes donde n es el número de días en un mes determinado.
Trophy rastrea las clasificaciones en cada ejecución de una clasificación recurrente de forma individual y proporciona APIs para obtener datos de clasificación de ejecuciones históricas.
Manejo de zonas horarias
Si has rastreado las zonas horarias de tus usuarios con Trophy, estas se utilizarán para garantizar que cada usuario tenga las mismas oportunidades de ganar sin importar dónde se encuentre en el mundo. En la práctica, esto significa que las clasificaciones se finalizan y los ganadores se eligen aproximadamente 12 horas después de que terminen naturalmente en UTC para permitir que los usuarios de todas las zonas horarias hagan su último esfuerzo.Consejos para clasificaciones semanales
Para crear una clasificación semanal, configura una clasificación recurrente con un cronograma de 7 días y establece la fecha de inicio en el próximo primer día de la semana. Mientras esperas a que llegue la fecha de inicio, la clasificación estará en estadoscheduled y se activará automáticamente en la fecha de inicio.
Lógica de clasificación
Las clasificaciones en Trophy son configurables para ordenar a los participantes de diferentes maneras y así admitir casos de uso comunes.Métodos de clasificación
El método de clasificación de una clasificación determina en qué dimensión se ordenarán los participantes.
Clasificaciones por métrica
Las clasificaciones por métrica están vinculadas a una Métrica existente de Trophy y ordenan a los usuarios según su valor métrico total. Utiliza clasificaciones por métrica si solo deseas ordenar a los usuarios según una única interacción.Clasificaciones por puntos
Las clasificaciones por puntos están vinculadas a un Sistema de Puntos existente de Trophy y ordenan automáticamente a los usuarios según sus puntos totales. Utiliza una clasificación por puntos si deseas ordenar a los usuarios según una combinación de métricas, logros u otras funciones de Trophy.Clasificaciones de Racha
Las clasificaciones de racha ordenan a los usuarios según la duración de su racha actual.Las clasificaciones de racha solo pueden ser perpetuas.
Desgloses de Clasificación
Si tienes una base de usuarios grande, es una buena práctica dividir a los participantes de la clasificación en grupos más pequeños y socialmente conectados. Esto a menudo genera mayor participación que cuando se usan clasificaciones globales. Las clasificaciones en Trophy se pueden configurar para agrupar usuarios en grupos más pequeños según uno o más atributos de usuario personalizados. Para configurar un desglose de clasificación, dirígete a la página de configuración de la clasificación y crea o selecciona uno o más atributos de usuario en el campo ‘Atributos de Desglose’. Trophy comenzará automáticamente a agrupar usuarios en clasificaciones más pequeñas según los valores de los atributos elegidos para cada usuario.userAttributes de la siguiente manera:
key:value delimitados por comas en userAttributes de la siguiente manera:
Cuando se proporcionan múltiples filtros
userAttributes, todos los filtros deben coincidir
para que un usuario se incluya en las clasificaciones devueltas.Elegibilidad
La elegibilidad controla qué usuarios pueden participar en una clasificación. Úsala cuando una clasificación deba estar abierta solo a un grupo específico de usuarios, por ejemplo, clientes de pago, una región concreta o una cohorte beta. La elegibilidad se basa en atributos de usuario personalizados. Un usuario solo puede participar en una clasificación, y aparecer en sus rankings, si sus atributos cumplen todas las reglas de elegibilidad que establezcas. Las clasificaciones sin reglas de elegibilidad están abiertas a todos los usuarios. Para establecer reglas de elegibilidad, ve a la página de configuración de la clasificación y añade uno o más atributos de usuario, junto con los valores que deben tener los usuarios, en el campo Atributos de usuario de la sección Elegibilidad.
Si estableces varias reglas de elegibilidad, un usuario debe cumplirlas todas
para ser elegible.
Las reglas de elegibilidad solo se pueden cambiar mientras una clasificación está
Inactive. Consulta los
estados de la clasificación.Elegibilidad frente a desgloses
Los desgloses y la elegibilidad usan atributos de usuario, pero cumplen funciones distintas:- Los desgloses dividen a los participantes en grupos más pequeños. Todos los usuarios siguen apareciendo en el ranking, pero dentro de su propio grupo.
- La elegibilidad decide quién puede participar. Los usuarios que no cumplen las reglas quedan excluidos por completo.
Fechas de inicio y fin
Usa las fechas de inicio y fin para controlar el periodo en el que las clasificaciones clasifican activamente a los usuarios.
Fechas de inicio
Las clasificaciones de Trophy se pueden programar para que comiencen en la fecha futura que elijas. Esto suele ser útil para disponer de tiempo para hacer cambios o ajustes de última hora antes de que las clasificaciones empiecen a ordenar a los usuarios. Las clasificaciones con una fecha de inicio futura quedan programadas y se activan automáticamente en la fecha de inicio que elijas.Fechas de fin
Las clasificaciones de Trophy pueden tener fecha de fin. Si estableces una fecha de fin en una clasificación, después de esa fecha pasará al estadofinished, las posiciones se finalizarán y se elegirán los ganadores.
Debido a las diferencias entre zonas horarias, las clasificaciones pueden
finalizarse hasta 12 horas después de la fecha de fin en UTC, para permitir que todos los usuarios lleguen
a la fecha de fin según su reloj local.
Restricciones de tiempo
Además de las fechas de inicio y fin, las clasificaciones se pueden configurar con restricciones de tiempo. Cuando las restricciones de tiempo están habilitadas, las posiciones de la clasificación solo se actualizan durante el periodo configurado. Las restricciones de tiempo son útiles al crear clasificaciones para eventos o promociones de duración limitada que se ejecutan durante un periodo específico. Las restricciones de tiempo funcionan en todas las clasificaciones, incluidas las clasificaciones recurrentes. Cuando una clasificación recurrente tiene una restricción de tiempo, esta se aplica a cada ciclo de la clasificación.Configuración de restricciones de tiempo
Para establecer restricciones de tiempo en una clasificación, ve a la página de configuración de la clasificación y activa el interruptor con la etiqueta ‘Restringir a franja horaria’. Esto mostrará dos campos: una hora de inicio y una hora de fin.- Si estableces solo una hora de inicio, las posiciones de la clasificación empezarán a actualizarse únicamente después de esa hora, cada día en que la clasificación esté activa.
- Del mismo modo, si estableces solo una hora de fin, las posiciones de la clasificación dejarán de actualizarse después de esa hora, cada día en que la clasificación esté activa.
- Si estableces una hora de inicio y una de fin, las posiciones de la clasificación solo se actualizarán durante el periodo configurado.

Consideraciones sobre la zona horaria
Las restricciones de tiempo en las clasificaciones se aplican en la hora local de cada participante, según su zona horaria configurada. Esto significa que cada usuario puede participar en la clasificación en cualquier momento dentro de la restricción de tiempo configurada, según su reloj local.Límites de participantes
Las clasificaciones en Trophy tienen un número máximo de participantes predeterminado de 1000. Sin embargo, se puede configurar una clasificación con cualquier número de participantes para admitir casos de uso como Top 100 o similares.
Creación de clasificaciones
Para crear una clasificación, ve a la página de clasificaciones en el panel de Trophy y haz clic en el botón Nueva clasificación.1
Introduce un nombre
Elige un nombre para la clasificación.
2
Introduce una clave única
Introduce una clave de referencia única para la clasificación. Es la que usarás para hacer referencia a la clasificación en el código de tu aplicación.
3
Elige un método de ranking
Elige uno de los métodos con los que la clasificación ordenará a los usuarios:
- Métrica: ordena a los usuarios por el valor total de una métrica elegida
- Puntos: ordena a los usuarios por el total de puntos de un sistema de puntos elegido
- Racha: ordena a los usuarios por la duración de su racha actual
4
Define el máximo de participantes
Elige el número máximo de participantes que debe admitir la clasificación. El
límite superior actual que admite Trophy es de 1000. Lee esta
sección para saber más sobre cómo elegimos este límite.
5
Guarda los cambios
Guarda los cambios y ve a la página de configuración para definir la elegibilidad, las fechas de inicio y fin, los calendarios de clasificaciones recurrentes y mucho más.
Gestión de clasificaciones
Las clasificaciones en Trophy tienen varios estados que te ayudan a controlar cuándo y cómo pueden unirse los usuarios.Estados de la clasificación
Las clasificaciones pueden tener uno de los siguientes estados:InactiveScheduledActiveFinished
Inactive. Mientras están inactivas, se puede cambiar cualquier propiedad o ajuste de la clasificación; no serán visibles para los usuarios y estos no podrán unirse a ellas.
Cuando quieras que los usuarios empiecen a participar, puedes establecerla como Active. Esto significa que Trophy empezará a registrar la actividad de los usuarios e incluirlos en las clasificaciones.
Las clasificaciones configuradas con una fecha de inicio en el futuro no se pueden activar; solo pueden estar en estado Scheduled. Cuando pase la fecha de inicio, Trophy las pasará automáticamente a Active y empezará a aceptar participantes.
Si una clasificación tiene una fecha de finalización, cuando esta pase, Trophy la pasará automáticamente al estado Finished y dejará de monitorizar la actividad de los usuarios. Una vez finalizada, la clasificación no será visible para los usuarios, pero aún puedes consultar las API para obtener las posiciones de ejecuciones históricas.
Mostrar clasificaciones
Analíticas de la clasificación
Trophy incluye analíticas integradas para ayudarte a entender cómo interactúan los usuarios con tus clasificaciones.
Total de participantes únicos
Este gráfico muestra cuántos usuarios únicos han participado en cualquier ejecución de una clasificación a lo largo del tiempo. Es útil para entender cuántos de tus usuarios participan realmente en las clasificaciones y cómo influyen en ello los límites de participantes.
Usuarios activos
Este gráfico muestra el número de usuarios que han cambiado de posición al menos una vez en una clasificación determinada. Es útil para hacerse una idea de lo competitivo que es el usuario promedio en una clasificación concreta.
Cambios de rango
Este gráfico muestra el número total de cambios de rango en una clasificación particular a lo largo del tiempo. Esto es útil para entender qué tan competitivos son los usuarios en general.
Distribución de puntuaciones
Este gráfico es un histograma de las puntuaciones de los usuarios en una clasificación particular. Esto es útil para tener una idea de qué tan agrupados o dispersos están los usuarios, y qué secciones de las clasificaciones son las más competitivas.
Preguntas frecuentes
¿Cuántos participantes pueden estar en una clasificación al mismo tiempo?
¿Cuántos participantes pueden estar en una clasificación al mismo tiempo?
Limitamos las clasificaciones a 1,000 participantes.Lee más sobre esto en la sección dedicada de esta página.
¿Puedo limitar una clasificación a determinados usuarios?
¿Puedo limitar una clasificación a determinados usuarios?
Sí. Añade reglas de elegibilidad a la clasificación mediante atributos
de usuario personalizados, y solo los usuarios con los valores de atributo correspondientes podrán
participar y aparecer en la clasificación.
No veo una opción de clasificación semanal, ¿cómo puedo configurar una?
No veo una opción de clasificación semanal, ¿cómo puedo configurar una?
Trophy admite la ejecución de clasificaciones repetitivas en cualquier número
arbitrario de días. Así que una clasificación semanal sería simplemente una clasificación que se repite cada 7
días. Lee esta sección para más consejos sobre
la creación de clasificaciones semanales.