Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.trophy.so/llms.txt

Use this file to discover all available pages before exploring further.

Aquí integrarás tu aplicación web backend con Trophy y comenzarás a construir tu primera función gamificada.
Estas instrucciones son para quienes desean implementar Trophy manualmente. Si prefieres usar agentes de codificación, cambia de pestaña arriba.
1

Crea tu cuenta de Trophy

Primero, crea una cuenta nueva si aún no tienes una y accede al panel de Trophy.Completa la incorporación para configurar tu cuenta.
2

Añade el SDK de Trophy a tu backend

Tenemos bibliotecas SDK disponibles en la mayoría de los principales lenguajes de programación, pero si no ves el tuyo en la lista, ¡háznoslo saber y crearemos uno!
npm install @trophyso/node
Alternativamente, puedes llamar directamente a la API usando cualquier cliente HTTP del lado del servidor.
3

Configura el entorno

Ve a la página de integración del panel de Trophy y crea una nueva clave de API.Añade tu clave de API como variable de entorno en tu aplicación backend:
TROPHY_API_KEY='*******'
Luego inicializa el cliente de la API de Trophy en tu backend usando esa clave de API:
import { TrophyApiClient } from "@trophyso/node";

const trophy = new TrophyApiClient({
  apiKey: process.env.TROPHY_API_KEY as string,
});
Asegúrate de que todas las llamadas al SDK de Trophy usen este cliente para la autenticación.
4

Crea tu primera métrica

Todas las funciones de gamificación se basan en interacciones del usuario. En Trophy, usas Métricas para definir y modelar esas interacciones y Eventos para rastrearlas.Aquí crearás tu primera métrica para comenzar. En el panel de Trophy, dirígete a la página de métricas y pulsa el botón Nueva métrica:
Asigna un nombre a la métrica y haz clic en Guardar.
5

Integra la métrica en tu backend

Una vez creada la métrica, ve a la pestaña de configuración y copia su clave de referencia única del API.
Para rastrear un evento contra esta métrica cuando un usuario interactúa con tu producto, llama al API de evento de cambio de métrica, pasando los detalles del usuario que realizó la interacción. En este ejemplo, la clave de la métrica sería flashcards-flipped:
curl -X POST https://app.trophy.so/api/metrics/flashcards-flipped/event \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "user": {
    "id": "18",
    "email": "user@example.com",
    "tz": "Europe/London"
  },
  "value": 750
}'
Al realizar esta llamada, le indicas a Trophy que un usuario específico interactuó con tu producto. Como resultado, Trophy procesará automáticamente cualquier función de gamificación como Logros o Rachas que hayas configurado contra la métrica.
6

Continúa construyendo tu experiencia de gamificación

Con una métrica integrada en tu backend, estás listo para comenzar a agregar funciones de gamificación a tu producto.Sigue los enlaces a continuación para conocer más sobre cada función que puedes construir con Trophy:

Logros

Recompensa a los usuarios por su progreso continuo o por realizar acciones específicas.

Rachas

Motiva a los usuarios a desarrollar hábitos de uso regular.

Puntos

Construye sistemas de puntos sofisticados para recompensar y retener usuarios.

Tablas de clasificación

Crea competencias amistosas para aumentar la participación de los usuarios.

Correos electrónicos

Envía correos electrónicos de ciclo de vida personalizados a los usuarios en el momento perfecto.

Notificaciones push

Impulsa flujos de notificación automatizados usando datos de gamificación personalizados.
O explora nuestra referencia de API para familiarizarte con lo que Trophy puede hacer.

​
Obtén soporte

¿Quieres ponerte en contacto con el equipo de Trophy? Contáctanos por correo electrónico. ¡Estamos aquí para ayudarte!