---
title: 'Ciclo de Vida del Cliente'
description: 'Cómo el cliente recorre Lead → Customer → Churn, cuándo se asigna cada etapa, y cómo leerlo en el JSON del cliente.'
---

# 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](/es-MX/api-reference/register/customer/get), junto a las demás tags. Basta buscar la tag cuyo `tag` sea `5`, `6` o `7`:

```json
{
    "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 el **`name`** (`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**:

```json
"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 cuando `customer`**: la fecha prevista de churn. Es un **pronóstico vivo** — cada nueva compra la empuja hacia adelante.
- `churnedAt` — presente solo cuando `churn`: 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.
