# Lejek konwersji i mapa ciepła: dokumentacja modułu PrestaShop 8 i 9

> Instalacja, pulpit, lejek, pozyskiwanie, produkty, mapa ciepła, raport tygodniowy i ustawienia modułu DataFirefly Lejek konwersji i Heatmapa dla PrestaShop 8 i 9.

- Strona: <https://www.datafirefly.com/pl/documentation/dffunnelheatmap/>
- Język: pl
- Zaktualizowano: 2026-10-16
- Inne języki: [fr](https://www.datafirefly.com/documentation/dffunnelheatmap/index.md), [en](https://www.datafirefly.com/en/documentation/dffunnelheatmap/index.md), [es](https://www.datafirefly.com/es/documentation/dffunnelheatmap/index.md), [de](https://www.datafirefly.com/de/documentation/dffunnelheatmap/index.md), [it](https://www.datafirefly.com/it/documentation/dffunnelheatmap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffunnelheatmap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffunnelheatmap/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

Moduł **DataFirefly - Lejek konwersji i Heatmapa** (`dffunnelheatmap`) pokazuje, gdzie Twoi odwiedzający rezygnują, skąd przychodzą kupujący i co zatrzymuje ich na Twoich stronach. Łączy lejek konwersji w 9 krokach, raport pozyskiwania, statystyki produktów, mapę ciepła z wykrywaniem kliknięć ze złości i tygodniowy raport e-mail. Całe zbieranie danych jest first-party: nic nie opuszcza Twojego serwera.

Ta dokumentacja dotyczy wersji **1.3.2**, zgodnej z PrestaShop od 8.0 do 9.x (PHP 7.2 lub nowszy).

## Instalacja i aktualizacja

1. Pobierz archiwum `dffunnelheatmap.zip` ze swojego konta klienta.
2. W panelu otwórz **Moduły > Menedżer modułów**, kliknij **Wgraj moduł** i wybierz plik ZIP.
3. Moduł tworzy 6 tabel i dodaje zakładkę **Statystyki > Lejek i mapa ciepła**.

Aby zaktualizować z poprzedniej wersji, wgraj nowy plik ZIP na zainstalowany moduł. Skrypty aktualizacji uruchamiają się same: Twoje dane i ustawienia zostają zachowane.

Brak zależności zewnętrznych: bez Composera, bez CDN. Ustawienia domyślne pasują do większości sklepów: mapa ciepła dla 100% sesji, przechowywanie przez 90 dni, Do Not Track respektowany, pracownicy wykluczeni.

## Pierwsze kroki

Dopóki nie przyjdzie pierwsza wizyta, pulpit pokazuje listę kontrolną: śledzenie włączone, lejek lub mapa ciepła włączone, pierwsza wizyta odebrana. Przeglądarki zalogowane do panelu nie są liczone: aby sprawdzić zbieranie danych, otwórz sklep w oknie prywatnym lub na innym urządzeniu.

## Pulpit

Interfejs ma sześć zakładek: **Pulpit**, **Lejek konwersji**, **Pozyskiwanie**, **Produkty**, **Mapa ciepła** i **Ustawienia**.

- **Wskaźniki**: sesje, unikalni odwiedzający, złożone zamówienia, wskaźnik dodania do koszyka, współczynnik konwersji, śledzony przychód z VAT, średnie zamówienie i największe porzucenie w lejku. Każdy wskaźnik jest porównywany z poprzednim okresem o tej samej długości.
- **Dzień po dniu**: wykres sesji, zamówień lub współczynnika konwersji. Przyciski nad wykresem zmieniają wskaźnik bez przeładowania strony, a link _Pokaż dane_ otwiera tabelę wartości.
- **Rekomendacje**: do 6 ustaleń podzielonych na _Do poprawy_, _Do sprawdzenia_ i _Dobra wiadomość_, każde z linkiem do odpowiedniego raportu.
- **W tej chwili**: odwiedzający z ostatnich 5 minut, oglądane strony i podział według urządzeń, odświeżane co 30 sekund.

Karta podsumowania (sesje, zamówienia i konwersja z ostatnich 7 dni, odwiedzający w tej chwili) pojawia się też na pulpicie startowym PrestaShop.

### Rekomendacje

Pojawiają się dopiero powyżej minimalnej liczby danych, około 30 sesji na urządzenie lub kanał, aby nie wyciągać wniosków z trzech wizyt. Moduł sprawdza:

- największy wyciek w lejku między dwoma krokami;
- odsetek sesji, które wchodzą do kasy i składają zamówienie;
- różnicę konwersji między telefonem a komputerem;
- kanały, które przynoszą ruch bez żadnego zamówienia, oraz kanał o najlepszej konwersji;
- najczęściej oglądany produkt spośród tych, które rzadko trafiają do koszyka;
- stronę z największą liczbą kliknięć ze złości i bez efektu;
- wzrost lub spadek ruchu o co najmniej 20%.

## Lejek konwersji

Lejek liczy sesje. Sesja kończy się po 30 minutach bezczynności. Każda sesja jest liczona na najdalszym kroku, do którego dotarła, oraz we wszystkich wcześniejszych: lejek zawsze się zwęża.

1. **Wizyta**: dowolna odsłona strony.
2. **Strona produktu**: wyświetlenie karty produktu.
3. **Dodanie do koszyka**: wykrywane po stronie serwera, niezależnie od strony, z której nastąpiło.
4. **Strona koszyka**: wyświetlenie koszyka.
5. **Kasa**: wejście do procesu zamówienia.
6. **Adres**: krok adresu w standardowej kasie, wykrywany w przeglądarce.
7. **Dostawa**: wybór przewoźnika, wykrywany w przeglądarce.
8. **Płatność**: krok płatności, wykrywany w przeglądarce.
9. **Złożone zamówienie**: zapisywane po stronie serwera przy zatwierdzeniu zamówienia, a następnie potwierdzane przez stronę potwierdzenia.

Szczegółowa tabela pokazuje dla każdego kroku sesje, które do niego dotarły, ich udział, sesje utracone od poprzedniego kroku, współczynnik porzuceń i sesje, które uruchomiły sam krok. Dodanie do koszyka ze strony kategorii pomija na przykład stronę produktu. Wiersze z porzuceniem powyżej 30% lub 50% są wyróżnione kolorem.

Kolumna **vs poprzedni okres** pokazuje zmianę udziału sesji w punktach. Tabela **Konwersja według urządzenia** porównuje komputer, tablet i telefon. Przycisk **Eksportuj CSV** pobiera lejek z bieżącymi filtrami.

## Pozyskiwanie

Każda sesja jest przypisana do kanału na podstawie domeny strony źródłowej (zapisywana jest tylko domena), parametrów UTM i identyfikatorów kliknięć reklamowych.

- **Bezpośrednie**: brak strony źródłowej i parametrów UTM.
- **Wyszukiwanie organiczne**: wyszukiwarki (Google, Bing, Qwant, DuckDuckGo, Ecosia...).
- **Płatne reklamy**: identyfikator kliknięcia Google Ads lub Microsoft Ads (`gclid`, `msclkid`) albo `utm_medium` typu cpc, ppc, paid lub display.
- **Media społecznościowe**: Facebook, Instagram, TikTok, LinkedIn, Pinterest, X, YouTube... albo link z `fbclid` lub `ttclid`.
- **E-mail**: `utm_medium=email` lub poczta webowa (Gmail, Outlook...).
- **Strony odsyłające**: każda inna strona.
- **Inne kampanie**: parametr UTM, który nie pasuje do żadnego z powyższych przypadków.

Powroty ze strony płatności (PayPal, Stripe...) nie liczą się jako źródło: nigdy nie zastępują prawdziwego pochodzenia wizyty.

Zakładka pokazuje kanały (sesje, udział, odrzucenia, dodania do koszyka, konwersja, zamówienia i przychód), następnie źródła, kampanie `utm_campaign`, strony wejścia z linkiem do ich mapy ciepła oraz podział na nowych i powracających odwiedzających. Kliknij kanał, aby otworzyć lejek przefiltrowany według tego kanału.

## Produkty

Dla każdego produktu: odsłony (jedna na sesję), pierwsze dodania do koszyka, zamówienia, sprzedane ilości, wskaźnik dodania do koszyka i wskaźnik odsłona-zamówienie. Dostępne są cztery sortowania: **Najczęściej oglądane**, **Najczęściej dodawane**, **Najczęściej zamawiane** i **Szanse**.

Sortowanie **Szanse** pokazuje produkty wyświetlone co najmniej 20 razy, których wskaźnik dodania do koszyka jest niższy niż połowa średniej sklepu. Przyciągają odwiedzających, ale coś ich zatrzymuje: cena, zdjęcia, opis, dostępność lub czas dostawy.

## Mapa ciepła

### Wybór strony

Strony są pogrupowane według typu (strona główna, produkty, kategorie, koszyk i kasa...) i posortowane według liczby odsłon. Pole wyszukiwania filtruje po tytule lub adresie. Najczęściej oglądana strona ładuje się automatycznie. Blok **Strony do obserwacji** na górze zakładki pokazuje strony z największą liczbą kliknięć ze złości i bez efektu.

Strona wyświetla się w podglądzie w najczęstszym rozmiarze ekranu jej odwiedzających, dla wybranego urządzenia (komputer, tablet lub telefon). Przewijaj podgląd: warstwa ciepła podąża za nim.

Każde kliknięcie jest umieszczane na elemencie, który kliknął odwiedzający, w tym samym miejscu wewnątrz niego, niezależnie od szerokości jego ekranu, wysokości strony w chwili kliknięcia czy przyklejonego nagłówka. Kliknięcia w element przypięty (pasek dodawania do koszyka u dołu ekranu) zostają na nim podczas przewijania. Jeśli elementu nie ma w podglądzie lub jest ukryty (zwinięte menu, zamknięte okno), kliknięcie wraca do swoich pierwotnych współrzędnych. W podglądzie banery zgód są ukryte i działają tylko skrypty sklepu: skrypty zewnętrzne (tagi, czaty) są blokowane.

### Trzy tryby

- **Kliknięcia**: mapa ciepła kliknięć, od żółtego (mało kliknięć) do ciemnoczerwonego (dużo).
- **Przewijanie**: odsetek odwiedzających, którzy docierają do każdej wysokości strony, ze średnią linią zgięcia.
- **Frustracja**: znaczniki kliknięć ze złości (czerwone) i kliknięć bez efektu (szare). Bliskie kliknięcia są grupowane, a ich liczba jest wyświetlana.

Kliknięcie ze złości to seria 3 kliknięć w ciągu sekundy w tym samym miejscu. Kliknięcie bez efektu to kliknięcie w obraz lub element, który wygląda na klikalny, bez żadnej reakcji strony.

### Segmenty i klikane elementy

Wybór segmentu pokazuje **Wszystkich odwiedzających**, **tylko kupujących** (sesje z zamówieniem) lub **tylko niekupujących**. Panel boczny pokazuje najczęściej klikane elementy wraz z kliknięciami ze złości i bez efektu. Najedź na element, aby zlokalizować go w podglądzie.

Podgląd ładuje stronę sklepu w panelu administracyjnym. Sklep i panel muszą być w tej samej domenie, a serwer nie może wysyłać nagłówka `X-Frame-Options: DENY`: użyj `SAMEORIGIN`.

## Tygodniowy raport e-mail

W każdy poniedziałek e-mail podsumowuje miniony tydzień (od poniedziałku do niedzieli) w porównaniu z poprzednim:

- sesje, złożone zamówienia, współczynnik konwersji i śledzony przychód wraz ze zmianą;
- do 4 punktów, na które warto spojrzeć najpierw, z rekomendacji;
- lejek w 5 kluczowych krokach (wizyta, strona produktu, dodanie do koszyka, kasa, złożone zamówienie);
- 5 głównych kanałów pozyskiwania z konwersją i przychodem;
- przycisk, który otwiera pulpit na tym tygodniu.

### Ustawienia raportu

W **Ustawienia > Tygodniowy raport e-mail**:

- **Wysyłaj raport w każdy poniedziałek**: domyślnie włączone.
- **Odbiorcy**: jeden adres w wierszu. Jeśli pole jest puste, raport trafia na e-mail sklepu.
- **Język raportu**: domyślnie język sklepu. Raport jest dostępny po francusku, angielsku, hiszpańsku, niemiecku, włosku, niderlandzku, polsku i portugalsku.
- **Zapisz i wyślij test**: od razu wysyła odbiorcom raport z zeszłego tygodnia.
- **Podgląd zeszłego tygodnia**: otwiera raport w nowej karcie, dokładnie tak, jak zobaczą go odbiorcy.

### Kiedy raport jest wysyłany?

Zadanie cron nie jest potrzebne. Pierwsza wizyta zarejestrowana w poniedziałek uruchamia wysyłkę, po odpowiedzi dla odwiedzającego, który więc nie czeka. Blokada zapobiega dwóm wysyłkom dla tego samego tygodnia. Po tygodniu bez wizyt żaden e-mail nie jest wysyłany. Po instalacji lub aktualizacji pierwszy raport wychodzi w kolejny poniedziałek.

Raport korzysta z konfiguracji e-mail PrestaShop. Jeśli e-maile są wyłączone w **Zaawansowane > E-mail**, w ustawieniach pojawia się ostrzeżenie. Linki w raporcie otwierają panel bez tokenu bezpieczeństwa: PrestaShop prosi o potwierdzenie przed wyświetleniem strony, to normalne.

## Filtry

Raporty mają wspólny pasek filtrów: **okres** (7, 30, 90 lub 365 dni albo własne daty), **urządzenie**, **kanał** (pulpit i lejek) oraz **sklep** w multisklepie. Filtry są zachowywane przy przechodzeniu między zakładkami.

## Ustawienia

### Śledzenie

- **Włącz śledzenie**, a następnie osobno włącz **lejek konwersji** i **mapę ciepła**.
- **Próbkowanie mapy ciepła** (od 1 do 100%): odsetek sesji zapisywanych dla mapy ciepła. Lejek zawsze zapisuje wszystkie sesje.

### Prywatność

- **Respektuj Do Not Track i Global Privacy Control**: domyślnie włączone.
- **Tryb bez plików cookie**: sesja istnieje w karcie przeglądarki. Unikalni odwiedzający nie są już liczeni.
- **Przechowywanie danych** w dniach (domyślnie 90). Starsze zdarzenia są usuwane automatycznie, najwyżej raz na godzinę.

### Wykluczenia

- **Śledź zalogowanych pracowników**: domyślnie wyłączone, przeglądarki zalogowane do panelu nie są liczone.
- **Wykluczone adresy IP**: jeden w wierszu, dokładny adres, zakres CIDR (`192.168.1.0/24`) lub prefiks (`10.0.*`). Twój bieżący adres jest wyświetlany.
- **Wyklucz tę przeglądarkę**: ustawia plik cookie wykluczenia, przydatne na telefonie lub komputerze niezalogowanym do panelu.

### Konserwacja

Blok **Konserwacja danych** pokazuje ilość zapisanych danych i oferuje trzy działania: czyszczenie danych poza okresem przechowywania, wygenerowanie nowego klucza śledzenia i usunięcie wszystkich danych.

## Prywatność i RODO

- Nie jest zapisywany żaden adres IP, e-mail ani wartość pola formularza.
- Zapisywane są tylko teksty klikalnych elementów (przyciski, linki), a na stronach konta i zamówienia żaden tekst. E-maile i długie ciągi cyfr są maskowane w przeglądarce, a potem na serwerze.
- Techniczne pliki cookie first-party: `dffh_sid` (sesja, 30 minut), `dffh_vid` (anonimowy odwiedzający, 13 miesięcy) i `dffh_optout` (wykluczenie). Tryb bez plików cookie je usuwa.
- Boty i narzędzia audytowe (Lighthouse, PageSpeed...) są ignorowane.
- Adres zbierania danych przyjmuje tylko żądania POST podpisane kluczem śledzenia, a zapisywane są wyłącznie adresy Twojego sklepu.

W zależności od Twojej oceny i oceny Twojego inspektora ochrony danych możesz wspomnieć o tym śledzeniu w polityce prywatności lub włączyć tryb bez plików cookie.

## Rozwiązywanie problemów

**Nie pojawiają się żadne dane.** Sprawdź, czy nie testujesz z przeglądarki zalogowanej do panelu lub z wykluczonego adresu IP i czy Do Not Track nie jest włączony w przeglądarce. Po instalacji wyczyść pamięć podręczną PrestaShop, jeśli używasz cache całych stron.

**Kroki adres, dostawa i płatność pozostają na zerze.** Opierają się na standardowej kasie PrestaShop (motywy Classic i Hummingbird). Zewnętrzny moduł kasy może ich nie udostępniać. Pozostałe kroki, w tym złożone zamówienie, są nadal śledzone po stronie serwera.

**Podgląd mapy ciepła pozostaje pusty.** Sklep i panel muszą być w tej samej domenie, bez nagłówka `X-Frame-Options: DENY`.

**Raport tygodniowy nie dociera.** Użyj _Zapisz i wyślij test_: komunikat pokaże, czy wysyłka się nie powiodła, czy e-maile są wyłączone lub czy brakuje odbiorcy. Sprawdź też folder spam.

## Odinstalowanie

Odinstalowanie usuwa zakładkę, hooki i ustawienia. Zebrane dane są domyślnie zachowywane. Aby je usunąć, przed odinstalowaniem włącz w ustawieniach **Usuń dane przy odinstalowaniu**: wtedy 6 tabel modułu zostanie usuniętych.