Saltar al contenido principal

​
¿Qué es un Sistema de Puntos?

Los sistemas de puntos se utilizan para crear contadores que rastrean las interacciones de los usuarios con Métricas, Logros y Rachas. Luego puedes construir funcionalidades como ‘XP’ y ‘Energía’ basadas en estos contadores dentro de tu producto.

​
Casos de Uso

​
Recompensas

Los sistemas de puntos pueden utilizarse para crear funcionalidades como ‘XP’ o ‘Gemas’ que recompensan a los usuarios por diversas interacciones a diferentes tasas. De esta manera, los puntos pueden usarse para ponderar el valor de ciertas interacciones de forma diferente a otras, recompensando a los usuarios por realizar las acciones que consideras más estrechamente correlacionadas con la retención.

​
Medición

Los sistemas de puntos también pueden utilizarse para crear funcionalidades como ‘Energía’ que miden el uso de tu producto de manera que te da control sobre la promoción y restricción de la actividad del usuario. Esto te permite controlar la frecuencia con la que los usuarios pueden usar tu producto mediante una mecánica flexible que opera fuera de tu código base.

​
Crear Sistemas de Puntos

Trophy te permite configurar múltiples sistemas de puntos para diferentes casos de uso dentro de tu aplicación.
Para crear un sistema de puntos, dirígete a la página de puntos y sigue los pasos a continuación.
1

Pulse Nuevo Sistema de Puntos

Asigne un nombre al nuevo sistema de puntos y una clave única. La clave es lo que utilizará para referenciar el sistema de puntos en las APIs y en las plantillas de correo electrónico si es relevante.
2

Agregue una descripción (Opcional)

También puede darle al sistema de puntos una descripción que se devuelve desde las APIs para mostrarse en su aplicación.
3

Configure el máximo de puntos (Opcional)

Si desea limitar el número de puntos que cada usuario puede tener en su nuevo sistema, establezca un valor en el campo ‘puntos máximos’.
Cualquier activador de puntos que configure para este sistema de puntos respetará el máximo establecido.
4

Asigne una insignia (Opcional)

Puede asignar una insignia o logotipo subiendo una imagen o ingresando una URL de imagen personalizada. Las APIs devuelven una URL compatible con src para mostrar en su aplicación.

​
Activadores de Puntos

En Trophy, los puntos se otorgan o se deducen de los usuarios a través de activadores. Estos definen las diferentes mecánicas que conforman su sistema de puntos. Puede agregar tantos activadores como desee a cada sistema de puntos que configure, lo que le permite crear diferentes lógicas para cómo se otorgan o deducen los puntos para diferentes sistemas de puntos.

​
Tipos de Activadores

Existen múltiples tipos de activadores en Trophy que pueden utilizarse para otorgar o deducir puntos de diferentes maneras.

​
Activadores de Métricas

Los puntos pueden otorgarse o deducirse continuamente a medida que los usuarios incrementan las Métricas. Puede elegir otorgar o deducir cualquier número arbitrario de puntos en cualquier umbral de métrica arbitrario, por ejemplo “otorgar 10 puntos por cada 3 tareas completadas”.

​
Activadores de Racha

Se pueden otorgar o deducir Puntos al alcanzar cualquier duración arbitraria de una Racha, por ejemplo “otorgar 50 puntos por cada 7 días de racha”.

​
Activadores de Logro

Se pueden otorgar o deducir Puntos cuando los usuarios desbloquean Logros específicos, por ejemplo “otorgar 100 puntos cuando los usuarios completen el logro profile-completed”.

​
Activadores Basados en Tiempo

Se pueden otorgar o deducir Puntos en intervalos de tiempo repetitivos, cada hora o cada día. Por ejemplo “otorgar 10 puntos cada 3 horas”.

​
Activadores de Identificación de Usuario

Se pueden otorgar Puntos cuando los usuarios son identificados por primera vez en Trophy, útil para conceder una cantidad inicial de puntos cuando se registran en tu producto.

​
Crear Activadores

Para crear un nuevo activador de puntos, dirígete al sistema de puntos para el que deseas crear un activador y sigue los pasos a continuación.
Todos los nuevos activadores de puntos se crean como ‘Inactivos’ para permitir pruebas y ajustes antes del despliegue a producción.
1

Elige un tipo de activador

Elige cómo quieres que se otorguen o deduzcan puntos según lo descrito por los tipos de activadores disponibles.
2

Configura el activador

Una vez que hayas elegido el tipo de activador de puntos, necesitas configurar los ajustes del activador.
  • Si elegiste el activador de Métrica, necesitarás elegir la métrica y el umbral en el que se otorgarán o deducirán puntos.
  • Si elegiste el activador de Racha, necesitarás establecer la duración de la racha que debería otorgar o deducir puntos.
  • Si elegiste el disparador de Logro, deberás seleccionar el logro que otorgará o deducirá puntos al completarse.
  • Si elegiste el disparador de Tiempo, deberás seleccionar la unidad de tiempo en la que deseas otorgar o deducir puntos (horas o días) y el número de esas unidades de tiempo después de las cuales deseas otorgar o deducir puntos.
  • Si elegiste el disparador de Primera Identificación de Usuario, no necesitarás agregar ninguna configuración adicional.
3

Establece los puntos a otorgar/deducir

Una vez configurado tu disparador, establece el número de puntos a otorgar o deducir cuando se active.
4

Agrega filtros de atributos (Opcional)

Puedes asignar filtros de atributos a un disparador de puntos para restringir aún más cuándo se aplican.
  • Para limitar un disparador de métrica a que solo se aplique a eventos con atributos de eventos personalizados específicos, selecciona un atributo e ingresa un valor en la sección Atributo de Evento.
  • Para limitar cualquier tipo de disparador a que solo se aplique a un usuario con uno o más atributos de usuario personalizados específicos, agrega atributos y los valores deseados en la sección Atributos de Usuario.
5

Guarda los cambios

Guarda el nuevo disparador de puntos.
6

Activa

Una vez que estés satisfecho de que tu nuevo disparador se comportará como esperas, cambia su estado a activo para ponerlo en funcionamiento.

​
Equilibrio de Puntos

Gestionar un sistema de puntos efectivo requiere encontrar el ritmo óptimo al cual los usuarios ganan puntos. Demasiado rápido, y los usuarios experimentarán fatiga de puntos, volviéndolos inútiles. Demasiado lento, y los usuarios pueden aburrirse y abandonar. La herramienta de vista previa de Trophy puede modelar diferentes escenarios para ayudarte a determinar con qué frecuencia los usuarios deben ganar Puntos en cada uno de tus sistemas de puntos.

​
Potenciadores de Puntos

Los potenciadores de puntos son multiplicadores que puedes usar para aumentar la cantidad de puntos otorgados a los usuarios durante un período de tiempo específico. Esta sección explica cómo funcionan los potenciadores y cómo pueden usarse para aumentar la retención y el engagement de tu aplicación.

​
Segmentación de Potenciadores

Hay varias formas diferentes en las que puedes usar potenciadores en Trophy.
  • Potenciadores globales multiplican los puntos ganados por todos los usuarios durante la ventana del potenciador, o pueden limitarse a una cohorte específica de usuarios usando atributos de usuario personalizados.
  • Potenciadores específicos por usuario solo multiplican los puntos ganados por un único usuario dentro de la ventana del potenciador.
Normalmente, los potenciadores globales se usan para aumentar el engagement en toda la plataforma durante eventos clave del calendario como Black Friday/Cyber Monday en comercio electrónico, Año Nuevo en fitness y temporada de exámenes en plataformas educativas. Por el contrario, los potenciadores específicos por usuario se usan comúnmente para proporcionar incentivos adicionales para que los usuarios realicen acciones que están correlacionadas con una mayor retención.

​
Creación de Potenciadores

Los potenciadores específicos por usuario solo pueden crearse de forma programática a través de la API de administración.
Para crear un potenciador de puntos global en el panel de Trophy, sigue los pasos a continuación.
1

Ve a la página de Potenciadores

Ve a la página de puntos y haz clic en el sistema de puntos para el que deseas crear un potenciador. Luego navega a la pestaña Potenciadores y haz clic en el botón Nuevo Potenciador.
2

Elige un nombre

Elige un nombre para tu potenciador que describa claramente para qué es. Por ejemplo “Potenciador 2X - Todos los Usuarios - Navidad 2026”.
3

Establece el multiplicador

Establece el valor numérico por el que el potenciador multiplicará los puntos ganados. Si eliges un multiplicador decimal, tendrás la opción de elegir el comportamiento de redondeo que debe usar el potenciador.
4

Establece la ventana del potenciador

Elige una fecha de inicio y (opcionalmente) una fecha de finalización para tu potenciador. Si eliges una fecha de inicio futura, Trophy programará el potenciador para que se active en la fecha elegida. De manera similar, si estableces una fecha de finalización, Trophy se encargará de detener tu potenciador por ti.
5

Agrega filtros de atributos (opcional)

Esta funcionalidad requiere atributos de usuario personalizados que están disponibles en el plan Pro.
Si deseas que tu impulso afecte solo a una cohorte de usuarios específica, establece condiciones de atributos de usuario que coincidan con las de tu cohorte objetivo. Trophy se encargará de aplicar el impulso únicamente a los puntos obtenidos por usuarios con valores de atributos de usuario coincidentes.
6

Activar impulso

Haz clic en Guardar Impulso para guardar tu nuevo impulso en tu cuenta. El impulso estará en estado inactivo de forma predeterminada. Para activarlo, haz clic en el menú desplegable a la derecha del nombre del impulso en la página de Impulsos y haz clic en Activar.

​
Multiplicadores de Impulso

Cada impulso tiene un único valor multiplicador que aumenta el total de puntos obtenidos por los usuarios afectados por ese impulso. Los multiplicadores de impulso deben ser números positivos, pero pueden ser decimales para soportar escenarios donde se requieran impulsos porcentuales como ‘50% más puntos’.

​
Acumulación de Impulsos

Los impulsos de puntos en Trophy se acumulan mediante multiplicación. Esto permite que los usuarios se beneficien de múltiples impulsos simultáneamente. Para demostrar la acumulación, considera un impulso 2X, 1.5X y 3X todos activos dentro del mismo período de tiempo. El multiplicador de impulso resultante para un usuario que califique para los tres impulsos sería el siguiente:
Boost Stacking Example
Overall Multiplier (3 boosts) = 2X * 1.5X * 3X = 9X

​
Redondeo de Impulsos

Trophy admite valores de eventos de métrica de punto flotante, pero se encarga de redondear los puntos a enteros automáticamente. Sin embargo, al usar multiplicadores de impulso decimales, puede haber algunos escenarios donde este redondeo predeterminado no sea suficiente para producir siempre valores de puntos enteros. Por lo tanto, Trophy ofrece tres modos de redondeo para proporcionar control adicional sobre el comportamiento de redondeo específicamente cuando los boosts están involucrados en los cálculos de Puntos.
  • Redondear hacia abajo: Por defecto, Trophy redondeará los Puntos hacia abajo al entero más cercano cuando la multiplicación de boost resulte en un decimal.
  • Redondear hacia arriba: Trophy redondea los Puntos decimales hacia arriba al entero más cercano después de la multiplicación de boost.
  • Redondear al más cercano: Trophy redondeará los Puntos al entero más cercano, hacia arriba o hacia abajo, según el valor final después de la multiplicación de boost. Por ejemplo 1.2 se redondea a 1 y 1.7 se redondea a 2.
En escenarios donde los Puntos se utilizan para imitar las mecánicas de crédito de plataforma, se recomienda usar el comportamiento predeterminado de redondeo hacia abajo para proteger contra deslizamientos.
Simplemente elige tu modo de redondeo preferido al crear boosts a través del panel de Trophy.

​
Niveles de Puntos

Los niveles de Puntos son hitos discretos que defines en un sistema de Puntos en Trophy. Cada nivel tiene un umbral. Cuando el total de Puntos de un usuario en el sistema supera este umbral, Trophy les asigna ese nivel automáticamente. No necesitas mantener la lógica de niveles en tu propio código base. Usa los niveles para niveles de rango, interfaz de progresión, niveles de recompensas o analíticas. Trophy mantiene el nivel actual de cada usuario sincronizado cada vez que ganan o pierden Puntos en ese sistema.

​
Configuración de niveles

Para configurar niveles para un sistema de Puntos, ábrelo desde la página de Puntos en el panel de Trophy y usa la pestaña de niveles para agregar o gestionar niveles.
1

Abre tu sistema de puntos

Desde la página de puntos, selecciona el sistema de puntos al que deseas agregar niveles.
2

Abre la pestaña de niveles

Desde la página de tu sistema de puntos, abre la pestaña de niveles.
3

Agrega niveles

Crea cada nivel con una clave estable, un nombre visible, una descripción opcional, una imagen de insignia y el umbral de puntos requerido para alcanzar ese nivel.Los umbrales deben reflejar cómo deseas que se sienta la progresión a medida que los usuarios acumulan puntos de tus activadores.
4

Guarda

Guarda tus niveles. Trophy evaluará los totales contra estos umbrales en cada cambio de puntos.

​
Mostrar Niveles

La mayoría de los equipos combinan tres enfoques: una vista estática de cada nivel (para pantallas de progresión), el nivel actual del usuario (para encabezados y perfil) y retroalimentación inmediata cuando una acción los impulsa a un nuevo nivel.

​
Mostrar Todos los Niveles

Llama a la API de obtener niveles una vez por clave de sistema de puntos (por ejemplo, al cargar la aplicación o desde tu servidor al renderizar una página de progresión). La respuesta es un array de niveles con key, name, description, badgeUrl opcional y el umbral points para cada nivel. Al vincular tu interfaz a la respuesta de la API de Trophy, te asegurarás de que se actualice automáticamente cuando realices cambios en los niveles en el panel de Trophy.
Response
[
  {
    "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
    "key": "bronze",
    "name": "Bronze",
    "description": "Starting level",
    "badgeUrl": "https://example.com/bronze.png",
    "points": 0
  },
  {
    "id": "2240fe51-6bce-4b44-b0ad-bddc4e123534",
    "key": "silver",
    "name": "Silver",
    "description": "Mid-tier level",
    "badgeUrl": null,
    "points": 50
  },
  {
    "id": "3340fe51-6bce-4b44-b0ad-bddc4e123534",
    "key": "gold",
    "name": "Gold",
    "description": "Top level",
    "badgeUrl": "https://example.com/gold.png",
    "points": 200
  }
]

​
Mostrar el Nivel del Usuario

La API de puntos del usuario devuelve el total del usuario, su objeto level actual y awards recientes. El campo level contiene el nivel actual del usuario, o null si no existen niveles o aún no han alcanzado el umbral de puntos para ningún nivel. Combina total con la lista ordenada de niveles del paso anterior para dibujar una barra de progreso entre el umbral actual y el siguiente.
Response
{
  "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
  "key": "xp",
  "name": "XP",
  "description": null,
  "badgeUrl": null,
  "maxPoints": null,
  "total": 100,
  "level": {
    "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
    "key": "silver",
    "name": "Silver",
    "description": "Mid-tier level",
    "badgeUrl": null,
    "points": 50
  },
  "awards": [
    {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
      "awarded": 10,
      "date": "2021-01-01T00:00:00Z",
      "total": 100,
      "trigger": {
        "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
        "type": "metric",
        "points": 10,
        "metricName": "Flashcards Flipped",
        "metricThreshold": 1000
      }
    }
  ]
}

​
Notificaciones de Cambio de Nivel

Cuando envías un evento de cambio de métrica, la respuesta incluirá un mapa points indexado por las claves de tu sistema de puntos para cada sistema que cambió como resultado del evento. Los datos contienen una clave level solo cuando el nivel del usuario cambió debido a este evento. Si su nivel permaneció igual, esa clave se omite, por lo que puedes tratar de forma segura un level presente como una señal de cambio de nivel sin contabilidad adicional.
Response
{
  ...,
  "points": {
    "xp": {
      ...,
      "level": {
        "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
        "key": "bronze",
        "name": "Bronze",
        "description": "Starting level",
        "badgeUrl": null,
        "points": 0
      },
      ...
    }
  }
}
Un patrón típico es verificar el objeto de tu sistema después de un evento exitoso, y luego activar una notificación emergente, un modal o un sonido: 
const pts = response.points?.xp; // use your points system key

if (pts?.level) {
  // Level changed on this request — e.g. toast, modal, confetti if level up
  notifyLevelChange(pts.level.name, pts.total);
}
El mismo comportamiento de level se aplica cuando los puntos cambian por la finalización de un logro. Para notificaciones impulsadas por el servidor (correo electrónico, push, CRM) que no deben depender de que el cliente vea la respuesta HTTP, suscríbete al webhook points.level_changed en su lugar. Este webhook se activa cuando el nivel de un usuario cambia como resultado de ganar o perder puntos, e incluye previousLevel y newLevel.

​
Análisis a nivel de cuenta

La API de resumen de nivel devuelve cuántos usuarios están actualmente en cada nivel, lo cual es útil para paneles de administración, vistas de embudo o balanceo de progresión.
Response
[
  {
    "level": {
      "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
      "key": "bronze",
      "name": "Bronze",
      "description": "Starting level",
      "badgeUrl": "https://example.com/bronze.png",
      "points": 0
    },
    "users": 5012
  },
  {
    "level": {
      "id": "2240fe51-6bce-4b44-b0ad-bddc4e123534",
      "key": "silver",
      "name": "Silver",
      "description": "Mid-tier level",
      "badgeUrl": null,
      "points": 50
    },
    "users": 1501
  },
  {
    "level": {
      "id": "3340fe51-6bce-4b44-b0ad-bddc4e123534",
      "key": "gold",
      "name": "Gold",
      "description": "Top level",
      "badgeUrl": "https://example.com/gold.png",
      "points": 200
    },
    "users": 102
  }
]

​
Mostrando Puntos

Hay varias formas de usar Trophy para obtener y mostrar puntos en tu aplicación.
Para ver ejemplos funcionales, consulta nuestras guías sobre cómo agregar una función de XP o una función de energía a tu aplicación web o móvil.

​
Activación de UI transaccional

En primer lugar, cualquier punto otorgado o deducido de los usuarios como resultado de un evento de cambio de métrica se devuelve en la respuesta al utilizar la API de evento de cambio de métrica. La respuesta incluye el nuevo total de puntos del usuario, cuántos puntos se otorgaron o dedujeron como resultado del evento, y los detalles de los activadores de puntos específicos que se ejecutaron. Cuando los Niveles de Puntos están habilitados, cada objeto de puntos en esa respuesta también puede incluir level: Trophy incluye el nuevo nivel del usuario solo cuando cambió como resultado de ese evento. El mismo comportamiento opcional de level se aplica cuando los puntos cambian por una finalización de logro. Ejemplo de respuesta POST /metrics/{key}/event (los campos coinciden con la especificación de la API de Trophy; tus claves bajo points e leaderboards dependen de tu cuenta):
Response
{
  "metricId": "d01dcbcb-d51e-4c12-b054-dc811dcdc623",
  "eventId": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
  "total": 750,
  "achievements": [
    {
      "id": "5100fe51-6bce-6j44-b0hs-bddc4e123682",
      "trigger": "metric",
      "metricId": "5100fe51-6bce-6j44-b0hs-bddc4e123682",
      "metricName": "Flashcards Flipped",
      "metricValue": 500,
      "name": "500 Flashcards Flipped",
      "description": "Write 500 words in the app.",
      "achievedAt": "2020-01-01T00:00:00Z"
    }
  ],
  "currentStreak": {
    "length": 1,
    "frequency": "daily",
    "started": "2025-04-02",
    "periodStart": "2025-03-31",
    "periodEnd": "2025-04-05",
    "expires": "2025-04-12"
  },
  "points": {
    "xp": {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
      "key": "xp",
      "name": "XP",
      "description": null,
      "badgeUrl": null,
      "maxPoints": null,
      "total": 10,
      "level": {
        "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
        "key": "bronze",
        "name": "Bronze",
        "description": "Starting level",
        "badgeUrl": null,
        "points": 0
      },
      "added": 10,
      "awards": [
        {
          "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
          "awarded": 10,
          "date": "2021-01-01T00:00:00Z",
          "total": 10,
          "trigger": {
            "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
            "type": "metric",
            "metricName": "Flashcards Flipped",
            "metricThreshold": 100,
            "points": 10
          }
        }
      ]
    }
  },
  "leaderboards": {
    "daily_champions": {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123535",
      "key": "daily_champions",
      "name": "Daily Champions",
      "description": null,
      "rankBy": "metric",
      "runUnit": null,
      "runInterval": 0,
      "maxParticipants": 100,
      "metricName": "Flashcards Flipped",
      "metricKey": "flashcards-flipped",
      "threshold": 10,
      "start": "2025-01-01",
      "end": null,
      "previousRank": 50,
      "rank": 12
    }
  }
}
Esto hace que sea realmente sencillo leer la respuesta y activar cualquiera de las siguientes UI transaccionales en tu aplicación:
  • Mostrar notificaciones y ventanas emergentes dentro de la aplicación
  • Reproducir efectos de sonido

​
Visualización de los Puntos del usuario

Trophy también tiene APIs que te permiten obtener los datos de puntos del usuario cuando lo necesites. Primero, la API de puntos de usuario devuelve el total de puntos del usuario para un sistema de puntos particular, su level actual (o null si los niveles no están en uso o aún no han alcanzado un nivel), y hasta 100 de los eventos más recientes que otorgaron puntos o dedujeron puntos de ellos. Puedes usar esta API para mostrar el total de puntos del usuario en cualquier lugar de tu plataforma, así como una sección de ‘Últimas recompensas’ o similar. GET /users/{id}/points/{key} — ejemplo de cuerpo de respuesta (especificación de API de Trophy):
Response
{
  "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
  "key": "xp",
  "name": "XP",
  "description": null,
  "badgeUrl": null,
  "maxPoints": null,
  "total": 100,
  "level": {
    "id": "1140fe51-6bce-4b44-b0ad-bddc4e123534",
    "key": "silver",
    "name": "Silver",
    "description": "Mid-tier level",
    "badgeUrl": null,
    "points": 50
  },
  "awards": [
    {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
      "awarded": 10,
      "date": "2021-01-01T00:00:00Z",
      "total": 100,
      "trigger": {
        "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
        "type": "metric",
        "points": 10,
        "metricName": "Flashcards Flipped",
        "metricThreshold": 1000
      }
    }
  ]
}
Luego, la API de resumen de Puntos de usuario puede utilizarse para obtener datos históricos de Puntos para un usuario en particular. Los datos pueden agregarse diariamente, semanalmente o mensualmente entre una fecha de inicio y una fecha de fin. Utiliza esta API para mostrar a los usuarios gráficos de progreso de Puntos en cualquier período de tiempo. Ejemplo de respuesta GET /users/{id}/points/{key}/event-summary 200 (especificación de API de Trophy; la estructura coincide con tus parámetros de consulta aggregation, startDate y endDate):
GET /users/{id}/points/{key}/event-summary — 200 response
[
  {
    "date": "2024-01-01",
    "total": 100,
    "change": 100
  },
  {
    "date": "2024-01-02",
    "total": 300,
    "change": 200
  },
  {
    "date": "2024-01-03",
    "total": 600,
    "change": 300
  }
]

​
Visualización de Datos Agregados

Además, hay varias APIs que pueden utilizarse para obtener y mostrar datos de Puntos a nivel de cuenta. Primero, la API de resumen de Puntos devuelve datos agregados del sistema de Puntos en toda tu base de usuarios. Utiliza estos datos para mostrar un histograma de Puntos para un sistema de Puntos en particular y mostrar a los usuarios cómo se comparan con otros en la plataforma. Cuando utilizas Niveles de Puntos, la API de resumen de niveles complementa esto con un recuento de usuarios por nivel. GET /points/{key}/summary — ejemplo de respuesta 200 (especificación de API de Trophy):
GET /points/{key}/summary — 200 response
[
  { "from": 0, "to": 0, "users": 5012 },
  { "from": 1, "to": 100, "users": 1501 },
  { "from": 101, "to": 200, "users": 1007 },
  { "from": 201, "to": 300, "users": 584 },
  { "from": 301, "to": 400, "users": 201 },
  { "from": 401, "to": 500, "users": 102 },
  { "from": 501, "to": 600, "users": 25 },
  { "from": 601, "to": 700, "users": 0 },
  { "from": 701, "to": 800, "users": 0 },
  { "from": 801, "to": 900, "users": 0 },
  { "from": 901, "to": 1000, "users": 0 }
]
Finalmente, la API de sistema de Puntos devuelve los metadatos del sistema y los disparadores. Ejemplo de respuesta 200 (especificación de API de Trophy):
GET /points/{key} — 200 response
{
  "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
  "name": "XP System",
  "description": "Experience points for user engagement",
  "badgeUrl": "https://example.com/badge.png",
  "maxPoints": null,
  "triggers": [
    {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
      "type": "metric",
      "points": 10,
      "status": "active",
      "metricId": "0040fe51-6bce-4b44-b0ad-bddc4e123534",
      "metricName": "words written",
      "metricThreshold": 1000,
      "userAttributes": [
        { "key": "plan-type", "value": "premium" },
        { "key": "region", "value": "us-east" }
      ],
      "eventAttribute": { "key": "source", "value": "mobile-app" },
      "created": "2021-01-01T00:00:00Z",
      "updated": "2021-01-01T00:00:00Z"
    },
    {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123536",
      "type": "streak",
      "points": 10,
      "status": "active",
      "streakLengthThreshold": 7,
      "created": "2021-01-01T00:00:00Z",
      "updated": "2021-01-01T00:00:00Z"
    },
    {
      "id": "0040fe51-6bce-4b44-b0ad-bddc4e123535",
      "type": "achievement",
      "points": 50,
      "status": "active",
      "achievementId": "0040fe51-6bce-4b44-b0ad-bddc4e123535",
      "achievementName": "finish onboarding",
      "userAttributes": [{ "key": "plan-type", "value": "premium" }],
      "created": "2021-01-01T00:00:00Z",
      "updated": "2021-01-01T00:00:00Z"
    }
  ]
}
La API de resumen de Puntos también puede filtrarse para devolver únicamente datos de usuarios con atributos de usuario personalizados específicos.
Utiliza la respuesta de la API de sistema de Puntos para mostrar a los usuarios cómo pueden ganar Puntos en tu plataforma. Cualquier nuevo disparador que agregues se devolverá automáticamente desde esta API, reduciendo cambios de código en tu plataforma y trasladando las operaciones a Trophy.

​
Analíticas de puntos

Trophy cuenta con analíticas integradas para rastrear las otorgaciones de puntos de cada sistema de puntos que configures en tus usuarios en tiempo real, incluyendo:
  • Total de puntos ganados por todos los usuarios a lo largo del tiempo
  • Máximo de puntos ganados por un solo usuario
  • Promedio de puntos ganados en los primeros 14 días (útil para entender patrones de retención de nuevos usuarios y el impacto de los puntos)
  • Un desglose de los activadores de puntos otorgados más comunes

​
Obtener soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Comunícate con nosotros por correo electrónico. ¡Estamos aquí para ayudar!