Clasificaciones

Aprende a usar Clasificaciones en una experiencia de producto gamificada con Trophy.

​

¿Qué son las Clasificaciones?

Las Clasificaciones son competencias sociales entre usuarios de tu aplicación. Usa clasificaciones para aumentar el engagement y fomentar la interacción social.

​

Tipos de Clasificaciones

En esta sección describimos los diferentes tipos de clasificaciones soportadas en 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 indefinidamente, o hasta la fecha de finalización configurada.

Usa clasificaciones perpetuas cuando quieras crear rankings históricos de toda la actividad del usuario.

​

Clasificaciones Recurrentes

Las clasificaciones recurrentes pueden configurarse 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 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 recurrente de forma individual y proporciona APIs para obtener datos de clasificación de ejecuciones históricas.

Recomendamos usar clasificaciones recurrentes en lugar de perpetuas cuando sea posible, ya que las clasificaciones recurrentes dan a los nuevos usuarios las mismas oportunidades de competir con los usuarios existentes, ayudando a evitar que las clasificaciones se vuelvan obsoletas.

​

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 se eligen los ganadores aproximadamente 12 horas después de que terminen naturalmente en UTC, para permitir que los usuarios en 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 calendario 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 clasificar a los participantes de diferentes formas 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é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 sus puntos totales.

Utiliza una clasificación de puntos si deseas clasificar a los usuarios según una combinación de métricas, logros u otras funcionalidades de Trophy.

​

Clasificaciones por Racha

Las clasificaciones por racha ordenan a los usuarios según la longitud de su racha actual.

Las clasificaciones por racha solo pueden ser perpetuas.

​

Desgloses de Clasificación

Si tienes una base de usuarios amplia, la mejor práctica es dividir a los participantes de la clasificación en grupos más pequeños y socialmente conectados. Esto suele generar mayor engagement que cuando se usan clasificaciones globales.

Las clasificaciones en Trophy pueden configurarse para agrupar usuarios en grupos más pequeños según uno o más atributos de usuario personalizados.

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 uno o más atributos de usuario en el campo ‘Breakdown Attributes’.

Trophy comenzará automáticamente a agrupar usuarios en clasificaciones más pequeñas según los valores de los atributos seleccionados para cada usuario.

Para obtener las clasificaciones de un grupo particular de usuarios con un valor de atributo específico, usa el API de clasificaciones, especificando un filtro de atributo en el parámetro userAttributes de la siguiente manera:

cURL

curl --request GET \
  --url https://api.trophy.so/v1/leaderboards/{key}?userAttributes=city:london \
  --header 'X-API-KEY: <api-key>'

Para obtener las clasificaciones de un grupo particular de usuarios con una combinación específica de atributos de usuario, pasa múltiples filtros key:value delimitados por comas en userAttributes de la siguiente manera:

cURL

curl --request GET \
  --url https://api.trophy.so/v1/leaderboards/{key}?userAttributes=region:southeast,city:london \
  --header 'X-API-KEY: <api-key>'

Cuando se proporcionan múltiples filtros userAttributes, todos los filtros deben coincidir para que un usuario sea incluido en las clasificaciones devueltas.

​

Fechas de Inicio y Fin

Usa fechas de inicio y fin para controlar la ventana de tiempo dentro de la cual las clasificaciones están ordenando activamente a los usuarios.

​

Fechas de inicio

Las clasificaciones en Trophy se pueden configurar para comenzar en una fecha futura de tu elección. Esto suele ser útil para dar tiempo a realizar cambios o ajustes de último momento antes de que las clasificaciones empiecen a clasificar 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 las clasificaciones se finalizarán y se elegirán los ganadores.

Debido a las diferencias en 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 la puntuación del rango más bajo para unirse a la clasificación.

Optamos por limitar el tamaño de las clasificaciones para ayudar a guiar a los clientes en 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 los usuarios nuevos. Para evitar esto, mantén tus clasificaciones pequeñas dividiéndolas en clasificaciones más pequeñas usando atributos de desglose.

Para obtener más información sobre los efectos negativos en las clasificaciones globales, lee esta publicación del blog.

La única excepción a esto es cuando se usan atributos de desglose para agrupar a los participantes en cohortes más pequeñas. Al usar atributos de desglose, el límite de participantes se aplica a cada grupo, no al total general.

​

Crear Clasificaciones

Para crear una clasificación, dirígete a la página de clasificaciones en el panel de Trophy y presiona el botón Nueva Clasificación.

1. Ingresa un nombre

   Elige un nombre para la clasificación.

2. Ingresa una clave única

   Ingresa 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 de la racha actual
4. Establece el máximo de participantes

   Elige el número máximo de participantes que la clasificación debe admitir. 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. Presiona guardar

   Presiona guardar y dirígete a la página de configuración para establecer fechas de inicio y finalización, programaciones de clasificaciones recurrentes y más.

​

Gestionar 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 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 podrán unirse a ellas.

Una vez que esté listo para que los usuarios comiencen a participar, puede configurarla como Active. Esto significa que Trophy comenzará a rastrear la actividad de los usuarios e inscribirlos en las clasificaciones.

Las clasificaciones que se han configurado con una fecha de inicio en el futuro no pueden activarse, solo pueden estar en estado Scheduled. Una vez que haya pasado la fecha de inicio, Trophy las activará automáticamente como 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 de los usuarios. Una vez que una clasificación haya 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 está archivada, solo puede restaurarse contactando con soporte.

​

Mostrar Clasificaciones

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

​

Analíticas de Clasificación

Trophy incluye analíticas integradas para ayudarle a entender cómo los usuarios interactúan con sus clasificaciones.

​

Participantes Únicos Totales

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 sus 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. Esto es útil para tener una idea de cuán 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. Esto es útil para entender cuán 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 cuán agrupados o dispersos están los usuarios, y qué secciones de las clasificaciones son las más competitivas.

​

Preguntas Frecuentes

¿Cuántos participantes puede tener 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.

No veo una opción de clasificación semanal, ¿cómo puedo configurar una?

Trophy permite ejecutar clasificaciones recurrentes 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 cómo crear clasificaciones semanales.

​

Obtener Soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por correo electrónico. ¡Estamos aquí para ayudarte!