# RFM-Kundensegmentierung für PrestaShop: Dokumentation

> Das Modul bewertet jeden Kunden von 1 bis 5 nach Aktualität, Häufigkeit und Umsatz seiner Bestellungen, ordnet ihn einem von 11 RFM-Segmenten zu, berechnet sein Abwanderungsrisiko und ermöglicht gemessene Kampagnen…

- Seite: <https://www.datafirefly.com/de/documentation/dfrfmsegment/>
- Sprache: de
- Aktualisiert am: 2026-09-24
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfrfmsegment/index.md), [en](https://www.datafirefly.com/en/documentation/dfrfmsegment/index.md), [es](https://www.datafirefly.com/es/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)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

Das Modul bewertet jeden Kunden von 1 bis 5 nach Aktualität, Häufigkeit und Umsatz seiner Bestellungen, ordnet ihn einem von 11 RFM-Segmenten zu, berechnet sein Abwanderungsrisiko und ermöglicht gemessene Kampagnen mit Kontrollgruppe. Diese Seite behandelt Installation, Einstellungen und jede Ansicht des Moduls.

## Installation

1. Öffnen Sie im Backoffice **Module > Modulmanager** und klicken Sie auf **Modul hochladen**.
2. Laden Sie die ZIP-Datei `dfrfmsegment` hoch. Die Installation legt die Modultabellen und drei Einträge im Menü **Kunden** an: **RFM-Segmentierung** (Dashboard), **RFM-Kundenscores** (Liste) und **RFM-Kampagnen**.
3. Öffnen Sie **Kunden > RFM-Segmentierung** und klicken Sie auf **Scores jetzt berechnen**. Die erste Berechnung analysiert die gesamte Bestellhistorie: einige Sekunden, bei sehr großen Datenbeständen bis zu einer Minute.

Kompatibel mit PrestaShop 8.0 bis 9.x mit demselben ZIP. Für ein Update von einer früheren Version laden Sie einfach das neue ZIP hoch: Die Update-Skripte legen die neuen Tabellen an, ohne Ihre Scores zu verlieren.

## Einstellungen

Die Einstellungen öffnen Sie über die Schaltfläche **Konfigurieren** des Moduls oder **Einstellungen** im Dashboard. Nicht relevante Felder werden je nach Auswahl ausgeblendet. Starten Sie nach einer Änderung die Berechnung neu, um die Parameter anzuwenden.

### Datenquelle

- **Analysezeitraum**: Anzahl der Monate für Häufigkeit und Umsatz (standardmäßig 24, 0 für die gesamte Historie). Die Aktualität nutzt immer die letzte gültige Bestellung, auch wenn sie älter ist.
- **Umsatz**: Produkte netto abzüglich Rabatte (Standard), gezahlter Betrag netto oder brutto. Beträge werden in die Standardwährung umgerechnet. Nur gültige Bestellungen zählen.
- **Gastkonten einbeziehen**: standardmäßig deaktiviert.
- **Echtzeit-Aktualisierung**: bewertet einen Kunden neu, sobald sich der Status einer seiner Bestellungen ändert, mit den Schwellenwerten der letzten vollständigen Berechnung.
- **CSV-Trennzeichen**: Semikolon für Excel in Europa, Komma oder Tabulator.
- **Messzeitraum der Kampagnen**: Zeitraum, in dem Bestellungen in die Ergebnisse einer Kampagne einfließen (standardmäßig 30 Tage).
- **Präfix der Gutscheincodes**: RFM ergibt zum Beispiel Codes wie RFM-7KQ2M9XA.

### Bewertung von 1 bis 5

Jede Dimension arbeitet im **automatischen** Modus (Kunden werden in fünf gleich große Gruppen aufgeteilt) oder im **manuellen** Modus (vier aufsteigende Schwellenwerte). Bei der Aktualität erhält ein Kunde, dessen letzte Bestellung innerhalb des ersten Werts liegt, eine 5. Bei Häufigkeit und Umsatz ergibt das Erreichen des vierten Werts eine 5. Die Häufigkeit ist standardmäßig manuell (2, 3, 5, 10 Bestellungen), weil die meisten Kunden nur einmal bestellen und Quintile dann wenig aussagen.

### Abwanderungsrisiko

Die Risikokennzahl teilt die Tage seit der letzten Bestellung durch den üblichen Abstand zwischen zwei Bestellungen des Kunden. Bei Einmalkäufern nutzt das Modul den mittleren Wiederkaufabstand des Shops. Standardmäßig wechselt der Kunde bei 1,5 zu **Beobachten**, bei 2,5 zu **Abwanderungsgefährdet** und bei 4 zu **Kritisch**.

## Die 11 Segmente

| Segment | Profil | Empfohlene Kampagne |
| --- | --- | --- |
| Champions | Kürzlicher Kauf, häufig, hoher Warenkorb | Vorabzugang, VIP-Vorteile, Bitte um Bewertungen und Empfehlungen |
| Treue Kunden | Kaufen regelmäßig mit gutem Warenkorb | Treueprämien, Upselling |
| Potenziell treue Kunden | Neu, mehr als eine Bestellung | Treueprogramm, persönliche Empfehlungen |
| Neukunden | Erste Bestellung vor Kurzem | Willkommensstrecke, Anreiz für die zweite Bestellung |
| Vielversprechend | Neu, kleiner Warenkorb | Markeninhalte, Grenze für kostenlosen Versand |
| Brauchen Aufmerksamkeit | Durchschnittliche Kunden, letzte Bestellung länger her | Befristetes Angebot auf Basis früherer Käufe |
| Kurz vor dem Einschlafen | Geringer Wert, nachlassende Aktivität | Beliebte Produkte, moderater Rabatt |
| Gefährdet | Kauften regelmäßig, kommen nicht mehr | Persönliche Rückgewinnungs-E-Mail mit starkem Angebot |
| Nicht verlieren | Ehemalige Top-Kunden, die nicht mehr bestellen | Persönlicher Kontakt, Umfrage, bestes Angebot |
| Im Winterschlaf | Geringer Wert, letzte Bestellung lange her | Kostengünstige Reaktivierung, Neuheiten |
| Verloren | Niedrigste Werte überall | Letzter Versuch, danach aus bezahlten Kampagnen ausschließen |

Ein Einmalkäufer mit einem Aktualitäts-Score von 4 oder 5 wird immer als Neukunde eingestuft.

## Dashboard

**Kunden > RFM-Segmentierung** zeigt den gesamten Zustand Ihres Kundenstamms. Eine Navigationsleiste führt zu jedem Abschnitt.

- **Kennzahlen**: bewertete Kunden und Umsatz im Zeitraum, Anteil wiederkehrender Kunden, gefährdeter Umsatz, typischer Wiederkaufabstand.
- **Segmente**: Anzahl und Anteil der Kunden, Umsatzanteil, durchschnittlicher Warenkorb, durchschnittliche Tage seit der letzten Bestellung, Entwicklung des Anteils über 30 Tage, Zugänge in 7 Tagen. Die Schaltflächen **Anzeigen** und **CSV** öffnen oder exportieren das Segment.
- **Entwicklung der Segmente**: Anteil jedes Segments über 30, 90 oder 365 Tage. Das Diagramm erscheint nach zwei Berechnungen an verschiedenen Tagen.
- **Karte Aktualität und Wert**: Zeilen = Aktualitäts-Score, Spalten = Mittel aus Häufigkeits- und Umsatz-Score. Klicken Sie auf eine Zelle, um ihre Kunden zu öffnen.
- **Abwanderungsrisiko**: Kunden und Umsatz je Stufe, mit Liste und Export.
- **Bewegungen der letzten 30 Tage**: Wechsel zwischen Segmenten, grüner Pfeil für einen Aufstieg, roter für einen Abstieg, CSV-Export je Bewegung.
- **Integrationen**: Status der Kundengruppen und der letzten Übertragung an Brevo oder Klaviyo.
- **Wertvolle Stammkunden, die abspringen**: die 10 gefährdeten Kunden mit dem größten Gewicht.

## Kundenliste und Kundenseite

**Kunden > RFM-Kundenscores** listet alle bewerteten Kunden mit Segment, vorherigem Segment, RFM-Code, R- und FM-Score, Tagen seit der letzten Bestellung, Bestellungen und Umsatz im Zeitraum, Risiko und Newsletter-Abo. Jede Spalte lässt sich filtern und sortieren. Markieren Sie Kunden und wählen Sie in den Sammelaktionen **Auswahl als CSV exportieren**.

Auf der Seite eines Kunden (**Kunden > Kunden > Anzeigen**) zeigt die Karte **RFM-Profil** Segment, Scores, Risiko, üblichen Abstand zwischen Bestellungen, vorheriges Segment, letzte Kampagne und Gutscheincode, genutzt oder nicht.

## Kampagnen

### Kampagne erstellen

1. Öffnen Sie **Kunden > RFM-Kampagnen**.
2. Starten Sie mit einer Vorlage (Abspringende Kunden zurückgewinnen, Zweite Bestellung von Neukunden, Treue Kunden im Abwärtstrend, Champions belohnen, Schlafende Kunden reaktivieren) oder stellen Sie Ihre Zielgruppe zusammen: Segmente, Herkunftssegment, Risikostufe, kürzlicher Segmentwechsel, Newsletter-Einwilligung.
3. Die Zusammenfassung rechts zeigt live die Zahl der passenden Kunden, der Zielkunden und der Kontrollgruppe.
4. Klicken Sie auf **Erstellen und CSV herunterladen** oder, bei aktiver Integration, auf **Erstellen und senden an Brevo** bzw. **Klaviyo**. Der Kampagnenbericht öffnet sich und die Datei wird heruntergeladen.

Deaktivieren Sie **Ergebnisse messen** für einen einmaligen Export ohne Speicherung der Liste und ohne Messung.

### Kontrollgruppe

Der Regler **Kontrollgruppe** (0 bis 50 %, standardmäßig 10 %) hält einen zufälligen Teil der Liste zurück. Diese Kunden erscheinen weder in der CSV noch in der Übertragung an Brevo oder Klaviyo. Der Vergleich ihrer Käufe mit denen der Zielkunden zeigt die echte Wirkung der Kampagne. Streben Sie mindestens 100 Kontrollkunden für eine belastbare Aussage an.

### Persönliche Gutscheine

Aktivieren Sie **Für jeden Kunden einen persönlichen Gutschein erstellen** und wählen Sie Art (Prozent oder Betrag), Wert, Gültigkeit, Mindestbestellwert und optional kostenlosen Versand. Jeder Zielkunde erhält eine Einmal-Warenkorbregel, die seinem Konto vorbehalten ist. Der Code steht in der CSV und in den an Brevo oder Klaviyo gesendeten Attributen. Das Limit liegt bei 10.000 Codes pro Kampagne.

### Kampagnenbericht

Der Bericht vergleicht Zielkunden und Kontrollgruppe im Messzeitraum: Konversion, Bestellungen, Umsatz netto, Umsatz pro Kunde, Zuwachs in Konversionspunkten, geschätzter Zusatzumsatz und genutzte Gutscheine. Ein Zwei-Anteile-Test mit 95 % zeigt, ob der Unterschied signifikant ist, und eine Meldung fasst das Ergebnis zusammen. Beim Löschen einer Kampagne werden ihre ungenutzten Gutscheine entfernt; bereits genutzte bleiben für die Bestellhistorie erhalten.

## Kundengruppen

Aktivieren Sie in den Einstellungen im Abschnitt **Kundengruppen** die Synchronisierung und ordnen Sie jedem Segment eine Gruppe zu, oder klicken Sie auf **Eine Gruppe pro Segment erstellen**, um die 11 Gruppen „RFM - ...“ mit Namen in jeder Sprache anzulegen. Eine optionale Gruppe kann alle Kunden ab einer Risikostufe sammeln. Die Synchronisierung läuft nach jeder vollständigen Berechnung und jeder Echtzeit-Aktualisierung.

Verwenden Sie eigene Gruppen: Mitglieder, die nicht mehr zum Segment passen, werden entfernt. Die Standardgruppe des Kunden und die nativen Gruppen Besucher, Gast und Kunde werden nie verändert. In PrestaShop gelten gruppenspezifische Preise nur für die Standardgruppe: Nutzen Sie Warenkorbregeln für Segmentrabatte.

## Brevo und Klaviyo

### Brevo

1. Wählen Sie in den Einstellungen im Abschnitt **E-Mail-Marketing-Synchronisierung** Brevo und fügen Sie Ihren API-Schlüssel ein (Brevo > SMTP und API > API-Schlüssel).
2. Klicken Sie auf **Verbindung testen**: Ihre Brevo-Listen werden mit ihrer ID angezeigt. Tragen Sie die ID der Liste ein, die die Kontakte erhält.
3. Wählen Sie die Namensattribute: FIRSTNAME / LASTNAME oder PRENOM / NOM bei älteren französischen Konten.

Automatisch erstellte Attribute: RFM_SEGMENT, RFM_CODE, RFM_CHURN_LEVEL, RFM_REVENUE, RFM_ORDERS, RFM_LAST_ORDER, RFM_PREV_SEGMENT, RFM_CAMPAIGN, RFM_VOUCHER und RFM_VOUCHER_END.

### Klaviyo

Wählen Sie Klaviyo, fügen Sie einen privaten API-Schlüssel mit Schreibrechten für Profiles und Lists ein und geben Sie optional eine Listen-ID an. Gesendete Eigenschaften: 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 und rfm_voucher_expires.

### So funktioniert die Übertragung

Nur Kontakte mit geänderten Daten seit der letzten Übertragung werden gesendet. Standardmäßig nur Newsletter-Abonnenten. Der Gutscheincode wird nur gesendet, solange er einlösbar ist. Legen Sie danach in Ihrem Tool dynamische Segmente an, zum Beispiel RFM_SEGMENT gleich `at_risk` oder RFM_CAMPAIGN gleich dem Kampagnennamen. Die Übertragung startet über die Schaltfläche **An ... senden** im Dashboard, beim Erstellen einer Kampagne oder automatisch nach jedem Cron, wenn die Option aktiv ist. Der Link **Alle Kontakte erneut senden** erzwingt eine vollständige Übertragung.

## Berechnung automatisieren

Planen Sie eine tägliche Berechnung, um die Scores aktuell zu halten und die Historie aufzubauen. Die Cron-URL mit Token wird im Dashboard und auf der Konfigurationsseite angezeigt. Sie funktioniert auch im Wartungsmodus. Beispiel für eine cPanel-Aufgabe um 3 Uhr nachts:

```
0 3 * * * curl -s "https://www.ihr-shop.de/index.php?fc=module&module=dfrfmsegment&controller=cron&token=IHR_TOKEN" > /dev/null
```

Über die Kommandozeile im PrestaShop-Stammverzeichnis:

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

`--esp` sendet nach der Berechnung die geänderten Kontakte an Brevo oder Klaviyo, `--esp-force` sendet alle Kontakte erneut.

## Spalten der CSV-Datei

Die Spalten behalten englische Namen, damit Sie sie in Ihrem E-Mail-Tool nur einmal zuordnen: 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 und voucher_expires. Die Datei ist UTF-8 mit BOM kodiert und öffnet sich korrekt in Excel.

## Häufige Fragen und Fehlerbehebung

### Ein Kunde erscheint nicht in den Scores

Er hat keine gültige Bestellung, es ist ein Gastkonto bei deaktivierter Option, oder die Berechnung lief seit seiner Bestellung nicht mehr. Prüfen Sie im Multishop auch den Shop-Kontext.

### Das Verlaufsdiagramm ist leer

Es braucht mindestens zwei Berechnungen an verschiedenen Tagen. Planen Sie den täglichen Cron.

### Der Brevo- oder Klaviyo-Test schlägt fehl

Prüfen Sie den API-Schlüssel und bei Klaviyo die Schreibrechte für Profiles und Lists. Die PHP-Erweiterung cURL muss auf dem Server aktiv sein. Die Details des letzten Fehlers stehen im Bereich Integrationen des Dashboards.

### Kundengruppen bleiben leer

Prüfen Sie, ob die Synchronisierung aktiv ist und jedem Segment eine Gruppe zugeordnet ist, und starten Sie die Berechnung neu. Die Gruppen Besucher, Gast und Kunde werden bewusst abgelehnt.

### Deinstallation

Die Deinstallation löscht Scores, Historie und Kampagnen. Die erstellten Kundengruppen und die bereits erzeugten Warenkorbregeln bleiben bestehen, da sie in Ihren Preisregeln oder Bestellungen genutzt werden können.
