Установка Javascript SDK

Renta Javascript SDK — позволяет организовать сбор данных c веб-сайта. SDK обеспечивает потоковую передачу данных в следующие пункты назначения: 

• Snowflake

• Google BigQuery

• Clickhouse

• Facebook Conversions API

• Webhooks

Преимущество данного источника данных заключается в поддержке server-side интеграции, что обеспечивает сбор данных от имени первой стороны (1st party data). 

Весь процесс настройки сбора данных можно разделить на несколько простых шагов: 

1. Создание проекта

2. Создание пользовательского домена.
   Необходимо только для server-side имплементации. 

3. Внедрение отслеживания событий.  

Создание проекта

Чтобы создать новый источник данных в Каталоге интеграций выберите Javascript.

Затем укажите следующие настройки: 

Site URL

Укажите URL сайта для которого необходимо настроить отслеживание. 

Server-side implementation

Позволяет настроить отслеживания со стороны сервера. По-умолчанию трекинг происходит со стороны Renta, но мы настоятельно рекомендуем использовать поддомен вашего веб-сайта.

Для этого включите server-side implementation и укажите следующие настройки: 

Installing Code

Скопируйте полученный код в поле Installing Code и установите на все страницы сайта. Например, при помощи Google Tag Manager.

Теперь вы можете перейти к настройки событий на стороне сайта. 

Настройка отслеживания событий

При помощи Javascript SDK вы можете настроить 4 типа событий: 

Page

Это базовое событие, которое отправляет информацию о просмотре страницы. Данное событие рекомендуется вызывать на всех страницах сайта.

Чтобы вызвать событие просмотра страницы используйте код ниже:

Вы также можете указать дополнительные атрибуты, если стандартных данных недостаточно. Как модифицировать событие типа page читайте в данном руководстве. 

Track

Используйте для фиксации любых действий пользователей на сайте. Вы можете создавать собственные имена событий с любым количеством описывающих атрибутов. 

Ниже приведены сценарии использования данного типа события: 

1. Регистрация в продукте

2. Подписка на рассылку

3. Совершение транзакции в интернет-магазине

То есть, вы можете создавать любые события, которые является ценными для вашего проекта. 

Пример вызова javascript-кода для фиксации транзакции:

1<script>
2
3  analytics.track('Transaction completed', {
4  transactionId: "ABC00001",
5  transactionRevenue: 1000
6
7});
8
9</script>

Каждое событие track состоит из: 

Identity

Необходимо использовать только в момент идентификации пользователя. Ниже приведены сценарии, когда стоит вызывать данный тип события: 

1. После успешной регистрации

2. После успешной авторизации

3. Когда пользователь обновил свою контактную информацию

Для вызова события используйте javascript-код: 

1<script>
2
3 analytics.identify("userid_variable", {
4  name: "Elon Musk",
5  email: "elon@tesla.com",
6  company: "Tesla Motors"
7
8 });
9
10</script>

Помимо стандартных полей, identity поддерживает следующие поля:

Group

Событие служит для обьединение пользователей в общую группу.

В качестве группы может служить название компании, департамента или проект. То есть, можно использовать любой внутренний идентификатор в вашей системе. 

Для вызова события используйте javascript-код: 

1<script>
2
3 analytics.group("groupid_variable", {
4
5  company: "Tesla",
6  industry: "Auto Manufacturing",
7  employees: 70757
8
9 });
10
11</script>

Помимо стандартных полей, group поддерживает следующие поля:

Структура стандартных полей

По-умолчанию события всех типов поступают со стандартным списком полей, которые доступны для передачи в server-side интеграциях, а также сохраняются в отдельную таблицу при интеграции DWH. 

Перечь стандартных полей, а также их описание доступно ниже в таблице: