Esta guía describe el proceso completo para añadir una funcionalidad de rachas a tu aplicación web o móvil usando Trophy.
A modo ilustrativo, utilizaremos el ejemplo de una plataforma de estudio que emplea una racha diaria para incentivar y recompensar a los usuarios por ver tarjetas de estudio.
Requisitos previos
- Una cuenta de Trophy
- Aproximadamente 10 minutos
Configuración de Trophy
En Trophy, las Métricas son los componentes fundamentales de la gamificación y modelan las diferentes interacciones que los usuarios realizan con tu producto.
En esta guía, la interacción que nos interesa es flashcards-viewed, pero puedes crear una métrica que mejor represente la interacción desde la cual quieres generar rachas.
En el panel de Trophy, dirígete a la página de métricas y crea una métrica.
Una vez que hayas creado tu métrica, dirígete a la página de rachas y selecciona la frecuencia de racha que deseas (diaria, semanal o mensual).
Luego añade tu métrica a las condiciones de racha y establece el umbral que los usuarios deben cumplir (por ejemplo, al menos 1 para extender su racha en cada período).
También puedes añadir múltiples métricas y elegir si los usuarios deben cumplir todas o solo una—consulta la documentación de condiciones de racha para más detalles.
En Trophy puedes hacer seguimiento de las interacciones de los usuarios enviando Eventos desde tu código a las API de Trophy asociados a una métrica específica.
Cuando se registran eventos para un usuario específico, Trophy verificará automáticamente si han cumplido las condiciones de su racha para el período actual y actualizará la racha del usuario en consecuencia.
Esto es lo que hace que crear experiencias gamificadas con Trophy sea tan fácil: hace todo el trabajo por ti entre bastidores.
Instalación del SDK de Trophy
Para interactuar con Trophy desde tu código utilizarás el SDK de Trophy disponible en la mayoría de los principales lenguajes de programación.
Instala el SDK de Trophy:
A continuación, obtén tu clave API desde la página de integración de Trophy y agrégala como una variable de entorno solo del lado del servidor.
Asegúrate de no exponer tu clave API en código del lado del cliente.
Seguimiento de Interacciones de Usuarios
Para hacer seguimiento de un evento (interacción de usuario) asociado a tu métrica, utiliza la API de cambio de métrica.
Al incluir la zona horaria del usuario en el atributo tz, Trophy
hará seguimiento automático de las rachas según el reloj local del usuario y gestionará
casos límite complicados donde los usuarios cambian de zona horaria.
La respuesta a esta llamada API es el conjunto completo de cambios a cualquier funcionalidad que hayas creado con Trophy, incluyendo los datos más recientes sobre la racha del usuario.
Valida que esto funciona verificando el panel de control de Trophy.
Visualización de Rachas
Tienes varias opciones para mostrar rachas en tu aplicación. Aquí veremos las opciones más comunes.
Notificaciones Emergentes
Podemos usar la respuesta de la API de cambio de métrica para mostrar notificaciones emergentes (o ‘toasts’) cuando el usuario extiende su racha.
Aquí hay un ejemplo de esto en acción:
Mostrar Rachas de Usuario
Para obtener datos sobre la racha de un usuario, usa la API de racha de usuario.
Esta API no solo devuelve datos sobre la racha actual del usuario como length y expires, sino que también puede devolver datos históricos de rachas que se pueden usar para mostrar cualquier tipo de interfaz de racha que desees a través del parámetro historyPeriods.
Aquí hay un ejemplo de un calendario de rachas estilo git construido usando los datos de la respuesta anterior:
Consulta este repositorio de ejemplo para ver un componente React que gestiona esta interfaz usando datos de Trophy.
Analíticas
La página de rachas en Trophy muestra datos sobre rachas activas, la longitud promedio de las rachas y las rachas más largas.
Congelación de Rachas
Trophy también admite congelación de rachas, lo que puede ayudar a evitar que los usuarios pierdan su racha si accidentalmente se pierden un periodo.
Obtén más información sobre la congelación de rachas en la documentación dedicada de congelación de rachas.
Obtener Soporte
¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por correo electrónico. ¡Estamos aquí para ayudar!