Ciclo de Vida del Cliente
Cada cliente de Guper lleva una etapa de ciclo de vida que refleja el momento de su relación con la marca. La etapa se asigna automáticamente en la plataforma (no la gestionas tú) y viene en el JSON del cliente como una tag.
Hay tres etapas, y el cliente tiene exactamente una activa a la vez:
| Etapa | tag |
Qué significa |
|---|---|---|
| 🔵 Lead | 5 |
Registrado, pero aún no ha comprado. Un contacto/prospecto. |
| 🟢 Customer | 6 |
Ya hizo al menos una compra y está activo. |
| 🔴 Churn | 7 |
Era cliente pero quedó inactivo (dejó de comprar más allá de lo esperado). |
Cuándo se asigna cada tag
Este es el punto central — el momento exacto en que el cliente entra en cada etapa:
| Momento en el recorrido | Tag resultante |
|---|---|
| Se crea el registro (primer contacto, sin pedido aún) | recibe Lead |
| El cliente hace su primera compra (primer pedido procesado) | pierde Lead, recibe Customer |
| El cliente queda inactivo — pasa la ventana esperada de recompra sin comprar | pierde Customer, recibe Churn |
| Un cliente en Churn vuelve a comprar | pierde Churn, vuelve a Customer (reactivación) |
registro 1ª compra inactividad
─────────▶ 🔵 Lead ──────────────▶ 🟢 Customer ──────────────▶ 🔴 Churn
▲ │
└───────── nueva compra ─────┘
(reactivación)
Después de la primera compra el cliente nunca vuelve a ser Lead — solo alterna entre Customer y Churn.
¿Cuánto tiempo hasta Churn?
La ventana de inactividad no es fija — se adapta al ritmo de compra de cada cliente:
- Quien compra con frecuencia pasa a Churn antes.
- Quien compra espaciado tiene una ventana mucho más larga.
En la práctica:
- Cliente con historial (2+ compras): pasa a Churn tras ~3× su propio intervalo medio de recompra. Ej.: quien suele comprar cada ~15 días entra en Churn en ~45 días.
- Cliente de primera compra (aún sin cadencia propia): usa el intervalo medio típico de la tienda como ventana (~1×). Ej.: si la tienda recompra cada ~80 días en promedio, el comprador de primera vez tiene ~80 días.
Cómo leerlo en el JSON del cliente
La etapa viene dentro del array tags de la respuesta de Obtener cliente, junto a las demás tags. Basta buscar la tag cuyo tag sea 5, 6 o 7:
{
"id": 4224868,
"name": "Ivone Suerez",
"tags": [
{
"tag": 6,
"name": "Customer",
"createdAt": "2026-05-28T20:20:26-03:00"
},
{
"tag": 2,
"name": "Opt-in",
"createdAt": "2026-05-28T20:18:34-03:00"
}
]
}
- Identifica la etapa por el
tag(5/6/7) o elname(Lead/Customer/Churn). - Solo una tag de ciclo de vida aparece a la vez — la de la etapa actual.
- Si ninguna de las tres aparece, el cliente aún no fue clasificado (ej.: un registro muy reciente en procesamiento).
El objeto lifecycle (recomendado)
Además de la tag, la respuesta trae un objeto lifecycle dedicado — la forma más directa de leer la etapa y, sobre todo, el pronóstico de churn:
"lifecycle": {
"stage": "customer", // lead | customer | churn
"churnAt": "2026-08-25T20:20:26-03:00", // (customer) cuándo pasa a churn si no compra
"churnedAt": null // (churn) cuándo quedó inactivo
}
stage— la etapa actual (lead/customer/churn).churnAt— presente solo cuandocustomer: la fecha prevista de churn. Es un pronóstico vivo — cada nueva compra la empuja hacia adelante.churnedAt— presente solo cuandochurn: cuándo el cliente quedó inactivo.
Uso en campañas
Como la etapa es una tag, se puede usar directamente como segmento en campañas y audiencias:
- Apuntar a Lead → campañas de activación (convertir el contacto en una primera compra).
- Apuntar a Churn → campañas de reactivación (recuperar al cliente).
- Apuntar a Customer → campañas para la base activa.