Merge pull request #77 from trophyso/streak-prefs

Add docs for user preferences

Author: jasontlouro

assets/features/streaks/streak_personalization.mp4

@@ -704,7 +704,8 @@
             "label": "Comenzar gratis",
             "href": "https://app.trophy.so/sign-up?utm_source=docs&utm_medium=navbar-links"
           }
-        }
+        },
+        "anchors": []
       }
     ]
   },
@@ -839,4 +840,4 @@
       "destination": "/es/platform/experimentation#what-is-engagement"
     }
   ]
-}
+}

docs.json

@@ -1,33 +1,32 @@
 ---
 title: Rachas
 description: Aprende a usar rachas en una experiencia de producto gamificada con Trophy.
-og:description: Utiliza rachas diarias, semanales o mensuales para crear
-  patrones de uso habituales y mantener a los usuarios volviendo a tu
-  aplicación.
+og:description: Usa rachas diarias, semanales o mensuales para crear patrones de
+  uso habitual y mantener a los usuarios regresando a tu aplicación.
 icon: flame
 ---
 
 import MetricChangeResponseBlock from "../../snippets/metric-change-response-block.mdx";
 
 ## ¿Qué son las Rachas? {#what-are-streaks}
 
-Una racha es un período de días, semanas o meses consecutivos en que un usuario ha realizado una acción clave en tu plataforma. Se ha demostrado que las rachas aumentan significativamente la retención, particularmente cuando la acción del usuario que se rastrea se alinea con el valor central de tu producto.
+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 significativamente la retención, especialmente cuando la acción del usuario que se rastrea se alinea con el valor central de tu producto.
 
 ## Frecuencia de Racha {#streak-frequency}
 
-Las rachas en Trophy pueden ser **diarias, semanales o mensuales**. Esto significa que un usuario debe cumplir sus [condiciones de racha](#streak-conditions) al menos una vez cada día, semana o mes natural para mantener su racha.
+Las rachas en Trophy pueden ser **diarias, semanales o mensuales**. Esto significa que un usuario debe cumplir sus [condiciones de racha](#streak-conditions) al menos una vez cada día, semana o mes del calendario para mantener su racha.
 
-Si has [configurado zonas horarias](/es/features/users#param-tz) para tus usuarios, Trophy rastreará automáticamente la racha de cada usuario en su zona horaria local (incluyendo tener en cuenta cuando los usuarios cambian de zona horaria) y mantendrá las rachas intactas.
+Si has [configurado zonas horarias](/es/features/users#param-tz) para tus usuarios, Trophy rastreará automáticamente la racha de cada usuario en su zona horaria local (incluyendo cuando los usuarios cambian de zona horaria) y mantendrá las rachas intactas.
 
 <Note>
-Trophy calcula automáticamente los datos de racha para cada frecuencia, lo que significa que puedes cambiar en cualquier momento.
+Trophy calcula automáticamente los datos de racha para cada frecuencia de racha, lo que significa que puedes cambiar en cualquier momento.
 </Note>
 
 ## Condiciones de Racha {#streak-conditions}
 
-En Trophy puedes establecer los umbrales que un usuario debe cumplir para extender su racha según tus [Métricas](/es/features/metrics) configuradas.
+En Trophy puedes establecer los umbrales que un usuario debe cumplir para extender su racha basándote en tus [Métricas](/es/features/metrics) configuradas.
 
-Puedes elegir qué métricas deben formar parte de tu racha, y para aquellas que elijas, puedes establecer un umbral personalizado que los usuarios deben cumplir.
+Puedes elegir qué métricas deben formar parte de tu racha, y para las que elijas, puedes establecer un umbral personalizado que los usuarios deben cumplir.
 
 <Frame>
   <img
@@ -39,14 +38,14 @@ Puedes elegir qué métricas deben formar parte de tu racha, y para aquellas que
 </Frame>
 
 Al combinar métricas de esta manera, puedes elegir entre dos modos de evaluación:
-- `ALL` significa que un usuario debe cumplir cada umbral de métrica para extender su racha
-- `OR` significa que un usuario solo tiene que cumplir uno de tus umbrales de métrica para extender su racha
+- `ALL` significa que un usuario debe cumplir todos los umbrales de métricas para extender su racha
+- `OR` significa que un usuario solo tiene que cumplir uno de tus umbrales de métricas para extender su racha
 
 De esta manera puedes diseñar tu lógica de rachas para que se ajuste al caso de uso de tu aplicación.
 
-## Congelaciones de Racha {#streak-freezes}
+## Congelaciones de Rachas {#streak-freezes}
 
-Las congelaciones de racha ayudan a los usuarios a mantener sus rachas por más tiempo al permitirles omitir períodos sin que se reinicie a cero. Esto ayuda a mantener las rachas motivadoras incluso si los usuarios no mantienen un hábito de uso perfecto.
+Las congelaciones de rachas ayudan a los usuarios a mantener sus rachas por más tiempo al permitirles perder períodos sin que se restablezcan a cero. Esto ayuda a mantener las rachas motivadoras incluso si los usuarios no mantienen un hábito de uso perfecto.
 
 <Frame>
   <img
@@ -57,46 +56,72 @@ Las congelaciones de racha ayudan a los usuarios a mantener sus rachas por más
   />
 </Frame>
 
-Las congelaciones de racha son opcionales en Trophy pero se pueden configurar en la [página de rachas](https://app.trophy.so/streaks) del panel de Trophy.
+Las congelaciones de rachas son opcionales en Trophy pero pueden configurarse en la [página de rachas](https://app.trophy.so/streaks) del panel de Trophy.
 
 ### Otorgar Congelaciones Iniciales {#granting-initial-freezes}
 
-Puedes configurar cualquier número de congelaciones arbitrarias para otorgar a nuevos usuarios cuando los identificas por primera vez con Trophy.
+Puedes configurar cualquier número arbitrario de congelaciones para otorgar a nuevos usuarios cuando los identifiques por primera vez con Trophy.
 
 <Tip>
-Otorgar a los usuarios demasiadas congelaciones puede disminuir su valor percibido, pero otorgar muy pocas congelaciones podría resultar en un mayor número de rachas perdidas. Un buen punto de partida es una congelación por usuario, ¡pero el truco está en experimentar!
+Otorgar demasiadas congelaciones a los usuarios puede disminuir su valor percibido, pero conceder muy pocas congelaciones podría resultar en un mayor número de rachas perdidas. Un buen punto de partida es una congelación por usuario, ¡pero el truco está en experimentar!
 </Tip>
 
 ### Acumulación de Congelaciones {#freeze-accumulation}
 
-A medida que los usuarios agotan las congelaciones de racha, necesitarán un suministro continuo de nuevas para mantenerlas activas. Para facilitar esto, Trophy puede otorgar automáticamente congelaciones de racha 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.
+A medida que los usuarios agotan las congelaciones de rachas, necesitarán un suministro continuo de nuevas para seguir adelante. Para facilitar esto, Trophy puede otorgar automáticamente congelaciones de rachas 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.
 
-Si has [configurado zonas horarias](/es/features/users#param-tz) para tus usuarios, Trophy consumirá automáticamente las congelaciones a medianoche en la zona horaria del usuario cuando sea necesario para extender su racha, y si se deben otorgar nuevas congelaciones a un usuario, se otorgarán hasta diez minutos después.
+Si has [configurado zonas horarias](/es/features/users#param-tz) para tus usuarios, Trophy consumirá automáticamente las congelaciones a medianoche en la zona horaria del usuario cuando sea necesario para extender su racha, y si hay nuevas congelaciones pendientes de otorgar a un usuario, se otorgarán hasta diez minutos después.
 
-### Número Máximo de Congelaciones {#maximum-freeze-count}
+### Cantidad Máxima de Congelaciones {#maximum-freeze-count}
 
-En Trophy también configuras el número máximo de congelaciones que puede tener cada usuario, hasta un límite de 100. La [acumulación de congelaciones](#freeze-accumulation) solo otorgará congelaciones hasta este límite.
+En Trophy también configuras el número máximo de congelaciones que cada usuario puede tener, hasta un límite de 100. La [acumulación de congelaciones](#freeze-accumulation) solo otorgará congelaciones hasta este límite.
 
 ## Seguimiento de Rachas {#tracking-streaks}
 
-Trophy calcula automáticamente las rachas para todos los usuarios según los [eventos de métrica](/es/features/events#tracking-metric-events) que reportes a Trophy.
+Trophy calcula automáticamente las rachas para todos los usuarios en función de los [eventos de métrica](/es/features/events#tracking-metric-events) que reportes a Trophy.
 
-No se requiere trabajo adicional para rastrear rachas, y puedes comenzar a usarlas de inmediato. Solo asegúrate de que las rachas estén habilitadas en el panel de Trophy.
+No se requiere trabajo adicional para realizar el seguimiento de rachas, y puedes comenzar a usarlas de inmediato. Solo asegúrate de que las rachas estén habilitadas en el panel de Trophy.
 
 <Tip>
 Para un recorrido completo sobre cómo configurar una función de rachas usando Trophy, consulta nuestra [guía oficial](/es/guides/how-to-build-a-streaks-feature).
 </Tip>
 
-## Gestión de Rachas {#managing-streaks}
+## Personalización de Rachas {#streak-personalization}
 
-Esta sección describe algunas de las operaciones que puedes realizar para gestionar las rachas de los usuarios en tu aplicación.
+Trophy puede permitir que los usuarios personalicen cómo funciona su racha dentro de los límites que establezcas para ellos.
+
+Para hacer esto, activa la personalización de rachas en la [página de rachas](https://app.trophy.so/streaks) del panel de Trophy.
+
+<Frame>
+  <video
+    autoPlay
+    muted
+    loop
+    playsInline
+    className="w-full aspect-15/4"
+    height="200"
+    width="100%"
+    noZoom
+    src="../../assets/features/streaks/streak_personalization.mp4"
+  />
+</Frame>
+
+Una vez habilitado, los usuarios podrán personalizar las [condiciones de racha](#streak-conditions) que deben cumplir para extender su racha, incluyendo el modo de evaluación de racha y el umbral para cada métrica, a través de las preferencias de usuario.
+
+<Tip>
+Para obtener más información sobre cómo establecer preferencias de usuario para un usuario específico, lee la documentación dedicada sobre [preferencias de usuario](/es/features/users#streak-preferences).
+</Tip>
+
+## Administración de Rachas {#managing-streaks}
+
+Esta sección describe algunas de las operaciones que puedes realizar para administrar las rachas de los usuarios en tu aplicación.
 
 ### Restaurar la Racha de un Usuario {#restoring-a-users-streak}
 
-Para restaurar la racha de un usuario, dirígete a la página de detalles del usuario y utiliza la acción 'Restaurar Racha'. Restaurar la racha de un usuario la establece a la duración que tenía cuando la perdió por última vez.
+Para restaurar la racha de un usuario, dirígete a la página de detalles del usuario y usa la acción 'Restaurar Racha'. Restaurar la racha de un usuario la establece en la duración que tenía cuando la perdió por última vez.
 
 <Tip>
-También puedes usar el [API de administración para restaurar rachas](/es/admin-api/endpoints/streaks/restore-streaks) para restaurar rachas programáticamente.
+También puedes usar la [API de administración para restaurar rachas](/es/admin-api/endpoints/streaks/restore-streaks) para restaurar rachas de forma programática.
 </Tip>
 
 <Frame>
@@ -110,30 +135,28 @@ También puedes usar el [API de administración para restaurar rachas](/es/admin
   ></video>
 </Frame>
 
-## Visualización de Rachas {#displaying-streaks}
+## Mostrar Rachas {#displaying-streaks}
 
-Trophy expone los datos de rachas de dos formas, que pueden usarse para crear elementos de interfaz dentro de tus aplicaciones y mostrar rachas a los usuarios.
+Trophy expone los datos de rachas de dos formas, que pueden usarse para construir elementos de interfaz dentro de tus aplicaciones y mostrar rachas a los usuarios.
 
 <Tip>
-  Consulta nuestra [guía completa](/es/guides/how-to-build-a-streaks-feature) sobre cómo agregar una
-  función de rachas a tu aplicación para más detalles.
+  Consulta nuestra [guía completa](/es/guides/how-to-build-a-streaks-feature) sobre cómo agregar una funcionalidad de rachas a tu aplicación para más detalles.
 </Tip>
 
 ### Respuesta de Evento de Métrica {#metric-event-response}
 
-Cuando [incrementas una métrica](/es/features/events#tracking-metric-events) para un usuario, la respuesta del [API de métricas](/es/api-reference/endpoints/metrics/send-a-metric-change-event) incluirá la racha
-actual del usuario.
+Cuando [incrementas una métrica](/es/features/events#tracking-metric-events) para un usuario, la respuesta de la [API de métricas](/es/api-reference/endpoints/metrics/send-a-metric-change-event) incluirá la racha actual del usuario.
 
 <MetricChangeResponseBlock />
 
-Esto se puede usar para activar de forma transaccional elementos de UI/UX, incluyendo:
+Esto puede usarse para activar transaccionalmente elementos de UI/UX incluyendo:
 
 - Mostrar ventanas emergentes dentro de la aplicación
 - Reproducir efectos de sonido
 
 ### API de Rachas de Usuario {#user-streaks-api}
 
-La [API de rachas de usuario](/es/api-reference/endpoints/users/get-a-users-streak) devuelve la racha actual de un único usuario, junto con su historial reciente de rachas. Usa el parámetro de consulta `historyPeriods` para controlar cuántos períodos devolver.
+La [API de rachas de usuario](/es/api-reference/endpoints/users/get-a-users-streak) devuelve la racha actual de un usuario individual, junto con su historial reciente de rachas. Usa el parámetro de consulta `historyPeriods` para controlar cuántos períodos devolver.
 
 {/* vale off */}
 
@@ -200,7 +223,7 @@ Usa estos datos para mostrar el historial de rachas de un usuario dentro de tu a
 
 ### Listar Rachas de Múltiples Usuarios {#list-multiple-users-streaks}
 
-Si quieres mostrar rachas para varios usuarios a la vez, por ejemplo para soportar una función de rachas de amigos o grupos de usuarios, usa la [API de listar rachas de usuario](/es/api-reference/endpoints/streaks/get-streaks).
+Si deseas mostrar rachas para múltiples usuarios a la vez, por ejemplo para soportar una funcionalidad de rachas de amigos o grupos de usuarios, entonces usa la [API de listado de rachas de usuario](/es/api-reference/endpoints/streaks/get-streaks).
 
 ```json [expandable]
 [
@@ -224,4 +247,4 @@ Si quieres mostrar rachas para varios usuarios a la vez, por ejemplo para soport
 
 ## Obtener Soporte {#get-support}
 
-¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudar!
+¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por [correo electrónico](mailto:support@trophy.so). ¡Estamos aquí para ayudarte!