Javascript SDK data stream schema to warehouse

Renta Javascript SDK поддерживает интеграцию со следующими хранилищами данных:

  • Snowflake
  • Google BigQuery
  • Clickhouse

После создания интеграции в вашем хранилище данных будет создано две таблицы: событий и сессий.

Таблица событий
Все события, которые вы настроили при помощи Javascript SDK поступают в хранилище данных в режиме реально времени. 

Таблица сессий
Вставка сессий происходит раз в сутки в 02:00 UTC. 

Ниже вы можете ознакомится со структурой таблиц и описанием полей. 

Структура таблицы событий

Название поля Тип данных Описание
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

Название таблиц

Название таблиц вы указываете в конфигурации интеграции: