Tiers, ranking y journeys

Distribucion de tiers, leaderboard e inscripciones a journeys.

Distribucion de tiers

GET/api/v1/metrics/tiers/distribution

Cantidad de clientes por tier (incluye 'none'). Lectura en vivo.

{
  "totalClients": 3120,
  "tiers": [
    { "id": "gold", "name": "Oro", "color": "#FFD700", "count": 120 },
    { "id": "silver", "name": "Plata", "color": "#C0C0C0", "count": 1000 },
    { "id": "none", "name": "Sin tier", "color": "#9CA3AF", "count": 2000 }
  ]
}

Leaderboard

GET/api/v1/metrics/ranking/leaderboard

Leaderboard top-N por scope/periodo, o el ranking de un usuario especifico. Equivalente a /api/v1/rankings.

Parametro	Tipo	Descripcion

{
  "entries": [
    { "rank": 1, "externalUserId": "user_1", "displayName": "Ana", "totalScore": 9800, "highScore": 1200, "totalPlays": 80, "totalWins": 50, "winRate": 62, "rankingScore": 9800 }
  ],
  "scope": "org",
  "scopeId": "_",
  "period": "all",
  "total": 3120
}

Inscripciones a journeys

GET/api/v1/metrics/journeys/summary

Serie diaria de inscripciones a journeys. Respaldado por el rollup nocturno (~24h de retraso).

Parametro	Tipo	Descripcion

{
  "range": { "from": "2026-06-14T00:00:00.000Z", "to": "2026-06-16T00:00:00.000Z" },
  "granularity": "day",
  "freshness": "daily-rollup",
  "totals": { "enrolled": 540 },
  "series": [
    { "date": "2026-06-14", "enrolled": 22 },
    { "date": "2026-06-15", "enrolled": 31 }
  ]
}

El funnel por journey (completados/abandonados) no esta en el rollup todavia.