Документация 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 ничего не меняет на сайте и не определяет, кто из посетителей пользуется вспомогательными технологиями.