Что такое пользовательские события
enKod позволяет отслеживать множество событий на вашем сайте или в приложении. Среди них: просмотры товаров или страниц, изменения корзин, избранного, заказы и возвраты заказов. В определенный момент вам может понадобиться настроить механику на основе специфического события, которое мы не предусмотрели.
В этом случае вы можете создать пользовательское событие, и по нему:
- сегментировать базу
- отправлять сообщения
- запускать сценарии
Пользовательское событие - это HTTP API-запрос или метод JS-скрипта, который вы создаете в сервисе, называете удобным вам образом и передаете нам со своего сайта, из внутреннего сервиса, мобильного приложения и любой необходимой системы. Внутри кастомного события вы можете передавать набор параметров, которые так же можно использовать при сегментации. Параметры события будут созданы автоматически, если не были созданы заранее.
Событие всегда должно быть привязано к контакту. Какой из способов передачи вы бы ни выбрали - передача идентификатора контакта внутри события обязательна.
Создание и параметры событий
Создание событий происходит в разделе Данные ➔ События.
Событие до его передачи должно быть обязательно создано в сервисе. В противном случае мы его не запишем. В то же время создавать заранее параметры необязательно, мы создадим их автоматически. Вам останется только позже добавить для них названия.
Передача пользовательских событий
API
Используйте метод POST /customEvent/save чтобы передать нам событие.
Скрипт
ekEvents.push('event', {email:'[email protected]', phone:'79000000000', params: {param1: 'value1'}});
где:
- event - системное имя события, созданного в enKod ➔ Пользовательские события
- param- системное имя параметра
- value- значение параметра
С методом может передаваться (не обязательно) емейл и/или телефон контакта. Если емейл и/или телефон не переданы или контакты с такими идентификаторами не найдены в аккаунте, то мы свяжем событие с сессией, если знаем ее. В случае привязки к сессии и при ее отсутствии (и отсутствии в вашем аккаунте переданных емейла или телефона) событие не отобразится в enKod.
Лог событий
В том же разделе Данные ➔ События в табе «История событий» вы можете просматривать всю историю кастомных событий, которые вы передали нам за все время. По истории можно искать сами события, а так же контакты, которые были переданы в них.
По клику на название события будут отображаться детали - параметры и значения, которые были созданы.
Сегментация по пользовательским событиям
Сегментация по пользовательским событиям с подусловиями по параметрам события доступна для всех типов данных параметров: строка, дата, дата-время, число, дробное и логический.
Старт сценария при получении пользовательского события
В сценариях вы можете настроить начальный блок «Пользовательское событие», указав ограничения по значениям параметров этого события, если необходимо. В таком случае, при получении указанного события будет запущен сценарий для пользователя, переданного в запросе.
