¿Qué son los usuarios?
Los usuarios son las personas que utilizan tu producto. Informas a Trophy sobre tus usuarios mediante las API y usas el panel de control para diseñar experiencias de gamificación en torno a ellos. Los usuarios deben ser personas individuales; no pueden ser empresas ni organizaciones. Para crear estructuras organizativas o agrupaciones de usuarios, considera usar un atributo de usuario personalizado.Atributos clave
Los atributos clave son propiedades de los usuarios que Trophy controla y gestiona, y sirven para cosas comoid o email. Algunos son obligatorios y otros opcionales.
Atributos obligatorios
Trophy solo requiere un atributo clave:id. Todos los usuarios que registres en Trophy deben tener un id, ya que es lo que los identifica como una persona única.
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:El nombre completo del usuario. Está disponible en las plantillas de correo electrónico y en otras áreas
donde quieras dirigirte al usuario por su nombre.
La dirección de correo electrónico del usuario. Se usará en todos los
correos electrónicos que configures como parte de tu
experiencia de gamificación con Trophy.
La zona horaria del usuario. Debe especificarse como un identificador de zona
horaria IANA.
Se usa para las rachas, las posiciones en la clasificación y el envío de correos electrónicos a los usuarios
según su hora local.En JavaScript, puedes obtener la zona horaria del usuario con este fragmento de código:
Fetching timezone
Si has configurado algún correo electrónico de Trophy, solo
se enviará a un usuario cuando este campo sea true. Nota: si no proporcionas
email, intentar establecer este campo en true provocará un error.La fecha en que el usuario se registró en tu plataforma, como
YYYY-MM-DD. Se aceptan fechas y horas
ISO 8601 y se almacenan como su día natural en UTC. No debe ser
posterior a 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.La lista de tokens de dispositivo que se asociarán al usuario. Si has configurado
alguna de las Notificaciones push de Trophy, solo se
enviarán a un usuario cuando se proporcione este campo.
Atributos de usuario personalizados

Crear atributos
Para crear un nuevo atributo de usuario personalizado, ve a la pestaña de atributos de la página de usuarios en el panel de Trophy y haz clic en el botón Add User Attribute. Asigna un nombre y una clave única al atributo. La clave es lo que usarás para hacer referencia al atributo en las llamadas a la API.Establecer atributos
Es posible asignar valores a los atributos de usuarios específicos mediante su clave única, ya sea en línea, cuando los usuarios incrementan métricas a través de la API de incremento de métricas, o de forma explícita mediante las API de identificación de usuarios, creación de usuarios o actualización de usuarios. En todas las API, el esquema para establecer los valores de los atributos es coherente. Este es un ejemplo de un payload de solicitud que establece el valor de dos atributos de usuario personalizados,subject y plan:
Usar atributos
Usa los atributos de usuario personalizados en todo Trophy para personalizar las funciones de gamificación, agregar y filtrar los datos devueltos por las API, y segmentar y comparar cohortes de usuarios en analítica.Personalización de funciones
Los atributos personalizados de usuario se pueden usar para personalizar los logros, adaptar la forma en que distintos usuarios obtienen puntos y mucho más. Sigue los enlaces a las páginas correspondientes que aparecen a continuación para obtener más información.Personalización de logros
Configura logros que solo pueden desbloquear usuarios específicos.
Personalización de puntos
Personaliza cómo obtienen puntos los distintos usuarios.
Segmentación de correos electrónicos
Controla qué usuarios reciben correos electrónicos de gamificación.
Personalización de correos electrónicos
Personaliza el texto y los asuntos de los correos electrónicos con atributos personalizados de usuario.
Elegibilidad para las clasificaciones
Limita las clasificaciones a grupos específicos de usuarios.
Agregación y filtrado de datos
Puedes usar atributos personalizados de usuario para agregar y filtrar los datos que devuelven algunas API, y así admitir una amplia variedad de casos de uso de gamificación. En todos los casos, los atributos se incluyen en el parámetro de consultauserAttributes mediante un esquema coherente:
?userAttributes=city:london,subscription-plan:pro
Esta es la lista de todas las API que admiten el parámetro de consulta userAttributes:
Analíticas segmentadas
Los atributos personalizados de usuario se pueden usar para segmentar y comparar los gráficos de retención y participación entre grupos de usuarios. Esto es útil para saber qué cohortes aprovechan al máximo tus funciones de gamificación y cuáles tienen dificultades para participar y, por tanto, requieren atención.Identificación de usuarios
Cuando le informas a Trophy sobre un usuario de tu plataforma, lo llamamos identificación. Hay dos formas de identificar usuarios con Trophy: la identificación en línea y la 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 informas a Trophy sobre los usuarios a medida que usan tu plataforma con normalidad. En la práctica, esto significa que cada vez que utilices la API de eventos de métricas, envías los datos completos del usuario que desencadenó el evento. Este es un ejemplo en el que se realiza una llamada a la API de eventos de métricas y los datos del usuario que realizó la interacción se envían en el cuerpo de la solicitud:id, Trophy actualizará los datos del usuario que se envíen.
En otras palabras, la identificación en línea se realiza mediante una operación UPSERT.
Identificar a los usuarios de esta manera tiene dos ventajas clave:
- Todos los usuarios nuevos que se registran en tu plataforma e incrementan una métrica se rastrean automáticamente en Trophy sin que tengas que escribir ningún código de identificación explícito
- Cualquier cambio en las propiedades de los usuarios existentes, como el nombre o la 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 consiste en escribir código en tu aplicación que informe a Trophy sobre los usuarios de forma explícita, separada de cualquier interacción con métricas. Es útil si quieres tener control total sobre cómo y cuándo Trophy conoce a tus usuarios. Algunos escenarios en los que podrías querer usar la identificación explícita son:- Quieres informar a Trophy sobre los nuevos usuarios inmediatamente después del registro, antes de que incrementen una métrica
- Haces seguimiento de muchas métricas en Trophy y no quieres repetir el código de identificación en línea.
- Quieres informar a Trophy solo sobre una cohorte específica de usuarios, cuyas condiciones controlas tú
Creación de usuarios
Para crear explícitamente un nuevo usuario en Trophy, usa la API de creación de usuarios.Cómo mantener actualizados a los usuarios
Para informar a Trophy sobre una actualización de un usuario en tu plataforma, puedes usar la API de actualización de usuarios. Las propiedades que pases a Trophy se actualizarán con los nuevos valores que especifiques.Configurar las preferencias de usuario
Trophy ofrece APIs para ayudarte a crear un centro de preferencias que tus usuarios pueden utilizar para controlar y personalizar cómo interactúan con tus funciones 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 a tus usuarios correos electrónicos y Notificaciones push gamificados. 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 controlar qué notificaciones reciben y a través de qué canales.
- achievement_completed: notificaciones que se envían cuando un usuario completa un Logro
- recap: notificaciones periódicas con un resumen del progreso del usuario
- reactivation: notificaciones que se envían para volver a captar a usuarios inactivos
- streak_reminder: recordatorios para ayudar a los usuarios a mantener sus Rachas
email, push, o ambos. Para desactivar por completo un tipo de notificación, 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 los controles del formulario: preselecciona casillas o interruptores en la interfaz de tu centro de preferencias según los valores actuales
- Mostrar el estado actual: muestra qué notificaciones están habilitadas y por qué canales
- Gestionar preferencias ausentes: si un tipo de notificación no aparece en la respuesta, significa que el usuario aún no ha configurado preferencias para él, y puedes aplicar la configuración predeterminada de tu aplicación
Preferencias de racha
Trophy admite preferencias de usuario para las rachas, lo que permite a los usuarios personalizar las condiciones que deben cumplir para extender su racha, incluidos los días de la semana que cuentan para ella.Para usar las preferencias de racha, debes tener habilitada la personalización de rachas.
enabled: indica si se calculan las rachas para este usuario. Cuando esfalse, la racha del usuario siempre es0y no se envían webhooks ni notificaciones de racha.metrics: un array de métricas con umbrales personalizados necesarios 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 reemplazan los días libres de la organización. El usuario no perderá su racha si está inactivo en esos días.
Streak preferences
Obtener la información de un usuario
Para obtener los detalles de un usuario que ya has identificado en Trophy, usa la API Get User. Esto devolverá todos los detalles del usuario junto con el atributocontrol, que puedes usar para inscribir a los usuarios de forma condicional en cualquier función de gamificación. Más información sobre Experimentación.
Response
Analíticas de usuarios
Analíticas básicas
De forma predeterminada, Trophy incluye analíticas de usuarios de alto nivel, entre ellas las de la página de usuarios, como:- El número total de usuarios que has registrado en Trophy
- El número de usuarios activos a diario
- El número de usuarios activos cada mes

Usuarios destacados
Además, en el Dashboard, Trophy muestra una lista de Usuarios destacados con los usuarios que más han avanzado en las métricas de tu plataforma. Son tus usuarios más comprometidos, ¡así que conviene saber quiénes son!Preguntas frecuentes
¿Cuántos usuarios puedo registrar en Trophy?
¿Cuántos usuarios puedo registrar en Trophy?
¡Tantos como quieras! Trophy solo cobra cada mes por los usuarios activos, que son aquellos que interactúan con tu producto al menos una vez en un mes determinado.Esto es genial porque, si un usuario deja de usar tu producto, no pagarás por él en los meses siguientes.Puedes ver el número total de usuarios por los que se te cobrará cada mes dentro de Trophy en la barra lateral:
Puedes estimar los costes de uso en nuestra página de precios.
