Tokeny generowane na żądanie (user token)

Jeśli chcemy zautomatyzować proces badań w naszej firmie, potrzebujemy możliwości nadawania tokena w sposób automatyczny, bez wcześniejszego definiowania respondenta czy importowania do systemu listy adresatów e-mail. W tym przypadku przychodzi z pomocą user token, czyli token który nie jest generowany przez Webankietę, a nadawany jest przez klienta. Ma on te same właściwości co klasyczny token (blokada przed możliwością kilkukrotnego wypełnienia i indentyfikacja odpowiedzi respondenta), ale może być to np. ID klienta, które przekazywane jest w linku do ankiety. Aby wygenerować taki token, konieczne jest zaangażowanie działu IT w budowę prostego skryptu generującego unikalne linki do ankiety w niżej opisany sposób.

user_token jest dodawany jako klasyczny parametr typu GET do URL-a ankiety. Parametr mozna stosować tylko kiedy ankieta ma włączoną opcję indywidualnych linków dla każdego respondenta z włączoną identyfikacją respondentów. Wówczas ankietę można wypełnić tylko jeden raz dla konkretnej wartości parametru, a do wypełnienia dołączony zostanie przekazany dodany parametr, co pozwoli na późniejszą identyfikację wypełnienia i powiązanie go z konkretnym respondentem.

W towarzystwie parametru user_token można przekazać też dodatkowe atrybuty dla tego kontaktu, tak by pełniły funkcję dodatkowych informacji o respondencie (np. segment klienta, dział pracownika, numer obsługującego konsultanta). Przekazanie tych informacji pozwala na dalsze filtrowanie i segmentację wyników według wartości przekazanych w atrybutach.

Istnieje możliwość ustawienia daty i godziny, po której link z user_token przestanie być aktywny. Jest to przydatne w badaniach, które muszą zostać zrealizowane w ściśle określonym oknie czasowym.

W tym celu do linku należy dodać parametr user_token_exp, którego wartością jest data zapisana w formacie Unix Timestamp.

Jak to zrobić?

Przykład: https://www.webankieta.pl/ankieta/123456/badanie.html?user_token=123456&user_token_exp=1767225600

Jeśli respondent kliknie w link po upływie tego czasu, zobaczy komunikat o zakończeniu zbierania wyników.

Pamiętaj, że parametr user_token_exp pełni funkcję technicznej blokady i działa „w tle” – system używa go tylko do weryfikacji w momencie wejścia w link, ale nie zapisuje tej daty wprost w wynikach.

Jeśli chcesz, aby informacja o dacie ważności linku była również widoczna w Twoich raportach (np. w pliku XLS, aby wiedzieć, jaki termin miał dany respondent), powinieneś przekazać tę datę również jako standardową etykietę (np. pod parametrem l1).

Przykład pełnego linku:

...?user_token=123&user_token_exp=1767225600&l1=2026-01-20 10:00

W tym scenariuszu:

⚠️ Ważna uwaga

Pamiętaj, że parametry w adresie URL są widoczne dla odbiorcy. Istnieje ryzyko, że osoby postronne mogą próbować ręcznie zmienić datę w linku (wpisując inny Timestamp), aby uzyskać dostęp do ankiety po terminie.

Aby temu zapobiec i uniemożliwić jakąkolwiek ingerencję w parametry, rekomendujemy skrócenie całego gotowego linku.

Możesz w tym celu skorzystać z dowolnego zewnętrznego narzędzia (np. Bitly) lub użyć naszego automatycznego rozwiązania: Webhook do skracania linka do ankiety. Dzięki temu techniczna konstrukcja linku pozostanie ukryta dla respondenta.

Jeżli parametr user_token zostanie przekazany w linku do ankiety, informacja ta pojawi się w następujących miejscach:

W przypadku surowych danych i pliku SPSS (oprócz systemowego tokena), będzie to odpowiednia kolumna w Excelu lub dodatkowa zmienna V w SPSS.

W momencie wejścia przez respondenta w link zawierający user_token, zostanie on "ucięty" i w pasku adresu user_token będzie niewidoczny, wraz z etykietami.

Jeżeli respondent przekaże link z paska przeglądarki innej osobie, to ta osoba nie będzie w stanie wejść do ankiety (ponieważ nie będzie dopisanej informacji o user tokenie)