Segmentos
Qué segmentos de clientes existen, cómo consultarlos por API y dónde aparecen dentro de otros recursos
Los segmentos son grupos de clientes que Dardo arma y mantiene solo, según cómo se comporta cada uno con tu programa. Sirven para filtrar, para comunicar y para entender qué está pasando con tu base.
curl "https://api.dardo.ai/api/v2/segments" \
-H "X-API-Key: TU_CLAVE_API"Se consultan, no se crean
No hay endpoint para crear, editar ni borrar segmentos. GET /api/v2/segments es la única operación del grupo. Los segmentos son predefinidos y dinámicos: cada cliente entra y sale solo, a medida que cambia su comportamiento. No hay que mantenerlos.
Qué devuelve
| Campo | Tipo | Qué es |
|---|---|---|
id | integer | Identificador del segmento en tu cuenta |
name | string | Nombre del segmento |
type | string | dynamic — el cliente entra y sale según su comportamiento |
customersCount | integer | Cuántos clientes tiene hoy |
{
"data": [
{ "id": 2844321, "name": "RfmNovice", "type": "dynamic", "customersCount": 135 },
{ "id": 2844330, "name": "LoyaltyCardStatusInstalled", "type": "dynamic", "customersCount": 3720 }
],
"meta": { "totalItems": 20, "itemsPerPage": 20, "currentPage": 1 }
}Los id son propios de cada cuenta. No los escribas fijos en tu código: consultá GET /api/v2/segments y resolvé por name, que sí es estable entre cuentas.
Los segmentos
Se agrupan en cuatro familias según lo que miran.
Comportamiento de compra
Cruzan hace cuánto que el cliente no viene con qué tan seguido venía. Son los que usás para decidir a quién comunicarle qué.
| Nombre | A quién agrupa |
|---|---|
RfmNovice | Recién llegados, con poca historia todavía |
RfmPromising | Vinieron hace poco y empiezan a repetir |
RfmChampions | Los mejores: vienen seguido y hace poco |
RfmLoyal | Constantes en el tiempo |
RfmNeedsAttention | Venían bien y están empezando a aflojar |
RfmAboutToSleep | Se están yendo, todavía se pueden recuperar |
RfmAtRisk | Eran buenos clientes y hace rato no vienen |
RfmCantLoseThem | Los que más valen y están a punto de perderse |
RfmHibernating | Hace mucho que no aparecen |
RfmInactive | Sin actividad |
La segmentación por comportamiento de Dardo trabaja con dos ejes: frescura y frecuencia — hace cuánto vino y cada cuánto viene. No usa el eje monetario: cuánto gastó no entra en el cálculo. Si tu integración necesita cruzar por gasto, tenés que hacerlo vos con purchaseSum desde Operaciones.
Dónde tienen la tarjeta
| Nombre | A quién agrupa |
|---|---|
LoyaltyCardStatusInstalled | Tienen la tarjeta instalada |
LoyaltyAppleWallet | La tienen en Apple Wallet |
LoyaltyGooglePay | La tienen en Google Pay |
LoyaltyWalletPasses | La tienen en Wallet Passes |
LoyaltyPWA | La usan como aplicación web |
Datos incompletos
Útiles para saber qué le falta a tu base.
| Nombre | A quién agrupa |
|---|---|
HealthyCardStatusNotInstalled | Se registraron pero nunca instalaron la tarjeta |
HealthyUnknownGender | Sin género cargado |
HealthyEmptyBirthday | Sin fecha de nacimiento cargada |
Cumpleaños
| Nombre | A quién agrupa |
|---|---|
CommunicationBirthdaysToday | Cumplen años hoy |
CommunicationBirthdaysCurrentMonth | Cumplen años este mes |
La lista de arriba es la que traen las cuentas relevadas. Puede variar según la configuración de tu programa: consultá siempre GET /api/v2/segments en tu cuenta en vez de asumir esta lista.
Los segmentos de un cliente
No hace falta pedirlos aparte. Cada cliente ya viene con los suyos embebidos en los recursos donde aparece:
- En Clientes
- En Tarjetas, dentro del objeto
customer - En Operaciones, dentro del objeto
customer
Buscar una tarjeta por teléfono te devuelve, en una sola llamada, la tarjeta, el saldo, el cliente y sus segmentos. Es el camino más corto para que un punto de venta sepa con qué tipo de cliente está tratando.
No hay filtro por segmento en GET /api/v2/customers. Para listar a todos los clientes de un segmento hay que recorrer el padrón y filtrar del lado de tu sistema. Si tu caso lo necesita, escribinos a soporte@dardo.ai.
Reaccionar a un cambio de segmento
Si lo que querés es actuar cuando alguien cae en un segmento —por ejemplo, mandarle algo al que está por perderse— no hace falta que consultes esta lista periódicamente. Las Automatizaciones se disparan solas ante ese cambio.