Web-события и сессии

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

14

15

Для web-событий существует привязка к [[источнику события>>doc:Main.Using.Smart_Communications.Settings_SC.Event_sources.WebHome]] (например, один из нескольких сайтов, или мобильное приложение).

16

17

Вместе с информацией о web-событии может сохраняться его [[контекст>>doc:Main.Using.Smart_Communications.Events.WebHome||anchor="H41A43E43D44243543A44144244143E43144B442438439"]] — данные объекта, с которым связано событие. Например, вместе с событием **Добавлен товар в контейнер** сохранится объект **Продукт**, т.е. значения всех [[полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]] добавленного в контейнер продукта.

18

19

20

Объект, хранящийся в контексте web-события, статичен — его атрибуты сохраняют значения, которые были в момент события. Например, если вы выводите в текст сообщения цену продукта из контекста web-события, клиент увидит цену на момент события, а не на момент отправки сообщения.

21

22

На этом построена работа некоторых триггеров, например, [[Изменилась цена на просмотренный товар>>doc:Main.Using.Smart_Communications.Campaign_list.Triggers.WebHome||anchor="H41843743C43543D43843B43044144C44643543D43043D43043F44043E44143C43E44244043543D43D44B43944243E432430440"]].

23

24

25

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

26

27

Loymax Smart Communications может получать информацию о web-событиях тремя способами, описанными ниже. Независимо от способа передачи, в Loymax Smart Communications создаётся объект с одним и тем же набором атрибутов ([[полей>>doc:Main.Using.Smart_Communications.Settings_SC.Data_field.WebHome]]) и доступных действий.

28

29

==== **JS-трекер** ====

30

31

В [[JS-трекере>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome]] предусмотрен набор преднастроенных web-событий (например, авторизация на сайте или просмотр продукта), а также есть возможность настраивать произвольные пользовательские события (например, клиент поставил продукту низкую оценку).

32

33

==== **Мобильный SDK** ====

34

35

Метод event [[Мобильного SDK>>doc:Main.Integration.Integration_of_SC.MobileSDK.WebHome]] позволяет передавать в Loymax Smart Communications произвольные web-события, связанные с активностью клиента в мобильном приложении. Набор поддерживаемых событий настраивается на этапе интеграции.

36

37

==== **REST API** ====

38

39

Мастер-система Партнёра может передавать в Loymax Smart Communications информацию о web-событиях через вызовы [[REST API>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.WebHome]] (методы [[Web_event>>doc:Main.Integration.Integration_of_SC.Data_communiction.SmC_API.SmC_API_methods.Web_event.WebHome]]).

== **Сессии** ==

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

44

45

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

46

47

Анонимная сессия может быть привязана к клиенту (деанонимизирована) двумя способами:

48

49

* В рамках сессии произошло событие [[авторизации или регистрации>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome||anchor="H41043244243E44043843743044643844F43844043543343844144244043044643844F"]] клиента.

50

* Web-событие в рамках сессии послужило триггером кампании, и клиент перешёл по ссылке из сообщения, отправленного в рамках данной кампании.

51

52

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

53

54

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

55

56

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

57

58

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

59

60

Деанонимизация сессии происходит автоматически, если на сайте настроена обработка JS-трекером события [[авторизации и регистрации>>doc:Main.Integration.Integration_of_SC.JS_tracker.WebHome||anchor="H41043244243E44043843743044643844F43844043543343844144244043044643844F"]] (##user_login##).

61

62

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

63

64

При работе через мобильный SDK и/или REST API логика группировки событий в сессии должна быть реализована на стороне Партнёра.

65

66

Поле идентификатора сессии (##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-событие к уже существующей сессии.

67

68

Деанонимизация сессии происходит, как только в Loymax Smart Communications передаётся web-событие с заполненным полем идентификатора клиента.

69

70

71

Рекомендуется придерживаться следующих принципов при формировании сессий:

72

73

* обеспечивать уникальность идентификаторов сессий;

74

* начинать новую сессию, если с момента последнего действия клиента прошло больше 1-2 часов.