Теги клиентов

Общая информация

Теги могут являться индикатором какого-либо действия совершенного клиентом или характеристикой, относящей клиента, к какой-либо группе (пол, возраст, город и т.д.). Эти данные используются в сегментации клиентов для аналитики и дальнейшей обработки, например: запуска цепочки событий (триггеров), выбора в качестве аудитории для рассылок или акций.

Пользовательские / системные теги

Системные теги – уже заложены в платформу и привязаны к основным системным событиям, таким как: покупка, получение подарка, открытие письма, использование промокода и т.д. или отражают основные характеристики клиентов – пол, возраст, геоданные. Они присваиваются клиентам автоматически при указании характеристики или совершении системного события.

Пользовательские теги – создаются партнером, исходя из его потребностей, в кабинете или через API и могут быть присвоены через рассылки, триггерные сценарии и использоваться для сегментации клиентов наряду с системными.

📘

Пользователи платформы не могут удалить или изменить системные теги. Имеется в ввиду, что нельзя удалить сам тег из платформы. Удалить некоторые системные теги у клиента возможно.

Типы тегов

Каждый тег может иметь один из двух типов:

Флаг

При получении этого события, Sailplay проверяет, был ли уже у данного пользователя установлен этот флаг. Если был, ничего не происходит. Если не был - флаг устанавливается.

Счетчик

При получении данного события, Sailplay, увеличивает счетчик на 1 для данного события для данного пользователя.

Добавление / удаление тегов клиента

Sailplay API позволяет добавить, удалить или получить список тегов клиента. В запросе помимо авторизационных данных клиента и приложения нужно передавать еще параметр 'tags': список тегов, которые будут добавлены / удалены.

📘

Инфо

Если тег, переданный в запросе на добавление, отсутствовал в дереве тегов, он будет создан в категории "Автоматически созданные теги" -> "Созданные через Backend API".

Для присвоения тега клиенту используется метод /users/tags/add.
Для удаления: /users/tags/delete.

Получение списка тегов клиента

Метод /users/tags/list служит для получения списка всех присвоенных клиенту тегов. При этом для клиента можно запросить список определенных тегов, передав их параметре tags:

tags=["Tag1","Tag2"]

В этом случае запрос вернет только те теги из списка, которые присвоены данному клиенту.

Системные теги