Коммуникационные сообщения

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

Важно! Подключение каналов коммуникации в Manzana Loyalty осуществляется сотрудниками Manzana Group и определяется условиями договора. Без настройки сервисов отправка невозможна.

Для коммуникаций с участниками используются следующие каналы связи:

• Сообщения в личный кабинет участника- это сообщения, которые отображаются в личном кабинете участника программы лояльности. Сообщения, у которых окончился срок хранения, не будут отображены участнику.
• Сообщения SMS на мобильный номер, зарегистрированный в системе в карточке контакта;
• Сообщения E-mail на почтовый адрес, зарегистрированный в системе в карточке контакта;
• Сообщения на кассовый чек - это текстовые сообщения, которые непосредственно формируются для события чека. Возможна непосредственная печать сообщений на чеке, если это позволяет программное обеспечение POS-терминала.
• Сообщение на монитор POS-терминала (сообщение кассиру) - это текстовые сообщения, которые непосредственно выводятся на POS-терминал при регистрации чека.
• Сообщения PUSH.

Сообщения в личный кабинет, сообщения SMS, E-mail и PUSH создаются и отправляются только в момент успешной регистрации фискального чека. Сообщения кассиру и сообщения на кассовый чек могут формироваться как при обработке фискального чека, так и при обработке мягкого чека, если включены системные настройки: Loyalty.Processing.SoftCheque.POSMessages.Visible, Loyalty.Processing.ChequeRequest.CashDeskMesssages.TurnOn. При этом сообщения кассиру и сообщения на кассовый чек не сохраняются в базе.

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

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

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

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

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

• SMS сообщения
• E-mail сообщения
  • Смена и подтверждение E-mail с использованием кода подтверждения в E-mail – сообщении
  • Верификация E-mail у контактов, зарегистрированных на кассе
• PUSH сообщения
• Обработка правила, в котором есть шаблон сообщения
• Использование метапеременных
• Агрегирование сообщений
  • Агрегирование SMS сообщений
  • Агрегирование PUSH сообщений
    • Вложение файлов сертификатов в Аккаунт коммуникаций
• Транслитерация SMS и HTML-формат для E-mail сообщений
• Генерация персональных предложений
• Ограничение по количеству персональных предложений
• Особенности отправки дисконтных персональных предложений
• Формирование шаблонных персональных предложений
• Сообщения по шаблону​​​​​​
• Мультиаккаунтность для SMS и PUSH рассылок

SMS сообщения

Система позволяет рассылать SMS сообщения. Маркетинговые сообщения отправляются, если у контакта разрешена доставка SMS и введён номер мобильного телефона в соответствии с маской в системной настройке MobilePhoneMask. Технические SMS сообщения (новый пароль от личного кабинета, код верификации, если клиент забыл карту лояльности) игнорируют запрет доставки. SMS сообщение доставляется по событию регистрации фискального чека или при отработке соответствующего задания по расписанию. Оно считается погашенным сразу после отправки. По событию регистрации мягкого чека SMS сообщения никогда не создаются и не доставляются. Для SMS сообщений система позволяет учесть часовой пояс клиента, чтобы клиент случайно не получил сообщение в неприемлемое для себя время, например, ночью.

Для отправки SMS сообщений должен быть создан отправитель (список телефонов) и аккаунт мобильной коммуникации (в аккаунте на вкладке «Настройки SMS» должно быть установлено поле «Активно» в значении «Да» и заполнены корректно настройки, полученные от SMS провайдера).

E-mail сообщения

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

Смена и подтверждение E-mail с использованием кода подтверждения в E-mail – сообщении

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

Для достижения единообразия пользовательского опыта и повышения лояльности к ПЛ

в системе есть возможность настроить при смене и подтверждении E-mail использование кода подтверждения вместо ссылки в E-mail – сообщении.

Для отправки проверочного кода в интерфейсе системы настройки задаются в разделе «Настройки» => «Настройки рассылок ЛК партнера» в секции «Подтверждение телефона или E-mail (при смене и др.)».

Реализация процесса смены и подтверждения E-mail через код в E-mail – сообщении осуществляется с помощью методов API интеграции с МП и ЛК на сайте.

 Рис. Поля для настройки подтверждения и смены E-mail в ЛК партнера

Параметры настройки кода при подтверждении и смене E-mail по коду

Системные настройки для использования кода подтверждения при смене и подтверждении E-mail:

PrivateOffice.ConfirmAndUpdateEmail.Code 

PrivateOffice.ConfirmAndUpdateEmail.MessageTemplateWithCode 

PrivateOffice.ConfirmAndUpdateEmail.CodeLifetime 

PrivateOffice.ConfirmAndUpdateEmail.CodeLength 

PrivateOffice.ConfirmAndUpdateEmail.CodeFormat 

PrivateOffice.ConfirmAndUpdateEmail.LimitOfValidCodes 

Верификация E-mail у контактов, зарегистрированных на кассе

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

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

Рис. Шаблон сообщения для верификации E-mail

При создании контакта в системе (параметр Command = ADD в запросе ContactUpdateRequest) Е-mail сообщение с токеном формируется только один раз в случае успешной обработки запроса. Повторно Е-mail сообщение с токеном может быть сформировано только при обновлении контакта в системе (параметр Command = UPDATE в запросе ContactUpdateRequest), если Е-mail не подтвержден.

Перейдя по ссылке из письма, новый участник ПЛ перенаправляется на страницу, с которой формируется запрос Odata POST Contact/UpdateRequestVerifyEmailAddress забирающий токен из ссылки и подтверждающий E-mail.

Если срок действия токена по настройке PrivateOffice.ConfirmationEmail.ExpireCode не истек, то на странице подтверждения выдается сообщение «Адрес электронной почты подтвержден». В карточке контакта E-mail становится верифицированным. В случае, если срок истек, то сообщение будет: «Срок действия ссылки истек. Адрес электронной почты не подтвержден».

Информация о шаблоне сообщения берется из партнерской настройки Loyalty.Processing.ContactUpdate.VerificationEmailTemplate. Сообщение формируется только при включенной настройки Loyalty.Processing.ContactUpdate.VerificationEmail.TurnOn.

PUSH сообщения

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

PUSH сообщение доставляется по событию регистрации фискального чека или при отработке соответствующего задания по расписанию. По событию регистрации мягкого чека PUSH сообщения никогда не создаются и не доставляются.

Для отправки PUSH сообщений должен быть создан аккаунт мобильной коммуникации (в аккаунте на вкладке «Настройки PUSH» должно быть установлено поле «Активно» в значении «Да» и заполнены корректно настройки для рассылки PUSH).

Обработка правила, в котором есть шаблон сообщения

Обработка правила с сообщениями производится стандартными алгоритмами фильтрации. Если параметры чека и его состав подходят под условия фильтров, то по данному чеку будут сформированы сообщения. Сообщения на чек, на POS-терминал отображаются непосредственно в ответах чека. Сообщения в личный кабинет создаются в базе и отображаются участникам программы лояльности в личном кабинете посредством соответствующего метода API для интеграции с МП или ЛК. Сообщения E-mail, SMS, PUSH передаются специальным службам, которые производят соответствующие рассылки.

Форма правила для ввода сообщения выглядит следующим образом:

Рис. Секция отправки сообщений в карточке правила начисления

Для каналов связи Сообщение на чек, Сообщение на кассу (POS-терминал) и Сообщение в ЛК структура формы одинакова и состоит из двух полей. Первое поле бинарное – оно имеет два значения и указывает: будет ли правило формировать сообщение по указанному каналу. Далее непосредственно поле для тела сообщения, которое не имеет собственного названия.

Для каналов связи Push, E-mail, SMS/Viber есть дополнительные поля для настройки сообщений.

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

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

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

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

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

Использование метапеременных

В теле сообщения, отправляемого через правило или простой шаблон сообщения, возможно использование только тех метапеременных, которые есть в описании этих шаблонов. При формировании сообщения вместо метапеременной подставляется её актуальное значение для конкретного контакта или карты. Например, если нужно, чтобы кассир обращался к покупателю по имени отчеству, то можно в тело сообщения кассиру в правиле добавить такой текст: «Это важный клиент: %first_name% %middle_name%!». В этом случае, по карте в чеке будет определяться контакт, а вместо метапеременных будут подставляться соответствующие параметры карточки контакта. И на терминал кассиру, например, по событию мягкого чека будет выводиться: «Это важный клиент: Филипп Филиппович!» или «Это важный клиент: Маргарита Николаевна!», в зависимости от того, кто пользуется картой, предъявленной на POS-терминал для операции.

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

1. %greetings% - Приветствие участника в зависимости от пола (Уважаемый, Уважаемая, Уважаемый участник)

2. %full_name% - Полное имя клиента

3. %first_name% - Имя клиента

4. %middle_name% - Отчество клиента

5. %second_name% - Фамилия клиента

6. %date% - Текущая дата, в которую происходит событие обработки задания

7. %card_num% - Номер карты клиента

8. %discount% - Уровень скидки по карте

9. %bonuses_amount% – Количество баллов, которое будет начислено по карте клиента в рамках задания

10. %contact_balance% – Активный баланс клиента (по всем картам)

11. %contact_status_active_balance% – Активный баланс клиента по статусным баллам (по всем картам)

12. %active_balance% - Активный баланс бонусных баллов клиента по текущей карте

13. %full_balance% - Баланс бонусных баллов клиента по текущей карте

14. %active_status_balance% - Активный баланс статусных баллов клиента по текущей карте

15. %full_status_balance% - Баланс статусных баллов клиента по текущей карте

16. %bonuses_writeoff% - Количество баллов, которое списано с карт контакта в рамках задания

17. %normal_bonuses_writeoff% - Количество бонусных баллов, которое списано с карт контакта в рамках задания

18. %normal_bonuses_amount% – Количество бонусных баллов, которое начислено в рамках задания

19. %status_bonuses_writeoff% - Количество статусных баллов, которое списано с карт контакта в рамках задания

20. %status_bonuses_amount% - Количество статусных баллов, которое начислено в рамках задания

21. %coupon_num% - Номер купона

22. %coupon_writeoff% - Сумма списанных при выпуске купона баллов

23. %coupon_type% - Тип выпущенного купона

24. %coupon_desc% - Описание выпущенного купона

25. %password% - Пароль участника. В текущей версии не поддерживается.

26. %unsubscribe% - Ссылка на страницу личного кабинета для отказа получения рассылки. В текущей версии не поддерживается.

27. %login% - Логин клиента в программе Лояльности

28. %partner% - Партнер, указанный в задании.

29. %pass_link% - Ссылка для Pass-book для карты участника. В текущей версии не поддерживается.

30. %personal_offer_current% - Текущие персональные предложения

31. %personal_offer_future% - Будущие персональные предложения

32. %personal_offers_E-mail% - Текущие персональные предложения, которые агрегированы как html (смотри пользовательскую документацию). В текущей версии не поддерживается.

33. %charged_money% - сумма начисленных денежных средств по текущей операции (если со знаком минус – считаем, что было списание)

34. %card_money_balance% - баланс денежных средств по карте операции. Выводится значение после совершения операции.

35. %master-account_money_balance% - баланс денежных средств по мастер-счёту, в который входит карта текущей операции. Выводится значение после совершения операции.

36. %Current_contact_level% - Текущий уровень контакта

37. %Current_card_level% - Текущий уровень карты

38. %Previous_contact_level% - Предыдущий уровень контакта

39. %Previous_card_level% - Предыдущий уровень карты

40. %*ContactEA*[Key]% - Метапеременная для значения расширенного атрибута контакта. Key - ключ необходимого атрибута

41. %*CardEA*[Key]% - Метапеременная для значения расширенного атрибута карты. Key - ключ необходимого атрибута

42. %*Template_PCC*TemplateID% - Метапеременная для содержания форматированного шаблона сообщения текущих персональных акций

43. %*Template_PCF*TemplateID% - Метапеременная для содержания форматированного шаблона сообщения будущих персональных акций

44. %chips_amount% - Количество наклеек

45. %*couponnum*RuleExternalID% - Номер выпускаемого по правилу моментального купона (вместо RuleExternalID подставляется внешний идентификатор правила, по которому выпускается моментальный купон). Для корректного считывания переменной, помимо коммуникации, которая отправится по правилу-сообщению, в правиле выпуска моментального купона в секции «Отправка сообщения» необходимо активировать поле «Отправить E-mail» и добавить метапеременную в «Текст E-mail». Перед сохранением правила обязательно деактивировать поле «Отправить E-mail», чтобы коммуникация не отправилась повторно.

Рис. Шаблон сообщения с метапеременной в правиле выпуска моментального купона

46. %code_registration% - код для регистрации участника по SMS (только на фискальный чек).

47. %CounterContact*xx*[RuleExternalId]% - метапеременная для значения счётчика по контакту с учётом текущего чека.

48. %CounterCard*xx*[RuleExternalId]% - метапеременная для значения счётчика по карте с учётом текущего чека. 

49.%DifferenceThresholdCounterContact*xx*[RuleExternalId]*[LowerThreshold]*[UpperThreshold]% - Метапеременная для разности порога и значения счётчика по контакту с учётом текущего чека.

50. %DifferenceThresholdCounterCard*xx*[RuleExternalId]*[LowerThreshold]*[UpperThreshold]% - Метапеременная для разности порога и значения счётчика по карте с учётом текущего чека. 

Для метапеременных, перечисленных в п. 47-50,  карта и контакт (Contact/Card) определяются по параметру запроса чека. Правило RuleExternalId - по внешнему идентификатору правила-счетчика, который подставляется без квадратных скобок, UpperThreshold - это значение верхнего порога значения счетчика, LowerThreshold - значение нижнего порога.

Вместо *xx* подставляется период (например, сутки) и тип периода (например, текущие), а именно:

dc - сутки текущие
dp - сутки предыдущие
ds - сутки скользящие
wc - неделя текущая (календарная)
wp - неделя прошлая (календарная)
ws - неделя скользящая
mc - месяц текущий (календарный)
mp - месяц прошлый (календарный)
ms - месяц скользящий
tc - квартал текущий (календарный)
tp - квартал прошлый (календарный)
ts - квартал скользящий
sc - полугодие текущее (календарный)
sp - полугодие прошлый (календарный)
ss - полугодие скользящий
yc - год текущий (календарный)
yp - год прошлый (календарный)
ys - год скользящий

Текущий и прошлый календарные типы периодов определяются датой регистрации запроса.

Скользящий период  - период до времени регистрации запроса. Если чек регистрируется 01.10.2025, а в метапеременной указаны:

• сутки текущие (dc), то посчитаются покупки  за 01.10.25, 
• сутки предыдущие (dp) -  за 30.09.25,
• неделя текущая (wc)  - за 29.09 - 05.10.25,
• неделя прошлая (wp) -  за 22 - 28.09.25,
• неделя скользящая (ws) -  за 24-30.09.25

       Остальные периоды определяются аналогично.

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

Из правила-счетчика количества товаров для метапеременной берется значение из поля "Внешний идентификатор":

В правиле-сообщении записывается текст сообщения на чек вида: "Вы стали участником розыгрыша путешествия и других призов. Количество шансов на победу: %CounterContact*mc*demoOK% шт за покупку товаров".

%CounterContact*mc*demoOK% - вместо метапеременной система подставит значения счетчика покупок контакта в текущем месяце. Если клиент совершил покупку 12.12.2025, то посчитаются товары по чекам с 1 по 12.12 включительно.

51. %CharacterCombination*[RuleExternalId]% - метапеременная для буквосочетания из шаблона правила-сообщения

52. %FactorAccumulations*[RuleExternalId]% - текущие накопления для поощрения с использованием накопительного правила

53. %NecessaryFactorAccumulations*[RuleExternalId]% - сколько минимально нужно купить, чтобы применилось поощрение с использованием накопительного правила

54. %ContactEvent*XX*YY*N% - параметрическая метапеременная для даты. Подробнее описание см. здесь.

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

55. %normal_bonuses_amount_by_rulenormal_bonuses_amount*RuleExternalID% - сумма баллов по данному чеку/заказу по конкретному правилу.

56. %status_bonuses_amount_by_rulestatus_bonuses_amount*RuleExternalID% - сумма статусных баллов по данному чеку/заказу по конкретному правилу

57. %normal_bonuses_amount_by_offer_categorycategory_amount*CounterExternalID% - сумма баллов по данному чеку/заказу по категории офферов.

58. %status_bonuses_by_offer_categorystatus_category_amount*CounterExternalID% - сумма статусных балов по чеку/заказу по категории офферов.

59. %bonuses_amount_by_listbonuses _amount*RuleListId% - сумма баллов по чеку/заказу по выбранному списку правил. Могут быть как бонусные так и статусные баллы.

Агрегирование сообщений

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

Агрегирование SMS сообщений

Отправитель (список телефонов) для агрегированного SMS-сообщения используется из карточки партнера чека из поля «Список телефонов».

Рис. Представление «Списки телефонов» в карточке Партнёра

В случае, если поле «Список телефонов» в партнере имеет пустое значение, отправитель (список телефонов) берется из системной настройки Loyalty.Processing.AggregatedMessage.Phonelist.ExternalID.

Текст первого элемента агрегированного SMS-сообщения используется из карточки партнера чека из поля «SMS заголовок» (в секции «Настройка сообщений»). Если не заполнено поле «SMS заголовок» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Sms.Header.

Текст последнего элемента агрегированного SMS-сообщения используется из карточки партнера чека из поля «SMS подвал». Если не заполнено поле «SMS подвал» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Sms.Footer.

Приоритет агрегированного SMS-сообщения используется из карточки партнера чека из поля «Приоритет сообщения». Если не заполнено поле «Приоритет сообщения» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Priority.

Рис. Настройка SMS-сообщений в карточке партнёра: SMS заголовок, SMS подвал, приоритет сообщений

Аккаунт для агрегированного SMS-сообщения используется из карточки партнера чека из поля «Аккаунт коммуникации».

Рис. Представление «Аккаунты коммуникаций» в карточке Партнёра

Если поле «Аккаунт коммуникации» имеет пустое значение, SMS-аккаунт берется из значения системной настройки Loyalty.Processing.AggregatedMessage.SmsAccount.

В настоящей версии не предусмотрена рассылка транзакционных SMS-сообщений провайдерами расширенных рассылок. SMS-сообщения в текущей версии передаются провайдерам по протоколу SMPP.

Агрегирование PUSH сообщений

Аккаунт для агрегированного PUSH сообщения используется из карточки партнера чека из поля «Аккаунт коммуникации». Если поле «Аккаунт коммуникации» имеет пустое значение, аккаунт берется из значения системной настройки Loyalty.Processing.AggregatedMessage.SmsAccount.

Рис. Поле «Аккаунт коммуникаций» в карточке партнера

Тема (а также версия сертификата, ссылка на раздел в МП) для агрегированного PUSH сообщения берется из примененного правила с максимальным приоритетом.

Рис. Настройки отправки PUSH-сообщений в карточке правила начисления

Если несколько правил с одним максимальным приоритетом, то тема берется из поля «Тема PUSH» из одного правила, у которого дата изменения старше остальных. Агрегирование E-mail сообщений

Отправитель (E-mail провайдеры) для агрегированного E-mail сообщения берется из карточки партнера чека из поля «E-mail провайдеры».

Рис. Представление «E-mail провайдеры» в карточке Партнёра

В случае, если поле «Списки телефонов» имеет пустое значение, отправитель (список телефонов) берется из системной настройки Loyalty.Processing.AggregatedMessage.Phonelist.ExternalID.

Формат агрегированного E-mail сообщения используется из карточки партнера чека из поля «E-mail формат». Если не заполнено поле «E-mail формат» в партнере, то используется значение из системной настройки Loyalty.processing.AggregatedMessage.EmailFormat.

Текст первого элемента агрегированного E-mail сообщения используется из карточки партнера чека из поля «E-mail заголовок». Если не заполнено поле «E-mail заголовок» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Email.Header.

Текст последнего элемента агрегированного E-mail сообщения используется из карточки партнера чека из поля «E-mail подвал». Если не заполнено поле «E-mail подвал» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Email.Footer.

Рис. Настройка Email сообщений в карточке партнёра: E-mail формат, E-mail заголовок, E-mail подвал

Приоритет агрегированного E-mail сообщения используется из карточки партнера чека из поля «Приоритет сообщения». Если не заполнено поле «Приоритет сообщения» в партнере, то используется значение из системной настройки Loyalty.Processing.AggregatedMessage.Priority.

Тема для агрегированного E-mail-сообщения берется из примененного правила с максимальным приоритетом. Если несколько правил с одним максимальным приоритетом, то тема берется из поля «Тема E-mail» из одного правила, у которого дата изменения старше остальных.

Если E-mail сообщения передаются для доставки каким-нибудь провайдером расширенной рассылки, то в этом случае необходимо указать провайдера этой рассылки в карточке партнёра в секции «Массовая рассылка».

Рис. Настройка массовой рассылки Email сообщений в карточке партнёра

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

Вложение файлов сертификатов в Аккаунт коммуникаций

В карточке «Аккаунта коммуникаций» в секции "Настройки PUSH iOS" можно прикрепить файл с сертификатом для iOS с расширением *.p12'.

Если отображается ошибка под "прикрепленные файлы", то необходимо предоставить привилегии на сущность Annotation в Ролях безопасности пользователя.

Рис. Ошибка при отсутствии настройки привилегии на сущность Annotation в Ролях безопасности

В «Аккаунте коммуникаций» в зависимости от типа сертификата – для продуктивной среды или для тестовой песочницы можно прикрепить соответствующий файл.

Рис. Секция «Настройки PUSH IOS» в карточке «Аккаунт коммуникаций»

Рис. Поле для загрузки файла сертификата для продуктивной среды

Чтобы добавить файл другого типа необходимо заменить значение поля «Тип сертификата». Также возможно прикрепить 2 файла одновременно - файл сертификата для тестовой песочницы (sandbox) и для продуктивной среды (prod).

Рис. Прикрепленные файлы сертификатов для тестовой и продуктивной среды

Транслитерация SMS и HTML-формат для E-mail сообщений

Для SMS сообщений предусматривается транслитерация. В этом случае каждое сообщение передаётся провайдеру рассылки с определённым флагом, и в зависимости от наличия флага провайдер осуществляет транслитерацию сообщения. Это может быть оправданным для большого количества сообщений, поскольку SMS с латинскими символами позволяет в одном сообщении передавать до 160 символов; с кириллическими символами – до 70 символов.

Настройка транслитерации для агрегированного SMS-сообщения используется из карточки партнера чека из поля «Транслитерация» (на вкладке «Настройка агрегированных сообщений»).

В случае, если отправляемое E-mail сообщение необходимо воспринимать как размеченный текст (HTML), то необходимо корректно указать значение поля «E-mail формат» в партнере.

Рис. Поля Транслитерация (для SMS) и E-mail формат (для формата HTML) в карточке партнёра

Генерация персональных предложений

Персональное предложение – это сообщение по существующей персональной акции. Для правила есть два вида персональных предложений: персональные предложения с текстом сообщений персональных акций и шаблонные персональные предложения (сообщение по шаблону с параметрами персональных акций). В данном пункте рассматриваются персональные предложения с текстом сообщений персональных акций. Шаблонные персональные предложения рассматриваются в пункте Формирование шаблонных персональных предложений.

В каждой персональной акции есть текстовое поле для сообщений для разных каналов связи (Сообщение на чек, Сообщение на кассу (POS-терминал), Сообщение в ЛК, PUSH-сообщение, E-mail сообщение и Сообщение по SMS/Viber). Текст в данных полях не может содержать метапеременных, поскольку он сам по себе подставляется в тело сообщений вместо определённых метапеременных.

Рис. Секция настройки отправки сообщений в карточке Персональной акции

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

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

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

Текущие персональные предложения подставляются вместо метапеременных: %personal_offer_worked% и %personal_offer_current%.

Метапеременная %personal_offer_worked% может применяться только в сообщениях по правилам начисления. Вместо неё подставляются персональные предложения, значения которых применились для данного конкретного чека (а именно текст сообщения персональных акций).

Метапеременная %personal_offer_current% может применяться как в сообщениях по правилу начисления, так и в сообщениях задания по расписанию. Вместо этой метапеременной подставляются все текущие персональные предложения (а именно текст сообщения персональных акций). Если событие создания сообщения регламентируется правилом начисления, а в составе чека нет товара, для которого есть текущее значение персональной акции с персональным предложением, но поощрение по правилу применилось – все текущие персональные предложения будут подставлены в метапеременную %personal_offer_current% доставлены по указанному каналу связи. На это следует обращать внимание, поскольку если нет факта применения правила, то никакие сообщения по нему не доставляются. Поэтому для гарантированной доставки персональных предложений транзакционными сообщениями лучше использовать правило начисления «Правило-сообщение».

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

Не поддерживается отправка сообщений с персональными предложениями через механизм расширенных E-mail рассылок.

Если метапеременная %personal_offer_current% есть в шаблоне сообщения задания по расписанию, то следует иметь в виду, что задание с типом «Контакт» будет отыскивать персональные предложения для контакта, задание с типом «Карта» будет отыскивать персональные предложения для карт. В этом случае необходимо аккуратно относиться к формированию персональных предложений в случае, если у контакта подразумевается несколько карт. В этом случае возможно увеличение количества сообщений, если одновременно предусматриваются персональные предложения и для контактов, и для карт по отдельности. Важно! Если у контакта подразумевается несколько карт лояльности, то значения персональных акций лучше формировать либо для контактов, либо для карт, смешанного случая лучше не использовать.

Метапеременную %personal_offer_future% можно использовать в задании по расписанию и в правилах с типом «Сообщение». Вместо данной метапеременной в сообщение подставляются все будущие персональные предложения. Будущие персональные предложения – это сообщения из значений интеграционных персональных акций, сроки действия которых находятся в пределах календарной недели, следующей за событием создания сообщения. Следует обращать внимание, что будущими могут быть только интеграционные персональные предложения, ручные персональные предложения всегда считаются текущими.

Вместо каждой из метапеременных: %personal_offer_worked%, %personal_offer_current%, %personal_offer_future% подставляются построчно все сообщения значений персональной акции. Например, если по какой-то карте есть три текущих персональных акции. Сообщение первой есть «Текст 1», сообщение второй есть «Текст2», сообщение третьей есть «Текст3», а в сообщении на чек есть метапеременная %personal_offer_current%, то на чеке будет напечатано следующее сообщение:

Текст1

Текст2

Текст3

Порядок сообщений зависит от приоритета значения персональной акции. Чем выше приоритет, тем ближе к началу агрегированного сообщения расположено сообщение персонального предложения. Например, если в приведённом выше примере, приоритет 3-ей персональной акции будет 100, второй – 1, первой – 50, то итоговое сообщение будет таким:

Текст3

Текст1

Текст2

Ограничение по количеству персональных предложений

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

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

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

Особенности отправки дисконтных персональных предложений

Формирование сообщений, шаблон которых относится к правилу начисления, определяется событием фискального чека. Это общий алгоритм, он также относится и к персональным предложениям. Некоторые сообщения могут быть переданы на POS-терминал и по событию мягкого чека.

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

Формирование шаблонных персональных предложений

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

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

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

%*Template_PCC*TemplateID% - Метапеременная для содержания форматированного шаблона сообщения текущих персональных акций.

%*Template_PCF*TemplateID% - Метапеременная для содержания форматированного шаблона сообщения будущих персональных акций.

Вместо TemplateID необходимо подставить внешний идентификатор шаблона сообщения с типом операции «Персональная акция».

В метапеременные подставляются персональные акции, относящиеся только к этому, конкретному правилу.

Персональные акции в метапеременные могут подставляться в двух вариантах: 1. В порядке убывания приоритета, при равенстве приоритета - в порядке убывания даты и времени создания персональной акции; 2. В порядке возрастания приоритета, при равенстве приоритетов – в порядке возрастания даты создания персональной акции. Это регулируется системной настройкой Loyalty.Communication.OrderPCVmessage.

Все персональные акции добавляются в метапеременные последовательно. После первого и всех последующих элементов шаблонного сообщения (под элементом понимается одна персональная акция) добавляется символ, который формируется из значения системных настроек для соответствующего канала связи: Loyalty.PCС.CashDeskMessage.Separator, Loyalty.PCС.ChequeMessage.Separator, Loyalty.PCС.EmailMessage.Separator, Loyalty.PCС.PersonalMessage.Separator, Loyalty.PCС.PrivateOfficeMessage.Separator, Loyalty.PCС.SMSMessage.Separator.

В метапеременные подставляются только действующие активные персональные акции, которые относятся к активному и действующему правилу (в свою очередь, относящиеся к активной и действующей кампании).

В шаблоне сообщения с типом операции «Персональная акция» можно использовать следующие метапеременные:

1. %Campaign_Message% – Сообщение персональной акции (персональное предложение). Метапеременная забирает текст из поля "Сообщение" (message), которое передается в представлении персонального предложения
2. %Campaign_Name% – Наименование правила персональной акции, которое связано с персональным предложением
3. %Campaign_Priority% – Приоритет расчёта персональной акции
4. %Campaign_Value% – Значение персональной акции
5. %Effective_From% – Дата начала действия персональной акции
6. %Effective_To% – Дата, по которую действует персональная акция
7. %Goods_Name% – Наименование товара или общности товаров (списки товаров, группы товаров и т.д), которые связаны с персональным предложением
8. %Goods_Picture% – Ссылка на изображение URL (IconUrl) из справочника товара/товаров, который связан с персональным предложением
9. %Maximum_Quantity_Goods% – Максимальное кол-во товара для поощрения по акции
10. %Minimum_Quantity_Goods% – Минимальное кол-во товара для акции
11. %Minimum_Sum_Goods% – Минимальная сумма покупки товара для акции
12. %MxN_Quantity_Goods% – Количество товара (для акции MxN). Кол-во товара задается в поле "Кол-во товара" (quantity_goods) на форме карточки персонального предложения
13. %MxN_Price_Goods% - Количество товара по цене (для акции MxN. Цена задается в поле "По цене товара" (price_of_quantity) на форме карточки персонального предложения.
14. %Number_Applications% – Лимит применимости акции в период действия (для карты). Лимит задается в поле "Количество срабатываний для карты (за все время)" (operationslimitforcard_regadlessdate) на форме карточки персонального предложения
    
    Техническое описание метапеременных для пп

Сообщения по шаблону

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

Рис. Справочник шаблонов сообщений

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

Внешний вид карточки шаблона сообщения:

Рис. Карточка шаблона сообщений

Мультиаккаунтность для SMS и PUSH рассылок

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

Рис. Справочник аккаунтов коммуникаций в системе

Для настройки служит карточка Аккаунта мобильной коммуникации. Карточка содержит следующую информацию:

Внешний вид карточки аккаунта коммуникации:

Рис. Карточка аккаунта коммуникаций (обзор)

Рис. Карточка аккаунта коммуникаций (детализация)

Создаваемые заданием по расписанию SMS и PUSH сообщения будут переданы для доставки тому провайдеру, ссылка на аккаунт которого указана непосредственно в задании по расписанию.

Рис. Выбор SMS-аккаунта в карточке Задания по расписанию

Рис. Выбор PUSH-аккаунта в карточке Задания по расписанию

SMS и PUSH сообщения, которые создаются по правилу или по шаблону, будут переданы для доставки тому провайдеру, ссылка на аккаунт которого указана в карточке партнёра. Партнёр определяется по чеку. В чеке всегда указан внешний идентификатор партнёра. Если в карточке партнёра нет ссылки на аккаунт мобильной коммуникации, то провайдером доставки SMS и PUSH сообщений будет тот, внешний идентификатор которого проставлен в системной настройке Loyalty.Processing.AggregatedMessage.SmsAccount.

Через Push-сервис ML существует несколько способов отправки push-сообщений на iOS и Android.

Отправка iOS-пушей:

• через Apple Push Notification service (APNs) с использованием сертификата .p12 - certificate-based connection. Подробное описание в разделе 5.2.9.4 Вложение файлов сертификатов в Аккаунт коммуникаций;
• через Firebase с использованием server key - legacy HTTP protocol;
• через Firebase с использованием с использованием JWT-токенов по протоколу HTTP V1;

Отправка Android-пушей:

• через Firebase с использованием server key - legacy HTTP protocol;
• через Firebase с использованием JWT-токенов по протоколу HTTP V1

Рис. Параметры настройки для отправки push-сообщений в Аккаунте коммуникаций