Dokumentace Pandus SDK
Přehled událostí
Každá událost, kterou Pandus SDK posílá samo: zobrazení, posouvání, kliknutí, formuláře, video, frustrace, Web Vitals, chytré události, události GA4 a signály bariér.
Aktualizováno:
Každá událost má stejný tvar: name, čas, stránka (URL po seznamu povolených parametrů), šablona stránky, ID relace a klienta (jen se souhlasem), režim souhlasu, zařízení, místo, zdroj, jazyk a až 25 parametrů.
Skupiny automatických událostí zapínáte a vypínáte v Analytika → Události. Každou událost lze označit jako klíčovou (konverzi): pak se objeví v konverzích, trychtýřích, atribuci a v prioritě problémů, např. „bariéra v kroku před purchase“.
Automatické události
| Událost | Kdy |
|---|---|
first_visit |
První návštěva prohlížeče |
session_start |
Nová relace (po 30 minutách bez aktivity) |
page_view |
Každá stránka včetně tras jednostránkových aplikací |
user_engagement |
Čas na stránce, dokud je viditelná |
scroll |
25, 50, 75 a 90 % stránky |
click |
Kliknutí na odkaz na jiný web |
file_download |
Kliknutí na dokument, archiv nebo mediální soubor |
view_search_results |
Stránka výsledků hledání webu |
form_start, form_submit |
Návštěvník začne a odešle formulář |
video_start, video_progress, video_complete |
Video HTML5 na stránce |
copy, print, outbound_share |
Kopírování (bez textu), tisk, sdílení na sociální síť |
consent_update |
Návštěvník změní volbu |
Frustrace
| Událost | Kdy |
|---|---|
rage_click |
Několik rychlých kliknutí na jednom místě |
dead_click |
Kliknutí bez reakce stránky |
error_click |
Kliknutí, po kterém přijde chyba JavaScriptu |
quick_back |
Návštěvník se vrátí během pár sekund |
excessive_scroll |
Posouvání nahoru a dolů bez nalezení |
form_abandon |
Neodeslaný formulář s posledním dotčeným polem (nikdy jeho hodnotou) |
js_error |
Chyba JavaScriptu se zprávou a zásobníkem očištěným od URL a osobních údajů |
Rychlost
web_vitals nese LCP, INP, CLS, FCP a TTFB zobrazení stránky s prvkem, který stojí za LCP, INP a CLS.
Chytré události
SDK rozpozná add_to_cart, begin_checkout, purchase, sign_up, login, contact a generate_lead podle textů tlačítek v sedmi jazycích, vzorů URL a platformy (dataLayer WooCommerce a GTM). Jsou označené „zjištěno automaticky“; každou potvrdíte nebo vypnete v Analytika → Události. Událost, kterou pošlete sami, má vždy přednost před zjištěnou.
Doporučené události (schéma GA4)
login, sign_up, search, share, select_content, generate_lead a celá sada 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. Viz E-commerce.
Signály bariér
Signály bariér jdou do vlastní tabulky, bez ID relace a klienta. Počítají se podle šablony stránky a prvku, nikdy podle člověka.
| Signál | 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 |
dle pravidla axe |
a11y_prefs |
předvolby zobrazení, jen jako podíly při nejméně 20 relacích |
a11y_skip_link_used |
pozitivní signál: odkaz „přeskočit na obsah“ funguje |
barrier_report_sent |
návštěvník odeslal formulář „Nahlásit bariéru“ |
Co který signál znamená, popisuje část Živé bariéry a co opravit nejdřív.
Data heatmap
Se zapnutým modulem chování nesou kliknutí svou pozici a selektor a každé zobrazení stránky posílá hloubku posouvání, pozornost a body fokusu. Tyto body heatmap se nezapočítávají do měsíčního limitu událostí.
Pandus SDK i skener jsou automatické kontroly, ne úplný audit a ne právní poradenství. SDK na webu nic nemění a nezjišťuje, kteří návštěvníci používají asistivní technologie.