Подготовка к работе и перенос исторических данных

На этом этапе необходимо определить логику базовых сущностей и на их основе произвести перенос исторических данных. В разделе описаны принципы взаимодействия с API Sailplay и стандартный набор сущностей, используемый при работе с сервисом Sailplay.

Отделы и сотрудники

Сотрудники, это сущность, от лица которой производится авторизация и последующие действия в интерфейсе Sailplay. Для того чтобы передавать данные в сервис, предварительно, нужно создать сотрудников, которые будут находиться в определенных отделах.

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

Создать отделы и сотрудников можно как по API, так и в личном кабинете. Более подробная информация о сущностях “Сотрудники” и “Отделы”, а так же, как правильно работать с этими сущностями, находится по ссылке.

Авторизация

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

Клиенты

Перед использованием сервиса, будет полезно произвести перенос в Sailplay записей клиентов, имеющихся у вас в базе. В дальнейшем это нужно для того, чтобы персонально коммуницировать с потенциальными покупателями и производить индивидуальный расчет скидок. Загрузите клиентов и их основные свойства с помощью метода API “Создать клиента”. Подробное описание на все возможные методы работы с сущностью “ Клиенты ” находится здесь.

Для передачи дополнительных личных свойств клиента, таких как, второй номер телефона или utm метки при регистрации, воспользуйтесь сущностью "Атрибуты клиентов". Подробное описание сущности и ее методы работы, находятся по ссылке.

Еще одной важной сущностью, являются “Теги клиентов”. Они созданы для того, чтобы передать в Sailplay действия, совершенные потенциальным покупателем или их отношения к сегментам. Например, клиент совершил звонок в компанию. Для Sailplay, это хорошая возможность, чтобы спросить клиента, насколько успешно удалось пообщаться. Или, например, клиент зарегистрировался в приложении. Что, если отправить такому клиенту push с предложением: Анастасия, пройдите опрос после регистрации и получите 500 баллов на следующую покупку. На этапе интеграции старайтесь сразу задуматься о том, что теги, в виде осуществленных событий или действий, очень важный фактор для коммуникации с клиентом. На основе присвоенных тегов происходят сегментированные отправки сообщений и другие, более сложные сценарии. Помимо отправки, есть еще и триггеры, которые помогают воспроизводить действия в момент проставления тега. Подробное описание сущности тегов находится здесь.

Товары

В Sailplay API реализованы механизмы для загрузки и управления товарной номенклатурой, позволяющие перенести структуру товаров, организованную внутри вашей системы. Наличие номенклатуры в Sailplay важно для правильной организации маркетинговых акций, сегментаций и аналитики. Компаниям, требуется управлять продажами в определенных группах товаров. Создайте возможность анализировать эффекты работы акций с помощью сервиса и оценивать её, сравнивая начальную статистику по продажам с полученным результатом. Подробное описание того, как с помощью API правильно создавать данные в сущности “Товары”, а также как можно удалять и изменять их, находится по ссылке

Для того, чтобы передать дополнительные характеристики товаров, такие как вес, цвет или размер, в Sailplay создана отдельная сущность “Атрибуты товаров”. Мы рекомендуем передавать как можно больше атрибутов. Каждый из переданных параметров может быть использован для воспроизведения процессинговой логики, сегментации и аналитики. По ссылке расположено детальное описание сущности и процесс работы с ней.

Покупки

Наличие покупок в Sailplay не менее важно, чем наличие товаров и клиентов. Главным критерием внедрения сервиса является, корректная передача всех покупок в real time, вне зависимости от того, где именно произведена покупка и есть ли у нее идентифицированный покупатель. Перенос исторических покупок не является обязательным условием при внедрении сервиса. Но настоятельно рекомендуется произвести передачу данных за последний год. По ссылке находится документация на описание сущности “Покупки”.

Для того, чтобы передавать дополнительные свойства покупок, например, тип доставки или номер кассы, таким образом увеличивая персонализацию заказа, в Sailplay есть дополнительная сущность: “Атрибуты покупок”. Ее детальное описание находится по ссылке.