Исходный код вики Web-события и сессии
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | == **Web-события** == | ||
| 2 | |||
| 3 | Web-событие — это действие, которое клиент совершил на сайте или в мобильном приложении. В Loymax Smart Communications web-события представляют собой объекты, которые сохраняются в базе данных и могут быть использованы для построения сегментов, а также в кампаниях и массовых рассылках. | ||
| 4 | |||
| 5 | Для web-событий существует привязка к [[источнику события>>doc:Main.Using.Smart_Communications.Settings_SC.Event_sources.WebHome]] (например, один из нескольких сайтов, или мобильное приложение). | ||
| 6 | |||
| 7 | Вместе с информацией о web-событии может сохраняться его [[контекст>>doc:Main.Using.Smart_Communications.Events.WebHome||anchor="H41A43E43D44243543A44144244143E43144B442438439"]] — данные объекта, с которым связано событие. Например, вместе с событием **Добавлен товар в контейнер** сохранится объект **Продукт**, т.е. значения всех [[полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] добавленного в контейнер продукта. | ||
| 8 | |||
| 9 | {{info}} | ||
| 10 | Объект, хранящийся в контексте web-события, статичен — его атрибуты сохраняют значения, которые были в момент события. Например, если вы выводите в текст сообщения цену продукта из контекста web-события, клиент увидит цену на момент события, а не на момент отправки сообщения. | ||
| 11 | |||
| 12 | На этом построена работа некоторых триггеров, например, [[Изменилась цена на просмотренный товар>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41843743C43543D43843B43044144C44643543D43043D43043F44043E44143C43E44244043543D43D44B43944243E432430440"]]. | ||
| 13 | {{/info}} | ||
| 14 | |||
| 15 | === **Способы получения информации о web-событиях** === | ||
| 16 | |||
| 17 | Loymax Smart Communications может получать информацию о web-событиях тремя способами, описанными ниже. Независимо от способа передачи, в Loymax Smart Communications создаётся объект с одним и тем же набором атрибутов ([[полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]]) и доступных действий. | ||
| 18 | |||
| 19 | ==== **JS-трекер** ==== | ||
| 20 | |||
| 21 | В [[JS-трекере>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome]] предусмотрен набор преднастроенных web-событий (например, авторизация на сайте или просмотр продукта), а также есть возможность настраивать произвольные пользовательские события (например, клиент поставил продукту низкую оценку). | ||
| 22 | |||
| 23 | ==== **Мобильный SDK** ==== | ||
| 24 | |||
| 25 | [[Мобильный SDK>>doc:Main.Integration.Integration_of_SC.MobileSDK.WebHome]]. Метод event позволяет передавать в Loymax Smart Communications произвольные web-события, связанные с активностью клиента в мобильном приложении. Набор поддерживаемых событий настраивается на этапе интеграции. | ||
| 26 | |||
| 27 | ==== **REST API** ==== | ||
| 28 | |||
| 29 | [[REST API>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.WebHome]]. Мастер-система Партнёра может передавать в Loymax Smart Communications информацию о web-событиях через вызовы REST API (методы [[Web_event>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.SmC_API_methods.Web_event.WebHome]]). | ||
| 30 | |||
| 31 | == **Сессии** == | ||
| 32 | |||
| 33 | Сессия — это последовательность действий клиента на сайте или в мобильном приложении (т.е. последовательность web-событий). Идентификатор сессии является обязательным атрибутом web-события и позволяет привязать его к клиенту. | ||
| 34 | |||
| 35 | Если ни в одном событии в сессии не заполнено поле идентификатора клиента (например, клиент просматривает продукты на сайте, не авторизуясь), сессия будет анонимной. Анонимные сессии хранятся в базе данных Loymax Smart Communications в течение 60 дней. | ||
| 36 | |||
| 37 | Анонимная сессия может быть привязана к клиенту (деанонимизирована) двумя способами: | ||
| 38 | |||
| 39 | * В рамках сессии произошло событие [[авторизации или регистрации>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome||anchor="H41043244243E44043843743044643844F43844043543343844144244043044643844F"]] клиента. | ||
| 40 | * Web-событие в рамках сессии послужило триггером кампании, и клиент перешёл по ссылке из сообщения, отправленного в рамках данной кампании. | ||
| 41 | |||
| 42 | Логика работы с сессией различается в зависимости от способа передачи web-событий в Loymax Smart Communications. | ||
| 43 | |||
| 44 | === Работа с сессиями через JS-трекер === | ||
| 45 | |||
| 46 | При старте новой сессии JS-трекер создаёт и отправляет клиенту файл cookie. Дальнейшие действия клиента будут привязываться к сессии по данному файлу. Срок жизни cookie составляет 1 час с автоматическим продлением после каждого нового действия. | ||
| 47 | |||
| 48 | В случае, если срок жизни cookie истёк, а клиент совершил новое действие, JS-трекер создаёт новый файл cookie и стартует новую сессию. | ||
| 49 | |||
| 50 | Деанонимизация сессии происходит автоматически, если на сайте настроена обработка JS-трекером события [[авторизации и регистрации>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome||anchor="H41043244243E44043843743044643844F43844043543343844144244043044643844F"]] (##user_login##). | ||
| 51 | |||
| 52 | === Работа с сессиями через мобильный SDK и через REST API === | ||
| 53 | |||
| 54 | При работе через мобильный SDK и/или REST API логика группировки событий в сессии должна быть реализована на стороне Партнёра. | ||
| 55 | |||
| 56 | Поле идентификатора сессии (##session_id##) является обязательным для метода [[event>>doc:Main.Integration.Integration_of_SC.MobileSDK.WebHome||anchor="event"]] мобильного SDK и для метода [[Web_event>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.SmC_API_methods.Web_event.WebHome]] REST API. На основании полученного значения ##session_id## Loymax Smart Communications создаёт новую сессию или привязывает web-событие к уже существующей сессии. | ||
| 57 | |||
| 58 | Деанонимизация сессии происходит, как только в Loymax Smart Communications передаётся web-событие с заполненным полем идентификатора клиента. | ||
| 59 | |||
| 60 | {{info}} | ||
| 61 | Рекомендуется придерживаться следующих принципов при формировании сессий: | ||
| 62 | |||
| 63 | * обеспечивать уникальность идентификаторов сессий; | ||
| 64 | * начинать новую сессию, если с момента последнего действия клиента прошло больше 1-2 часов. | ||
| 65 | {{/info}} | ||
| 66 | |||
| 67 |