Trackear evento

Registrar un evento custom para un cliente.

POST/api/v1/events/track

Registra un evento custom. Puede otorgar XP y puntos si hay reglas configuradas.

Request body

Parametro	Tipo	Descripcion
eventName*	string	Nombre del evento
externalUserId	string	ID externo del usuario
clientId	string	ID del cliente en SouthGames
properties	object	Propiedades del evento

Se requiere clientId o externalUserId.

Compras: para registrar una venta usa el evento oficial purchase, que tiene un contrato propio (order_id obligatorio, monto entero) y es el unico que alimenta las metricas de ingresos. Ver Evento de compra.

Ejemplo

curl -X POST https://southgames.ai/api/v1/events/track \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -H "Content-Type: application/json" \
  -d '{
    "eventName": "producto_visto",
    "externalUserId": "user_123",
    "properties": { "producto_id": "SKU-123", "categoria": "combos" }
  }'

Respuesta

{
  "success": true,
  "eventName": "producto_visto",
  "xpAwarded": 30,
  "newTotalXp": 450,
  "tierUp": null,
  "pointsAwarded": 15,
  "newPointsBalance": 165,
  "triggeredNotifications": []
}

Efectos automaticos

Al trackear un evento, el sistema evalua automaticamente:

Efecto	Descripcion
XP	Si hay una regla de tier para el evento `custom` con `eventName` coincidente
Puntos	Si hay una regla de puntos para el evento `custom` con `eventName` coincidente
Journeys	Journeys activos que escuchen este evento
Referidos	Verificacion de completitud de referidos
Misiones	Progreso de misiones con accion `custom_event`
In-app	Notificaciones in-app con trigger tipo `event`