Saltar al contenido principal

​
¿Qué son las Clasificaciones?

Las clasificaciones son competiciones sociales entre usuarios de tu aplicación. Utiliza las 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 para siempre, o hasta la fecha de finalización configurada. Utiliza clasificaciones perpetuas cuando quieras crear clasificaciones de actividad de usuarios de todos los tiempos.

​
Clasificaciones Repetitivas

Las clasificaciones repetitivas 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 repetitiva se denomina ‘ejecución’. Por ejemplo, una clasificación mensual tendría 12 ejecuciones en un año, pero una clasificación diaria tendría n 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 repetitiva de forma individual y proporciona APIs para obtener datos de clasificación de ejecuciones históricas.
Recomendamos usar clasificaciones repetitivas en lugar de perpetuas siempre que sea posible, ya que las clasificaciones repetitivas brindan a los nuevos usuarios las mismas oportunidades de competir con los usuarios existentes, lo que ayuda a evitar que las clasificaciones se vuelvan obsoletas.

​
Gestión 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, lo que permite a los usuarios de todas las zonas horarias hacer 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 estado scheduled 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 varias formas diferentes y 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étricas

Las clasificaciones de métricas están vinculadas a una Métrica existente de Trophy y clasifican a los usuarios según su valor total de métrica. Utiliza clasificaciones de métricas si solo deseas clasificar a los usuarios según una única interacción.

​
Clasificaciones por puntos

Las clasificaciones de puntos están vinculadas a un Sistema de Puntos existente de Trophy y clasifican automáticamente a los usuarios según su total de puntos. Utiliza una clasificación de puntos si deseas clasificar a los usuarios según una combinación de métricas, logros u otras características de Trophy.

​
Clasificaciones por Racha

Las clasificaciones de racha ordenan a los usuarios según la longitud de su racha actual.
Las clasificaciones de racha solo pueden ser perpetuas.

​
Desglose de Clasificaciones

Si tienes una gran base de usuarios, es una buena práctica dividir a los participantes de la clasificación en grupos más pequeños y socialmente conectados. Esto suele generar mayor participación que el uso de clasificaciones globales. Las clasificaciones en Trophy pueden configurarse para agrupar a los usuarios en grupos más pequeños según un atributo de usuario personalizado específico.
Al usar desgloses de clasificación, los límites de participantes se aplican a nivel de grupo, no de forma general.
Para configurar un desglose de clasificación, dirígete a la página de configuración de la clasificación y crea o selecciona tu atributo de usuario en el campo ‘Atributo de Desglose’. Trophy comenzará automáticamente a agrupar a los usuarios en clasificaciones más pequeñas según los valores de tu atributo elegido para cada usuario.
Para obtener las clasificaciones de un grupo particular de usuarios con un valor de atributo específico, utiliza la API de clasificaciones, especificando el valor del atributo en el parámetro userAttributes de la siguiente manera: 
curl --request GET \
  --url https://api.trophy.so/v1/leaderboards/{key}?userAttributes=city:london \
  --header 'X-API-KEY: <api-key>'
Si deseas obtener las clasificaciones de un grupo particular de usuarios con una combinación específica de atributos de usuario, crea un nuevo atributo para rastrear la combinación y úsalo como tu atributo de desglose de la siguiente manera: 
curl --request GET \
  --url https://api.trophy.so/v1/leaderboards/{key}?userAttributes=region_city:southeast_london \
  --header 'X-API-KEY: <api-key>'

​
Fechas de Inicio y Fin

Utiliza las fechas de inicio y fin para controlar el período durante el cual las clasificaciones están activamente ordenando a los usuarios.

​
Fechas de Inicio

Las clasificaciones en Trophy se pueden configurar para que comiencen en una fecha futura de tu elección. Esto suele ser útil para permitir tiempo para cambios o ajustes de último momento antes de que las clasificaciones empiecen a rankear usuarios. Las clasificaciones con una fecha de inicio en el futuro están programadas y se activan automáticamente en la fecha de inicio que elijas.

​
Fechas de Finalización

Las clasificaciones en Trophy pueden tener fechas de finalización. Si estableces una fecha de finalización en una clasificación, después de esa fecha entrará en estado finished y los rankings se finalizarán y se elegirán los ganadores.
Debido a diferencias en las zonas horarias, las clasificaciones pueden finalizarse hasta 12 horas después de la fecha de finalización en UTC para permitir que todos los usuarios alcancen la fecha de finalización según su reloj local.

​
Límites de Participantes

Las clasificaciones en Trophy tienen un número máximo de participantes de 1,000. Sin embargo, una clasificación puede configurarse para tener cualquier número arbitrario de participantes para soportar casos de uso como Top 100 o similares.
Si una clasificación ya tiene un número de participantes que coincide con su máximo configurado, los nuevos usuarios tendrán que superar el puntaje del rango más bajo para unirse a la clasificación.
Elegimos limitar el tamaño de las clasificaciones para ayudar a guiar a los clientes sobre las mejores prácticas.Tradicionalmente, las clasificaciones con muchos participantes no logran involucrar a los usuarios más allá del 1% superior, y tienen un impacto negativo en los usuarios de la mitad inferior, particularmente en usuarios nuevos. Para evitar esto, mantén tus clasificaciones pequeñas dividiéndolas en clasificaciones más reducidas utilizando atributos de desglose.Para obtener más información sobre los efectos negativos en las clasificaciones globales, lee esta publicación de blog.
La única excepción a esto es cuando se utilizan atributos de desglose para agrupar a los participantes en cohortes más pequeños. Al usar atributos de desglose, el límite de participantes se aplica a cada grupo, no de forma general.

​
Crear 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. Esto es lo que usarás para referenciar la clasificación en el código de tu aplicación.
3

Elige un método de clasificación

Elige uno de los métodos por el cual la clasificación clasificará a los usuarios:
  • Métrica: Clasifica a los usuarios por el valor total de una métrica elegida
  • Puntos: Clasifica a los usuarios por el total de puntos en un sistema de puntos elegido
  • Racha: Clasifica a los usuarios por la longitud actual de su racha
4

Establece el máximo de participantes

Elige el número máximo de participantes que debería soportar la clasificación. El límite superior actual admitido por Trophy es de 1,000. Lee esta sección para obtener más información sobre cómo elegimos este límite.
5

Guarda los cambios

Guarda y ve a la página de configuración para establecer fechas de inicio y finalización, programaciones de clasificaciones repetidas y más.

​
Administrar Clasificaciones

Las clasificaciones en Trophy tienen varios estados para ayudarte a controlar cuándo y cómo los usuarios pueden unirse a ellas.

​
Estados de la Clasificación

Las clasificaciones pueden tener uno de los siguientes estados:
  • Inactive
  • Scheduled
  • Active
  • Finished
  • Archived
Todas las clasificaciones nuevas se crean como Inactive. Mientras están inactivas, se puede cambiar cualquier propiedad o configuración de la clasificación, no serán visibles para los usuarios y los usuarios no pueden unirse a ellas. Una vez que esté listo para que los usuarios comiencen a participar, puede hacerla Active. Esto significa que Trophy comenzará a rastrear la actividad de los usuarios e ingresarlos en las clasificaciones. Las clasificaciones que se han configurado con una fecha de inicio en el futuro no pueden activarse, solo pueden ser Scheduled. Una vez que pase la fecha de inicio, Trophy automáticamente las hará Active y comenzará a aceptar participantes. Si una clasificación tiene una fecha de finalización, una vez que haya pasado Trophy la moverá automáticamente al estado Finished y dejará de monitorear la actividad del usuario. Una vez que una clasificación ha finalizado, no será visible para los usuarios, pero aún puede consultar las API para obtener las clasificaciones de ejecuciones históricas. Si decide que ya no necesita una clasificación, puede moverla al estado Archived.
Una vez que una clasificación se archiva, solo puede restaurarse contactando al soporte.

​
Mostrar Clasificaciones

Consulta nuestra guía completa sobre cómo agregar clasificaciones a tu aplicación para más detalles.

​
Analítica de Clasificaciones

Trophy tiene analítica integrada para ayudarte a entender cómo los usuarios interactúan 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. Esto es útil para entender cuántos de tus usuarios realmente participan en las clasificaciones y cómo los límites de participantes están afectando esto.

​
Usuarios Activos

Este gráfico muestra el número de usuarios que han cambiado de rango al menos una vez en una clasificación determinada. Resulta útil para entender qué tan competitivo es el usuario promedio en una clasificación particular.

​
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. Resulta ú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. Resulta útil para entender qué tan agrupados o dispersos están los usuarios, y qué secciones de las clasificaciones son las más competitivas.

​
Preguntas Frecuentes

Limitamos las clasificaciones a 1,000 participantes.Lee más sobre esto en la sección dedicada de esta página.
Trophy permite ejecutar clasificaciones recurrentes cada número arbitrario de días. Por lo tanto, una clasificación semanal sería simplemente una clasificación que se repite cada 7 días. Lee esta sección para obtener más consejos sobre cómo crear clasificaciones semanales.

​
Obtener Soporte

¿Deseas comunicarte con el equipo de Trophy? Contáctanos por correo electrónico. ¡Estamos aquí para ayudarte!