# Segmentacja klientów RFM PrestaShop: dokumentacja
> Moduł ocenia każdego klienta w skali od 1 do 5 pod względem świeżości, częstotliwości i wartości zamówień, przypisuje go do jednego z 11 segmentów RFM, oblicza ryzyko odejścia i pozwala…
- Strona:
- Język: pl
- Zaktualizowano: 2026-09-24
- Inne języki: [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), [de](https://www.datafirefly.com/de/documentation/dfrfmsegment/index.md), [it](https://www.datafirefly.com/it/documentation/dfrfmsegment/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrfmsegment/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfrfmsegment/index.md)
- Indeks:
Moduł ocenia każdego klienta w skali od 1 do 5 pod względem świeżości, częstotliwości i wartości zamówień, przypisuje go do jednego z 11 segmentów RFM, oblicza ryzyko odejścia i pozwala prowadzić mierzalne kampanie z grupą kontrolną. Ta strona opisuje instalację, ustawienia i każdy ekran modułu.
## Instalacja
1. W panelu administracyjnym otwórz **Moduły > Menedżer modułów** i kliknij **Prześlij moduł**.
2. Prześlij plik ZIP `dfrfmsegment`. Instalacja tworzy tabele modułu i trzy pozycje w menu **Klienci**: **Segmentacja RFM** (panel), **Oceny RFM klientów** (lista) i **Kampanie RFM**.
3. Otwórz **Klienci > Segmentacja RFM** i kliknij **Oblicz oceny teraz**. Pierwsze obliczenie analizuje całą historię zamówień: kilka sekund, do minuty przy bardzo dużej bazie.
Zgodny z PrestaShop od 8.0 do 9.x z tym samym plikiem ZIP. Aby zaktualizować wcześniejszą wersję, prześlij nowy ZIP: skrypty aktualizacji tworzą nowe tabele bez utraty ocen.
## Ustawienia
Ustawienia otwiera przycisk **Konfiguruj** modułu lub przycisk **Ustawienia** w panelu. Pola, które nie mają zastosowania, są ukrywane zależnie od wyborów. Po zmianie uruchom obliczenie ponownie, aby zastosować nowe parametry.
### Źródło danych
- **Okres analizy**: liczba miesięcy uwzględnianych dla częstotliwości i wartości (domyślnie 24, 0 dla całej historii). Świeżość zawsze opiera się na ostatnim ważnym zamówieniu, nawet starszym.
- **Wartość**: produkty netto minus rabaty (domyślnie), zapłacona kwota netto lub brutto. Kwoty są przeliczane na walutę domyślną. Liczą się tylko ważne zamówienia.
- **Uwzględnij konta gości**: domyślnie wyłączone.
- **Aktualizacja w czasie rzeczywistym**: przelicza klienta, gdy tylko zmieni się status jednego z jego zamówień, z progami z ostatniego pełnego obliczenia.
- **Separator CSV**: średnik dla Excela w Europie, przecinek lub tabulator.
- **Okno śledzenia kampanii**: okres, w którym zamówienia liczą się do wyników kampanii (domyślnie 30 dni).
- **Prefiks kodów rabatowych**: na przykład RFM daje kody typu RFM-7KQ2M9XA.
### Ocena od 1 do 5
Każdy wymiar działa w trybie **automatycznym** (klienci są dzieleni na pięć równych grup) lub **ręcznym** (cztery rosnące progi). Dla świeżości klient, którego ostatnie zamówienie mieści się w pierwszej wartości, otrzymuje 5. Dla częstotliwości i wartości osiągnięcie czwartego progu daje 5. Częstotliwość jest domyślnie w trybie ręcznym (2, 3, 5, 10 zamówień), bo większość klientów ma tylko jedno zamówienie, a kwintyle niewiele wtedy mówią.
### Ryzyko odejścia
Wskaźnik ryzyka dzieli liczbę dni od ostatniego zamówienia przez zwykły odstęp między dwoma zamówieniami klienta. Dla klienta z jednym zamówieniem moduł używa mediany czasu ponownego zakupu w sklepie. Domyślnie klient przechodzi do **Obserwacji** przy 1,5, do **Zagrożonych odejściem** przy 2,5 i do **Krytycznych** przy 4.
## 11 segmentów
| Segment | Profil | Zalecana kampania |
| --- | --- | --- |
| Mistrzowie | Niedawny zakup, często, wysoki koszyk | Wcześniejszy dostęp, korzyści VIP, prośba o opinie i polecenia |
| Lojalni klienci | Kupują regularnie z dobrym koszykiem | Nagrody za lojalność, upsell |
| Potencjalnie lojalni | Niedawni, więcej niż jedno zamówienie | Program lojalnościowy, spersonalizowane rekomendacje |
| Nowi klienci | Niedawne pierwsze zamówienie | Sekwencja powitalna, zachęta do drugiego zamówienia |
| Obiecujący | Niedawni, mały koszyk | Treści marki, próg darmowej dostawy |
| Wymagają uwagi | Przeciętni klienci, ostatnie zamówienie dość dawno | Oferta ograniczona czasowo oparta na wcześniejszych zakupach |
| Zasypiający | Niska wartość, malejąca aktywność | Popularne produkty, umiarkowany rabat |
| Zagrożeni | Kupowali regularnie, już nie wracają | Spersonalizowany e-mail odzyskujący z mocną ofertą |
| Nie wolno ich stracić | Dawni najlepsi klienci, którzy przestali zamawiać | Kontakt osobisty, ankieta, najlepsza oferta |
| Uśpieni | Niska wartość, ostatnie zamówienie dawno temu | Tania reaktywacja, nowości |
| Utraceni | Najniższe oceny we wszystkim | Ostatnia próba, potem wykluczenie z płatnych kampanii |
Klient z jednym zamówieniem i oceną świeżości 4 lub 5 zawsze trafia do Nowych klientów.
## Panel
**Klienci > Segmentacja RFM** pokazuje pełny stan bazy. Pasek nawigacji prowadzi do każdej sekcji.
- **Wskaźniki**: ocenieni klienci i przychód z okresu, udział powracających klientów, zagrożony przychód, typowy czas ponownego zakupu.
- **Segmenty**: liczba i udział klientów, udział w przychodzie, średni koszyk, średnia liczba dni od ostatniego zamówienia, zmiana udziału w 30 dni, nowi w 7 dni. Przyciski **Zobacz** i **CSV** otwierają lub eksportują segment.
- **Zmiany segmentów**: udział każdego segmentu w okresie 30, 90 lub 365 dni. Wykres pojawia się po dwóch obliczeniach wykonanych w różne dni.
- **Mapa świeżości i wartości**: wiersze = ocena świeżości, kolumny = średnia ocen częstotliwości i wartości. Kliknij komórkę, aby otworzyć jej klientów.
- **Ryzyko odejścia**: klienci i przychód według poziomu, z listą i eksportem.
- **Przepływy z ostatnich 30 dni**: przejścia między segmentami, zielona strzałka przy awansie, czerwona przy spadku, eksport CSV dla każdego przepływu.
- **Integracje**: stan grup klientów i ostatniej wysyłki do Brevo lub Klaviyo.
- **Wartościowi stali klienci, którzy się oddalają**: 10 zagrożonych klientów o największej wadze.
## Lista klientów i karta klienta
**Klienci > Oceny RFM klientów** pokazuje wszystkich ocenionych klientów z segmentem, poprzednim segmentem, kodem RFM, ocenami R i FM, dniami od ostatniego zamówienia, zamówieniami i przychodem z okresu, ryzykiem i zapisem do newslettera. Każdą kolumnę można filtrować i sortować. Zaznacz klientów i wybierz **Eksportuj zaznaczone do CSV** w akcjach zbiorczych.
Na stronie klienta (**Klienci > Klienci > Zobacz**) karta **Profil RFM** pokazuje segment, oceny, ryzyko, zwykły odstęp między zamówieniami, poprzedni segment, ostatnią kampanię i kod rabatowy, wykorzystany lub nie.
## Kampanie
### Tworzenie kampanii
1. Otwórz **Klienci > Kampanie RFM**.
2. Zacznij od szablonu (Odzyskaj odchodzących klientów, Drugie zamówienie nowych klientów, Lojalni klienci, którzy spadli, Nagrodź mistrzów, Reaktywuj uśpionych klientów) lub zbuduj własną grupę: segmenty, segment pochodzenia, poziom ryzyka, niedawna zmiana segmentu, zgoda na newsletter.
3. Podsumowanie po prawej pokazuje na żywo liczbę pasujących klientów, docelowych i kontrolnych.
4. Kliknij **Utwórz i pobierz CSV** albo **Utwórz i wyślij do Brevo** lub **Klaviyo**, jeśli integracja jest aktywna. Otwiera się raport kampanii, a plik zostaje pobrany.
Odznacz **Śledź wyniki**, aby wykonać jednorazowy eksport bez zapisywania listy i bez pomiaru.
### Grupa kontrolna
Suwak **Grupa kontrolna** (od 0 do 50 %, domyślnie 10 %) odkłada losową część listy. Ci klienci nie trafiają ani do CSV, ani do wysyłki do Brevo lub Klaviyo. Porównanie ich zakupów z zakupami klientów docelowych daje rzeczywisty efekt kampanii. Dla wiarygodnego wniosku celuj w co najmniej 100 klientów kontrolnych.
### Kupony osobiste
Zaznacz **Utwórz osobisty kupon dla każdego klienta** i wybierz typ (procent lub kwota), wartość, ważność, minimalne zamówienie i opcjonalnie darmową dostawę. Każdy klient docelowy otrzymuje jednorazową regułę koszyka zarezerwowaną dla jego konta. Kod trafia do CSV i do atrybutów wysyłanych do Brevo lub Klaviyo. Limit to 10 000 kodów na kampanię.
### Raport kampanii
Raport porównuje klientów docelowych i grupę kontrolną w oknie śledzenia: konwersję, zamówienia, przychód netto, przychód na klienta, wzrost w punktach konwersji, szacowany dodatkowy przychód i wykorzystane kupony. Test dwóch proporcji na poziomie 95 % pokazuje, czy różnica jest istotna, a komunikat podsumowuje wniosek. Usunięcie kampanii usuwa jej niewykorzystane kupony; wykorzystane zostają dla historii zamówień.
## Grupy klientów
W ustawieniach, w sekcji **Grupy klientów**, włącz synchronizację i przypisz grupę do każdego segmentu albo kliknij **Utwórz grupę dla każdego segmentu**, aby wygenerować 11 grup „RFM - ...” z nazwami w każdym języku. Opcjonalna grupa może zbierać wszystkich klientów powyżej poziomu ryzyka. Synchronizacja działa po każdym pełnym obliczeniu i każdej aktualizacji w czasie rzeczywistym.
Używaj dedykowanych grup: członkowie, którzy już nie pasują do segmentu, są z nich usuwani. Domyślna grupa klienta i natywne grupy Gość, Klient-gość i Klient nigdy nie są zmieniane. W PrestaShop ceny specyficzne dla grupy działają tylko dla grupy domyślnej: rabaty dla segmentów realizuj regułami koszyka.
## Brevo i Klaviyo
### Brevo
1. W ustawieniach, w sekcji **Synchronizacja e-mail marketingu**, wybierz Brevo i wklej klucz API (Brevo > SMTP i API > Klucze API).
2. Kliknij **Test połączenia**: pojawią się Twoje listy Brevo z ich ID. Wpisz ID listy, która ma otrzymywać kontakty.
3. Wybierz atrybuty imienia: FIRSTNAME / LASTNAME lub PRENOM / NOM dla starszych francuskich kont.
Atrybuty tworzone automatycznie: RFM_SEGMENT, RFM_CODE, RFM_CHURN_LEVEL, RFM_REVENUE, RFM_ORDERS, RFM_LAST_ORDER, RFM_PREV_SEGMENT, RFM_CAMPAIGN, RFM_VOUCHER i RFM_VOUCHER_END.
### Klaviyo
Wybierz Klaviyo, wklej prywatny klucz API z uprawnieniami zapisu Profiles i Lists i opcjonalnie podaj ID listy. Wysyłane właściwości: 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 i rfm_voucher_expires.
### Jak działa wysyłka
Wysyłane są tylko kontakty, których dane zmieniły się od ostatniej wysyłki. Domyślnie tylko subskrybenci newslettera. Kod rabatowy jest wysyłany tylko, dopóki można go wykorzystać. Następnie utwórz w swoim narzędziu segmenty dynamiczne, na przykład RFM_SEGMENT równe `at_risk` lub RFM_CAMPAIGN równe nazwie kampanii. Wysyłkę uruchamia przycisk **Wyślij do** w panelu, utworzenie kampanii lub automatycznie każdy cron, jeśli opcja jest włączona. Link **Wyślij ponownie wszystkie kontakty** wymusza pełną wysyłkę.
## Automatyzacja obliczeń
Zaplanuj codzienne obliczenie, aby oceny były aktualne i budowała się historia. URL crona z tokenem jest widoczny w panelu i na stronie konfiguracji. Działa też w trybie konserwacji sklepu. Przykładowe zadanie cPanel o 3 w nocy:
```
0 3 * * * curl -s "https://www.twoj-sklep.pl/index.php?fc=module&module=dfrfmsegment&controller=cron&token=TWOJ_TOKEN" > /dev/null
```
Z wiersza poleceń, w katalogu głównym PrestaShop:
```
php modules/dfrfmsegment/cli.php
php modules/dfrfmsegment/cli.php --esp
php modules/dfrfmsegment/cli.php --esp-force
```
`--esp` wysyła zmienione kontakty do Brevo lub Klaviyo po obliczeniu, `--esp-force` wysyła ponownie wszystkie kontakty.
## Kolumny pliku CSV
Kolumny mają angielskie nazwy, aby wystarczyło je raz przypisać w narzędziu e-mail: 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 i voucher_expires. Plik jest zapisany w UTF-8 z BOM, aby poprawnie otwierał się w Excelu.
## Najczęstsze pytania i rozwiązywanie problemów
### Klient nie pojawia się w ocenach
Nie ma żadnego ważnego zamówienia, jest kontem gościa przy wyłączonej opcji albo obliczenie nie było uruchamiane od jego zamówienia. W trybie multisklepu sprawdź też kontekst sklepu.
### Wykres zmian jest pusty
Potrzebuje co najmniej dwóch obliczeń wykonanych w różne dni. Zaplanuj codzienny cron.
### Test Brevo lub Klaviyo nie działa
Sprawdź klucz API, a dla Klaviyo uprawnienia zapisu Profiles i Lists. Na serwerze musi być włączone rozszerzenie PHP cURL. Szczegóły ostatniego błędu są widoczne w panelu Integracje.
### Grupy klientów pozostają puste
Sprawdź, czy synchronizacja jest włączona i czy każdy segment ma przypisaną grupę, a potem uruchom obliczenie ponownie. Grupy Gość, Klient-gość i Klient są celowo odrzucane.
### Odinstalowanie
Odinstalowanie usuwa oceny, historię i kampanie. Utworzone grupy klientów i wygenerowane już reguły koszyka pozostają, ponieważ mogą być używane w Twoich regułach cenowych lub zamówieniach.