Web-события и сессии используются в Loymax Smart Communications для обработки действий клиента на сайте интернет-магазина или в мобильном приложении.

​Web-события

Web-событие — это действие, которое клиент совершил на сайте или в мобильном приложении. В Loymax Smart Communications web-события представляют собой объекты, которые сохраняются в базе данных и могут быть использованы для построения сегментов, а также в кампаниях и массовых рассылках.

Для web-событий существует привязка к источнику события (например, один из нескольких сайтов, или мобильное приложение).

Вместе с информацией о web-событии может сохраняться его контекст — данные объекта, с которым связано событие. Например, вместе с событием Добавлен товар в контейнер сохранится объект Продукт, т.е. значения всех полей добавленного в контейнер продукта.

Способы получения информации о web-событиях

Loymax Smart Communications может получать информацию о web-событиях тремя способами, описанными ниже. Независимо от способа передачи, в Loymax Smart Communications создаётся объект с одним и тем же набором атрибутов (полей) и доступных действий.

JS-трекер

В JS-трекере предусмотрен набор преднастроенных web-событий (например, авторизация на сайте или просмотр продукта), а также есть возможность настраивать произвольные пользовательские события (например, клиент поставил продукту низкую оценку).

Мобильный SDK

Метод event Мобильного SDK позволяет передавать в Loymax Smart Communications произвольные web-события, связанные с активностью клиента в мобильном приложении. Набор поддерживаемых событий настраивается на этапе интеграции.

REST API

Мастер-система Партнёра может передавать в Loymax Smart Communications информацию о web-событиях через вызовы REST API (методы Web_event).

Сессии

​Сессия — это последовательность действий клиента на сайте или в мобильном приложении (т.е. последовательность web-событий). Идентификатор сессии является обязательным атрибутом web-события и позволяет привязать его к клиенту.

Если в рамках сессии не передавалось событие user_login или user_visit c заполненным полем идентификатора клиента (например, клиент просматривает продукты на сайте, не авторизуясь), сессия будет анонимной. Анонимные сессии хранятся в базе данных Loymax Smart Communications в течение 60 дней.

Логика работы с сессией различается в зависимости от способа передачи web-событий в Loymax Smart Communications.

Работа с сессиями через JS-трекер

При старте новой сессии JS-трекер создаёт и отправляет клиенту файл cookie. Дальнейшие действия клиента будут привязываться к сессии по данному файлу. Срок жизни cookie составляет 1 час с автоматическим продлением после каждого нового действия. При этом автоматически генерируется и записывается в базу данных событие user_visit.

Если клиент ранее уже авторизовался на сайте, и у него сохранился файл cookie от прошлой сессии, JS-трекер автоматически заполнит поле идентификатора клиента. Кроме того, JS-трекер заполнит поле идентификатора клиента, если тот перешёл на сайт по ссылке из email-рассылки.

В остальных случаях для идентификации клиента необходима передача в JS-трекер события авторизации и регистрации (user_login). Соответствующий код нужно добавить на страницу авторизации.

В случае, если срок жизни cookie истёк, а клиент совершил новое действие, JS-трекер создаёт новый файл cookie и стартует новую сессию.

Работа с сессиями через мобильный SDK и через REST API

При работе через мобильный SDK и/или REST API логика группировки событий в сессии должна быть реализована на стороне Партнёра. Передача web-событий в Smart Communications осуществляется при помощи метода event мобильного SDK и метода Web_event REST API.

При старте новой сессии необходимо передать событие user_login или user_visit с заполненными полями идентификатора сессии (session_id) и идентификатора клиента (user_id) в мастер-системе. Во всех последующих событиях должно быть заполнено поле идентификатора сессии (session_id).