Контакты

Редактировал(а) Татьяна Брыкова 2026/01/28 12:11

Контакты в системе

Одной из основных функциональных составляющих системы ML является ведение единой базы участников программы лояльности с возможностью учёта всей истории покупок без смены идентификатора (карты программы лояльности). Основными возможностями системы в части управления базой участников (Контактов) являются заведение и редактирование анкетных данных участников ПЛ, хранение этих данных, удобный и быстрый доступ к ним, использование анкетных данных для фильтрации применения алгоритмов поощрений.

1712922946965-609.png

Рис. Справочник контактов

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

1712923029403-370.png

Рис. Поле с количеством записей в справочнике контактов

Поиск записей в справочнике контактов осуществляется через поле поиска.

1712923063511-703.png

Рис. Поле поиска записей в справочнике контактов

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

1712923103795-428.png

Рис. Фильтр в справочнике контактов

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

1712923124550-619.png

Рис. Настройка фильтра в справочнике контактов

Так же есть возможность сформировать экспорт текущего представления справочника (с учётом фильтров) во внешний файл Excel. Данный механизм экспорта применим не только для контактов, но и для любых представлений в системе.

1712923185836-484.png

Рис. Экспорт справочника контактов во внешний файл

1712923235839-466.png

Рис. Процесс экспорта справочника контактов

1712923269643-471.png

Рис. Сохранение файла экспорта справочника контактов

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

1769589879407-130.png

Рис. Кнопка "Фильтровать" в чеках контакта

Чеки можно отфильтровать по всем полям сущности.

1716198239395-342.png

Рис. Фильтры для чеков

Как и в общем представлении, после фильтрации в связанном представлении появляется кнопка "Сбросить фильтры" справа от кнопки "Фильтровать".

1769589967528-504.pngРис. Сброс фильтров

Система предоставляет возможность вести множество характеристик участника, такие как персональные данные (ФИО, дата рождения, телефон, E-mail и т.п.) и характеристики участия в программе (дата регистрации, балансы, уровень участия в программе и т.п.).

Для повышения чистоты персональных данных контактов в системе имеются Партнерские/Системные настройки, осуществляющие проверки на разрешённые для использования символы и лимит на количество символов в поле ФИО:

Loyalty.Contact.FullnameSymbolsActive 

Loyalty.Contact.FullnameSymbols 

Loyalty.Contact.FullnameLenght 

Изначально проверяется наличие партнерской настройки, и если партнерской настройки нет, то проверяется системная.

1769590022774-768.png1712923573606-932.png

Рис. Карточка контакта

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

Персональные данные могут быть введены или изменены как оператором программы, так и непосредственно участником программы в его Личном кабинете. Характеристики участия в программе могут быть как статические (вводятся оператором или загружаются из внешних источников – например, посредством внешней системы распознавания бумажных анкет), так и динамические (балансы, уровень участия) – в этом случае они изменяются (пересчитываются) автоматически по правилам, настроенным в системе.

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

Для хранения анкетных данных участников в системе используется запись Контакт, доступ к которой возможен через соответствующую карточку. Форма карточки Контакта имеет несколько групп полей. Значения большинства полей интуитивно понятны. Следует обратить внимание, что значения некоторых полей используются как параметры фильтрации в алгоритмах правил системы. Из личных данных клиента в системе хранятся: дата регистрация клиента как участника программы лояльности, день рождения, пол, семейное положение, наличие детей. Количество детей, их возраст, дата свадьбы и другие параметры непосредственно не являются полями карточки контакта, но их хранение и дальнейшее использование можно организовать с помощью расширенных атрибутов контакта. Расширенные атрибуты контакта могут быть использованы при организации фильтрации.

Рекомендованные правила работы с согласиями на SMS, Email и мобильный Push описаны здесь.  

1712923701922-251.png

Рис. Раздел расширенных атрибутов в карточке контакта

Полями, которые могут использоваться в фильтрации, являются поля групп: Покупки, Баланс баллов, Баланс статусных баллов. Данные поля агрегируют информацию из аналогичных полей карт лояльности, которые закреплены за данным контактным лицом. Эта группа полей содержит текущую информацию о финансовой истории и истории предоставленных поощрений данного клиента. Например, поле «Количество покупок» – это количество всех покупок клиента за весь период, когда контакт является участником программы лояльности.

1712923833326-605.png

Рис. Раздел Покупки, Баланс бонусов, Баланс статусных бонусов, Баланс денежных средств в карточке контакта

Для каждого контакта в системе хранится коммуникационная история взаимодействия, а именно отправленные  Manzana Loyalty Online транзакционные SMS и E-mail сообщения. 

1712923892664-755.png

Рис. Раздел Сообщения в карточке контакта

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

Карточка Контакт позволяет хранить следующую информацию об участнике:

ПолеОписаниеОбязательное полеРедактирование
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Контактная информация
ФамилияФамилия участника ПЛНетПоле доступно для редактирования, заполняется вручную
ИмяИмя участника ПЛНетПоле доступно для редактирования, заполняется вручную
ОтчествоОтчество участника ПЛНетПоле доступно для редактирования, заполняется вручную
Мобильный телефонНомер мобильного телефона участника программы лояльности. Для мобильного телефона предусмотрена специальная маска, задаваемая системной настройкой. Мобильный номер должен быть введён в полном соответствии с этой маской, в противном случае сохранить запись контакта будет невозможно.НетПоле доступно для редактирования, заполняется вручную
Электронная почтаАдрес электронной почты. Отправка E-mail сообщений происходит на данную электронную почту контакта.НетПоле доступно для редактирования, заполняется вручную
Электронная почта 2Адрес дополнительной электронной почты. В текущей версии чисто информационное: отправка E-mail сообщений на данную электронную почту не происходит.НетПоле доступно для редактирования, заполняется вручную
Валидность анкетыПризнак валидности анкеты (проверка действительности данных, которые были указаны в анкете).Нет Поле доступно для редактирования, заполняется вручную
Ссылка на изображениеПоле для URL-ссылки на изображение, связанное с контактом. Может быть изображение на анкету участнику или другая информация. Заполняется вручную или через интеграцию из внешней системы.Нет Поле доступно для редактирования, заполняется вручную
Дополнительный телефонНомер дополнительного телефона. Чисто информационное поле: отправка SMS сообщений на данный телефон не происходит.Нет Поле доступно для редактирования, заполняется вручную
Способы связи
Предпочтительный способ связи

Основной способ связи. Возможные значения:

  • Любой
  • Телефон
  • Почта
  • SMS
  • WhatsApp
  • В офисе
  • Telegram 

Значение по умолчанию: Любой.

НетПоле доступно для редактирования, заполняется вручную
Мобильный телефон проверен

Признак того, что номер мобильного телефона участника ПЛ прошёл верификацию. Возможные значения:

  • Нет
  • Да

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию Нет

НетПоле доступно для редактирования, заполняется вручную
Коммуникации по SMS

Признак того, что участник ПЛ согласен получать SMS сообщения. Возможные значения:

  • Да
  • Нет

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию Да

НетПоле доступно для редактирования, заполняется вручную
Временная зонаВременная зона контакта (количество часов отличных от UTC). Параметр необходим для возможности отправки SMS с учетом временной зоны.НетПоле доступно для редактирования, заполняется вручную
E-mail проверен

Признак того, что адрес электронной почты участника ПЛ прошёл верификацию. Возможные значения:

  • Нет
  • Да

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию Нет

НетПоле доступно для редактирования, заполняется вручную
Коммуникации по E-mail

Признак того, что участник ПЛ согласен получать сообщения по Электронной почте. Возможные значения:

  • Да
  • Нет

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию Да

НетПоле доступно для редактирования, заполняется вручную
Коммуникации по телефону

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

  • Да
  • Нет

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

НетПоле доступно для редактирования, заполняется вручную
Разрешить уведомления

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

  • Да
  • Нет

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

НетПоле доступно для редактирования, заполняется вручную
Транслитерация

Признак того, что нужно транслитерировать сообщения. Возможные значения:

  • Да
  • Нет

При создании новой записи контакта, значение данного поля по умолчанию Да.

НетПоле доступно для редактирования, заполняется вручную
Согласие на электронный чек

Признак того, что участник ПЛ согласен получать электронные чеки. Возможные значения:

  • Нет
  • Да

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию «Нет». Изменить значение на «Да» возможно только тогда, когда заполнена электронная почта. При удалении электронной почты значение автоматически меняется на «Нет».

НетПоле доступно для редактирования, заполняется вручную
Личные сведения
Пол

Пол участника ПЛ. Возможные значения:

  • Пусто
  • Мужской
  • Женский

Значение по умолчанию: Пусто.

НетПоле доступно для редактирования, заполняется вручную
День рожденияДата рождения участника ПЛ.НетПоле доступно для редактирования, заполняется вручную
Семейное положение

Семейное положение контакта. Возможные значения:

  • Пусто
  • Не женат / Не замужем
  • Женат / Замужем
  • Разведён / Разведена
  • Вдовец / Вдова

Значение по умолчанию: Пусто

НетПоле доступно для редактирования, заполняется вручную
Имеет детей

Признак наличия детей. Возможные значения:

  • Неизвестно
  • Да
  • Нет

Значение по умолчанию: Пусто.

НетПоле доступно для редактирования, заполняется вручную
РегионСсылка на запись региона с типом Регион.НетПоле доступно для редактирования, заполняется вручную
ГородСсылка на запись города.НетПоле доступно для редактирования, заполняется вручную
УлицаНазвание улицы.НетПоле доступно для редактирования, заполняется вручную
ДомНомер дома.НетПоле доступно для редактирования, заполняется вручную
ЭтажНомер этажа в доме.НетПоле доступно для редактирования, заполняется вручную
КвартираНомер квартиры в доме.НетПоле доступно для редактирования, заполняется вручную
Информация по участию в ПЛ
Дата регистрацииДата регистрации анкеты участника ПЛ.НетПоле доступно для редактирования, заполняется вручную
Источник анкеты

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

  • Бумажный носитель
  • Приложение на планшете
  • Сайт
  • Данные, внесенные оператором
  • Касса
  • Cobrand Rosbank
  • Приложение «Кошелек»
  • Сервис городских платежей
  • Личный кабинет
  • Приложение на IOS
  • Приложение на Android
  • Терминал
  • Специальное приложение
  • Инфо-киоск
  • IVR
  • Call Tracking
  • ERP
  • Выставка
  • Референт
  • Банк
  • Бизнес партнёр
  • SMS

При создании новой записи контакта в интерфейсе, значение данного поля по умолчанию Ввод вручную оператором.

НетПоле доступно для редактирования, заполняется вручную
Редактируемый уровень

Признак редактируемости уровня. Возможные значения:

  • Да
  • Нет

При создании новой записи контакта, значение данного поля по умолчанию Нет.

НетПоле доступно для редактирования, заполняется вручную
УровеньУровень клиента (или статус участия клиента в программе).НетПоле не доступно для редактирования, заполняется автоматически – если Редактируемый уровень = Нет.
ПартнёрСсылка на партнёра, которому относится данный участник программы лояльности.ДаПоле доступно для редактирования, заполняется вручную
Магазин регистрации

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

При включенной настройке Loyalty.Processing.FillOrgunitWhenEmpty магазин регистрации заполняется магазином первой покупки, если магазин регистрации не заполнен на момент покупки.

НетПоле доступно для редактирования, заполняется вручную
Любимый магазинСсылка на магазин, который контакт указал как любимый в ЛК/МП.НетПоле доступно для редактирования, заполняется вручную
Тип контакта

 Тип клиента для компании. Возможные значения:

  • Участник ПЛ
  • Подписчик
  • Сотрудник
  • Не участник ПЛ
  • Технический

В текущей версии тип контакта может изменяться автоматически в зависимости от наличия активной карты. Раз в день ночью происходит проверка: если у контакта есть активная карта, то проставляется тип Участник ПЛ; если нет активной карты – Не участник ПЛ. При установке пароля магазина создаётся контакт-менеджер с типом "Технический".

НетПоле доступно для редактирования, заполняется вручную
Статус контакта

Статус клиента. Возможные значения:

  • Активный
  • В чёрном листе
  • Заблокирован
  • Отложен

Значение по умолчанию: Активный. Cтатус  "Заблокирован" не ограничивает списание или начисление бонусов. Этот параметр можно использовать в качестве условия фильтраций для правил начисления и правил списания.

НетПоле доступно для редактирования, заполняется вручную
Согласен на обработку персональных данных

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

  • Да
  • Нет

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

НетПоле доступно для редактирования, заполняется вручную
Карта по умолчаниюСсылка на карту контакта, которую он указал по умолчанию в ЛК/МП.НетПоле доступно для редактирования, заполняется вручную
Внешний идентификаторКод интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
ЛогинЛогин для входа в ЛК (заполняется в случае регистрации пользователя в ЛК через определенный метод).НетПоле доступно для редактирования, заполняется вручную
Роль в личном кабинетеСсылка на роль в личном кабинете (для участника ПЛ пусто или значение Customer, для менеджера ПЛ значение Manager). Присвоение контакту роли менеджера или администратора разрешено только разработчику при получении согласования.НетПоле доступно для редактирования, заполняется вручную
Есть в мобильном приложении

Параметр наличия мобильного приложения у контакта. Значение поля передается в методах  OData для создания/редактирования контакта  - POST Contact/Create и POST Contact/Update.

Возможные значения:

  • Да 
  • Нет

Значение данного поля по умолчанию Пусто.

НетПоле доступно для редактирования, заполняется вручную
Полнота анкеты

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

Возможные значения:

  • Да -  не все проверяемые поля заполнены
  • Нет - все проверяемые поля заполнены

На  основе параметра контакта создается РА  (если включена настройке Loyalty.Contact.EAKey.ContactCheckActivated.TurnOn), ключ которого задается в настройке Loyalty.Contact.EAKey.ContactCheckActivated

Функциональность для расчета параметра включается настройкой Actions.ContactCheckActivated.TurnOn. Перечень проверяемых полей задается настройкой Actions.ContactCheckActivated.Parameters 

НетПоле доступно для редактирования, заполняется вручную
Сведения Wallet
Наличие карты в WalletПризнак наличия у участника ПЛ карты в приложении «Кошелёк» (Wallet).НетПоле доступно для редактирования, заполняется вручную
Дата привязки карты в WalletДата привязки карты участником ПЛ в Wallet.НетПоле доступно для редактирования, заполняется вручную
Дата отвязки карты в WalletДата отвязки карты участником ПЛ в Wallet.НетПоле доступно для редактирования, заполняется вручную
Покупки
Сумма без скидокОбщая сумма покупок по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Сумма скидокОбщая сумма предоставленных скидок по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Сумма со скидкойОбщая сумма покупок с учётом скидок по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Текущая скидка (%)Текущий активный уровень скидки клиента. Агрегирует максимальное значение из уровня скидки карт лояльности, которые связаны с записью контакта. Не может превзойти 100%.НетПоле не доступно для редактирования, заполняется автоматически
Количество покупокОбщее количество покупок по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Средний чекЗначение среднего чека за всю историю участия в программе лояльности. Общая сумма покупок, делённая на количество покупок. Чеки возврата в количество покупок не входят.НетПоле не доступно для редактирования, заполняется автоматически
Средний чек со скидкамиЗначение среднего чека с учётом скидок за всю историю участия в программе лояльности. Общая сумма покупок со скидкой, делённая на количество покупок. Чеки возврата в количество покупок не входят.НетПоле не доступно для редактирования, заполняется автоматически
Дата последней операцииДата чека покупки с максимальной датой. Чеки возврата не учитываются для определения даты последней транзакции.НетПоле не доступно для редактирования, заполняется автоматически
Баланс бонусов
Дебет (баллы)Общее количество начисленных бонусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (баллы)Общее количество списанных бонусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (баллы)Итоговый баланс бонусных баллов по всем картам участника ПЛ с учётом всех записей бонусных баллов, которые ещё не начали своего действия.НетПоле не доступно для редактирования, заполняется автоматически
Активный баланс (баллы)Общий активный баланс бонусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Холдировано (баллы)Количество холдированных бонусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Баланс статусных бонусов
Дебет (статусные баллы)Общее количество начисленных статусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (статусные баллы)Общее количество списанных статусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (статусные баллы)Итоговый баланс статусных баллов по всем картам участника ПЛ с учётом всех записей статусных баллов, которые ещё не начали своего действия.НетПоле не доступно для редактирования, заполняется автоматически
Активный баланс (статусные баллы)Общий активный баланс статусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Холдировано (статусные баллы)Количество холдированных статусных баллов по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Баланс денежных средств
Дебет (деньги)Общее количество начисленных денежных средств по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Кредит (деньги)Общее количество списанных денежных средств по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Баланс (деньги)Общий баланс денежных средств по всем картам участника ПЛ.НетПоле не доступно для редактирования, заполняется автоматически
Зависимости
Карты

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

Примечание: показаны все активные карты, но при этом с любыми статусами карты для процессинга (Новая, Активная, Заблокирована, Закрыта, Завершена)

ПокупкиПредставление, в котором показаны связанные с данной записью участника программы лояльности покупки (Чеки, Заказы, Счетчики контакта, События счетчиков).
БонусыПредставление, в котором показаны связанные с данной записью участника программы лояльности бонусы (Баллы начисления, Баллы списания, Бонусные счета, Запросы начисления/списания баллов).
КупоныПредставление, в котором показаны связанные с данной записью участника программы лояльности купоны (Купоны, Лимиты по купонам, Запросы гашения купонов).
ПравилаПредставление, в котором показаны связанные с данной записью участника программы лояльности правила (Персональные предложения, Интеграционные персональные предложения, Рекомендованные товары).
ДеньгиПредставление, в котором показаны связанные с данной записью участника программы лояльности денежные транзакции (Начисления на денежный счёт, Списания с денежного счёта, Денежные транзакции).
СообщенияПредставление, в котором показаны связанные с данной записью участника программы лояльности транзакционные сообщения.
Расширенные атрибутыПредставление, в котором показаны все связанные с участником программы лояльности расширенные атрибуты.
Маркетинговые спискиПредставление, в котором показаны связанные с данной записью участника программы лояльности маркетинговые списки.
ОбращенияПредставление, в котором показаны активные обращения за последние 12 месяцев от данного участника программы лояльности.
Заявки на загрузку чековПредставление, в котором показаны связанные с данной записью участника программы лояльности заявки на загрузку чеков.
МагазиныПредставление, в котором показаны связанные с данной записью участника программы лояльности магазины.
Включено в задания по расписаниюПредставление, в котором показаны ЗПР, в которые включена данная запись участника
Списки покупокПредставление, в котором показаны связанные с данной записью участника программы списки покупок
Участия в ПЛПредставление, в котором показаны связанные с данной записью участника программы лояльности записи его участия в программах лояльности.
РодственникиПредставление, в котором показаны связанные с данной записью участника программы лояльности родственники.
Оценки магазиновПредставление, в котором показаны связанные с данной записью участника программы лояльности оценки магазинов.
ХарактеристикиПредставление, в котором показаны связанные с данной записью участника программы лояльности характеристики.
Технические расширенные атрибутыПредставление, в котором показаны все связанные с участником программы лояльности технические расширенные атрибуты.
Ссылки на файлыПредставление, в котором показаны все связанные с участником программы лояльности ссылки на файлы.
Промо-новостиПредставление, в котором показаны все связанные с участником программы лояльности промо-новости. Описание полей находится в  отдельной документации Manzana Loyalty Online API для интеграции с МП или ЛК на сайте
История уровнейПредставление, в котором показаны все связанные с участником программы лояльности история уровней контакта
Реферальные кодыПредставление, в котором показаны все связанные с участником программы лояльности реферальные коды
РефералыПредставление, в котором показаны все связанные с участником программы лояльности рефералы

В режиме отображения «Обзор» в карточке клиента отображается связанная информация по картам клиента, чекам, заказам, баллам и купонам. В этих данных выводятся по две последних связанных записи.

1769590194684-646.pngРис. Связанная информация по картам, чекам, заказам, купонам, баллам в карточке контакта

Для перехода в отображение всей детальной информации по этим записям нужно нажать на «Показать больше…» в соответствующем разделе.

1769590311781-256.pngРис. Переход на детализацию по картам, чекам, заказам, купонам, баллам в карточке контакта

1769590458992-296.png1712924605508-176.png

Рис. Карточка контакта (Детализация)

Обзорное видео раздела Контакты смотрите тут

С помощью метода POST Contact/Depersonalize можно удалить персональные данные контакта без дальнейшего восстановления. При наличии партнерской  настройки  Loyalty.ContactUpdate.Impersonalization.TurnOn, установленной в значение 1 или Y у контакта  затераются (переведены в NULL) ФИО, номера телефонов (мобильный, дополнительный), адреса электронной почты (основной и дополнительный). Контакт  деактивируется.

Если партнерская настройка Loyalty.ContactUpdate.Impersonalization.GenderDelete = 1 или Y, дополнительно переводится в null значение поля Пол. 

Если партнерская настройка Loyalty.ContactUpdate.Impersonalization.BirthdateDelete = 1 или Y, дополнительно переводится в null значение поля Дата рождения.

Если партнерская настройка Loyalty.ContactUpdate.Impersonalization.EA.Delete = 1 или Y, дополнительно производится поиск всех связанных с контактом расширенных атрибутов, и все записи удаляются.

Если партнерская настройка Loyalty.ContactUpdate.Impersonalization.Flag.EA.Create = 1 или Y, после удаления всех существующих РА,  создается новая запись РА с ключом из настройки Loyalty.ContactUpdate.Impersonalization.EA.Key

Если партнерская настройка Loyalty.ContactUpdate.Impersonalization.Close.Card = 1 или Y, то во всех связанных с контактом картах статус принудительно проставляется в «Закрыта».

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

Признак для отзыва персональных данных можно передать в Mindbox с помощью настроек Loyalty.mindbox.ContactEdit.Impersonalization.TurnOn  и Loyalty.mindbox.ContactEdit.Impersonalization.EA.Key

Активация и деактивация контакта

Для управления статусом активности контакта, в карточке контакта отображаются кнопки «Активировать» и «Деактивировать» в зависимости от статуса контакта. В деактивированные контакты попадают те, кто отказался от участия в ПЛ.

Если контакт активный, то в интерфейсе доступна кнопка «Деактивировать».

1769590668021-421.png

Рис. Кнопка «Деактивировать» на форме контакта

При нажатии на кнопку «Деактивировать» выводится модальное окно с текстом "Деактивировать контакт? При деактивации не будут заблокированы карты и купоны." и кнопками «Да», «Нет».

1717679335697-708.png

Рис. Модальное окно с подтверждением деактивации контакта

При нажатии на кнопку «Нет» модальное окно закрывается, статус контакта не меняется. При нажатии на кнопку «Да» все поля на форме контакта закрываются на редактирование. На форме контакта вместо кнопки «Деактивировать» отображается кнопка «Активировать».

1769590985028-382.pngРис. Кнопка «Активировать» на форме контакта.

При нажатии на кнопку «Активировать» все поля контакта открываются на редактирование (за исключением закрытых скриптами). На форме контакта вместо кнопки «Активировать» отображается кнопка «Деактивировать».

Деактивированные контакты скрываются из общего списка контактов в разделе Контакты и переносятся в подраздел «Деактивированные контакты».

1718005921455-218.pngРис. Сущность Деактивированные контакты с записью контакта

Кодовое слово Контакта

Кодовое слово контакта – это слово, которое может служить паролем для участника ПЛ при звонке в колл-центр.

Настройка кодового слова контакта происходит с помощью соответствующей кнопки на интерфейсе карточки контакта.

1712924753063-653.png

Рис. Настройка кодового слова контакта

Предварительно в карточке партнера заводятся настройки:

1712924790168-454.png

 Рис. Настройки верификации в карточке партнера

Для установки нового кодового слова оператор системы выбирает пункт «Изменить»

1712924824720-797.png

Рис. Установка или изменение кодового слова контакта

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

1712924850891-936.png

Рис. Отправка верификации на мобильный телефон контакта

Контакт сообщает полученный на мобильный телефон код верификации, который оператор вносит в поле проверки.

1712924871388-317.png

Рис. Введение кода верификации

При подтверждении кода верификации открывается поле для ввода/изменения кодового слова.

1712924892393-715.png

Рис. Ввод нового кодового слова

Для идентификации контакта (когда, например, контакт обращается по телефону) оператор выбирает пункт «Проверить».

1712924910989-555.png

Рис. Изменение кодового слова контакта

В открывшемся диалоге вносит кодовое слово, которое сообщил контакт в поле проверки.

1712924931403-776.png

Рис. Проверка кодового слова контакта

При корректном указании кодового слова система подтверждает идентификацию клиента.

1712924955196-476.png

Рис. Сообщение о корректности кодового слова

При некорректном указании выводится сообщение об ошибке.

1712924983530-295.png

Рис. Сообщение об ошибке кодового слова контакта

Кнопка "Кодовое слово" доступна на карточке контакта при наличии у пользователя привилегии в ролевой модели - "Изменение кодового слова контакта".

Верификация контакта по SMS

Верификация контакта при обращении в Контактный центр доступна через интерфейс в карточке контакта по кнопке “Отправить SMS код”. Верификация по SMS позволяет предотвратить мошеннические действия с данными клиентов.

При нажатии на кнопку “Отправить SMS код”, контакту отправляется смс с кодом, а в UI открывается окно для ввода кода, который должен сообщить контакт.

1769593192862-138.png

В открывшемся окне необходимо повторно нажать на кнопку "Отправить SMS код" и получить подтверждение, что код отправлен.

1769597491616-754.png

1769593928406-427.png

После ввести код, названный клиентом.

Если код введен неверно, система выдаст ошибку:

1769594802741-108.png

Далее необходимо нажать "Ок" и повторно отправить код.

Ввести корректный код и нажать "Проверить"

1769595146687-796.png

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

 1769595179647-776.png

Верификация клиента на этом завершена. Оператор может производить запрашиваемые операции.

Видимость кнопки “Отправить SMS код” регулируется в ролевой модели. Привилегия подключается администратором Manzana.

Изменение уровня контакта

Можно менять уровень контакта через интерфейс UI по кнопке «Изменить уровень контакта». Обновленное значение логируется вместе с логином изменившего.

1769591330227-181.pngРис. Кнопка "Изменить уровень контакта" в сущности Контакт

После нажатия на кнопку «Изменить уровень контакта»,  появляется  всплывающее окно, предлагающее выбрать новый уровень контакта.

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

1725625867954-476.png

После выбора значения поля «Новый уровень» кнопка «Подтвердить изменение уровня» становится доступна.

1725626080732-682.png

После нажатия на кнопку «Подтвердить изменение уровня» прежний уровень меняет свое значение на новый.

1769591433831-742.png

В истории уровней контакта также можно увидеть предыдущие и новое значение уровня.

1769591521577-487.png

Рис. История изменения уровней

Расширенные атрибуты контакта

Расширенные атрибуты контакта – это неограниченное количество дополнительных записей, которые связываются с записью самого контакта. Расширенные атрибуты могут быть трёх типов: текстовыми (строковыми), числовыми (десятичные числа) и типа дата-время. Все расширенные атрибуты, которые связаны с контактом, можно посмотреть в карточке контакта в разделе «Расширенные атрибуты».

При этом откроется связанное представление, которое представляет собой список всех расширенных атрибутов данного контакта:

1712925051190-239.png

Рис. Раздел расширенных атрибутов в карточке контакта

Если далее открыть какой-то расширенный атрибут, то его карточка выглядит следующим образом:

1712925108622-497.png

Рис. Карточка расширенного атрибута контакта

Карточка расширенного атрибута контакта содержит следующие поля:

ПолеОписаниеОбязательное полеРедактирование
Активно

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

Возможные значения

  • Активно
  • Неактивно

Значение по умолчанию Активно.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
КлючНазвание атрибута. Заполняется как текстовое значение, но должно совпадать с одним из названий определений расширенных атрибутов.ДаПоле доступно для редактирования, заполняется вручную
Тип атрибута

Тип атрибута. Возможные значения:

  • Число
  • Строка
  • Дата время

Значение по умолчанию: Строка.

ДаПоле доступно для редактирования, заполняется вручную
КонтактКонтакт, к которому относится расширенный атрибут.ДаПоле доступно для редактирования, заполняется вручную
Внешний идентификаторКод интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
ЗначениеЗначение расширенного атрибута.НетПоле доступно для редактирования, заполняется вручную
Задание по расписаниюСсылка на задание по расписаниюНетПоле доступно для редактирования, заполняется вручную
ОписаниеПодробное описание расширенного атрибута.НетПоле доступно для редактирования, заполняется вручную

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

Фильтрация контактов при обработке алгоритмов

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

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

Статический способ – это создание определённого списка контактов (маркетингового списка) и отнесение этого списка к записям, которые являются настройками алгоритмов процессинга. Алгоритмы будут работать только для тех контактов, которые входят в статические списки.

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

Динамическая и статическая фильтрация могут отрабатываться одновременно.

Динамическая фильтрация контактов

Почти все параметры контакта можно использовать при фильтрации алгоритмов процессинга. Для этого служат специальные записи – наборы контактов (подробнее см. в пункте Фильтрация по контактам).

1712925964646-187.png

Рис. Справочник фильтров по контактам

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

1712926038389-569.png

Рис. Карточка фильтра по контактам

Статическая фильтрация контактов

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

1712926105645-288.png

Рис. Справочник маркетинговых списков

Маркетинговый список содержит следующую информацию:

ПолеОписаниеОбязательное полеРедактирование
Активно

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

Возможные значения

  • Активно
  • Неактивно

Значение по умолчанию Активно.

ДаПоле доступно для редактирования, заполняется вручную
ОтветственныйПользователь, ответственный за создание и ведение данной записи.ДаПоле доступно для редактирования. Заполняется из справочника пользователей.
ПодразделениеПодразделение, к которому относится данная запись.ДаПоле доступно для редактирования. Заполняется из справочника подразделений.
Общие сведения
НаименованиеНаименование маркетингового списка.ДаПоле доступно для редактирования, заполняется вручную
Внешний идентификаторКод интеграции с внешними системами.НетПоле доступно для редактирования, заполняется вручную
ПартнерСсылка на партнёра, которому принадлежит данный список.НетПоле доступно для редактирования, заполняется вручную
ОписаниеОписание маркетингового списка. Заполняется в свободной форме.НетПоле доступно для редактирования, заполняется вручную
Количество участниковЧисло, равное количеству контактов в маркетинговом списке. Заполняется автоматически
Параметры интеграции
Тип маркетингового списка

Признак обновления маркетингового списка из Campaign по мере появления в нем новых контактов.

Возможные значения:

0 – Не используется
1 – Пополняемый
2 – Перезаписываемый

Значения по умолчанию - Пусто

НетПоле доступно для редактирования, заполняется вручную
Включать в ответ метода

Возможные значения:

  • Да
  • Нет

Если параметр в значении "Да", тогда маркетинговый список  возвращается в ответе метода GET MarketingList/GetAllByContact.

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

НетПоле доступно для редактирования, заполняется вручную
Зависимости
КонтактыПредставление, в котором показаны контакты, которые входят в данный список
Фильтры по контактамПредставление, в котором показаны фильтры по контактам, в которые входят в данный маркетинговый список и/или из которых исключён данный маркетинговый список
ПравилаПредставление, в котором показаны правила начисления, в которые входят в данный маркетинговый список и/или из которых исключён данный маркетинговый список
КампанииПредставление, в котором показаны кампании, в которые входят в данный маркетинговый список и/или из которых исключён данный маркетинговый список
Задания по расписаниюПредставление, в котором показаны задания по расписанию, в которые входят в данный маркетинговый список и/или из которых исключён данный маркетинговый список
Настройки персональных акцийПредставление, в котором показаны настройки персональных акций, в которые входят в данный маркетинговый список и/или из которых исключён данный маркетинговый список

Внешний вид карточки Маркетинговый список:

1712926196578-281.png

Рис. Карточка маркетингового списка

Добавление контактов в маркетинговый список

Добавить контакты в маркетинговый список можно вручную в карточке маркетингового списка, в правом верхнем углу нажать «Добавление нового элемента»:

1712926337551-152.png

Рис. Добавление нового элемента в маркетинговый список

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

1734943206131-275.png

Рис. Выбор контактов и добавление связи контакта и маркетингового списка

Если контакт уже состоит в маркетинговом списке, то его не будет в списке контактов, доступных к добавлению.

В этом же окне можно создать новую связь контакта и маркетингового списка.

Для добавления выбранных контактов в маркетинговый список необходимо нажать «Создать связь маркетингового списка и контакта».

1734949835037-239.png

Рис. Создание связи маркетингового списка и контакта

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

1712926537144-438.png

Рис. Создание связи маркетингового списка и контакта

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

1734950641986-577.png

Рис. Удаление одного контакта из маркетингового списка

Для удаления нескольких связей их необходимо выделить и нажать кнопку «Удалить связь».

1734950832841-137.png

Рис. Удаление нескольких контактов из маркетингового списка

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

1734951097194-414.png Рис. Маркетинговые списки контакта 

1734951189151-306.png

Рис. Добавление контакта в Маркетинговый список с помощью поиска

Если контакт уже добавлен в какой-то маркетинговый список, то этот список не будет доступен для добавления.

1769591722243-901.png

Рис. Удаление контакта из маркетингового списка (из карточки Контакта)

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

Формирование динамических маркетинговых списков реализовано путем интеграции списков из модуля Manzana Campaign в Manzana Loyalty. Подробнее можно ознакомиться в документации Campaign и в статье (в работе).

Маркетинговые списки, в которых состоит контакт, можно передавать по API (см. описание метода GET MarketingList/GetAllByContact), например, для персонализированного взаимодействия с пользователями через мобильное приложение (например, через in-app сообщения) на основе их поведенческих и транзакционных данных.

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

1769531601410-897.png

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

Идентификация участника программы лояльности

Клиент как участник программы лояльности идентифицируется по карте участника. При предъявлении карты участника на POS-терминале, если данная карта валидна, становятся доступны все операции: предоставление скидки, начисление баллов, оплата покупок.

Если клиенту не выдана карта – он не может быть участником программы лояльности. Карт лояльности у клиента может быть несколько. В этом случае для оплаты покупок клиенту доступны все баллы на всех картах лояльности, если он предъявит одну из своих карт для совершения операции, если статус участия данной карты позволяет оплату покупок баллами.

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

Если идентификация участника происходит с использованием мобильного номера, то при запросе баланса на мобильный телефон участника отправляется SMS сообщение с кодом подтверждения, код генерируется случайным образом (количество символов в коде и шаблон сообщения задаётся в карточке партнёра). Если сообщённый клиентом оператору POS-терминала код верен, то возможны дальнейшая операция покупки.

Следует иметь в виду, что при идентификации по мобильному номеру операция всё равно происходит по карте лояльности. Если у клиента несколько карт, то операция будет совершена по карте с максимальным количеством чеков (если у карт количество чеков одинаковое, то по карте, дата изменения записи которой самая максимальная). При этом не учитывается статус участия карты.

При идентификации на кассе участника ПЛ по номеру телефона, списание баллов с подтверждением по коду или без регулируется  партнерскими настройками:

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

Создание и обновление контакта по запросу

В системе есть возможность создать запись контакта или отредактировать некоторые поля его записи по запросу POS-сервиса. Для этого в запросе указываются теги, в которых передается ключ либо поля карточки контакта, либо ключ расширенного атрибута, и передаётся значение, которое будет вставлено в соответствующее поле карточки контакта, либо значение расширенного атрибута контакта, на которое будет заменено предыдущее или с которым будет создан расширенный атрибут контакта. Описание и пример запроса приведены в технической документации системы (API для интеграции с точкой продажи).

При создании контакта методом POS-сервиса не предусмотрено заполнение полей перечислимого типа значениями по умолчанию, поэтому все значения подобного рода параметров должны передаваться в запросе. При обновлении контакта методом POS-сервиса, если по обновляемому контакту не заполнены партнёр и магазин, они будут заполненными значениями, которые связаны с терминалом, с которого выполнен запрос изменения контакта. При создании/изменении контакта методом POS-сервиса, если текстовые параметры будут содержать специальные символы «$, <, >, &, %», то регистрация запроса будет проходить с ошибкой.

Особенности импорта контактов в базу данных

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

Импорт осуществляется в разделе системы Контакты с помощью кнопки «Импорт». Если указанная запись карты активна по статусу, не связана с каким-либо контактом, действующая по датам действия, то указанная запись карты успешно связывается с импортируемой записью контакта и её можно сразу использовать для алгоритмов процессинга. Стоит иметь в виду, что статус участия карты при этом не изменяется.

Подробнее об этапах и результатах импорта смотрите в разделе Руководства «Импорты».

1712926852947-933.png

Рис. Кнопка «Импорт» в разделе «Контакты»

Форматы мобильного телефона контактов

Система предоставляет возможность задания допустимых форматов для номеров мобильных телефонов контактов. За это отвечает партнерская/системная настройка Loyalty.Contact.MobileNumberPattern (партнерская настройка указывается через расширенный атрибут партнера). В значении данной настройки необходимо указывать возможные форматы через точку с запятой. Например, чтобы сделать возможным для определенного партнера регистрацию контактов с мобильными телефонами, принадлежащими только РФ и Белоруссии, то тогда в партнерской настройке необходимо следующее значение: [+][7][9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9];[+][3][7][5][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]

Значение настройки по умолчанию: [+][7][9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]

Обозначения:

[+] – означает один конкретный символ «+».

[7] – означает один конкретный символ «7».

[0-9] – означает один любой цифровой символ (от «0» до «9»).

Уникальность мобильного номера и адреса электронной почты – в рамках партнёра контакта, уникальность внешнего идентификатора контакта – в рамках всей базы данных.