# Segmentación de Clientes RFM PrestaShop: documentación

> El módulo puntúa a cada cliente de 1 a 5 según la recencia, la frecuencia y el importe de sus pedidos, lo sitúa en uno de los 11 segmentos RFM,…

- Página: <https://www.datafirefly.com/es/documentation/dfrfmsegment/>
- Idioma: es
- Actualizado el: 2026-09-24
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfrfmsegment/index.md), [en](https://www.datafirefly.com/en/documentation/dfrfmsegment/index.md), [de](https://www.datafirefly.com/de/documentation/dfrfmsegment/index.md), [it](https://www.datafirefly.com/it/documentation/dfrfmsegment/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfrfmsegment/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrfmsegment/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfrfmsegment/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

El módulo puntúa a cada cliente de 1 a 5 según la recencia, la frecuencia y el importe de sus pedidos, lo sitúa en uno de los 11 segmentos RFM, calcula su riesgo de abandono y te permite lanzar campañas medidas con grupo de control. Esta página cubre la instalación, los ajustes y cada pantalla del módulo.

## Instalación

1. En el back-office, abre **Módulos > Gestor de módulos** y haz clic en **Subir un módulo**.
2. Sube el archivo ZIP `dfrfmsegment`. La instalación crea las tablas del módulo y tres entradas en el menú **Clientes**: **Segmentación RFM** (panel), **Puntuaciones RFM de clientes** (lista) y **Campañas RFM**.
3. Abre **Clientes > Segmentación RFM** y haz clic en **Calcular puntuaciones ahora**. El primer cálculo analiza todo el historial de pedidos: unos segundos, hasta un minuto en una base muy grande.

Compatible con PrestaShop 8.0 a 9.x con el mismo ZIP. Para actualizar desde una versión anterior, sube el nuevo ZIP: los scripts de actualización crean las tablas nuevas sin perder tus puntuaciones.

## Ajustes

Los ajustes se abren desde el botón **Configurar** del módulo o el botón **Ajustes** del panel. Los campos que no aplican se ocultan según tus elecciones. Tras un cambio, vuelve a lanzar el cálculo para aplicar los nuevos parámetros.

### Origen de los datos

- **Periodo de análisis**: número de meses usados para la frecuencia y el importe (24 por defecto, 0 para todo el historial). La recencia usa siempre el último pedido válido, aunque sea más antiguo.
- **Importe**: productos sin IVA menos descuentos (por defecto), total pagado sin IVA o total pagado con IVA. Los importes se convierten a la moneda por defecto. Solo cuentan los pedidos válidos.
- **Incluir cuentas de invitado**: desactivado por defecto.
- **Actualización en tiempo real**: recalcula a un cliente en cuanto cambia el estado de uno de sus pedidos, con los umbrales del último cálculo completo.
- **Separador CSV**: punto y coma para Excel en Europa, coma o tabulador.
- **Ventana de seguimiento de campañas**: periodo en el que los pedidos cuentan en los resultados de una campaña (30 días por defecto).
- **Prefijo de los códigos**: por ejemplo RFM da códigos como RFM-7KQ2M9XA.

### Puntuación de 1 a 5

Cada dimensión funciona en modo **automático** (los clientes se reparten en cinco grupos del mismo tamaño) o **manual** (cuatro umbrales ascendentes). En recencia, un cliente cuyo último pedido está dentro del primer valor obtiene 5. En frecuencia e importe, alcanzar el cuarto valor da 5. La frecuencia está en manual por defecto (2, 3, 5, 10 pedidos), porque la mayoría de los clientes solo tiene un pedido y los quintiles aportan poco.

### Riesgo de abandono

El ratio de riesgo divide los días desde el último pedido entre el plazo habitual entre dos pedidos del cliente. Para un cliente con un solo pedido, el módulo usa el plazo mediano de recompra de la tienda. Por defecto el cliente pasa a **Vigilar** a 1,5, a **En riesgo de abandono** a 2,5 y a **Crítico** a 4.

## Los 11 segmentos

| Segmento | Perfil | Campaña recomendada |
| --- | --- | --- |
| Campeones | Compra reciente, frecuente, cesta alta | Acceso anticipado, ventajas VIP, petición de reseñas y recomendaciones |
| Clientes fieles | Compran con regularidad con buena cesta | Recompensas de fidelidad, venta de gama superior |
| Fieles potenciales | Recientes, más de un pedido | Programa de fidelización, recomendaciones personalizadas |
| Nuevos clientes | Primer pedido reciente | Secuencia de bienvenida, incentivo al segundo pedido |
| Prometedores | Recientes, cesta pequeña | Contenido de marca, umbral de envío gratis |
| Requieren atención | Clientes medios cuyo último pedido empieza a quedar lejos | Oferta limitada basada en compras anteriores |
| A punto de dormirse | Bajo valor, actividad en descenso | Productos populares, descuento moderado |
| En riesgo | Compraban con regularidad, ya no vuelven | Email de recuperación personalizado con una oferta fuerte |
| No podemos perderlos | Antiguos mejores clientes que dejaron de comprar | Contacto personal, encuesta, mejor oferta |
| Hibernando | Bajo valor, último pedido lejano | Reactivación de bajo coste, novedades |
| Perdidos | Puntuaciones más bajas en todo | Último intento, luego excluir de las campañas de pago |

Un cliente con un solo pedido y una recencia de 4 o 5 siempre se clasifica como Nuevo cliente.

## Panel

**Clientes > Segmentación RFM** reúne todo el estado de tu base. Una barra de navegación lleva a cada sección.

- **Indicadores**: clientes puntuados y facturación del periodo, cuota de clientes recurrentes, facturación en riesgo, plazo típico de recompra.
- **Segmentos**: número y cuota de clientes, cuota de facturación, cesta media, días medios desde el último pedido, evolución de la cuota en 30 días, entradas en 7 días. Los botones **Ver** y **CSV** abren o exportan el segmento.
- **Evolución de los segmentos**: cuota de cada segmento en 30, 90 o 365 días. Aparece tras dos cálculos hechos en días distintos.
- **Mapa de recencia y valor**: filas = puntuación de recencia, columnas = media de las puntuaciones de frecuencia e importe. Haz clic en una celda para ver sus clientes.
- **Riesgo de abandono**: clientes y facturación por nivel, con lista y exportación.
- **Movimientos de los últimos 30 días**: pasos de un segmento a otro, flecha verde para una mejora, roja para una bajada, exportación CSV por movimiento.
- **Integraciones**: estado de los grupos de clientes y del último envío a Brevo o Klaviyo.
- **Buenos clientes recurrentes que se están alejando**: los 10 clientes en riesgo que más pesan.

## Lista de clientes y ficha de cliente

**Clientes > Puntuaciones RFM de clientes** muestra todos los clientes puntuados con su segmento, segmento anterior, código RFM, puntuaciones R y FM, días desde el último pedido, pedidos y facturación del periodo, riesgo y suscripción al boletín. Cada columna se filtra y ordena. Marca clientes y elige **Exportar la selección a CSV** en las acciones en lote.

En la ficha de un cliente (**Clientes > Clientes > Ver**), el bloque **Perfil RFM** muestra su segmento, puntuaciones, riesgo, plazo habitual entre pedidos, segmento anterior, última campaña y cupón, usado o no.

## Campañas

### Crear una campaña

1. Abre **Clientes > Campañas RFM**.
2. Parte de una plantilla (Recuperar clientes que se alejan, Segundo pedido de nuevos clientes, Clientes fieles que han bajado, Recompensar a los campeones, Reactivar clientes dormidos) o define tu público: segmentos, segmento de origen, nivel de riesgo, cambio reciente de segmento, consentimiento del boletín.
3. El resumen de la derecha muestra en directo el número de clientes que coinciden, objetivo y de control.
4. Haz clic en **Crear y descargar CSV**, o **Crear y enviar a Brevo** o **Klaviyo** si la integración está activa. Se abre el informe de la campaña y se descarga el archivo.

Desmarca **Seguir los resultados** para una simple exportación puntual, sin guardar la lista ni medir nada.

### Grupo de control

El control deslizante **Grupo de control** (0 a 50 %, 10 % por defecto) aparta una parte aleatoria de la lista. Estos clientes no aparecen ni en el CSV ni en el envío a Brevo o Klaviyo. Comparar sus compras con las de los clientes objetivo da el efecto real de la campaña. Apunta a al menos 100 clientes de control para una conclusión fiable.

### Cupones personales

Marca **Crear un cupón personal para cada cliente** y elige el tipo (porcentaje o importe), el valor, la validez, el pedido mínimo y opcionalmente el envío gratis. Cada cliente objetivo recibe una regla de carrito de un solo uso, reservada a su cuenta. El código figura en el CSV y en los atributos enviados a Brevo o Klaviyo. El límite es de 10.000 códigos por campaña.

### Informe de campaña

El informe compara a los clientes objetivo y al grupo de control durante la ventana de seguimiento: conversión, pedidos, facturación sin IVA, facturación por cliente, mejora en puntos de conversión, facturación adicional estimada y cupones usados. Un test de dos proporciones al 95 % indica si la diferencia es significativa, y un mensaje resume la conclusión. Al eliminar una campaña se retiran sus cupones no usados; los ya usados se conservan para el historial de pedidos.

## Grupos de clientes

En los ajustes, sección **Grupos de clientes**, activa la sincronización y asocia un grupo a cada segmento, o haz clic en **Crear un grupo por segmento** para generar los 11 grupos "RFM - ..." con nombre en cada idioma. Un grupo opcional puede reunir a todos los clientes por encima de un nivel de riesgo. La sincronización se ejecuta tras cada cálculo completo y cada actualización en tiempo real.

Usa grupos dedicados: los miembros que ya no corresponden al segmento se retiran. El grupo por defecto del cliente y los grupos nativos Visitante, Invitado y Cliente nunca se modifican. En PrestaShop los precios específicos por grupo solo se aplican al grupo por defecto: usa reglas de carrito para los descuentos por segmento.

## Brevo y Klaviyo

### Brevo

1. En los ajustes, sección **Sincronización de email marketing**, elige Brevo y pega tu clave API (Brevo > SMTP y API > Claves API).
2. Haz clic en **Probar conexión**: aparecen tus listas de Brevo con su ID. Introduce el ID de la lista que recibirá los contactos.
3. Elige los atributos de nombre: FIRSTNAME / LASTNAME, o PRENOM / NOM para las cuentas francesas antiguas.

Atributos creados automáticamente: RFM_SEGMENT, RFM_CODE, RFM_CHURN_LEVEL, RFM_REVENUE, RFM_ORDERS, RFM_LAST_ORDER, RFM_PREV_SEGMENT, RFM_CAMPAIGN, RFM_VOUCHER y RFM_VOUCHER_END.

### Klaviyo

Elige Klaviyo, pega una clave API privada con permisos de escritura en Profiles y Lists e indica opcionalmente el ID de una lista. Propiedades enviadas: rfm_segment, rfm_code, rfm_r, rfm_f, rfm_m, rfm_churn_level, rfm_revenue, rfm_orders, rfm_last_order, rfm_previous_segment, rfm_campaign, rfm_voucher y rfm_voucher_expires.

### Cómo funciona el envío

Solo se envían los contactos cuyos datos han cambiado desde el último envío. Por defecto solo se envían los suscriptores del boletín. El cupón solo se envía mientras siga siendo utilizable. Después crea segmentos dinámicos en tu herramienta, por ejemplo RFM_SEGMENT igual a `at_risk`, o RFM_CAMPAIGN igual al nombre de la campaña. El envío se lanza desde el botón **Enviar a** del panel, al crear una campaña, o automáticamente tras cada cron si la opción está activa. El enlace **Reenviar todos los contactos** fuerza un envío completo.

## Automatizar el cálculo

Programa un cálculo diario para mantener las puntuaciones al día y construir el historial. La URL de cron, con su token, se muestra en el panel y en la página de configuración. También funciona cuando la tienda está en mantenimiento. Ejemplo de tarea cPanel a las 3 de la mañana:

```
0 3 * * * curl -s "https://www.tu-tienda.es/index.php?fc=module&module=dfrfmsegment&controller=cron&token=TU_TOKEN" > /dev/null
```

Desde la línea de comandos, en la raíz de PrestaShop:

```
php modules/dfrfmsegment/cli.php
php modules/dfrfmsegment/cli.php --esp
php modules/dfrfmsegment/cli.php --esp-force
```

`--esp` envía los contactos modificados a Brevo o Klaviyo tras el cálculo, `--esp-force` reenvía todos los contactos.

## Columnas del archivo CSV

Las columnas conservan nombres en inglés para asociarlas una sola vez en tu herramienta de email: email, firstname, lastname, company, language, newsletter, optin, segment, segment_label, rfm_code, r_score, f_score, m_score, orders_total, orders_period, revenue_period, avg_basket, first_order, last_order, recency_days, churn_level, churn_label, churn_score, previous_segment, segment_changed_at, id_customer, campaign, voucher_code y voucher_expires. El archivo está en UTF-8 con BOM para abrirse correctamente en Excel.

## Preguntas frecuentes y solución de problemas

### Un cliente no aparece en las puntuaciones

No tiene ningún pedido válido, es una cuenta de invitado con la opción desactivada, o el cálculo no se ha lanzado desde su pedido. En multitienda, comprueba también el contexto de tienda.

### El gráfico de evolución está vacío

Necesita al menos dos cálculos hechos en días distintos. Programa el cron diario.

### La prueba de Brevo o Klaviyo falla

Comprueba la clave API y, para Klaviyo, los permisos de escritura en Profiles y Lists. La extensión PHP cURL debe estar activa en el servidor. El detalle del último error aparece en el panel Integraciones.

### Los grupos de clientes no se llenan

Comprueba que la sincronización está activada y que cada segmento tiene un grupo asociado, luego vuelve a lanzar el cálculo. Los grupos Visitante, Invitado y Cliente se rechazan a propósito.

### Desinstalación

La desinstalación borra las puntuaciones, el historial y las campañas. Los grupos de clientes creados y las reglas de carrito ya generadas se mantienen, porque pueden usarse en tus reglas de precio o en tus pedidos.
