Схема потоковых данных в хр анилище даных
Renta Javascript SDK поддерживает интеграцию со следующими хранилищами данных:
Snowflake
Google BigQuery
Clickhouse
После создания интеграции в вашем хранилище данных будет создано две таблицы: событий и сессий.
Таблица событий
Все события, которые вы настроили при помощи Javascript SDK поступают в хранилище данных в режиме реально времени.
Таблица сессий
Вставка сессий происходит раз в сутки в 02:00 UTC.
Ниже вы можете ознакомится со структурой таблиц и описанием полей.
Структура таблицы событий
| Field name | Type of data | Description |
|---|---|---|
| dateTime | datetime | Дата и время события по UTC |
| date | date | Дата события по UTC |
| sendAt | datetime | Дата и время отправки события с клиентской стороны |
| eventId | String | Уникальный ID события |
| eventType | String | Тип события |
| eventName | String | Имя события |
| properties | String | Json объект, который содержит пользовательские атрибуты события |
| anonymousId | String | Уникальные значение cookie |
| userId | String | Номер userId. Содержит значение передаваемое в Google Analytics. |
| groupId | String | Уникальные значение группы (доступно только для события типа group) |
| content | String | Содержание utm_content |
| medium | String | Содержание utm_medium |
| source | String | Содержание utm_source |
| term | String | Содержание utm_term |
| campaign | String | Содержание utm_campaign |
| dataSource | String | Источник данных для обращения. По умолчанию обращения от analytics.js будут иметь значение web, а обращения от мобильных SDK – значение app. |
| device | String | Тип устройства: desktop, tablet, mobile, TV. |
| deviceBrowser | String | Браузер (например, Chrome или Firefox). |
| deviceBrowserVersion | String | Версия браузера. |
| deviceOperatingSystem | String | Операционная система (например, Macintosh или Windows). |
| deviceOperatingSystemVersion | String | Версия операционной системы. |
| deviceIp | String | IP-адрес |
| country | String | Страна |
| city | String | Город |
| region | String | Регион |
| deviceUserAgent | String | User Agent |
| deviceScreenHeight | Int | Расширение экрана пользователя в пикселях по высоте |
| deviceScreenWidth | Int | Расширение экрана пользователя в пикселях по ширине |
| deviceViewPortHeight | Int | Размер области просмотра в браузере по высоте |
| deviceViewPortWidth | Int | Размер области просмотра в браузере по ширине |
| deviceDocEncoding | String | Кодировка. Например, UTF-8. |
| location | String | URL с учетом дополнительных параметров. Например: https://site.com/catalog/platya?page=2 |
| hostname | String | Домен. Например: https://site.com/ |
| path | String | Путь URL страницы. Например: /catalog/platya |
| title | String | Title страницы. |
| page | String | Полный путь URL. Например: https://site.com/catalog/platya |
| documentReferrer | String | Если поле medium имеет значение referral, здесь указывается путь источника трафика, а имя хоста содержится в поле source. |
| fbclid | String | Идентификатор клика Facebook Ads, который передается в URL при клике по объявлению. |
| gclid | String | Идентификатор клика Google Ads, который передается в URL при клике по объявлению. |
| ydclid | String | Идентификатор клика Yandex Direct, который передается в URL при клике по объявлению. |
| ga_cookie_id | String | Уникальное значение файлов cookie Google Analytics |
| ym_cookie_id | String | Уникальное значение файлов cookie Яндекс.Метрики |
| fbc_cookie_id | String | Уникальное значение файлов cookie Facebook |
| fbp_cookie_id | String | Уникальное значение файлов cookie Facebook |
| offset | String | Служебный параметр Javascript SDK. Используется для подсчёта сессий (таблица сессий доступна только в интеграции с DWH). |
Структура таблицы сессий
Renta Javscript SDK формирует сессии по логике Google Analytics.
Подробней с логикой расчета вы можете ознакомиться в документации.
| Название столбца | Описание |
|---|---|
| sessionId | Номер сессии. Является уникальным значением. |
| anonymousId | Уникальный идентификатор куки Renta Javsctipr SDK. Задается на уровне устройства. |
| userIds | Массив значений userId. |
| eventIds | Перечень событий, которые входят в sessionId. |
| totalHits | Кол-во событий в рамках сессии |
| transactionIds | Идентификаторы транзакций, которые были достигнуты в рамках сессии |
| totalTransactions | Кол-во транзакций, которые были достигнуты в рамках сессии. |
| totalPageviews | Кол-во просмотренных страниц |
| totalEvents | Кол-во событий |
| timestamp | Время в формате Unix Timestamp. |
| dateTime | Время начала сессии по UTC. Является первым dateTime в рамках сессии. |
| dateTimeLast | Окончание сессии по UTC. Является последним хитом в рамках сессии. |
| date | Дата начала сессии по UTC. |
| secondsInSession | Длительность сессии в секундах. |
| content | Содержание utm_content |
| medium | Содержание utm_medium |
| source | Содержание utm_source |
| term | Содержание utm_term |
| campaign | Содержание utm_campain |
| gclid | Содержит Google Click ID, если включена авторазметка между Google Ads и Google Analytics. |
| device | Тип устройства: desktop, tablet, mobile, TV. |
| ip | IP устройства |
| city | Город |
| country | Страна |
| region | Регион |
| browser | Браузер |
| browserVersion | Версия браузера |
| operatingSystem | Операционная система |
| operatingSystemVersion | Версия операционной системы |
| landingPage | Страница входа на сайте. Является page первого хита. |
| hostname | Доменное имя. Определяется по landingPage. |
| exitPage | Страница выхода. Последняя просмотренная страница в рамках сессии. |
| bounce | Возвращает единицу, если в рамках сессии был отказ. Отказ фиксируется при условии, если в сессии был только один хит. |
| visitSession | Номер сеанса пользователя. Если это первый сеанс, полю задается значение 1. |
| newVisits | Если это первый визит, тогда 1. В остальных случаях пустое значение. |
| documentReferral | Доменное имя. Игнорируя utm-метки. Например, если переход был с http://convert.ua/contacts?source=test, то documentReferral = convert.ua. |
| documentReferrer | Полный адрес страницы с которой был переход на сайт. Логика похожа на documentReferral, только возвращает полный путь url-a: http://site.com/contacts |
Название таблиц
Название таблиц вы указываете в конфигурации интеграции:
Ready to get started?
Build your data pipeline today or get a personalized demo. Start free!
Need help?
Get expert support to ensure your project succeeds. We're here to help!
Feature requests?
Help shape our product! Share your ideas for new features and integrations.