¿Qué son los Usuarios?
Los usuarios son las personas individuales que utilizan tu producto. Le informas a Trophy sobre tus usuarios a través de APIs y utilizas el panel de control para diseñar experiencias de gamificación en torno a ellos. Los usuarios deben ser individuos, no pueden ser empresas u organizaciones. Para crear estructuras organizacionales o agrupaciones de usuarios, considera utilizar un atributo de usuario personalizado.Atributos Clave
Los atributos clave son propiedades de los usuarios controladas y gestionadas por Trophy y son para cosas comoid o email, algunos son obligatorios mientras que otros son opcionales.
Atributos Obligatorios
Trophy solo requiere un atributo clave,id. Cada usuario sobre el que informes a Trophy debe tener un id, esto es lo que los identifica como una persona única.
string
requerido
Este es el ID del usuario en tu base de datos.
Atributos Opcionales
Además, puedes informar a Trophy sobre cualquiera de los siguientes atributos clave opcionales y los pondrá a tu disposición como parte de tu experiencia de gamificación:string
El nombre completo del usuario. Este está accesible en plantillas de correo electrónico y otras áreas
donde puedas querer dirigirte al usuario por su nombre.
string
La dirección de correo electrónico del usuario. Esta dirección se utilizará en cualquier
correo electrónico que configures como parte de tu experiencia
de gamificación con Trophy.
string
La zona horaria del usuario. Debe especificarse como un identificador de zona horaria
IANA.
Se utiliza para rachas, clasificaciones del ranking y envío de correos electrónicos a los usuarios de
acuerdo con su hora local.En JavaScript, puedes obtener la zona horaria del usuario usando este fragmento:
Fetching timezone
boolean
predeterminado:"true"
Si has configurado algún correo electrónico de Trophy, solo se
enviarán a un usuario cuando este campo sea true. Nota: Si no proporcionas un
email, intentar establecer este campo como true generará un error.string
La fecha en que el usuario se registró en tu plataforma, como
YYYY-MM-DD. Se aceptan
fechas-hora ISO 8601 y se almacenan como su día de calendario UTC. No debe ser
posterior al día de hoy en la zona horaria del usuario. Este campo es independiente de
created, que es la fecha en que Trophy tuvo conocimiento del usuario por primera vez.array<string>
La lista de tokens de dispositivo que se asociarán con el usuario. Si has configurado
Notificaciones push de Trophy, solo se
enviarán a un usuario cuando se proporcione este campo.
Atributos de usuario personalizados
Esta función está disponible en el plan Pro

Crear atributos
Para crear un nuevo atributo de usuario personalizado, dirígete a la pestaña de atributos de la página de usuarios en el panel de Trophy y pulsa el botón Agregar atributo de usuario. Asigna al atributo un nombre y una clave única. La clave es lo que usarás para hacer referencia al atributo en las llamadas a la API.Establecer atributos
Los atributos pueden recibir valores para usuarios específicos usando su clave única, ya sea en línea, mientras los usuarios incrementan métricas mediante la API de incremento de métricas, o explícitamente a través de las APIs de identificación de usuario, crear usuario o actualizar usuario. En todas las APIs, el esquema para establecer valores de atributos es consistente. Aquí tienes un ejemplo de una carga útil de solicitud que establece el valor de dos atributos de usuario personalizadossubject y plan:
Usar atributos
Usa atributos de usuario personalizados en Trophy para personalizar funciones de gamificación, agregar y filtrar datos devueltos por las APIs, y para segmentar y comparar cohortes de usuarios en análisis.Personalización de Funciones
Los atributos personalizados de usuario pueden utilizarse para personalizar logros, customizar la forma en que diferentes usuarios ganan puntos y más. Sigue los enlaces a las páginas relevantes a continuación para obtener más información.Personalización de Logros
Configura logros que solo pueden ser desbloqueados por usuarios específicos.
Personalización de Puntos
Personaliza cómo diferentes usuarios ganan puntos.
Segmentación de Correos Electrónicos
Controla qué usuarios reciben correos electrónicos gamificados.
Personalización de Correos Electrónicos
Personaliza el contenido y las líneas de asunto de los correos electrónicos con atributos personalizados de usuario.
Agregación y Filtrado de Datos
Puedes usar atributos personalizados de usuario para agregar y filtrar datos devueltos por algunas APIs para soportar una amplia gama de casos de uso de gamificación. En todos los casos, los atributos se incluyen en el parámetro de consultauserAttributes usando un esquema consistente:
?userAttributes=city:london,subscription-plan:pro
Aquí está una lista de todas las APIs que soportan el parámetro de consulta userAttributes:
Analíticas Segmentadas
Los atributos personalizados de usuario pueden utilizarse para segmentar y comparar gráficos de retención y engagement entre grupos de usuarios. Esto es útil para comprender qué cohortes están haciendo pleno uso de tus funciones de gamificación, y cuáles tienen dificultades para interactuar y por lo tanto requieren atención.Identificación de Usuarios
Cuando le informas a Trophy sobre un usuario en tu plataforma, a esto lo llamamos identificación. Hay dos formas en las que puedes identificar usuarios con Trophy, identificación en línea e identificación explícita.Identificación en línea
La identificación en línea es la forma más sencilla de informar a Trophy sobre tus usuarios, ya que no requiere ningún código específico de identificación de usuarios. Simplemente le dices a Trophy sobre los usuarios a medida que utilizan tu plataforma de forma normal. En la práctica, esto significa que cada vez que usas la API de eventos de métricas, pasas los detalles completos del usuario que activó el evento. Aquí hay un ejemplo donde se realiza una llamada a la API de eventos de métricas, y los detalles del usuario que realizó la interacción se pasan en el cuerpo de la solicitud:id, entonces Trophy actualizará los detalles del usuario que se pasen.
En otras palabras, la identificación en línea se realiza mediante una operación UPSERT.
Identificar usuarios de esta manera tiene dos beneficios clave:
- Todos los usuarios nuevos que se registren en tu plataforma e incrementen una métrica son rastreados automáticamente en Trophy sin necesidad de que escribas código de identificación explícito
- Cualquier cambio en las propiedades de usuarios existentes como nombre o dirección de correo electrónico se sincroniza automáticamente con Trophy la próxima vez que el usuario incremente una métrica
Identificación Explícita
La identificación explícita es cuando escribes código en tu aplicación que le indica explícitamente a Trophy sobre los usuarios de forma separada de cualquier interacción con métricas. Esto es útil si deseas un control completo sobre cómo y cuándo Trophy conoce a tus usuarios. Los escenarios en los que podrías querer usar la identificación explícita incluyen:- Quieres informar a Trophy sobre nuevos usuarios inmediatamente al registrarse, antes de que incrementen una métrica
- Rastreas muchas métricas en Trophy y no quieres repetir el código de identificación inline.
- Quieres informar a Trophy solo sobre un grupo específico de usuarios, del cual controlas las condiciones
Creación de Usuarios
Para crear explícitamente un nuevo usuario en Trophy, usa el API de Creación de Usuarios.Mantener los Usuarios Actualizados
Para informar a Trophy sobre una actualización de un usuario en tu plataforma, puedes usar el API de Actualización de Usuarios. Todas las propiedades que pases a Trophy se actualizarán a los nuevos valores que especifiques.Configuración de preferencias de usuario
Trophy cuenta con API para ayudarte a crear un centro de preferencias que tus usuarios pueden utilizar para controlar y personalizar la forma en que interactúan con tus funcionalidades de gamificación. Esta sección describe todas las preferencias que puedes exponer a tus usuarios y su función.Preferencias de notificaciones
Puedes usar Trophy para enviar correos electrónicos y notificaciones push gamificados a tus usuarios. La API de actualización de preferencias de Trophy te permite crear un centro de preferencias dentro de tu aplicación con el que tus usuarios pueden interactuar para controlar qué notificaciones reciben y a través de qué canales.
- achievement_completed: Notificaciones enviadas cuando un usuario completa un logro
- recap: Notificaciones de resumen periódico sobre el progreso del usuario
- reactivation: Notificaciones enviadas para volver a interactuar con usuarios inactivos
- streak_reminder: Recordatorios para ayudar a los usuarios a mantener sus rachas
email, push, o ambos. Para desactivar un tipo de notificación por completo, pasa un array vacío.
Por ejemplo, el siguiente fragmento de código actualiza las preferencias de notificación de un usuario en Trophy:
Response
- Rellenar controles de formulario: Preselecciona casillas de verificación o conmutadores en la interfaz de tu centro de preferencias según los valores actuales
- Mostrar el estado actual: Muestra qué notificaciones están habilitadas y a través de qué canales
- Gestionar preferencias faltantes: Si un tipo de notificación no está presente en la respuesta, significa que el usuario aún no ha configurado preferencias para ello, y puedes usar la configuración predeterminada de tu aplicación
Preferencias de Racha
Trophy admite preferencias de usuario para rachas, lo que permite a los usuarios personalizar las condiciones que deben cumplir para extender su racha, incluyendo qué días de la semana cuentan para ella.Para usar las preferencias de racha, debes tener la personalización de rachas habilitada.
enabled: Si las rachas se calculan para este usuario. Cuandofalse, la racha del usuario siempre es0y no se envían webhooks ni notificaciones de racha.metrics: Un array de métricas con umbrales personalizados requeridos para extender la racha.evaluationMode: Determina cómo se combinan las métricas para extender la racha. Puede serALLoOR.daysOff: Un array de números de días de la semana (0= domingo hasta6= sábado) que sobrescriben los días libres de la organización. El usuario no perderá su racha si está inactivo en estos días.
Streak preferences
Recuperación de información del usuario
Para obtener los detalles de un usuario que ya has identificado con Trophy, utiliza la API Get User. Esto devolverá los detalles completos del usuario junto con el atributocontrol que puedes usar para inscribir condicionalmente a los usuarios en cualquier función de gamificación. Obtén más información sobre Experimentación.
Response
Analítica de usuarios
Analítica básica
Por defecto, Trophy incluye analítica de usuarios de alto nivel en la página de Usuarios que incluye:- El número total de usuarios que le has indicado a Trophy
- El número de usuarios que están activos diariamente
- El número de usuarios que están activos mensualmente

Usuarios destacados
Además, en el Dashboard, Trophy muestra una lista de Usuarios Destacados con el conjunto de usuarios que han logrado el mayor progreso contra las Métricas de tu plataforma. ¡Estos son tus usuarios más comprometidos, así que es útil saber quiénes son!Preguntas frecuentes
¿Cuántos usuarios puedo indicarle a Trophy?
¿Cuántos usuarios puedo indicarle a Trophy?
¡Tantos como quieras! Trophy solo cobra cada mes por los usuarios activos, que son los usuarios que interactúan con tu producto al menos una vez en un mes determinado.Esto es excelente porque significa que si un usuario abandona, no pagarás por él en los meses siguientes.Puedes ver el número total de usuarios que se te cobrarán cada mes dentro de Trophy en la barra lateral:
Puedes estimar los costos de uso en nuestra página de precios.
