Saltar al contenido principal

¿Qué son las rachas?

Una racha es un período de días, semanas o meses consecutivos en los que un usuario ha realizado una acción clave en tu plataforma. Se ha demostrado que las rachas aumentan de forma significativa la retención, en especial cuando la acción del usuario que se mide se alinea con el valor central de tu producto.

Frecuencia de la racha

Las rachas en Trophy pueden ser diarias, semanales o mensuales. Esto significa que un usuario debe cumplir sus condiciones de racha al menos una vez cada día, semana o mes natural para mantener su racha. Si has configurado zonas horarias para tus usuarios, Trophy hará un seguimiento automático de la racha de cada usuario en su zona horaria local (incluso cuando cambien de zona horaria) y mantendrá las rachas intactas.
Trophy calcula automáticamente los datos de racha para cada frecuencia de racha, por lo que puedes cambiar de frecuencia en cualquier momento.

Condiciones de la racha

En Trophy puedes definir los umbrales que un usuario debe alcanzar para extender su racha según tus Métricas configuradas. Puedes elegir qué métricas forman parte de tu racha y, para las que elijas, establecer un umbral personalizado que los usuarios deben alcanzar.
Al combinar métricas, puedes elegir entre dos modos de evaluación:
  • ALL significa que el usuario debe alcanzar el umbral de todas las métricas para extender su racha
  • OR significa que el usuario solo tiene que alcanzar el umbral de una de tus métricas para extender su racha
De este modo, puedes diseñar la lógica de tu racha para que se ajuste al caso de uso de tu aplicación.

Días libres

En las rachas diarias, puedes marcar días concretos de la semana como días libres en la página de rachas del panel de Trophy. Esos días no cuentan para la racha: los usuarios todavía pueden extender su racha si están activos, pero no estar activos en un día libre no la romperá.
Debes dejar al menos un día que cuente para la racha. Las rachas semanales y mensuales ignoran los días libres. A diferencia de las congelaciones de racha, los días libres no se consumen. Se aplican cada semana hasta que los cambies. Si has habilitado la personalización de rachas, los usuarios pueden anular los días libres predeterminados mediante las preferencias de usuario.

Congelaciones de racha

Las congelaciones de racha ayudan a los usuarios a conservar sus rachas durante más tiempo, ya que les permiten omitir un número determinado de períodos sin que la racha vuelva a cero. Así, las rachas siguen siendo motivadoras aunque los usuarios no mantengan un hábito de uso perfecto. Las congelaciones de racha son opcionales y se pueden configurar en la página de rachas del panel de Trophy. Cuando están habilitadas, tú decides cuántas congelaciones puede tener un usuario y cuántas se le conceden con el tiempo. Cuando un usuario omite un período, se consume una congelación. Las congelaciones se consumen hasta que al usuario no le queda ninguna; en ese momento, su racha se restablece a cero.
Las congelaciones de racha se diferencian de las pausas de racha en que las congelaciones permiten a los usuarios omitir un número determinado de períodos sin perder su racha, sea cual sea el motivo, mientras que las pausas de racha protegen específicamente una racha durante un intervalo de fechas conocido y predefinido, como unas vacaciones o un descanso programados. Las congelaciones se consumen automáticamente cuando el usuario no realiza una actividad requerida, mientras que las pausas se crean manualmente con antelación para cubrir ausencias planificadas.

Otorgar congelaciones

Puedes configurar cualquier número de congelaciones para otorgar a los nuevos usuarios cuando los identifiques por primera vez con Trophy. Para configurarlo, activa la concesión de congelaciones y define el número inicial de congelaciones en la página de rachas del panel de Trophy.
Trophy también puede otorgar congelaciones de racha automáticamente a los usuarios con el tiempo. Puedes elegir un número arbitrario de días durante los cuales otorgar un número arbitrario de congelaciones a cada usuario. Para configurarlo, define el número de días durante los cuales se otorgarán congelaciones y la cantidad de congelaciones que se otorgarán en la página de rachas del panel de Trophy. Aquí también puedes establecer el número máximo de congelaciones que puede tener cada usuario, con un límite de 100.
Si has configurado zonas horarias para tus usuarios, Trophy consumirá automáticamente las congelaciones a medianoche en la zona horaria del usuario cuando sea necesario para mantener su racha, y si hay que otorgar nuevas congelaciones a un usuario, se otorgarán hasta diez minutos más tarde.

Pausas de racha

Las pausas de racha protegen la racha de un usuario durante un intervalo de fechas conocido, como unas vacaciones u otro descanso planificado. Mientras una pausa cubre un periodo, Trophy mantiene la longitud de la racha del usuario en lugar de finalizarla si no cumple sus condiciones de racha.
Las pausas de racha se diferencian de las congelaciones de racha en que las pausas protegen la racha de un usuario durante un intervalo de fechas conocido y predefinido, como unas vacaciones o un descanso programados, mientras que las congelaciones permiten a los usuarios omitir un número determinado de días (o periodos) sin perder su racha, independientemente del motivo. Las pausas se crean manualmente con antelación para cubrir ausencias planificadas, mientras que las congelaciones se consumen automáticamente cuando el usuario no realiza una actividad requerida.

Crear pausas

Crea pausas con la API de administración para crear pausas de racha. Puedes crear pausas para hasta 100 usuarios en una sola solicitud. Cada pausa requiere:
  • userId: el usuario para el que se crea la pausa
  • start: la primera fecha que cubre la pausa
  • end: la última fecha que cubre la pausa
Se rechazan las fechas de inicio en el pasado. Si has configurado zonas horarias para tus usuarios, Trophy evalúa start respecto a la fecha actual en la zona horaria local de cada usuario.

Eliminar pausas

Para que una pausa deje de aplicarse, elimínala con la API de administración para eliminar pausas de racha.

Consultar pausas

La API de rachas de usuario devuelve las pausas próximas y las activas en el campo pauses. Se omiten las pausas pasadas y eliminadas. Cada periodo de streakHistory incluye usedPause, que es true cuando la racha del usuario estuvo en pausa durante ese periodo.

Seguimiento de rachas

Trophy calcula automáticamente las rachas de todos los usuarios a partir de los eventos de métricas que envías a Trophy. No se requiere ningún trabajo adicional para hacer el seguimiento de las rachas, y puedes empezar a usarlas de inmediato. Solo asegúrate de que las rachas estén habilitadas en el panel de Trophy. También puedes consultar y actualizar la configuración de rachas de la organización (frecuencia, modo de evaluación, métricas, días libres, personalización y congelaciones) con la API de administración de configuración de rachas.
Para ver una guía completa sobre cómo configurar una función de rachas con Trophy, consulta nuestra guía oficial.

Personalización de rachas

Trophy permite que los usuarios personalicen el funcionamiento de su racha dentro de los límites que tú establezcas. Para ello, activa la personalización de rachas en la página de rachas del panel de Trophy. Una vez habilitada, los usuarios podrán personalizar, a través de las preferencias de usuario, las condiciones de la racha que deben cumplir para extenderla, incluidos el modo de evaluación de la racha, el umbral de cada métrica y los días libres.
Para obtener más información sobre cómo establecer las preferencias de un usuario específico, consulta la documentación dedicada a las preferencias de usuario.

Gestión de rachas

Esta sección describe algunas de las operaciones que puedes realizar para gestionar las rachas de los usuarios en tu aplicación.

Restaurar la racha de un usuario

Para restaurar la racha de un usuario, ve a la página de detalles del usuario y usa la acción ‘Restaurar racha’. Al restaurar la racha de un usuario, esta vuelve a la duración que tenía cuando la perdió por última vez.
También puedes usar la API de administración para restaurar rachas para restaurar rachas de forma programática.

Restablecer la racha de un usuario

Para restablecer a cero la racha de un usuario, ve a la página de detalles del usuario y usa la acción “Restablecer racha”. Al restablecer la racha de un usuario, su racha actual termina de inmediato, independientemente de si ha cumplido sus condiciones de racha para el período actual.
También puedes usar la API de administración para restablecer rachas para restablecer las rachas de hasta 100 usuarios en una sola solicitud.
Si restableces la racha de un usuario por error, puedes recuperarla restaurando la racha del usuario. Cuando se restablece una racha, el período correspondiente en el campo streakHistory de la API de rachas de usuario incluye una marca de tiempo resetAt que indica cuándo se produjo el restablecimiento.

Mostrar rachas

Trophy expone los datos de rachas de dos maneras, que puedes usar para crear elementos de interfaz en tus aplicaciones y mostrar las rachas a los usuarios.
Consulta nuestra guía completa sobre cómo agregar una función de rachas a tu app para obtener más detalles.

Respuesta del evento de métrica

Cuando incrementas una métrica para un usuario, la respuesta de la API de métricas incluye la Racha actual del usuario.
Response
Puedes usar esta información para activar de forma transaccional elementos de UI/UX, como:
  • Mostrar ventanas emergentes dentro de la app
  • Reproducir efectos de sonido

API de rachas de usuario

La API de rachas de usuario devuelve la Racha actual de un solo usuario, junto con su historial reciente de rachas y cualquier pausa de racha próxima o activa. Usa el parámetro de consulta historyPeriods para controlar cuántos períodos se devuelven.
Response
Usa estos datos para mostrar el historial de rachas de un usuario en tu aplicación.

Listar las rachas de varios usuarios

Si quieres mostrar las rachas de varios usuarios a la vez, por ejemplo, para admitir una función de rachas entre amigos o grupos de usuarios, usa la API de listado de rachas de usuarios.

Obtener soporte

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

Obtener soporte

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