Analytics de funnel

Obtener metricas de conversion de un funnel.

GET/api/v1/funnels/:funnelId/analytics

Calcula y retorna las metricas de conversion del funnel para el periodo indicado.

Path params

Parametro	Tipo	Descripcion

Query params

Parametro	Tipo	Descripcion

Ejemplo

curl "https://southgames.ai/api/v1/funnels/funnel_abc/analytics?period=30d" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

Respuesta

{
  "id": "snapshot_123",
  "funnelId": "funnel_abc",
  "periodStart": "2026-03-07T00:00:00.000Z",
  "periodEnd": "2026-04-06T00:00:00.000Z",
  "totalEntered": 1200,
  "totalConverted": 180,
  "conversionRate": 15.0,
  "steps": {
    "s1": {
      "entered": 1200,
      "completed": 450,
      "droppedOff": 750,
      "dropOffRate": 62.5,
      "avgTimeToNextMs": 86400000
    },
    "s2": {
      "entered": 450,
      "completed": 180,
      "droppedOff": 270,
      "dropOffRate": 60.0,
      "avgTimeToNextMs": null
    }
  },
  "computedAt": "2026-04-06T12:00:00.000Z"
}

Metricas por paso

Campo	Tipo	Descripcion
`entered`	number	Usuarios que llegaron al paso
`completed`	number	Usuarios que avanzaron al siguiente paso
`droppedOff`	number	Usuarios que abandonaron
`dropOffRate`	number	Porcentaje de abandono
`avgTimeToNextMs`	number \| null	Tiempo promedio al siguiente paso (ms)

Errores

Codigo	Status	Descripcion
`FUNNEL_NOT_FOUND`	404	El funnel no existe
`INVALID_PERIOD`	400	Periodo invalido (usar 7d, 30d, 90d)