Модель данных счётчика Статистики от SberAds: события и данные пользователя
Статистика от SberAds строит аналитику на событиях, а не на визитах и просмотрах: любое действие на сайте или в приложении фиксируется как событие, данные уходят в параметре meta. Типов событий 9: base, tech, crash, media, ub, ec, cv, email, server. В собственном событии допустимо до 30 параметров и до 6 уровней вложенности. Идентификаторы пользователя частью собираются сами, частью передаются отдельно.
Цифры
Лимиты и счёт визитов
| Параметр | Значение |
|---|---|
| Параметров в собственном событии | до 30 |
| Уровней вложенности параметров | до 6 |
| Длина `top100_id` | до 100 символов |
| Длина `adtech_uid` | до 36 символов |
| Типов событий | 9 |
| Новый визит при переходе того же пользователя из другого источника | не считается |
| Новый визит при продолжении сессии после 00:00 | не считается, но визит попадает в оба дня |
Типы событий
| Тип | Для чего | Как уходят данные |
|---|---|---|
| base | базовые отчёты | автоматически |
| tech | технические метрики (активность, загрузка сайта) | автоматически |
| crash | краши приложения, только SDK | автоматически |
| media | отдельный отчёт по медиаконтенту | нужны дополнительная настройка и разметка сайта |
| ub | отчёт «Аналитика блоков» | нужны дополнительная настройка и разметка сайта |
| ec | электронная коммерция | нужна дополнительная настройка и разметка сайта |
| cv | собственные события | вручную |
| события из email-рассылок | вручную | |
| server | события S2S | вручную |
Подробности
Как устроена модель
Счётчик не привязан к визитам и просмотрам страниц: любое взаимодействие с сайтом или приложением регистрируется как событие. Такой подход удобен, когда есть и сайт, и мобильное приложение, и умные устройства: данные собираются кроссплатформенно. Все данные события передаются в параметре meta. События делятся на типы по тому, в каких отчётах применяются.
Подсчёт посетителей в этой модели точнее, чем в прежней. Пользователь, который пришёл из другого источника трафика, не считается новым визитом. Не считается новым визитом и пользователь, оставшийся на сайте после 00:00, при этом такой визит учитывается в обоих днях. Из-за этого общее число визитов может быть меньше, чем в прежней модели, но данные корректнее. Насколько меньше, справка не называет.
События base
Собираются сразу при установке счётчика и нужны для базовых отчётов.
| Событие | Что фиксирует |
|---|---|
| Показ страницы/экрана | основные параметры: URL исходной страницы, с которой пришёл переход, «число минут», язык браузера, название и версия приложения, производитель устройства |
| Закрытие страницы | время на странице в секундах и просмотренные экраны |
| Переход по внешней ссылке | ссылка на сайте или в приложении, по которой пользователь ушёл на другой ресурс; в meta передаётся URL, куда ведёт переход |
| Первое открытие приложения после установки | событие отправляется при первом запуске приложения после установки |
| Переход по ссылке в приложении (deeplink) | событие вызывают самостоятельно, чтобы передать в трекер deeplink |
| Покупка в приложении | покупка или оформление подписки, которую обрабатывает Apple App Store или Google Play |
События tech и crash
Собираются автоматически.
| Событие | Тип | Что фиксирует |
|---|---|---|
| ping | tech | активность пользователя; определяет время на странице и позволяет выделить время, когда пользователь совершал действия; на нём строятся метрики «Отказов», «Длительность сессии», «Длительность просмотра» |
| ws | tech | данные по анализу загрузки сайта |
| src | crash | путь до файла, где возникла ошибка |
| log | crash | лог ошибки |
| describe | crash | описание ошибки |
События media и ub
Для обоих типов нужны дополнительная настройка и разметка сайта.
- Показ медиаконтента (media) срабатывает, когда пользователь смотрит медиаконтент на сайте или в приложении. Основные параметры: название, тип, id и канонический URL контента; даты публикации и изменения; число символов, слов и картинок; имя, идентификатор автора и ссылка на его страницу; мета-теги; категория.
- Показ блока и Клик по блоку (ub) срабатывают при показе блоков страниц и при клике по ним. Данные идут в отчёт «Аналитика блоков».
События ec
Для передачи нужна дополнительная настройка.
| Код события | Когда срабатывает |
|---|---|
| purchase | покупка товара в приложении или на сайте |
| add | товар добавлен в корзину |
| remove | товар удалён из корзины |
| click | клик по товару |
| detail | запрос подробных данных карточки товара |
| checkout | переход в корзину |
| checkout_option | просмотр данных в корзине |
| refund | возврат товара |
| impressions | запрос показа списка товаров |
| promoView | запрос показа акции |
| promoClick | клик по карточке с акцией |
События cv, email, server
Отправляются вручную.
- cv: собственные события. Нужно передать название события и данные для него; событие срабатывает, когда пользователь выполняет заданные условия.
- email: события из рассылок. Данные формируются в коде письма через тег img и отправляются вручную; передать можно любое событие. Подробнее — в разделе справки «Разметка писем».
- server: события S2S. Данные формирует площадка и отправляет сама, по HTTPS-запросам напрямую на серверы Статистики от SberAds. Подробнее — в разделе «Отправка данных S2S».
Данные пользователя
Трекинговые коды собирают данные о пользователях, часть из них автоматически.
| Идентификатор | Платформа | Что это | Как попадает в счётчик |
|---|---|---|---|
| top100_id | все | first-party идентификатор; любое строковое значение, одинаковое для одной установки приложения на устройстве и разное для разных установок; до 100 символов | автоматически |
| sa | web | first-party идентификатор Сбербанка | предоставляет пользователь или площадка |
| sv | web | third-party идентификатор Сбербанка | предоставляет пользователь или площадка |
| ruid | web | third-party идентификатор пользователя | автоматически |
| rambler_id | web | идентификатор авторизованного пользователя в системе Rambler_id | предоставляет пользователь или площадка |
| adtech_uid | web | first-party идентификатор пользователя; до 36 символов | предоставляет пользователь или площадка |
| gaid | Android | рекламный идентификатор Android | автоматически |
| idfa | iOS | рекламный идентификатор iOS | автоматически |
| idfv | iOS | идентификатор устройства для группы приложений одного разработчика (Identifier for Vendor) | автоматически |
| fingerprint_ip | все | фингерпринт | автоматически |
| user-agent | все | User-Agent браузера; может содержать название контрагента или отсутствовать | автоматически |
| ip | все | IP пользователя; значение задают в заголовке X-Forwarded-For, при server-side интеграции передают IP исходного пользователя | автоматически |
Параметры user_id, email, email_hash, phone, phone_hash, pub_id, sber_id, sber_sub_id, rambler_id автоматически не собираются. Их передачу включают в настройках: для web при активации счётчика или методами после активации, для Android и iOS — параметрами SDK при активации или методами после неё. Подробные страницы по этим способам у справки свои, в этой статье их нет.
Важно знать
- Состав base-событий на двух страницах разный. Страница типов называет «Смена идентификатора пользователя», которой нет на странице описаний. Страница описаний называет «Покупка в приложении», которой нет на странице типов. Что из этого реально уходит в отчёты, проверять в кабинете счётчика.
- Страница типов пишет, что данные base отправляются автоматически, а страница описаний — что событие deeplink нужно вызывать самостоятельно. Автоматически ли уходит deeplink, справка не уточняет.
- События ec тоже расходятся. Страница типов перечисляет 10 пунктов, включая «Добавление в избранное» и «Удаление из избранного». Страница описаний даёт 11 кодов, включая purchase, promoView, promoClick, а избранного там нет. Явного соответствия между названиями на одной странице и кодами на другой справка не даёт.
- Страницу описаний событий правили 21.11.2024, страницы типов и модели данных — 11.11.2025, данных пользователя — 26.06.2025. Расхождения могут быть следом разных редакций.
- «Число минут» в параметрах события показа страницы справка не поясняет. Для типа server сказано, что данные уходят «напрямую в kraken»; что это за адрес, справка на этих страницах не объясняет.
- Для top100_id указана платформа «все», а описание говорит об установке приложения на устройство; как значение формируется на сайте, на этих страницах не описано.
- Насколько число визитов в новой модели меньше, чем в прежней, справка не называет.