Документація Pandus SDK
Довідник подій
Кожна подія, яку Pandus SDK надсилає сам: перегляди, прокрутка, кліки, форми, відео, фрустрація, Web Vitals, розумні події, події GA4 і сигнали бар’єрів.
Оновлено:
Кожна подія має однакову форму: name, час, сторінка (URL після списку дозволених параметрів), шаблон сторінки, ID сесії та клієнта (лише за згоди), режим згоди, пристрій, місце, джерело, мова й до 25 параметрів.
Групи автоматичних подій вмикаються й вимикаються в Аналітика → Події. Будь-яку подію можна позначити як ключову (конверсію): тоді вона з’являється в конверсіях, воронках, атрибуції та в пріоритеті проблем, наприклад «бар’єр на кроці перед purchase».
Автоматичні події
| Подія | Коли |
|---|---|
first_visit |
Перший візит браузера |
session_start |
Нова сесія (після 30 хвилин без активності) |
page_view |
Кожна сторінка, зокрема маршрути односторінкових застосунків |
user_engagement |
Час на сторінці, поки вона видима |
scroll |
25, 50, 75 і 90 % сторінки |
click |
Клік на посилання на інший сайт |
file_download |
Клік на документ, архів чи медіафайл |
view_search_results |
Сторінка результатів пошуку сайту |
form_start, form_submit |
Відвідувач почав і надіслав форму |
video_start, video_progress, video_complete |
HTML5-відео на сторінці |
copy, print, outbound_share |
Копіювання (без тексту), друк, поширення в соцмережу |
consent_update |
Відвідувач змінює вибір |
Фрустрація
| Подія | Коли |
|---|---|
rage_click |
Кілька швидких кліків в одному місці |
dead_click |
Клік без реакції сторінки |
error_click |
Клік, після якого сталася помилка JavaScript |
quick_back |
Відвідувач повертається за кілька секунд |
excessive_scroll |
Прокрутка вгору-вниз без результату |
form_abandon |
Ненадіслана форма з останнім торкнутим полем (ніколи не його значенням) |
js_error |
Помилка JavaScript із повідомленням і стеком, очищеним від URL і персональних даних |
Швидкість
web_vitals містить LCP, INP, CLS, FCP і TTFB перегляду сторінки з елементом-винуватцем LCP, INP і CLS.
Розумні події
SDK розпізнає add_to_cart, begin_checkout, purchase, sign_up, login, contact і generate_lead за текстами кнопок сімома мовами, шаблонами URL і платформою (dataLayer WooCommerce та GTM). Вони позначені «визначено автоматично»; кожну ви підтверджуєте або вимикаєте в Аналітика → Події. Подія, яку ви надсилаєте самі, завжди має перевагу над визначеною.
Рекомендовані події (схема GA4)
login, sign_up, search, share, select_content, generate_lead і весь набір 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. Див. E-commerce.
Сигнали бар’єрів
Сигнали бар’єрів ідуть в окрему таблицю, без ID сесії й клієнта. Вони рахуються за шаблоном сторінки й елементом, ніколи — за людиною.
| Сигнал | 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 |
за правилом axe |
a11y_prefs |
налаштування відображення, лише частками при щонайменше 20 сесіях |
a11y_skip_link_used |
позитивний сигнал: посилання «перейти до вмісту» працює |
barrier_report_sent |
відвідувач надіслав форму «Повідомити про бар’єр» |
Що означає кожен сигнал — у розділі Живі бар’єри й що виправити першим.
Дані теплових карт
З увімкненим модулем поведінки кліки несуть свою позицію й селектор, а кожен перегляд сторінки надсилає глибину прокрутки, увагу й точки фокуса. Ці точки теплових карт не рахуються в місячний ліміт подій.
Pandus SDK і сканер — це автоматичні перевірки, не повний аудит і не юридична консультація. SDK нічого не змінює на сайті й не визначає, хто з відвідувачів користується допоміжними технологіями.