Документация

Описание особенностей поведения системы. СУЛ

Changelog

Changelog

Новое в версии 1.1.31

Скидки и бонусы

Changelog

Новое в версии 1.1.30

События

Отчетность

Changelog

Новое в версии 1.1.29. Промежуточное 2

Cкидочные и бонусные механики

Личный кабинет

API

Changelog

Новое в версии 1.1.29. Промежуточное 1

SMS-Провайдера

Changelog

Новое в версии 1.1.29

Скидочные и бонусные механики

Описание акций

Любимые товары

Отчетность

API

Changelog

Новое в версии 1.1.28

Скидочные и бонусные механики

Клиенты и карты

Ассортимент товаров

Продажи

Отчетность

API

 

Changelog

Новое в версии 1.1.27

Скидочные и бонусные механики

УЛК

Отчетность

 

Changelog

Новое в версии 1.1.26

Скидочные и бонусные механики

Клиенты и карты

Отчетность

API

Changelog

Новое в версии 1.1.25

Viber

СМС-провайдеры

Сценарии

Сегменты клиентов

Changelog

Исправления для версии 1.1.24

Чат-боты

API

Ролевая модель

УЛК

Исправление ошибок

Changelog

Новое в версии 1.1.24

Личный кабинет

Карты и пользователи

Changelog

Новое в версии 1.1.23

Сценарии

Коммуникации

Скидочные и бонусные механики

API

Changelog

Новое в версии 1.1.22

НСИ

Сценарии

Коммуникации

Скидочные и бонусные механики

API

Отчетность

VK-бот

Модуль Битрикс24

Модуль Фронтол

Changelog

Новое в версии 1.1.21

Скидочные и бонусные механики

НСИ

УЛК

Отчетность

API

Telegram-бот

Фронтол

Changelog

Новое в версии 1.1.20

Скидочные и бонусные механики

НСИ

API

УЛК

Расширения

Changelog

Новое в версии 1.1.19

Скидочные и бонусные механики

API

УЛК

Telegram

Расширения

Changelog

Новое в версии 1.1.18

 

Скидочные и бонусные механики

Механизм событий и сценариев

Клиенты и карты

API

Управление ролевой моделью

УЛК

Telegram

Аналитика

Исправленные ошибки

Расширения

Changelog

Новое в версии 1.1.17

Справочная информация

Клиенты и карты

Скидочные и бонусные механики

Аналитика

API

Исправлены ошибки

Changelog

Новое в версии 1.1.16

Справочная информация

Клиенты и карты

Скидочные и бонусные механики

Аналитика

API

Исправлены ошибки

Changelog

Новое в версии 1.1.15

Ассортимент

Скидочные и бонусные механики

Аналитика

Коммуникации

Исправлены ошибки

Changelog

Новое в версии 1.1.14

Получать электронные чеки

Скидочные и бонусные механики

Коммуникации с клиентами

Клиенты и карты

Аналитика

Исправлены ошибки

Карты пользователей

Работа с картами пользователей

Карты пользователей

Удаление карт пользователей

Процесс удаления

В меню слева необходимо нажать "Клиенты и карты".

image-1675068537236.png

Далее выбирается пункт "Карты".

image-1675068614306.png

Для перехода к удалению карт необходимо нажать "Сервис" - "Удалить карты".

image-1675068742448.png

На данной форме заполняются фильтры, по которым будут получены карты. Добавление фильтра осуществляется с помощью кнопки "Добавить фильтр". При выборе фильтра заполняются операторы сравнения и значения. Условия можно группировать с помощью кнопки "Сгруппировать условия".

image-1675068886933.png

Для получения карт по заданному отбору необходимо нажать кнопку "Получить карты". На открывшейся форме галочками отмечаются карты, которые планируется удалить. Разово возможно удалить 1000 карт.

image-1675069034474.png

После того как необходимые карты были отмечены к удалению, нужно нажать кнопку "Удалить карты". Появится окно подтверждения операции.

image-1675069102405.png

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

image-1675069214845.png

В случае нажатия кнопки "Нет" вопрос закроется, а форма выбора карт к удалению останется открытой.

image-1675069034474.png

Просмотр логирования операций удаления

На форме фильтров для получения карт необходимо нажать гиперссылку "Журнал операций".

image-1675069565654.png

Откроется форма с логами по удалениям карт.

image-1675070414218.png

При двойном нажатии на строчку откроется форма для просмотра подробной информации. 

 

image-1675070467160.png

 

 

 

 

Карты пользователей

Настройка виртуальных карт

Раздел настроек

Настройки виртуальных карты находятся в разделе "Клиенты и карты" - "Настройки виртуальных карт" 

image-1709646646821.png

Описание настроек

1. Токен для отправки обновления по карте - выдается сервисом.
2. Наименование организации на карте - наименование, которое используется в Apple Wallet.
3. Идентификатор эмитента - выдается google.

image-1709646684565.png

Продажи

Продажи

Удаление продаж

Процесс удаления продаж

В меню слева необходимо нажать "Правила программы".

image-1675070899256.png

Далее выбирается "Журнал продаж".

image-1675070941712.png

Для перехода к форме выбора продаж к удалению необходимо кнопку "Удалить продажи" (вверху справа (картинка "минус")).

image-1675071007471.png

В открывшейся форме галочками отмечаются строки продаж к удалению. Можно фильтровать строки благодаря набору фильтров справа. Для перехода к форме удаления нужно выбрать продажи и нажать кнопку "К форме удаления".

image-1675071207643.png

После нажатия на кнопку "К форме удаления" откроется форма подтверждения удаления, где галочками отмечаются продажи к удалению. Для удаления необходимо нажать на кнопку "Удалить продажи".

image-1675071440288.png

После нажатия появится окно с подтверждением операции.

image-1675071774821.png

При нажатии кнопки "Да" произойдет удаление продаж, форма удаления закроется и внизу появится сообщение со статусом операции.

image-1675071539281.png

При нажатии кнопки "Нет" форма подтверждения закроется, а форма выбора продаж к удалению останется открытой.

image-1675071440288.png

Просмотр логирования операций удаления продаж

На форме выбора продаж к удалению справа вверху необходимо нажать гиперссылку "Журнал операций".

image-1675071860658.png

В результате откроется форма со списком операций по удалению продаж.

image-1675071936258.png

При двойном нажатии на строчку откроется форма для просмотра подробной информации об операции удаления.

 

 

image-1675071983817.png

 

Продажи

Свойства продаж

Настройка свойств в ЛК СУЛ

Для добавления/изменения свойств продажи нужна роль "Добавление изменение настроек".

1. Для создания или изменения свойств продаж необходимо перейти в "Настройки" - "Свойства продаж".image-1726760979605.png

2. При создании или изменении существующего свойства откроется форма элемента с наименованием и значениями этого свойства.

image-1726762210914.png

Свойства имеют иерархию (иерархия элементов). 

3. Добавить значение в иерархию можно двумя способами:
1. Два раза нажать на элемент, тогда вы перейдете в текущее значение и при добавлении по кнопке "Добавить" родителем добавляемого значения будет элемент, в котором вы находитесь.
2. Выбрать элемент и нажать кнопку "Добавить в текущее". Тогда действия из пункта 1 выполняться автоматически (программа перейдет в текущее значение и добавит ему подчиненное) вам только останется ввести ему наименование.

4. Если вы перешли в элемент, то чтобы вернуться назад нужно нажать на "..."

image-1726762454227.png

5. Если значение является родителем других значений, то оно будет обозначаться значком папки.

6. При удалении значения, если оно является родителем других значений (учитывается полная иерархия до последнего элемента), то будет выведено оповещение с подтверждением операции удаления.

image-1726762612040.png

Настройка скидок по свойствам продаж

Добавлено новое условие скидок "По свойству продажи". При выборе этого условия обязательно выбрать свойство продажи, а затем выбрать список значений этого свойства, при передаче которых скидка должна будет сработать.

Нужно учитывать, что при выборе значения свойства учитывается иерархия, т.е. скидка сработает на выбранное значение и на все подчиненные ему.

image-1726762930318.png

Для выбора значения свойства надо нажать на кнопку "Выбрать". При двойном клике вы перейдете в иерархию выбранного элемента.

image-1726763000134.png

Просмотр свойств в продаже

В продажах таблица переданных свойств находится в правой части под таблицей примененных скидок. При двойном нажатии на свойство откроется форма свойства (если у пользователя достаточно прав)

image-1726762715446.png

 

Аналитическая отчетность

Особенности использования аналитической отчетности в системе управления лояльностью

Аналитическая отчетность

Настройка аналитической отчетности

Перейти к формированию отчетности можно нажав на иконку раздела "Аналитика". Откроется список доступных отчетов.

Раздел_Аналитика.gif

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

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

Собственный_вариант_отчета.gif

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

Для построения аналитической отчетности, требуется настроить периодическую выгрузку данных в специализированную базу данных. Для этого необходимо открыть раздел "Клиенты и карты" -> "События" и создать событие с типом "Выгрузка данных для аналитики".

Настройка_Выгрузки_Отчетность.gif

Периодичность выгрузки нужно выбирать в зависимости от необходимой актуальности данных в получаемой отчетности.

Нужно понимать, что аналитическая база данных не содержит оперативные данные. Актуальность данных определяется периодичностью выгрузки. Например,  в отчетах о продажах будут отображаться только те продажи, которые попали в систему до момента последней выгрузки.

 

Аналитическая отчетность

Выгрузка отчетов в файлы

Любой отчет можно выгрузить в файл в формате Excel 2007.  Для этого в командной панели отчета нужно выбрать пункт "Выгрузка" и выбрать вариант выгрузки:

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

Выгрузка_Отчетов.gif

Если открыта форма выгружаемого отчета, система выкидывает оповещение, при нажатии на которое открывается сформированная Excel таблица.

Если приложение по умолчанию для файлов xlsx не установлено, система предлагает выбрать приложение с помощью которого будет открываться файл

Выгрузка некоторых отчетов, особенно  с учетом группировок, может занять продолжительное время. Пользователю не требуется дожидаться результатов выгрузки, он может закрыть форму выгружаемого отчета и заниматься своими делами. Если необходимо получить выгруженный файл или проверить завершилась ли выгрузка заказанного отчета, можно перейти в раздел "Аналитическая отчетность" и в списке вариантов отчетов выбрать команду "Выгруженные отчеты".

image-1669748362694.gif

В открытой форме можно увидеть состояние выгрузки ранее заказанных отчетов, скачать файлы-результаты выгрузки предыдущих операций выгрузки, а также удалить уже не нужные файлы.

Для удобства открыть форму выгруженных файлов можно из любого отчета в подменю "Выгрузить..."

 

Ролевая система УЛК

Ролевая система УЛК

Роли и их назначение

На данный момент в системе определено 62 ролей для ограничения доступа к различным элементам конфигурации. В таблице ниже приведено их описание.

Для каждого объекта системы назначается своя роль с определенным типом доступа:

Название в конфигураторе

Представление в предприятии

Назначение
ул_БазовыеПраваБС

 

Базовые права для работы с БС

Дает доступ к необходимым элементам конфигурации для корректной работы с ней

ул_ДобавлениеИзменениеСкидок

Добавление и изменение скидок

Все возможности роли просмотра скидок + можно их изменять

ул_ПросмотрСкидок

Просмотр скидок

Только возможность просматривать существующие скидки, а так же выбирать их в формах выбора

ул_ДобавлениеИзменениеНачислениеИСписаниеБонусныхБаллов

Добавление и изменение начисление и списание бонусных баллов

Все возможности просмотра + можно изменять

ул_ПросмотрНачислениеИСписаниеБонусныхБаллов

Просмотр начисление и списание бонусных баллов

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

ул_ДобавлениеИзменениеПромокодов

Добавление и изменение промокодов

Все возможности просмотра + изменение

ул_ПросмотрПромокодов

Просмотр промокодов

Дает возможность просматривать созданные группы промокодов и промокоды, а так же доступ к форме выбора, но без возможности добавлять и изменять

ул_ДобавлениеИзменениеСертификатов

Добавление и изменение сертификатов

Все возможности просмотра + изменение

ул_ПросмотрСертификатов

Просмотр сертификатов

Дает возможность просматривать существующие сертификаты

ул_ДобавлениеИзменениеПодписок

Добавление и изменение подписок

Все возможности просмотра + изменение

ул_ПросмотрПодписок

Просмотр подписок

Дает возможность просматривать существующие подписки

ул_ДобавлениеИзменениеЛюбимыхТоваров

Добавление и изменение любимые товары

Все возможности просмотра + изменение

ул_ПросмотрЛюбимыхТоваров

Просмотр любимых товаров

Дает возможность изменять существующие и добавлять новые любимые товары

ул_ДобавлениеИзменениеАкции

Добавление и изменение акции

Все возможности просмотра + изменение

ул_ПросмотрАкции

Просмотр акции

Дает возможность изменять существующие и добавлять новые акции

ул_ПросмотрЖурналаТранзакций

Просмотр журнала транзакций

Дает возможность просматривать журнал транзакций

ул_ДобавлениеИзменениеЖурналаПродаж

Добавление и изменение журнала продаж

Возможность просмотра

ул_ПросмотрЖурналаПродаж

Просмотр журнала продаж

Просмотр журнала продаж

ул_ДобавлениеИзменениеЗаказов

Добавление и изменение заказов

Возможность просмотра + изменение и добавление заказов

ул_ПросмотрЗаказов

Просмотр заказов

Возможность просмотра существующих заказов

ул_ПросмотрДействийКлиентов

Просмотр действий клиентов

Возможность просматривать действия клиентов

ул_ДобавлениеИзменениеСлипЧеков

Добавление и изменение слип-чеков

Возможность просмотра + изменение и добавление слип-чеков

уд_ПросмотрСлипЧеков

Просмотр слип-чеков

Возможность просмотра существующих слип чеков

ул_ДобавлениеИзменениеВебХуки

Добавление и изменение веб-хуки

Возможность просмотра + изменение и добавление веб-хуки

ул_ПросмотрВебХуки

Просмотр веб-хуки

Возможность просмотра существующих веб-хуки

ул_ДобавлениеИзменениеУровнейКарт

Добавление и изменение уровней карт

Возможность просмотра + изменение и добавление уровней карт

ул_ПросмотрУровнейКарт

Просмотр уровней карт

Возможность просмотра существующих уровней карт

ул_ДобавлениеИзменениеКарт

Добавление и изменение карт

Возможность просмотра + изменение и добавление карт пользователей

ул_ПросмотрКарт

Просмотр карт

Возможность просмотра и выбора существующих карт пользователей

ул_ДобавлениеИзменениеКлиентов

Добавление и изменение клиентов

Возможность просмотра + изменение и добавление учетных записей клиентов

ул_ПросмотрКлиентов

Просмотр клиентов

Возможность просмотра существующих учетных записей клиентов

ул_ДобавлениеИзменениеСегментовКлиентов

Добавление и изменение сегментов клиентов

Возможность просмотра + изменение и добавление сегментов клиентов

ул_ПросмотрСегментовКлиентов

Просмотр сегментов клиентов

Возможность просмотра существующих сегментов клиентов

ул_ДобавлениеИзменениеСобытий

Добавление и изменение событий

Возможность просмотра + изменение и добавление событий

ул_ПросмотрСобытий

Просмотр событий

Возможность просмотра существующих событий

ул_ДобавлениеИзменениеСценарев

Добавление и изменение сценариев

Возможность просмотра + изменение и добавление сценариев

ул_ПросмотрСценариев

Просмотр сценариев

Возможность просмотра существующих сценариев

ул_ДобавлениеИзменениеМояОрганизация

Добавление и изменение моя организация

Возможность просмотра + изменение информации об организации

ул_ПросмотрМояОрганизация

Просмотр моя организация

Возможность просмотра информации об организации

ул_ДобавлениеИзменениеМагазинов

Добавление и изменение магазинов

Возможность просмотра + изменение и добавление карточек магазинов

ул_ПросмотрМагазинов

Просмотр магазинов

Возможность просмотра существующих карточек магазинов

ул_ДобавлениеИзменениеАссортимента

Добавление и изменение ассортимента

Возможность просмотра + изменение и добавление товарного ассортимента

ул_ПросмотрАссортимента

Просмотр ассортимента

Возможность просмотра существующего товарного ассортимента

ул_ДобавлениеИзменениеСегментовТоваров

Добавление и изменение сегментов товаров

Возможность просмотра + изменение и добавление сегментов товаров

ул_ПросмотрСегментовТоваров

Просмотр сегментов товаров

Возможность просмотра существующих сегментов товаров

ул_ДобавлениеИзменениеГородов

Добавление и изменение городов

Возможность просмотра + изменение и добавление городов

ул_ПросмотрГородов

Просмотр городов

Возможность просмотра существующих городов

ул_ДобавлениеИзменениеТиповЦен

Добавление и изменение типов цен

Возможность просмотра + изменение и добавление типов цен

ул_ДобавлениеИзменениеСлужбДоставки

Добавление и изменение служб доставки

Возможность просмотра + изменение и добавление служб доставки

ул_ПросмотрСлужбДоставки

Просмотр служб доставки

Возможность просмотра существующих служб доставки

ул_ПросмотрОтзывов

Просмотр отзывов

Возможность просмотра оставленных отзывов

ул_ДобавлениеИзменениеГруппПолучателей

Добавление и изменение групп получателей

Возможность просмотра + изменение и добавление групп получателей

ул_ПросмотрГруппПолучателей

Просмотр групп получателей

Возможность просмотра существующих групп получателей

ул_ОтправкаОповещений

Отправка оповещений

Возможность отправлять оповещения

ул_ДобавлениеИзменениеШаблоновОповещений

Добавление и изменение шаблонов оповещений

Возможность просмотра + изменение и добавление шаблонов оповещений

ул_ПросмотрШаблоновОповещений

Просмотр шаблонов оповещений

Возможность просмотра существующих шаблонов оповещений

ул_ПросмотрОтчетности

Использование отчетности

Работа с отчетами

ул_ДобавлениеИзменениеНастроек

Добавление и изменение настроек

Работа с настройками личного кабинета

ул_УдалениеКарт

Удаление карт

Возможность удаления карт

ул_УдалениеПродаж

Удаление продаж

Возможность удаления продаж

ул_ДобавлениеИзменениеНастроекЧатБотов

Добавление и изменение настроек чат ботов

Возможность изменения настроек чат ботов

ул_ДобавлениеИзменениеКаналовПродаж

Добавление и изменение каналов продаж

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

ул_ПросмотрКаналовПродаж

Просмотр каналов продаж

Возможность просмотра существующих каналов продаж
ул_ПросмотрПортретаКлиента

 

Просмотр портрета клиента

Возможность просмотра портрета клиента
Ролевая система УЛК

Предопределенные профили групп доступа

Соответствие предопределенной группы доступа в конфигурации и доступных ей ролей

Группа доступа

Доступные роли

Администратор

  1. Полные права

  2. АдминистраторСистемы

Маркетолог

  1. БазовыеПрава

  2. ЗапускВебКлиента

  3. ЗапускТонкогоКлиента

  4. ул_БазовыеПраваБС

  5. ул_ДобавлениеИзменениеСкидок

  6. ул_ДобавлениеИзменениеПромокодов

  7. ул_ДобавлениеИзменениеСертификатов

  8. ул_ДобавлениеИзменениеПодписок

  9. ул_ДобавлениеИзменениеЛюбимыхТоваров

  10. ул_ДобавлениеИзменениеАкции

  11. ул_ДобавлениеИзменениеЗаказов

  12. ул_ДобавлениеИзменениеСлипЧеков

  13. ул_ДобавлениеИзменениеУровнейКарт

  14. ул_ДобавлениеИзменениеКарт

  15. ул_ДобавлениеИзменениеКлиентов

  16. ул_ДобавлениеИзменениеКлиентов

  17. ул_ДобавлениеИзменениеСобытий

  18. ул_ДобавлениеИзменениеСценарев

  19. ул_ДобавлениеИзменениеМагазинов

  20. ул_ДобавлениеИзменениеАссортимента

  21. ул_ДобавлениеИзменениеСегментовТоваров

  22. ул_ДобавлениеИзменениеГородов

  23. ул_ДобавлениеИзменениеТиповЦен

  24. ул_ДобавлениеИзменениеСлужбДоставки

  25. ул_ДобавлениеИзменениеГруппПолучателей

  26. ул_ДобавлениеИзменениеШаблоновОповещений

  27. ул_ДобавлениеИзменениеОтчетов

  28. ул_ДобавлениеИзменениеНастроекЧатБотов
  29. ул_ДобавлениеИзменениеКаналовПродаж
  30. ул_ПросмотрПортретаКлиента

Только просмотр

  1. БазовыеПрава

  2. ЗапускВебКлиента

  3. ЗапускТонкогоКлиента

  4. ул_БазовыеПраваБС

  5. ул_ПросмотрСкидок

  6. ул_ПросмотрНачислениеИСписаниеБонусныхБаллов

  7. ул_ПросмотрПромокодов

  8. ул_ПросмотрСертификатов

  9. ул_ПросмотрПодписок

  10. ул_ПросмотрЛюбимыхТоваров

  11. ул_ПросмотрАкции

  12. ул_ПросмотрУровнейКарт

  13. ул_ПросмотрКарт

  14. ул_ПросмотрКлиентов

  15. ул_ПросмотрСегментовКлиентов

  16. ул_ПросмотрМагазинов

  17. ул_ПросмотрАссортимента

  18. ул_ПросмотрСегментовТоваров

  19. ул_ПросмотрГородов

  20. ул_ПросмотрСлужбДоставки

  21. ул_ПросмотрОтзывов

  22. ул_ПросмотрШаблоновОповещений

  23. ул_ПросмотрГруппПолучателей

  24. ул_ПросмотрКаналовПродаж
  25. ул_ПросмотрПортретаКлиента

Редактор карт

  1. БазовыеПрава

  2. ЗапускВебКлиента

  3. ЗапускТонкогоКлиента

  4. ул_БазовыеПраваБС

  5. ул_ДобавлениеИзменениеУровнейКарт

  6. ул_ДобавлениеИзменениеКарт

  7. ул_ДобавлениеИзменениеГруппПолучателей

  8. ул_ДобавлениеИзменениеКлиентов

  9. ул_ДобавлениеИзменениеСегментовКлиентов

  10. ул_ПросмотрПортретаКлиента

Редактор ассортимента, магазинов и городов

  1. БазовыеПрава

  2. ЗапускВебКлиентаЗапуск

  3. ТонкогоКлиента

  4. ул_БазовыеПраваБС

  5. ул_ДобавлениеИзменениеМагазинов

  6. ул_ДобавлениеИзменениеАссортимента

  7. ул_ДобавлениеИзменениеСегментовТоваров

  8. ул_ДобавлениеИзменениеГородов

  9. ул_ДобавлениеИзменениеТиповЦен

  10. ул_ДобавлениеИзменениеСлужбДоставки

  11. ул_ДобавлениеИзменениеКаналовПродаж

 

 

Ассортимент

Ассортимент

Удаление ассортимента

Для перехода к удалению ассортимента в меню слева необходимо выбрать пункт "Товары и магазины"

image-1676621407566.png

Далее выбирается пункт "Товарный ассортимент"

image-1676621478138.png 

В подменю "Сервис" необходимо выбрать "Удалить ассортимент"

image-1676621549074.png

В открывшейся форме в таблицу добавляются фильтры, по которым получится список ассортимента к удалению

image-1676621949158.png

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

image-1676621785259.png

Галочками слева выбирается ассортимент у удалению. После нажатия на кнопку "Удалить ассортимент" появляется окно подтверждения операции. 

image-1676621840334.png

После нажатия "Да" форма закрывается и появляется сообщение со статусом операции.

image-1676621884978.png

Если была нажата кнопка "Нет", то форма выбора ассортимента к удалению остается открытой.

image-1676621785259.png

API "Управление личного кабинета"

API "Управление личного кабинета"

Создание областей в УЛК

Позволяет создавать области данных в УЛК с указанными настройками подключения к серверу СУЛ и создавать пользователей УЛК.

POST запрос /data_area/add

Обмен данными выполняется по протоколу HTTP.

Кодировка текста utf-8. 

HTTP аутентификация: Basic Auth

 

Соответствие номеров и групп доступа:
1 - Администраторы 
2 - Маркетологи
3 - Редакторы ассортимента, магазинов и городов
4 - Редакторы карт
5 - Только просмотр

Ответ всегда приходит в следующем виде:

{
"code": Номер кода выполнения (200 - успешно, 400 - ошибка в ходе выполнения),
"data": Служебные сообщения, появившиеся в ходе выполнения (актуально только для завершения с ошибкой иначе null),
"message": Служебное сообщение о результате выполнения: "Область успешно создана" или "Возникли ошибки при выполнении операции добавления области данных"
}

Пример отправки запроса:

{
    "login": "login",                   		// Обязательный,   строка
    "data_area": "Номер области",       		// Обязательный,   число
    "server": "Адрес сервера",          		// Обязательный,   строка
    "port": "Номер порта",              		// Обязательный,   строка
    "password": "Пароль",               		// Обязательный,   зашифрованный в sha-1 строка
    "organization": "Наименование организации", // Обязательный,   строка
    "contact": "Контанктное лицо", 				// Необязательный, строка
    "phone": "Номер телефона",     				// Необязательный, строка
    "users": [                     				// Необязательный, массив структур
       {
           "name": "user1",             		// Обязательный,   строка
           "password": "password",      		// Обязательный,   строка только английские буквы
           "access_groups": [           		// Обязательный,   массив чисел
           1,
           2
           ], 
           "email": "email1@mail.ru",   		// Необязательный,	строка
           "phone": "79113456789"	      		// Необязательный, 	строка
       }
       {
           "name": "user2",  					// Обязательный,   строка            		
           "password": "itspassword",			// Обязательный,   строка только английские буквы    		
           "access_groups": [ 					// Обязательный,   массив чисел           		
            5
             ]              
       }
  ]
}

 

 

 

API "Управление личного кабинета"

Создание пользователей в области в УЛК

Позволяет создавать пользователей в области данных в УЛК с указанными группами доступа. 

POST запрос /data_area/add_users

Обмен данными выполняется по протоколу HTTP.

Кодировка текста utf-8. 

HTTP аутентификация: Basic Auth

 

Соответствие номеров и групп доступа:
1 - Администраторы 
2 - Маркетологи
3 - Редакторы ассортимента, магазинов и городов
4 - Редакторы карт
5 - Только просмотр

Ответ всегда приходит в следующем виде:

{
"code": Номер кода выполнения (200 - успешно, 400 - ошибка в ходе выполнения),
"data": Служебные сообщения, появившиеся в ходе выполнения (актуально только для завершения с ошибкой иначе null),
"message": Служебное сообщение о результате выполнения: "Пользователи для области успешно созданы" или "В ходе создания пользователей были получены ошибки"
}

Пример отправки запроса:

{
  "data_area": Номер области,		// Обязательный, 	число
  "users": [						// Обязательный, 	массив структур
    {
      "name": "user5",				// Обязательный, 	строка
      "password":"itspassword",		// Обязательный, 	строка только английские буквы
      "access_groups": [			// Обязательный, 	массив чисел
        1
      ]
    },
    {
      "name": "user6",				// Обязательный, 	строка
      "password": "password",		// Обязательный, 	строка только английские буквы
      "access_groups": [			// Обязательный, 	массив чисел
       4,
       5
      ],
      "email": "email6@mail.ru",	// Необязательный, 	строка
      "phone": "79223456781"		// Необязательный, 	строка
    }
  ]
}

 

 

 

Telegram-бот

Telegram-бот

1. Создание Telegram-бота

Для создания бота необходимо в телеграм найти аккаунт @BotFather.

Далее ему необходимо прописать следующие команды:
image-1678781088675.png

Красная команда - создание нового бота;
Зеленая команда - Имя бота, которое будет отображаться пользователю;
Желтая команда  - Логин бота для поиска в телеграм.

Синий прямоугольник с белой заливкой - место, в котором будет находится токен доступа к боту. Его нужно будет ввести в СУЛ. 

Telegram-бот

2. Ввод токена Telegram-бота

Для установки токена у пользователя должна быть роль ул_ДобавлениеИзменениеНастроек или ПолныеПрава. 
Для работы бота так же необходимо установить двухфакторную аутентификацию.

Чтобы настроить токен бота необходимо слева в меню нажать "Настройки".

image-1677588341946.png

Затем перейти в настройки поведения сервиса.

image-1677588386368.png

В переключателе вверху страницы выбрать "SMS, Email, Push, Telegram", а затем опустится вниз страницы. Нужная настройка называется "Токен доступа к Telegram-боту".

image-1678782232432.png

Работать бот может начать не сразу. Возможно придется подождать 10 - 15 минут.

 

Telegram-бот

3. Настройка Telegram-бота

Подготовка к настройке

Для настройки работы бота у пользователя должна быть роль ул_ДобавлениеИзменениеНастроекТелеграм или ПолныеПрава.

После обновления настроек их применение может произойти не сразу.  Возможно придется подождать 10 - 15 минут.

Раздел настроек

Чтобы перейти к форме настроек в меню слева необходимо нажать "Коммуникации".

image-1677588768348.png

В открывшейся форме нажать раздел "Чат боты".

image-1709647346557.png

Описание настроек

В открывшейся форме расположены настройки телеграм и вк ботов. Первые 5 настроек относятся и к телеграм и к вк боту.

Общие настройки:

- Флаг "Показывать раздел "Описание акций" отвечает за отображение введенных акций в настройках;

- Реквизит "Представление штрихкода карты" отвечает за формат отображения штрихкода;

- Флаг "Показывать раздел "Оценить сервис" отвечает за отправку показ раздела с оценкой сервиса пользователю;

- Флаг "Отображать правила бонусной программы" отвечает за отправку пользователю правил, введенных в реквизит "Правила бонусной программы";

- Флаг "Отображать представление карты" отвечает за отображение штрихкода карты (в Telegram) на фоне выбранной в реквизите "Изображение представления карты" картинки;

- Реквизит "Шаблон отображения карты Telegram-ботом" настраивается с помощью текста и параметров, которые выбираются в подменю справа (Параметры шаблона).

image-1709647984241.png

Настройки, относящиеся только к телеграм боту:

- Флаг "Запретить копирование в чат - боте" запрещает копирование сообщение в чате с телеграм ботом;

- Таблица список и порядок данных. С ее помощью настраивается список и порядок данных, которые будут необходимы при регистрации пользователя через Telegram.

image-1709648099712.png

 

Telegram-бот

4. Обзор Telegram-бота

После всех проведенных настроек переходим в бота.

Сразу будет отображаться окно авторизации. 

image-1678782347819.png

Для авторизации необходимо ввести почту или телефон (смотря что установлено в настройках СУЛ), а затем код подтверждения.

image-1678782462228.png

После этого становятся доступны функции бота в Reply-клавиатуре.

telegram1.jpg

1) Правила бонусной программы - настройка которая заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800080047.png
- Настройка в СУЛ:image-1678800138607.png

2) Описание карты - настройка которая заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800549284.png- Настройка в СУЛ:

image-1678800569861.png


3) Штрих-код карты - настройка, представление которой заполняется на вкладке "Коммуникации - Telegram"
- Представление в телеграм:

image-1678800608101.png- Настройка в СУЛ:

image-1678800629366.png

4) Оценить сервис - позволяет выставить оценку по пятибальной шкале от 1 до 5 и написать отзыв.

telegram2.jpg

После выбора оценки из Inline-клавиатуры необходимо ввести текст отзыва:

telegram3.jpg

 

 

Telegram-бот

5. Отправка данных в Telegram

В СУЛ Телеграм в качестве канала отправки оповещений могут использовать:

1). События. 

Для этого в форме элемента События необходимо перейти на страницу "Оповещения", установить флажок "Телеграм" и выбрать нужный шаблон оповещения:

image-1687270062710.png

2) Сценарии.

Из сценария отправка данных в Телеграм организована из узла с типом "Действие".

В форме узла необходимо добавить действие "Отправка Telegram". В качестве параметров используется следующие поля: "Значение" -  здесь можно ввести произвольный текст, который будет отправлен в Telegram.

"Шаблон" -  здесь можно выбрать предварительно подготовленный шаблон оповещения.

image-1687271058359.png

Поле "Значение" имеет более высокий приоритет над "Шаблон", то есть при если будут заполнены оба поля, то будет отправлен текст из поля "Значение".

 

Telegram-бот

1. Создание Telegram-бота

Для создания бота необходимо в телеграм найти аккаунт @BotFather.

Далее ему необходимо прописать следующие команды:
image-1678781088675.png

Красная команда - создание нового бота;
Зеленая команда - Имя бота, которое будет отображаться пользователю;
Желтая команда  - Логин бота для поиска в телеграм.

Синий прямоугольник с белой заливкой - место, в котором будет находится токен доступа к боту. Его нужно будет ввести в СУЛ. 

Источники данных

Источники данных

Создание источника данных

Для перехода к форме создания источника данных необходимо в меню слева выбрать "Настройки".

image-1678170753741.png

В открывшейся форме нужно выбрать вкладку "Источник данных".

image-1678170814731.png

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

image-1678170912412.png

В открывшейся форме нужно заполнить адрес сервера, порт сервера, логин и пароль.

Источники данных

Настройка подключения к SQL

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

image-1678171101968.png

Далее необходимо нажать на кнопку открытия существующей настройки, если настройка заполнена.

image-1678171202734.png

В случае, если настройка не заполнена, то нужно нажать на кнопку, раскрывающую выпадающий список, затем на кнотке "Создать".

image-1678171381550.png

Откроется форма "Настройки подключения к SQL" для создания, либо редактирования (в зависимости от прошлых действий), где необходимо ввести необходимые настройки и нажать кнопку "Записать и закрыть".

image-1678171684089.png

 

События

Описание параметров асинхронных и синхронных событий

События

Описание событий и их параметров

Событие "При продаже"/"при возврате" при списании и/или начислении более N суммы баллов.

Cобытие bonus_limit_exceeding - cинхронное

Параметры события:
bonus_add_limit - пороговое значение начисленных бонусов.
bonus_payment_limit - пороговое значение списаных бонусов.
time_zone - временная зона.
manage_groups - массив идентификаторов групп менеджеров, по которым проводить уведомления о событии.

Параметры bonus_add_limit и bonus_payment_limit могут использоваться вместе(оператор AND), когда присутствуют в json и значение больше 0, и по отдельности.

Пример:
{
...
"type": 0,
"event":"bonus_limit_exceeding",
...
"parameters":
[
{"bonus_add_limit":"20"},
{"bonus_payment_limit":"30"},
{"time_zone": 180},
{"manager_groups":["group_1", "group_2"]}
]
}

Параметры шаблона оповещения:

%ТИП_ОПЕРАЦИИ% - продажа или возврат
%ФИО% - ФИО клиента карты, по которому проводились операции
%НОМЕР_КАРТЫ% - номер карты клиента
%НАЧИСЛЕНО% - количество начисленных бонусов
%СПИСАНО% - количество списанных бонусов
%ПОЛУЧАТЕЛЬ_ФИО% - ФИО менеджера для рассылки
%ПОЛУЧАТЕЛЬ_EMAIL% - email менеджера для рассылки
%ПОЛУЧАТЕЛЬ_ТЕЛЕФОН% - телефон менеджера для рассылки

Событие при превышении числа свободных карт.

Событие free_card_exceeding - асинхронное

Параметры события:
free_card_limit_percent - пороговое значение числа свободных карт в процентах.
free_card_limit_count - пороговое значение числа свободных карт в количестве штук.
manager_groups - массив идентификаторов групп менеджеров, по которым проводить уведомления о событии.

Возможно одновременное использование free_card_limit_percent и free_card_limit_count.

Пример:
{
...
"type": 1,
"event":"free_card_exceeding",
...
"parameters":
[
{"free_card_limit_percent":"20"},
{"free_card_limit_count":"1000"},
{"manager_groups":["1","2"]}
]
}

Параметры шаблона оповещения:

%ПРОЦЕНТ_СВОБОДНЫХ% - процент свободных карт
%ДОСТУПНО_К_АКТИВАЦИИ% - число свободных карт в штуках
%СОЗДАНО_КАРТ% - всего созданных карт

%ПОЛУЧАТЕЛЬ_ФИО% - ФИО менеджера для рассылки
%ПОЛУЧАТЕЛЬ_EMAIL% - email менеджера для рассылки
%ПОЛУЧАТЕЛЬ_ТЕЛЕФОН% - телефон менеджера для рассылки

Событие при превышении числа карт по тарифу.

Cобытие tariff_card_exceeding - асинхронное

Параметры события:
tariff_card_limit_percent - пороговое значение числа доступных карт по тарифу в процентах.
tariff_card_limit_count - пороговое значение числа доступных карт по тарифу в количестве штук.
manager_groups - массив идентификаторов групп менеджеров, по которым проводить уведомления о событии.

Возможно одновременное использование tariff_card_limit_percent и tariff_card_limit_count

Пример:
{
...
"type": 1,
"event":"tariff_card_exceeding",
...
"parameters":
[
{"tariff_card_limit_percent":"20"},
{"tariff_card_limit_count":"1000"},
{"manager_groups":["1","2"]}
]
}

Параметры шаблона оповещения:

%АКТИВИРОВАНО_КАРТ% - всего активированных карт
%КАРТ_ПО_ТАРИФУ% - максимальное число карт, доступных по тарифу

%ПОЛУЧАТЕЛЬ_ФИО% - ФИО менеджера для рассылки
%ПОЛУЧАТЕЛЬ_EMAIL% - email менеджера для рассылки
%ПОЛУЧАТЕЛЬ_ТЕЛЕФОН% - телефон менеджера для рассылки

События

Уведомление о событиях в телеграм бот

Метод POST organization/job/add

параметр alert_to_telegram - булево. Включает отсылку сообщений в телеграм пользователей
параметр template_telegram_id - строка. Идентификатор шаблона для отправки сообщения в телеграм пользователей

Пример:
{
  ...
"alert_to_telegram":true,
"template_telegram_id":"template_1",
  ...
}

События

События в интерфейсе ЛК

На данный момент события разделены на два раздела:

"События" - здесь находятся события, которые присутствовали до момента разделения.

"Служебные события" - в этом разделе находятся события, необходимые для отправки служебных сообщений.

image-1685687636286.png

Для каждого раздела созданы свои роли для управления доступом. При срабатывании служебного события происходит отправка оповещения группе менеджеров. 

Группа менеджеров - это сущность, которая объединяет нескольких менеджеров.

В форме элемента ГруппыМенеджеров по кнопке "Добавить" можно привязать менеджера к группе менеджеров:

image-1685688420134.png

Менеджеры - это отдельный справочник сотрудников компании, для которых возможна отправка оповещений. Для этого у каждого Менеджера присутствует возможность указать контактные данные: почту и телефон.

Покажем связь перечисленных сущностей графически:

image-1685614149372.png

На данный момент к служебным событиям относятся:

- "При продаже"/"при возврате". Событие срабатывает при начислении количества баллов, которое превышает пороговые  значения.

- "При превышении числа свободных карт". Событие срабатывает когда количество свободных карт превышает пороговые  значения.

- "При превышении числа карт по тарифу". Событие срабатывает когда количество карт превышает пороговые  значения.

image-1685688078777.png

 

События

Отправка уведомлений в телеграм по сценарию

Метод POST organization/script/add

В массиве "condition_items" необходимо добавить объект с параметрами

"key": "telegram_exists"
"operator": "exists"

В массиве "action_items" объект с параметрами
"key": "telegram"
"value": ""
"template_id": ""

где
  template_id - идентификатор шаблона,
  value - подготовленный текст сообщения для отправки.

Параметр value имеет больший приоритет, чем template_id.

Пример:
{
  "id": "script_telegram",
  "name": "Сценарий script_telegram",
  "active": true,
  "start_date": 1599067313594,
  "end_date": 1698427313594,
  "event": "sale",
  "items": [
    {
      "id": "id_node0",
      "type": "main",
      "name": "Вход",
      "event": "sale",
      "next_item_id": "id_condition_1"
    },
    {
      "id": "id_condition_1",
      "type": "condition",
      "name": "Проверка наличия телеграмма",
      "condition_type": "and",
      "yes_item_id": "id_action1",
      "no_item_id": "id_exit",
      "condition_items": [
        {
          "key": "telegram_exists",
          "name": "Есть телеграмм",
          "operator": "exists"
        }
      ]
    },
    {
      "id": "id_action1",
      "type": "action",
      "name": "Отправка телеграмм",
      "next_item_id": null,
      "action_items": [
        {
         "name": "Отправка телеграмм",
         "key": "telegram",
         "value": "Спасибо за покупку!",
         "template_id": ""
        }
      ]
    },
    {
      "id": "id_exit",
      "type": "exit",
      "name": "Выход с отменой"
    }
  ]
}

События

Отправка уведомлений в VK по сценарию

Метод POST organization/script/add

В массиве "condition_items" необходимо добавить объект с параметрами

"key": "vk_exists"
"operator": "exists"

В массиве "action_items" объект с параметрами
"key": "vk"
"value": ""
"template_id": ""

где
  template_id - идентификатор шаблона,
  value - подготовленный текст сообщения для отправки.

Параметр value имеет больший приоритет, чем template_id.

Пример:
{
  "id": "script_vk",
  "name": "Сценарий script_vk",
  "active": true,
  "start_date": 1599067313594,
  "end_date": 1698427313594,
  "event": "sale",
  "items": [
    {
      "id": "id_node0",
      "type": "main",
      "name": "Вход",
      "event": "sale",
      "next_item_id": "id_condition_1"
    },
    {
      "id": "id_condition_1",
      "type": "condition",
      "name": "Проверка наличия VK",
      "condition_type": "and",
      "yes_item_id": "id_action1",
      "no_item_id": "id_exit",
      "condition_items": [
        {
          "key": "vk_exists",
          "name": "Есть VK",
          "operator": "exists"
        }
      ]
    },
    {
      "id": "id_action1",
      "type": "action",
      "name": "Отправка в VK",
      "next_item_id": null,
      "action_items": [
        {
         "name": "Отправка в VK",
         "key": "vk",
         "value": "Спасибо за покупку!",
         "template_id": ""
        }
      ]
    },
    {
      "id": "id_exit",
      "type": "exit",
      "name": "Выход с отменой"
    }
  ]
}

События

Уведомление о событиях в VK бот

Метод POST organization/job/add

параметр alert_to_vk - булево. Включает отсылку сообщений в VK пользователей
параметр template_vk_id - строка. Идентификатор шаблона для отправки сообщения в VK пользователей

Пример:
{
  ...
"alert_to_vk":true,
"template_vk_id":"template_1",
  ...
}

События

Настройка вариантов отправки оповещений

Описание настройки оповещений на форме

На форме события есть возможность настроить отправку оповещений по нему. Сделать это можно на вкладке "Оповещения" в табличке "Вариант отправки".

image-1702477582950.png

В колонке метод отправки для каждой строчки таблицы можно выбрать один из методов отправки:
- Email;
- Push;
- ВК;
- СМС;
- Телеграм.

Для каждого метода отправки выбирается свой шаблон оповещения. Для метода Email при использовании провайдеров  DashaMail или Unisender нужно выбирать внешний шаблон.
Так же для метода отправки можно поставить флаг "Обязательность", который означает обязательную отправку оповещения по данному методу отправки. 

Описание работы 

Рассмотрим алгоритм работы на следующем примере:

image-1702478059534.png

В момент срабатывания события клиенту будут отправляться оповещения в порядке, в котором они указаны в таблице.
- В первую очередь будет попытка отправки по вк.
- Если отправка по вк успешна, то дальше отработают все обязательные методы отправки (в данном случае СМС).
  Если же попытка отправки по вк не удалась, то дальше будет попытка отправки с использованием следующего метода (в данном случае телеграм).
- Если попытка по телеграм успешна, то дальше отработают все обязательные методы отправки (в данном случае СМС).
  Если же нет, то отработает следующий метод, в данном случае СМС.

 

Настройка сегментов

Настройка сегментов

Фильтрация сегмента по наличию Телеграма

Метод POST organization/card_segment/get_card


{
"filter_full":
[
{"telegram_available":
  {
  "value":true,
  "operator":"="
  }
}
],
"page": 1,
"per_page": 10,
"calculate_count":true
}

В ЛК добавлено свойство отбора "Доступен Телеграм". Выглядит так:

image-1687268667143.png

Настройка сегментов

Фильтрация сегмента по наличию VK

Метод POST organization/card_segment/get_card


{
"filter_full":
[
{"vk_available":
  {
  "value":true,
  "operator":"="
  }
}
],
"page": 1,
"per_page": 10,
"calculate_count":true
}

Веб-хуки

Веб-хуки

Настройка веб-хуков

image-1695804662491.png

  1. Адрес - адрес по которому будет отправлены web-hooks. 
  2. Событие - могут иметь типы:
    1. before_registration (До регистрации)- /organization/user/new перед добавлением пользователя, после проверок входных параметров.
    2. after_registration (После регистрации) - /organization/user/new после успешного добавления пользователя.
    3. before_order_add (Перед добавлением заказа) - /organization/order/add, /user/order/add (Добавить заказ). Перед добавлением заказа.
    4. before_order_update (Перед обновлением заказа) - /organization/order/{id}, /user/order/{id} (Обновить заказ). Перед обновлением заказа.
    5. before_order_setstatus (Перед установкой статуса заказа) - /organization/order/set_status (Установить статус заказа). Перед выполнением метода. /user/sber_get_status (Проверка статуса оплаты заказа через Сбербанк), если проведена полная авторизация суммы заказа
    6. before_delivery_service_calculate - /organization/delivery_service/{id}/calculate (Рассчитать стоимость доставки). Перед выполнением метода
    7. before_user_update (Перед обновлением пользователя) - /organization/user/{id} (Обновить информацию о пользователе). Перед выполнением метода
    8. before_user_new (Перед новым пользователем) - POST /user/new (Зарегистрировать пользователя). Перед выполнением метода
    9. on_subscription (При подписке) - при настроенном событие с типом "При истечении срока действия подписки".
  3. Порядок применения - порядковый номер выполнения web-hooks. Чем меньше номер, тем раньше выполнится web-hooks.
  4. Блок без ответа - если установлен флаг, то web-hooks не будет сохранять и ожидать ответ, в случае если он есть.
  5. Ожидание ответа - если установлен флаг, то web-hooks будет ожидать ответ.
  6. Ответ содержит данные - если установлен флаг, то web-hooks будет сохранять ответ.

VK-бот

VK-бот

Создание и настройка Vk-бота в сообществе

1. На странице в своем аккаунте в левом меню выбираем меню Сообщества и нажимаем на открывшейся странице Создать сообщество

1.jpg

2. Выбираем тип сообщества, желательно Бизнес сообщество.

2.jpg

3. Заполняем необходимые поля и нажимаем Создать сообщество

3.jpg

 

4.jpg

4. Выбираем в правом меню Управление

5.jpg

5. Заполняем данные и в поле Адрес запоминаем идентификатор группы.

6.jpg

6. Выбираем меню Работа с API. На закладке Long Poll API ставим переключатель в положение Включено, выбираем последнюю версию API и переключаемся на закладку Ключи доступа

7.jpg

7. Создаем ключ и даем права.

8.jpg

9.jpg

В меню Сообщения -> Настройки для бота включаем возможности ботов и кнопку Начать

21.jpg

 

22.jpg

8. Получаем ключ API, указав номер телефона.

10.jpg

9. Идентификатор сообщества и ключ api, полученные в пункте 5 и 8 соответственно, вводятся в настройках СУЛ. Необходимо перейти на вкладку "Каналы коммуникации".

image-1696313791138.png

Настройки VK будут расположены в самом низу.
image-1696313926492.png
10. Дополнительные настройки VK-бота находятся в разделе коммуникации. Необходимо перейти в "Чат-боты".

image-1696314030892.png
В группе полей "Настройки" находятся общие для всех ботов настройки (Telegram и VK).
image-1696314176254.png

Настройки VK-бота находятся в самом низу.

image-1696314263049.png
1) Флаг "Отображать команду "Вступить в сообщество" позволяет приглашать пользователя в группу.
2) "Список и порядок данных" определяет состав и последовательность данных для ввода пользователем при регистрации.
3) "Шаблон отображения карты VK-ботом" отвечает за текстовое описание карты пользователя.

11. Событие "При подписке на группу VK".
Чтобы настроить это событие необходимо перейти на вкладку клиенты и карты. Выбрать "События".

image-1696320017446.png
Добавить новое событие и в списке выбора выбрать "При подписке на группу ВК".

image-1696320076955.png
Для этого события можно настроить период действия и порядок применения.

VK-бот

Начало диалога с Vk-ботом

Для начала диалога с Vk-ботом на странице сообщества нужно нажать Сообщение и Перейти к диалогу с сообществом

1.jpg

 

2.jpg

Обработка объединения и стандартизации файлов

Обработка объединения и стандартизации файлов

Документация к обработке объединения и стандартизации файлов

- Настройки работы с дублями по картам выделены зеленым. В случае нахождения дубля по карте (по полю уникальности карты) можно настроить из какого файла будут браться накопления и баланс карты (так же можно настроить их суммирование). А так же откуда будет браться информация о клиенте и карте в случае нахождения дубля по карте.

- Настройки работы с дублями по клиентам выделены красным. Можно настроить откуда брать информацию по клиенту, в случае нахождения дубля по полю уникальности клиента.

При запуске обработки эта таблица будет заполнена всеми колонками сул. В ней необходимо задать соответствие колонки сул и колонки из выбранных файлов. Далее все колонки файлов будут стандартизированы и названы колонками сул, соответствующими им в таблице. Также можно удалить строки, которым не задано соответствие с помощью кнопки “Удалить пустые строки таблицы”.

 

2. Ньюансы при работе с обработкой

Настройки организации

Описание работы настроек организации

Настройки организации

Настройка приоритета отправки кодов

Описание настройки в СУЛ

Эта настройка находится на вкладке "Каналы коммуникации".

image-1698060969900.png

Она представлена в виде таблички, расположенной в самом низу этой вкладки.

image-1698061070571.png
В ней можно задать методы, которыми будет отправляться код подтверждения клиенту, а так же их приоритет. Приоритет влияет на отправку кода (подробнее рассмотрено ниже).

Пример работы этой настройки на расширении конфигурации "Управление торговлей" 11.5.14.69

 

В СУЛ настройка приоритетов имеет следующий вид:

image-1698062004249.png

Так же в СУЛ включена настройка "Использовать подтверждение клиента". 

При поиске карт пользователя ему отправляется код на электронную почту, так как она задана первой в приоритетах. Если же произойдет какая то ошибка при отправке кода подтверждения на почту, то сервер будет пробовать отправлять код на следующие за ней сервисы, в порядке приоритетности.

Если же код после успешной отправки сервером по каким - либо причинам не дошел клиенту, либо у клиента нету доступа к сервису, который был доступен для отправки, то при нажатии на кнопку повторной отправки на форме ввода кода будет предложен выбор его отправить. Методы и их порядок в этом меню будет соответствовать заданным в настройке приоритетов отправки кодов в СУЛ.

image-1698061757434.png

image-1698061821543.png

В случае же если таблица приоритетов пустая, то логика работы будет как в прошлых версиях ут. Вводится телефон/почта клиента и вручную выбирается куда отправить код.

Настройки организации

Настройка отображения штрихкода карты

Можно настроить несколько вариантов отображения штрихкода карты в личных кабинетах клиента (веб-кабинет, мобильное приложение, чат-боты).

Настройка "Отображение штрихкода карты" находится в настройках организации в разделе "Настройки карт".

image-1706279544960.png

В случае если выбран "Статичный штрихкод", то вид штрихового кода будет следующий:

image-1706279658402.png


В случае если выбран "Динамический qr-код", то вид штрихового кода будет следующий:

image-1706279666644.png

Для динамического qr-кода можно настроить время действия (в часах).

image-1706279644274.png



Каналы продаж

Каналы продаж

Описание каналов продаж

Список каналов продаж

Для работы с данным функционалом у пользователя должна быть роль "Добавление и изменение каналов продаж" (ул_ДобавлениеИзменениеКаналовПродаж) или "Просмотр каналов продаж" (ул_ПросмотрКаналовПродаж)
Каналы продаж находятся на вкладке "Товары и магазины"

image-1698146323249.png

Для добавление нового канала нужно нажать на "Добавить". Для изменения нужно открыть существующий.

image-1698146683004.png

Канал продаж в журнале продаж

Так же канал продаж выведен в списке продаж и на форме продажи.

image-1698146886440.png

image-1698146936442.png

Из формы продажи можно перейти в канал продажи (нажав на кнопку открытия канала продажи).

image-1698146992172.png

Канал продажи в условии скидки

Так же по каналам продаж можно настроить срабатывание скидки (в условиях скидки).

image-1698146752646.png

 

Инструкция по настройке модуля Битрикс24

Инструкция по настройке модуля Битрикс24

Инструкция по установке модуля для 1С-Битрикс

https://drive.google.com/file/d/15PZni-xeEEu_kxhGqxmWqCi8NIodNt_n/view?usp=drive_link

Скидочные и бонусные механики

Алгоритмы аналитики

Алгоритмы аналитики

Алгоритм расчета RFM-Анализа

Что такое RFM?

RFM аббревиатура (Recency Frequency Monetary — давность, частота, деньги) — сегментация клиентов в анализе сбыта по лояльности.

Определяет три группы:

 
Как считаем?

Данные для расчета RFM клиентов основываются на таблице продаж (bsSales). Продажи без карт не учитываются при расчете. Если у карты нет пользователя, то такие продажи также не учитываются в расчете.

Для каждого пользователя рассчитываются показатели Recency Frequency Monetary:

После рассчитанные значения записываются в таблицу CustomerProfile в соответствующие значения Recency, Frequency, Monetary. 

После этого карты распределяются в группы RFM согласно попаданию в значения групп RFM указанного в настройках организации. 

Также согласно указанной настройки "Наименование сегментов RFM" определяем имя для полученного значения RFM и записываем его в реквизит "RFMName"

После определения числового значения записываем полученное значение RFM карте (например 132).

Алгоритмы аналитики

Алгоритм ABC-сегментации клиентов

Данные для ABC-сегментации клиентов основываются на таблице продаж (bsSales). Продажи без карт не учитываются при расчете.

  1. Определяется таблица с суммой покупок с учетом скидок по каждой карте. В результате должна быть таблица с колонками: Карта, сумма покупок по карте (сумма по картам).
  2. Таблица сортируется по сумме продаж по убыванию (от большей суммы к меньшей).
  3. Определяется общая сумма покупок по этой таблице (сумма по компании).
  4. Определяется группа ABC-сегмента (настройки процентов распределения определяются в настройках организации): 
    1. Список карт с учетом сортировки, в сумме которые дают 80% от суммы по компании определяются в группу A
    2. Следующие клиенты клиенты дающие 15% от суммы по компании определяются в группу B
    3. Оставшиеся клиенты определяются в группу C

 

Алгоритмы аналитики

Настройки портрета клиента

Добавить настройку организации: 

  1. Количество групп по Recency (int). От 1 до 9
  2. Количество групп по Frequency (int). От 1 до 9
  3. Количество групп по Monetary (int). От 1 до 9
  4. Границы распределения по Recency. Массив соответствий
    1. Для каждой N-группы граница значений определяющая попадание в группу. Например: 
  5. Границы распределения по Frequency. Массив соответствий
    1. Для каждой N-группы граница значений определяющая попадание в группу. Например: Для группы "3" значения для попадания в эту группу от 25 до 45.
  6. Границы распределения по Monetary. Массив соответствий
    1. Для каждой N-группы граница значений определяющая попадание в группу. Например: Для группы "2" значения для попадания в эту группу от 21500 до 60000.
  7. Наименование сегментов RFM. Массив соответствий
    1. Необходимо для текстового представления полученных RFM показателей. Например: группы RFM 111, 112, 113 называются "VIP", группы 331, 332, 333 называются "Отток" и т.д.
  8. Распределение ABC-сегментации клиентов. Массив
    1. Три значения определяющие процент распределения для ABC-сегментации, в сумме дающие 100. Например "80,15,5". 

Пример распределения групп RFM:

    {
  "group": 1,
  "from": 0,
  "to": 15
},
{
  "group": 2,
  "from": 16,
  "to": 25
},
{
  "group": 3,
  "from": 26,
  "to": 35
}

    Пример распределения сегментов RFM

    {
  "groups": [111, 112, 113],
  "name": "VIP"
},
{
   "groups": [331, 332, 333],
  "name": "Отток"
}

    Клиенты

    Клиенты

    Портрет клиента

    Просмотр портрета клиента

    На форме элемента клиента есть гиперссылка "Портрет пользователя". При нажатии на нее откроется форма портрета клиента с данными о нем.

    image-1702535516976.png

     

     

    image-1702975348639.png


    Настройки анализа портрета клиента

    В настройках появилась новая страница "Дополнительные настройки клиента" -> "Настройки портрета клиента".

    image-1702971979473.pngimage-1702972055037.png

    На ней можно задать:
    - Распределение ABC сегментации клиентов. В этой настройке указываются проценты для групп A, B и C через зяпятую. Сумма процентов не должна превышать 100. На картинке ниже эта настройка выделена красным.
    - Границы групп распределения по Recency, Frequency и Monetary, которые в дальнейшем будут использованы при формировании портрета клиента. Границы указываются значениями границы "от". Настройки границ распределения на картинке ниже выделены зеленым.
    - Сегменты RFM. Для настройки сегментов добавлено две таблички, первая это сегменты, вторая это группы, входящие в этот сегмент. На основании количества групп, которые заданы в таблицах границ распределения формируются группы, которые можно добавлять в сегменты. При выделении строки в табличке сегментов в таблице групп будут показаны все группы, входящие в выделенный сегмент. На картинке ниже эти настройки выделены синим. По сегментам необходимо распределить все группы, которые выдаст программа. В противном случае настройки не будут сохранены. Количество доступных сегментов к созданию равняется количеству строк в таблице распределения RFM в квадрате. В данном случае: 32 = 9.

    image-1702971943683.png

    Обновление портрета клиентов

    Для обновления портрета клиентов было добавлено событие "Расчет и обновление портрета клиентов". Настройка события производится так же на форме настроек, для этого необходимо поставить галку "Обновлять портрет клиентов по расписанию" и настроить частоту выполнения события.

    image-1706082901431.png

    После сохранения настроек будет создано событие, которое можно посмотреть в разделе "События".

    image-1706083203306.png

    image-1706083219540.png

    Условия по портрету клиента в сценариях

    В сценарии были добавлены условия по значениям портрета клиента. Список таких условий представлен на фото ниже.

    image-1702537045078.png

    Условия по портрету клиента в сегментах клиентов

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

    image-1702537165837.png

     

     

    Клиенты

    Мастер настройки портрета клиента

    Начальная страница

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

    image-1709645812875.png

    Шаг 1

    На первом шаге необходимо выбрать количество групп распределения по RFM, которое будет создано.

    image-1709645896552.png

    Шаг 2

    На втором шаге необходимо заполнить границы распределения групп RFM. При нажатии на кнопку "Показать подсказку" внизу формы будет открыто пояснение по группам и границам, которые будут для них заданы. Подсказка будет изменятся вместе с изменением данных в таблице.

    image-1709646024516.png

    Шаг 3

    На третьем шаге будет предложено заполнить сегменты групп RFM. Таблица сегментов групп (слева) будет заполнена примерами, которые можно переименовывать/удалить и создать новые. При нажатии на "Показать подсказку" внизу формы будут показаны все нераспределенные группы.

    image-1709646137005.png

    Шаг 4

    На четвертом шаге будет предложено настроить событие по обновлению портрета клиентов по расписанию. Можно задать период обновления и частоту (час, день, месяц, год).

    image-1709646272582.png

    Шаг 5

    На пятом шаге необходимо настроить пороги ABC сегментации клиентов.

    image-1709646314875.png

    Завершение настройки

    Последним этапом в мастере настройки портрета клиентов является применение выбранных настроек. Для того чтобы они применились нужно нажать на кнопку "Завершить"

    image-1709646379119.png

     

     

    Клиенты

    Настройка ABC сегментации клиентов

    Раздел настроек

    Настройка находится в разделе "Настройки" - "Дополнительные настройки клиента"

    image-1709646936397.png

    Далее нужно перейти в "Настройки портрета клиента"

    image-1709646987776.png

    Описание настройки

    Название настройки "Распределение ABC-сегментации клиентов". В значение через запятую указывается процентное соотношение распределения клиентов по сегментам A,B и C соответственно. В сумме три числа должны давать 100 процентов.

    image-1709647149643.png

    Заморозки баллов

    Заморозки баллов

    Просмотр журнала заморозок

    Для просмотра журнала заморозок нужна роль "Просмотр журнала транзакций".

    Чтобы открыть журнал необходимо: Перейти на вкладку "Правила программы", далее "Журнал заморозок"

    image-1706264042888.png

    image-1706264061795.png

    На форме можно задавать отборы по карте, по датам совершения заморозки и по датам окончания заморозки.

    Для просмотра конкретной заморозки необходимо выбрать ее в таблице:

    image-1706264412357.png

    Заморозки баллов

    Удаление заморозки баллов

    Для удаления заморозки баллов нужна роль "Просмотр журнала транзакций".

    Для удаления определенной заморозки баллов нужно открыть заморозку из формы журнала заморозок:

    image-1706264293421.png
    Для удаления заморозки нужно нажать "Удалить заморозку". После нажатия появится окно подтверждения операции:

    image-1706264325515.png
    После подтверждения заморозка будет удалена, форма закроется и будет выведено оповещение о статусе операции:

    image-1706264369138.png