Типы событий счётчика Статистики от SberAds: базовые, пользовательские, медиа, технические
События счётчика делятся на группы по параметру event_type: base (базовые), cv (пользовательские), media (показ медиа контента), tech (технические) и ec (eCommerce); у событий о крашах SDK тип в справке не назван. Название конкретного события передаётся в event_name, дополнительные данные — в meta (JSON). В meta пользовательского события не более 30 пар.
Цифры
Группы и названия событий
| Группа | event_type | event_name | Когда срабатывает |
|---|---|---|---|
| Базовые | base | page_view | показ страницы или экрана |
| Базовые | base | page_close | закрытие страницы |
| Базовые | base | click | переход по внешней ссылке |
| Базовые | base | deeplink | переход по ссылке в приложение |
| Базовые | base | click | покупка в приложении |
| Базовые | base | login | авторизация пользователя |
| Пользовательские | cv | уникальное название (пример: button_click) | собственное событие |
| Медиа | media | page_view | показ медиа контента |
| Технические | tech | ping | активность пользователя |
| eCommerce | ec | действие (purchase, add и другие) | действие с товаром |
| Краши SDK | в справке не нашли | КРЭШ ГРУППА | падение приложения |
Показ страницы или экрана (page_view, meta)
| Поле | Формат | Что передают |
|---|---|---|
| title | String | заголовок страницы, не более 250 символов |
| referer | URL | аналог referer в web |
| browser | String | официальное название браузера |
| platform | String | платформа, на которой запущен браузер |
| browser_size | Число×Число | размеры страницы |
| screen_size | Число×Число | разрешение экрана |
| color_depth | Number | глубина цвета |
| language | String | язык браузера |
| timezone | Number | таймзона в минутах |
| app_name | String | название приложения (для приложений) |
| app_verison | String | версия приложения (для приложений) |
| manufacturer | String | производитель устройства (для приложений) |
Остальные базовые события
| Событие | event_name | meta |
|---|---|---|
| Закрытие страницы | page_close | time — время на странице в секундах (Number); screens — просмотренные экраны (Array из чисел) |
| Переход по внешней ссылке | click | URL страницы, на которую совершается переход |
| Переход по ссылке в приложение | deeplink | URL, на который совершается переход |
| Покупка в приложении | click | in_app_purchase, product_id, price, value, currency, quantity, subscription, free_trial, introductory_price (формат и описание полей в справке пустые) |
| Авторизация пользователя | login | meta нет; информация о пользователе — в базовом параметре auth_uid |
Медиа событие (meta)
| Поле | Формат | Что передают |
|---|---|---|
| name | String | название медиа контента |
| type | String | тип контента (article, news, blog и т. д.) |
| id | String | идентификатор контента |
| url | String | канонический url контента без query-параметров |
| date_published | String | дата публикации |
| date_modified | String | дата модификации |
| description | String | описание материала, не более 500 символов |
| article_height | String | высота контента в px |
| article_start | String | смещение контента от начала страницы в px |
| article_symbols | Number | количество символов в контенте |
| article_words | Number | количество слов |
| article_images | Number | количество картинок |
| author_name | String | имя автора |
| author_id | String | идентификатор автора |
| author_url | String | ссылка на страницу автора |
| themes | String | мета-теги |
| category | String | категория |
| schema | String | тип разметки (micro или ld) |
Технические события: ping
| Поле | Вложенность | Что передают |
|---|---|---|
| scroll | max, min, current | максимальная, минимальная и текущая позиция скролла во время пинга |
| doscroll* | max, min, current | то же в процентах |
| mdoscroll* | max, min, current | позиция скролла статьи в процентах |
| num | в справке не нашли | порядковый номер пинга |
| duration | в справке не нашли | длительность пинга в секундах |
| mid* | в справке не нашли | идентификатор медиа материала |
| url* | в справке не нашли | url медиа материала |
| rereading* | в справке не нашли | дочтение материала |
Звёздочка: только для новостных страниц, где собираются медиа события.
eCommerce события
| event_name | Описание в справке |
|---|---|
| purchase | покупка товара |
| add | добавление в корзину |
| remove | удаление из корзины |
| click | клик по товару |
| detail | показ подробных данных карточки товара |
| checkout | переход в корзину |
| checkout_option | данные в корзине |
| refund | возврат товаров |
| impressions | показ списка товаров |
| promoView | показ акции |
| promoClick | клик по карточке с акцией |
Краш SDK (meta)
| Поле | Что передают |
|---|---|
| src | путь до файла, где возникла ошибка |
| log | лог ошибки |
| describe | описание ошибки |
Подробности
Базовые события
Для каждого события из списка передаётся event_type=base. Название задаёт event_name. Дополнительные сведения кладут в meta в формате JSON.
Пользовательские события
Передаются с event_type=cv. Уникальное название события указывают в event_name (пример: button_click). Дополнительные параметры идут в meta в формате JSON, не более 30 пар «ключ=значение».
Медиа событие
Показ медиа контента передаётся как event_name=page_view, но с event_type=media, а не base. Сведения о материале (название, тип, автор, дата, объём текста и т. д.) идут в meta.
Технические события
Нужны для построения метрик и собираются автоматически. Группа задаётся на уровне SDK жёстко: event_type=tech, название события — ping. События без event_type считаются невалидными. В чистом виде в интерфейсе их не посмотреть, но они влияют на метрики Отказов, Время на странице и Время визита. В справке по этой группе описано одно событие — активность пользователя. Данные его пинга передаются в meta; формат может быть разный (JSON, Array, String), все значения приводят к строковому виду.
eCommerce события
Передаются с event_type=ec; выбранное действие указывают в event_name (пример: purchase), параметры ecom-события — в meta. Для начала отправки нужна дополнительная настройка передачи eCommerce-данных.
Краши SDK
События отправляются при падении приложения, собираются автоматически. Название или тип ошибки передают как название события, в примере — java.lang.RuntimeException. В meta идут путь к файлу, лог и описание ошибки.
Важно знать
- Название click занято двумя базовыми событиями: переход по внешней ссылке и покупка в приложении. Как их различить в данных, справка не поясняет. Отдельно click есть и у eCommerce (клик по товару), но там другой event_type (ec).
- В таблице события «Покупка в приложении» названы поля, а формат и описание пусты. Что в них передавать, справка не говорит.
- Переход по внешней ссылке: в тексте сказано «в формате JSON в параметре meta», а в примере meta содержит просто адрес. В таблице поле названо URL.
- Медиа событие: в таблице поля name и url, а в примере запроса в meta ключи title и canonical_url, и ключа name нет. Какие ключи читает счётчик, справка не уточняет.
- Технические события: сказано, что все данные приводят к строковому виду, а в примере значения scroll и num — числа, не строки.
- Параметр counter_type: в примерах запросов на этих страницах стоит counter_type=web, а страница базовых параметров запроса (см. статью про S2S) называет обязательными значения server или pixel.
- Описания checkout и checkout_option здесь («переход в корзину», «данные в корзине») отличаются от страницы формата eCommerce веб-счётчика («переход к оформлению покупки», «выбор пользователя на этапе оформления»). Там перечень действий без impressions, здесь impressions есть. Что считать верным, проверять по реальным событиям.
- Событие о краше: event_type в справке не назван. В event_name записано «КРЭШ ГРУППА», а ниже дан пример java.lang.RuntimeException. Что именно подставлять в event_name, справка прямо не поясняет.
- В параметре страницы показа версия приложения названа app_verison. Верное написание справка не уточняет.
- В перечне страницы «Параметры событий» есть «События Аналитики блоков», но среди страниц этой статьи описания нет.