Dokumentacja Pandus SDK
Katalog zdarzeń
Każde zdarzenie, które Pandus SDK wysyła samo: wyświetlenia, przewijanie, kliknięcia, formularze, wideo, frustracja, Web Vitals, inteligentne zdarzenia, zdarzenia GA4 i sygnały barier.
Zaktualizowano:
Każde zdarzenie ma ten sam kształt: name, czas, strona (URL po liście dozwolonych parametrów), szablon strony, identyfikator sesji i klienta (tylko za zgodą), tryb zgody, urządzenie, miejsce, źródło, język i do 25 parametrów.
Grupy zdarzeń automatycznych włączasz i wyłączasz w Analityka → Zdarzenia. Każde zdarzenie można oznaczyć jako zdarzenie kluczowe (konwersję): pojawia się wtedy w konwersjach, lejkach, atrybucji i w priorytecie problemów, np. „bariera na kroku przed purchase”.
Zdarzenia automatyczne
| Zdarzenie | Kiedy |
|---|---|
first_visit |
Pierwsza wizyta przeglądarki |
session_start |
Nowa sesja (po 30 minutach bez aktywności) |
page_view |
Każda strona, także trasy aplikacji jednostronicowych |
user_engagement |
Czas na stronie, gdy jest widoczna |
scroll |
25, 50, 75 i 90 % strony |
click |
Kliknięcie linku do innej witryny |
file_download |
Kliknięcie dokumentu, archiwum lub pliku multimedialnego |
view_search_results |
Strona wyników wyszukiwania w witrynie |
form_start, form_submit |
Odwiedzający zaczyna i wysyła formularz |
video_start, video_progress, video_complete |
Wideo HTML5 na stronie |
copy, print, outbound_share |
Kopiowanie (bez tekstu), drukowanie, udostępnienie w sieci społecznościowej |
consent_update |
Odwiedzający zmienia wybór |
Frustracja
| Zdarzenie | Kiedy |
|---|---|
rage_click |
Kilka szybkich kliknięć w jednym miejscu |
dead_click |
Kliknięcie bez reakcji strony |
error_click |
Kliknięcie, po którym pojawia się błąd JavaScript |
quick_back |
Odwiedzający wraca po kilku sekundach |
excessive_scroll |
Przewijanie w górę i w dół bez znalezienia czegoś |
form_abandon |
Niewysłany formularz z ostatnio dotkniętym polem (nigdy jego wartością) |
js_error |
Błąd JavaScript z komunikatem i stosem oczyszczonym z URL i danych osobowych |
Szybkość
web_vitals zawiera LCP, INP, CLS, FCP i TTFB wyświetlenia strony, z elementem odpowiedzialnym za LCP, INP i CLS.
Inteligentne zdarzenia
SDK rozpoznaje add_to_cart, begin_checkout, purchase, sign_up, login, contact i generate_lead po tekstach przycisków w siedmiu językach, wzorcach URL i platformie (dataLayer WooCommerce i GTM). Są oznaczone jako „wykryte automatycznie”; każde potwierdzasz lub wyłączasz w Analityka → Zdarzenia. Zdarzenie wysłane przez Ciebie zawsze ma pierwszeństwo przed wykrytym.
Zdarzenia zalecane (schemat GA4)
login, sign_up, search, share, select_content, generate_lead i cały zestaw e-commerce: view_item_list, select_item, view_item, add_to_wishlist, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info, purchase, refund, view_promotion, select_promotion. Zobacz E-commerce.
Sygnały barier
Sygnały barier trafiają do osobnej tabeli, bez identyfikatora sesji i klienta. Liczone są według szablonu strony i elementu, nigdy według osoby.
| Sygnał | WCAG |
|---|---|
a11y_focus_trap |
2.1.2 |
a11y_focus_lost |
2.4.3 |
a11y_focus_invisible |
2.4.7, 2.4.11 |
a11y_focus_obscured |
2.4.11 |
a11y_focus_order_jump |
2.4.3 |
a11y_unreachable_control |
4.1.2, 2.1.1 |
a11y_hidden_focusable |
4.1.2 |
a11y_form_error_unannounced |
3.3.1, 3.3.3 |
a11y_form_retry |
3.3.1 |
a11y_reflow |
1.4.10, 1.4.4 |
a11y_autoplay |
1.4.2 |
a11y_live_axe |
wg reguły axe |
a11y_prefs |
preferencje wyświetlania, tylko jako udziały przy co najmniej 20 sesjach |
a11y_skip_link_used |
sygnał pozytywny: link „przejdź do treści” działa |
barrier_report_sent |
odwiedzający wysłał formularz „Zgłoś barierę” |
Co oznacza każdy sygnał, opisuje sekcja Bariery na żywo i co naprawić najpierw.
Dane map ciepła
Przy włączonym module zachowania kliknięcia niosą swoją pozycję i selektor, a każde wyświetlenie strony wysyła głębokość przewijania, uwagę i punkty fokusu. Te punkty map ciepła nie liczą się do miesięcznego limitu zdarzeń.
Pandus SDK i skaner to kontrole automatyczne, nie pełny audyt i nie porada prawna. SDK niczego nie zmienia na stronie i nie ustala, którzy odwiedzający korzystają z technologii asystujących.