# Ankieta po zakupie: skąd się o nas dowiedziałeś?

> Moduł DataFirefly Post-Purchase Survey zadaje pytanie „Skąd się o nas dowiedziałeś?" na stronie potwierdzenia zamówienia, a następnie porównuje każdy deklarowany kanał z generowanym przychodem. Ta dokumentacja obejmuje instalację, ustawienia, przypomnienie…

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

Moduł **DataFirefly Post-Purchase Survey** zadaje pytanie „Skąd się o nas dowiedziałeś?" na stronie potwierdzenia zamówienia, a następnie porównuje każdy deklarowany kanał z generowanym przychodem. Ta dokumentacja obejmuje instalację, ustawienia, przypomnienie e-mailem i odczyt raportu.

## Instalacja

W zapleczu przejdź do **Moduły > Menedżer modułów**, kliknij _Wgraj moduł_ i wyślij plik ZIP. Podczas instalacji moduł tworzy swoje tabele, dodaje jedenaście gotowych odpowiedzi w językach sklepu i rejestruje zakładkę **Zamówienia > Ankieta atrybucji**.

W raporcie pojawiają się tylko zamówienia złożone po instalacji: wiersz śledzenia powstaje przy zatwierdzeniu zamówienia.

## Ustawienia ankiety

Otwórz konfigurację modułu (przycisk _Konfiguruj_ w menedżerze modułów).

- **Pytanie**: tekst nad odpowiedziami, wpisywany dla każdego języka.
- **Wiadomość z podziękowaniem**: zastępuje blok po wysłaniu odpowiedzi.
- **Pytaj**: wszystkich klientów albo tylko nowych klientów (pierwsze zamówienie).
- **Losowa kolejność odpowiedzi**: zmienia kolejność przy każdym wyświetleniu, aby ograniczyć preferowanie pierwszych opcji. Odpowiedzi oznaczone „Zawsze na końcu" pozostają na końcu.
- **Nie pytaj ponownie przez**: liczba dni, w których klient z zapisaną odpowiedzią nie jest pytany. Ustaw 0, aby pytać przy każdym zamówieniu.
- **Pokaż także w historii zamówień**: klient bez odpowiedzi znajdzie pytanie w szczegółach zamówienia na swoim koncie.
- **Wykrywaj źródło ruchu**: patrz osobna sekcja poniżej.

Pod formularzem wyświetla się podgląd bloku w takiej postaci, w jakiej widzi go klient.

## Zarządzanie odpowiedziami

Przycisk **Zarządzaj odpowiedziami**, dostępny w konfiguracji i na pasku raportu, otwiera listę odpowiedzi proponowanych klientowi. Dla każdej odpowiedzi:

- **Treść** dla każdego języka, do 128 znaków;
- **Poproś o szczegóły**: otwiera pole tekstowe po wybraniu tej odpowiedzi (przydatne przy „Inne");
- **Zawsze na końcu**: odpowiedź zostaje na końcu listy nawet przy losowaniu kolejności;
- **Kolor**: używany na wykresach raportu;
- **Włączone** oraz **pozycja** metodą przeciągnij i upuść;
- **Sklepy**: w trybie multisklepu zaznacz sklepy, w których odpowiedź jest dostępna.

Usunięcie odpowiedzi nie kasuje już otrzymanych odpowiedzi: pozostają w raporcie z adnotacją „Usunięta odpowiedź".

## Przypomnienie e-mailem

Przypomnienie wysyła jedną wiadomość do klientów, którzy nie odpowiedzieli. Każda odpowiedź jest linkiem: kliknięcie zapisuje odpowiedź i otwiera stronę z podziękowaniem, bez formularza i bez logowania.

### Ustawienia

- **Wyślij przypomnienie**: włącza funkcję.
- **Temat e-maila**: wpisywany dla każdego języka.
- **Wyślij po**: opóźnienie w godzinach po zamówieniu (domyślnie 72).
- **Pomijaj zamówienia starsze niż**: zapobiega masowej wysyłce do historii przy pierwszym włączeniu (domyślnie 30 dni).
- **E-maile na uruchomienie**: limit na każde wywołanie crona.
- **Tylko opłacone zamówienia**: pomija zamówienia niezatwierdzone.

### Zadanie cron

Strona konfiguracji pokazuje adres chroniony tokenem. Wywołuj go raz dziennie, na przykład:

```
0 9 * * * curl -s "https://twoj-sklep.pl/module/dfpostpurchasesurvey/cron?token=TWOJ_TOKEN" >/dev/null
```

Odpowiedź podaje liczbę wysłanych, pominiętych i nieudanych e-maili. Dwa przyciski pozwalają dodatkowo wysłać e-mail testowy na adres pracownika i uruchomić kolejkę ręcznie.

Koszyk podzielony na kilka zamówień wywołuje tylko jedną wiadomość, a odpowiedź zapisuje się dla wszystkich zamówień z tego koszyka.

## Raport atrybucji

Zakładka **Zamówienia > Ankieta atrybucji**. Wybierz okres, typ klientów (wszyscy, nowi, powracający) i opcję „Tylko opłacone zamówienia".

### Wskaźniki

Śledzone zamówienia, odpowiedzi, wskaźnik odpowiedzi, przychód netto i przychód z odpowiedzią, każdy porównany z poprzednim okresem o tej samej długości.

### Tabela według kanału

- **% odpowiedzi** i **% przychodu**: rozkład deklarowany i rozkład przychodu.
- **Indeks**: stosunek obu wartości, baza 100. Powyżej 100 kanał przynosi koszyki wyższe niż przeciętne.
- **Szacowany przychód**: stosuje zaobserwowany rozkład do wszystkich śledzonych zamówień, także tych bez odpowiedzi.

Kwoty są netto i przeliczone na walutę domyślną sklepu. Przycisk **Eksportuj CSV** tworzy jeden wiersz na zamówienie z deklarowanym kanałem, szczegółami, przychodem, wykrytym źródłem i kanałem zbierania (strona potwierdzenia lub e-mail).

## Wykrywanie źródła ruchu

Opcja domyślnie wyłączona. Po włączeniu moduł zapamiętuje pierwsze źródło UTM (`utm_source`, `utm_medium`, `utm_campaign`), typowe identyfikatory kliknięć reklamowych lub stronę odsyłającą wizyty i zapisuje je w istniejącym ciasteczku sesji sklepu. Nie ładuje żadnego skryptu zewnętrznego i żadne dane nie opuszczają sklepu.

Raport pokazuje wtedy tabelę krzyżową deklarowanego kanału i wykrytego źródła oraz odsetek odpowiedzi bez wykrywalnego źródła, czyli sprzedaż niewidoczną dla śledzenia opartego na cookie.

Ta opcja zapisuje informację o pochodzeniu w ciasteczku sesji. Wspomnij o niej w polityce cookie przed jej włączeniem.

## Karta zamówienia i pulpit

Karta zamówienia w zapleczu pokazuje panel z odpowiedzią klienta, szczegółami, oznaczeniem „Pierwsze zamówienie" gdy dotyczy oraz wykrytym źródłem. Pulpit PrestaShop pokazuje pięć najlepszych kanałów wybranego okresu.

## RODO

Moduł implementuje oficjalne hooki modułu psgdpr: eksport danych klienta zawiera jego odpowiedzi, a żądanie usunięcia anonimizuje odpowiednie wiersze (odłączony klient, wyczyszczony tekst i kampania), pozostawiając odpowiedź w statystykach.

## Aktualizacja

Wgraj nowy plik ZIP przez menedżer modułów. Skrypty aktualizacji dodają potrzebne kolumny i tabele, rejestrują nowe hooki i przypisują istniejące odpowiedzi do wszystkich sklepów. Żadne dane nie giną.

## Rozwiązywanie problemów

### Blok nie pojawia się na stronie potwierdzenia

Sprawdź, czy moduł jest podpięty do `displayOrderConfirmation`, czy co najmniej jedna odpowiedź jest aktywna dla danego sklepu i czy klient już nie odpowiedział lub nie pominął ankiety. Przy ustawieniu „Tylko nowi klienci" powracający klient nic nie zobaczy.

### Przypomnienia nie są wysyłane

Najpierw przetestuj wysyłkę przyciskiem e-maila testowego: korzysta z ustawień poczty sklepu. Następnie sprawdź, czy przypomnienie jest włączone, czy cron wywołuje adres z właściwym tokenem i czy istnieją zamówienia spełniające warunki opóźnienia i maksymalnego wieku.

### Raport jest pusty

Liczone są tylko zamówienia złożone po instalacji. Poszerz okres i odznacz „Tylko opłacone zamówienia", jeśli Twoje zamówienia czekają na płatność.
