События

Проверка инициализации SDK

Используйте флаг инициализации SDK, прежде чем отправлять события в API. Если SDK не инициализирован, то нет гарантии, что did и seance корректные и попытка отправить с ними запрос может привести к ошибкам.

Для того, чтобы работали сервисы и аналитика, необходимо передавать поведенческие действия пользователей (события) в API.

Настоятельно рекомендуется делать это со стороны клиента, т.к.:

1. К стандартным действиям требуется привязка к did и seance.
2. Последовательность действий, отправленных в API, имеет большое значение: если перешлете сначала заказ, а потом добавление в корзину, клиенту уйдет неправильное триггерное письмо.

Необходимо сделать кеш событий на клиенте: если попытка отправить событие окончилась неудачно (плохой интернет, API лежит), то необходимо повторить попытку через несколько секунд. Через 10 неудачных попыток необходимо остановить отправку, чтобы не устроить DDOS-атаку на сервер API.

Стандартные события

Стандартные события:

1. Просмотр товара
2. Просмотр категории
3. Поисковый запрос
4. Добавление в корзину
5. Удаление из корзины
6. Покупка
7. Добавление в избранное
8. Удаление из избранного

Все стандартные события должны иметь привязку к did и seance.

Кастомные события

Кастомные события, созданные в CDP платформы, можно передавать как с клиента, используя did+seance, так и с сервера, используя email или phone. Но лучше с клиента, иначе сегментация и таргетинг без did+seance могут работать некорректно.

Трекинг кликов по поиску и рекомендациям

Если пользователь нажал/кликнул на товар в результатах поиска или в товарных рекомендациях, предоставленных платформой, трекинг события нужно обязательно передавать с параметрами recommended_by и recommended_code, описанными в документации по трекингу событий. Без этого аналитика по использованию сервиса будет некорректной и сегментация/таргетинг будут работать неправильно.

Обработка ошибок

Ошибка	Что делать
SDK не инициализирован	Не обращаться к API
Нет связи	Повторить попытку с интервалом в 15 секунд не более 10 раз
4xx	Не делать повторные попытки
500	Повторить попытку с интервалом в 15 секунд не более 10 раз
502	Не делать повторные попытки
504	Не делать повторные попытки