MCP¿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.
ALLsignifica que un usuario debe alcanzar todos los umbrales de las métricas para extender su rachaORsignifica que un usuario solo tiene que alcanzar uno de los umbrales de las métricas para extender su racha
Días libres
Para 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 pueden seguir ampliando su racha si están activos, pero si no hacen actividad en un día libre, la racha no se rompe.
Congelaciones de racha
Las congelaciones de racha ayudan a los usuarios a mantener 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 otorgan con el tiempo. Cuando un usuario omite un período, se consume una congelación. Las congelaciones se consumen hasta que el usuario se queda sin 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 romper su racha, independientemente del motivo, mientras que las pausas de racha protegen una racha específicamente 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 cantidad de congelaciones para otorgarlas 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.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 período, 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 específicamente la racha de un usuario durante un intervalo de fechas conocido y predefinido, como unas vacaciones o un descanso programado, mientras que las congelaciones permiten a los usuarios omitir un número determinado de días (o períodos) sin perder su racha, sin importar el 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.
Creación de pausas
Crea pausas con la API de administración para crear pausas de rachas. Puedes crear pausas para hasta 100 usuarios en una sola solicitud. Cada pausa requiere:userId: el usuario para el que se crea la pausastart: la primera fecha que cubre la pausaend: la última fecha que cubre la pausa
start respecto a la fecha actual en la zona horaria local de cada usuario.
Eliminación de pausas
Para evitar que se aplique una pausa, elimínala con la API de administración para eliminar pausas de rachas.Lectura de pausas
La API de rachas de usuario devuelve las pausas próximas y las activas en el campopauses. Se omiten las pausas pasadas y las eliminadas.
Cada período de streakHistory incluye usedPause, que es true cuando la racha del usuario estuvo en pausa durante ese período.
Seguimiento de rachas
Trophy calcula automáticamente las rachas de todos los usuarios a partir de los eventos de métricas que reportas a Trophy. No se requiere 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 activadas en el panel de Trophy. También puedes leer 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 ajustes de rachas.Personalización de rachas
Trophy permite que los usuarios personalicen el funcionamiento de su racha dentro de los límites que tú definas. Para ello, activa la personalización de rachas en la página de rachas del panel de Trophy. Una vez habilitada la función, los usuarios podrán personalizar, a través de las preferencias de usuario, las condiciones de la racha que deben cumplir para extender su racha, incluidos el modo de evaluación de la racha, el umbral de cada métrica y los días libres.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.Restauración de 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.Restablecimiento de 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 la racha en el período actual. 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 campostreakHistory 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.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
- 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 consultahistoryPeriods para controlar cuántos períodos se devuelven.
Response
