Подготовка к работе и перенос исторических данных
На этом этапе необходимо определить логику базовых сущностей и на их основе произвести перенос исторических данных.
В разделе описаны принципы взаимодействия с API Sailplay и стандартный набор сущностей, используемый при работе с сервисом.
Отделы и сотрудники
Сотрудники — это сущность, pin_code которой используется для авторизации, а также в некоторых API запросах и действий в интерфейсе Sailplay.
Перед началом передачи данных необходимо создать сотрудников и определить, к каким отделам они относятся.
Что может быть отделом
Отделом может выступать:
- магазин
- склад
- регион
- поддомен сайта
- любая другая точка продаж или активности
При каждом API-запросе обязательно указывается идентификатор отдела, поэтому важно заранее воспроизвести структуру отделов в Sailplay.
Корректная структура отделов позволяет:
- правильно настраивать акции
- сегментировать клиентов
- получать корректную аналитику
Создать отделы и сотрудников можно:
- через API
- через личный кабинет Sailplay
Авторизация
Для выполнения запросов к API Sailplay необходимо регулярно получать токен доступа.
Авторизацию необходимо выполнять не реже одного раза в сутки,
чтобы обновлять токен для последующих API-запросов.
Подробное описание процесса авторизации и получения токена доступно по ссылке.
Клиенты
Перед началом работы с сервисом рекомендуется перенести в Sailplay исторические данные клиентов, уже имеющихся в вашей базе.
Это необходимо для:
- персональной коммуникации
- корректного расчета скидок
- работы сегментаций и акций
Загрузка клиентов
Для загрузки клиентов используйте API-метод «Создать клиента»
и передайте основные данные пользователя.
Полное описание всех методов работы с сущностью «Клиенты»
доступно здесь.
Атрибуты клиентов
Для передачи дополнительных свойств клиента, таких как:
- второй номер телефона
- UTM-метки при регистрации
- дополнительные персональные данные
используйте сущность «Атрибуты клиентов».
Теги клиентов
Еще одной важной сущностью являются «Теги клиентов».
Теги используются для передачи в Sailplay событий и действий клиента, например:
- клиент совершил звонок
- клиент зарегистрировался в мобильном приложении
- клиент выполнил определенное действие на сайте
На основе тегов:
- формируются сегменты
- запускаются коммуникации
- срабатывают триггерные сценарии
Товары
Sailplay API предоставляет инструменты для загрузки и управления товарной номенклатурой.
Наличие актуального каталога товаров необходимо для:
- корректной работы маркетинговых акций
- сегментации клиентов
- аналитики продаж
Атрибуты товаров
Для передачи дополнительных характеристик товаров, таких как:
- вес
- цвет
- размер
- любые другие параметры
используется сущность «Атрибуты товаров».
Передавайте максимально возможное количество атрибутов —
они могут быть использованы в процессинге, сегментациях и аналитике.
Покупки
Наличие покупок в Sailplay так же важно, как наличие клиентов и товаров.
Главная задача интеграции — корректная передача всех покупок в реальном времени,
независимо от того:
- где была совершена покупка
- был ли покупатель идентифицирован
Перенос исторических покупок не является обязательным,
но настоятельно рекомендуется передать данные минимум за последний год.
Атрибуты покупок
Для передачи дополнительных свойств покупки, например:
- тип доставки
- номер кассы
- дополнительные параметры заказа
используется сущность «Атрибуты покупок».