# Koło Fortuny i Pop-up Exit-Intent

> Dokumentacja modułu Koło Fortuny i Pop-up Exit-Intent dla PrestaShop 8 i 9: segmenty, losowanie po stronie serwera, unikalne kupony, leady i RODO.

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

## Prezentacja

Moduł **Koło Fortuny i Pop-up Exit-Intent** przechwytuje odwiedzających dokładnie w momencie, gdy zamierzają opuścić Twój sklep, i proponuje im grę: wpisują e-mail, kręcą kołem i odchodzą z kuponem. Zamieniasz ciche porzucenie w kwalifikowany lead, a często w natychmiastowe zamówienie.

Cechą szczególną modułu jest to, że **wygrywająca nagroda jest ustalana po stronie serwera** przez ważone losowanie. Prawdopodobieństwa nigdy nie trafiają do przeglądarki: koło jedynie animuje wynik rozstrzygnięty wcześniej w PHP, co uniemożliwia jakiekolwiek manipulacje po stronie klienta.

Moduł jest zgodny z PrestaShop 8.0 do 9.x, bez Composera i bez zależności zewnętrznych. Wszystkie teksty są konfigurowalne i wielojęzyczne.

## Instalacja

1. W zapleczu otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Prześlij moduł** i wybierz plik `dfexitwheel.zip`.
3. Instalacja automatycznie tworzy trzy tabele (segmenty, leady, konfiguracja), sześć domyślnych segmentów i dwie zakładki administracyjne.
4. Moduł jest aktywny od razu, z działającymi wartościami domyślnymi.

Żadne ustawienie nie jest wymagane na start: koło działa od momentu instalacji. Możesz potem dopracować segmenty, teksty i wyzwalacze.

## Konfiguracja ogólna

Na stronie konfiguracji modułu (**Konfiguruj**) ustawiasz:

- **Aktywuj moduł**: przełącznik główny.
- **Tytuł, podtytuł, placeholder e-maila, tekst przycisku**: wszystkie etykiety pop-upu, per język.
- **Tekst zgody (RODO)**: zdanie wyświetlane obok obowiązkowego pola zgody.
- **Komunikat wygranej / braku wygranej**: to, co pojawia się po losowaniu.
- **Kolor główny**: kolor akcentu pop-upu i koła.
- **Czas do kwalifikacji**: minimalny czas spędzony w sklepie, zanim pop-up może się uruchomić.
- **Częstotliwość (dni)**: okres, w którym odwiedzający nie zobaczy pop-upu ponownie.
- **Pokazuj zalogowanym klientom**, **Aktywuj na mobile**, **Minutnik mobile**.
- **Domyślna ważność kuponów**, **Jedna gra na e-mail**, **Zapisz do newslettera**.

Pola tekstowe są wielojęzyczne: użyj selektora języka przy każdym polu, aby wpisać wersję dla każdego języka sklepu.

## Zarządzanie segmentami koła

Ekran **Segmenty koła** wymienia wyświetlane części. Dla każdej definiujesz:

- **Etykietę**: tekst na segmencie (np. „-10%", „Darmowa dostawa", „Tym razem nic!").
- **Kolor**: kolor tła segmentu.
- **Typ nagrody**: rabat procentowy, rabat kwotowy, darmowa dostawa lub brak (segment bez wygranej).
- **Wartość**: procent lub kwota, zależnie od typu.
- **Wagę**: względne prawdopodobieństwo trafienia na ten segment. Wysoka waga oznacza częsty segment.
- **Kwotę minimalną**: minimalną wartość koszyka wymaganą, aby kupon miał zastosowanie.
- **Prefiks kodu** i **ważność (dni)** właściwe dla segmentu.
- **Pozycję** i **aktywność**.

### Jak działa ważenie

Losowanie sumuje wagi wszystkich aktywnych segmentów, a następnie wybiera segment proporcjonalnie do jego wagi. Przykład: przy wagach 25, 30, 20, 15, 8 i 2 segment o wadze 2 (główna nagroda) wypada mniej więcej 2 razy na 100. Zachowujesz więc pełną kontrolę nad hojnością koła.

Aby koło było rentowne, zachowaj jeden lub dwa segmenty „bez wygranej" albo z niskim rabatem o wysokiej wadze, a mocne rabaty zarezerwuj dla niskich wag.

## Kupony i reguły koszyka

Przy każdej wygranej moduł tworzy **naprawdę unikalną regułę koszyka PrestaShop (CartRule)**:

- Jedno użycie łącznie i jedno na klienta.
- Data wygaśnięcia obliczana z ważności segmentu (lub z ważności domyślnej).
- Opcjonalna kwota minimalna.
- Unikalny kod generowany dla każdego zwycięzcy.

Możliwe są trzy typy nagród: **procent**, **kwota stała** i **darmowa dostawa**. Kod jest wyświetlany zwycięzcy z przyciskiem kopiowania i wstępnie wypełnionym linkiem do sklepu.

Ponieważ każdy kod jest imienny i jednorazowy, nie da się go udostępnić ani odsprzedać na stronach z okazjami, w przeciwieństwie do kodu generycznego.

## Zebrane leady i eksport CSV

Ekran **Zebrane leady** rejestruje każdy udział: e-mail, uzyskany segment, kod kuponu, zgodę, datę, język i sklep. Lista jest tylko do odczytu i oferuje **eksport CSV**, którym zasilisz swoje narzędzie e-mailingowe.

Jeśli opcja **Zapisz do newslettera** jest aktywna, e-mail trafia też do natywnych subskrybentów PrestaShop (tabela zapisów do newslettera), o ile udzielono zgody.

## Wyzwalanie na desktop i mobile

Na **desktopie** pop-up uruchamia się przez wykrycie intencji wyjścia: gdy kursor szybko przesuwa się w stronę paska kart przeglądarki.

Na **mobile** to zdarzenie nie istnieje. Moduł przełącza się wtedy automatycznie na **konfigurowalny minutnik** i na wykrywanie szybkiego przewinięcia strony w górę.

Wbudowane zabezpieczenia zapobiegają natarczywości: limit częstotliwości (pop-up nie pojawia się ponownie przez X dni), czas kwalifikacji przed pierwszym możliwym uruchomieniem oraz definitywne wyłączenie po wygranej.

## Zgodność z RODO

- Zbieranie e-maila wymaga **pola wyraźnej zgody** z tekstem, który sam konfigurujesz.
- Zapis do newslettera jest **opcjonalny** i powiązany z tą samą zgodą.
- Leady można przeglądać i eksportować, co ułatwia obsługę wniosków o dostęp i usunięcie danych.

## Zgodność techniczna

- **PrestaShop**: 8.0 do 9.x.
- **Hooki**: actionFrontControllerSetMedia (ładowanie zasobów i konfiguracji front) oraz displayFooter (renderowanie pop-upu).
- **Multisklep** i **wielojęzyczność** obsługiwane.
- **Kupony**: natywne reguły koszyka, bez równoległej tabeli.
- Brak zależności Composera.

## FAQ

### Czy klient może oszukać koło?

Nie. Wygrywający segment jest obliczany po stronie serwera przed animacją. Przeglądarka otrzymuje tylko indeks wyniku i nigdy nie zna wag.

### Jakie rodzaje nagród mogę rozdawać?

Rabat procentowy, rabat kwotowy, darmowa dostawa lub segment bez wygranej. Każda wygrana tworzy unikalną regułę koszyka.

### Czy moduł jest zgodny z PrestaShop 9?

Tak, moduł jest zaprojektowany dla PrestaShop od 8.0 do 9.x, bez adaptacji.

## Rozwiązywanie problemów

- **Pop-up się nie wyświetla**: sprawdź, czy moduł jest aktywny, czy czas kwalifikacji upłynął i czy nie grano już wcześniej (wyczyść pamięć lokalną przeglądarki, aby testować ponownie).
- **Pop-up nie pojawia się ponownie**: to celowe po wygranej lub w oknie częstotliwości. Zresetuj pamięć lokalną, aby wymusić kolejne wyświetlenie.
- **Kupon nie ma zastosowania**: skontroluj kwotę minimalną segmentu i datę wygaśnięcia.
- **Pola tekstowe wyglądają na puste w konfiguracji**: upewnij się, że używasz najnowszej wersji modułu (wielojęzyczne wyświetlanie pól zostało poprawione w 1.0.0).