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

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

Фильтр Партнеры

Добавлено описание фильтра по Партнерам при создании акции. Эта опция актуальна для коалиционной ПЛ.

Обеспечение соблюдения законодательства по части хранения персональных данных

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

Посмотреть статью

Переименование Партнеров в Компании

С версии Системы 2023.1 Партнеры переименованы в Компании.

Удаление функциональности дополнительных карт

Функциональность дополнительных карт будет удалена с версии 2024.1.

Передача данных по истории чеков из системы Loymax в Kafka

В статью добавлен раздел по истории чеков, которая передается в Kafka.

Расширено соглашение об уровне сервиса и правила технической поддержки 

Статья расширена пунктом 9.5. Версия API, которая признана устаревшей, поддерживается в течение 1 года после уведомления Партнеров об обновлении.

Новое в аналитических отчетах BI

MS Excel:

• Изменено описание релиза Маркетинговые кампании версия 2023.1. Статья разделена на 2 отдельные статьи:
  • Маркетинговые кампании,
  • Портрет сегмента.
• Добавлены статьи для версии 2024.1:
  • Структура чека,
  • Совместные покупки.
• Внесены изменения в описание отчета в блоке Показатели ПЛ (изменения в разделе Спецификация) в версии 2024.1.

Apache Superset:

• Создан раздел с описанием отчетов в Apache Superset. В этом разделе опубликованы отчеты:
  • Показатели ПЛ версия 2024.1,
  • Рассылки версия 2024.1.

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

С версии 2022.2 округление стоимости при расчете скидки для товара способом расчета Фиксированная цена на единицу товара происходит не по математическим правилам, а в пользу покупателя.

Посмотреть статью

Авторизация в API через Swagger

Актуализирована информация о том, как следует заполнять поле client_id при авторизации через OAuth-приложение.

Добавлены права для OAuth-приложения

С версии 2022.2 для OAuth-приложения добавлены разрешения на просмотр и редактирование группы товаров:

• Пользователь АРМ имеет право просматривать группы товаров (GoodsGroupsView)
• Пользователь АРМ имеет право редактировать группы товаров (GoodsGroupsManage)

Стенды и окружения развертывания ПО

Опубликована статья с описанием стендов, которые используются в работе сотрудниками Loymax и сотрудниками Партнера.

Возможность печатать слип в составе чека на кассах Set Retail 10

• В настройках плагина Set Retail 10 добавлена возможность Печатать слип в составе чека. Посмотреть статью.
• При работе с КПО Set Retail в параметре Params необходимо передавать ссылку на электронный чек (eCheque) в запросе ConfirmPurchases.

Обработчик входящих SMS от Rapporto

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

Передача данных из системы Loymax в Kafka

Опубликована статья, в которой описан формат передаваемых в Kafka данных по покупкам.

Посмотреть статью

Умная маршрутизация сообщений в Viber через провайдера SMSTraffic

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

Новый метод для работы с паролем

Добавлено описание метода, который возвращает список нотификаторов клиента, на которые возможна отправка кода подтверждения для восстановления пароля (ResetPassword).

Новое в документации Loymax Smart Communications

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

Посмотреть статью

Новое в документации BI

• Опубликованы статьи с описанием релиза и подробным описанием отчета BI Показатели ПЛ версии 24.1 в Power BI.
• Опубликованы статьи с описанием релиза аналитических отчетов в MS Excel в блоке "Структура чека" и релиза аналитических отчетов в MS Excel в блоке «Совместные покупки» версии 24.1.

Новое в документации по Smart Communications

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

  • Для действий Актуализировать фильтр и Отфильтровать клиентов описана возможность формировать 2 сценария: положительный (в ветку цепочки будут отфильтрованы все клиенты, удовлетворяющие условиям фильтра) и отрицательный (все клиенты, которые не удовлетворяют условиям фильтра). Далее ветки цепочки можно снова объединять.

• Обновлена статья JS-трекер: добавлен раздел Работа с контейнерами, актуализированы примеры.

Плагин Loymax.Plugin.SmartCommunication разделен на 3 отдельных плагина

• Loymax.Plugins.SmartCommunications — плагин фронтенда для АРМ,
• Loymax.Plugins.SmartCommunications.Person — плагин для передачи данных о клиентах в SmartCommunications,
• Loymax.Plugins.SmartCommunications.Purchase – плагин для передачи данных о покупках в SmartCommunications.

Особенности шаблонов номеров купонов

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

Посмотреть статью Шаблоны номеров

Расширена регулярная задача по изменению атрибутов клиентов

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

Добавлены примеры отображения вспомогательных метапеременных

Примеры отображения добавлены для метапеременных WidthArranger, ToInt, GetElement.

Посмотреть статью

Отображение купонов в Управлении покупками

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

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

С версии 2022.2 в шаблоне можно задавать источник обращения к клиенту. Им может быть одно конкретное, указанное в поле Источник, OAuth-приложение. Либо можно указать в этом поле ВСЕ — тогда клиент будет получать универсальный текст уведомления независимо от канала коммуникации.

Посмотреть статью

Новые статьи в разделе BI

В подразделе Аналитические отчеты в Power BI (версия 2023.1) добавлены статьи:

• ML Отчет по эффективности персональных промопредложений.

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

Архивная валюта

В статью Валюта добавлен подраздел про архивацию. В нем отражены особенности работы валюты, если ее отправили в архив.

Добавлены примеры запросов для методов работы с процессингом

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

• Рассчитывает прямую скидку и доступную сумму списания бонусов,
• Рассчитывает бонусы.

Актуализированы статьи по настройке Google Pay

Обновлена информация в статьях:

• Создание сертификата для сервисного аккаунта Google,
• Настройка конфигураций плагина,
• Настройки в АРМ.

Добавлены новые примеры акций

• Начисление бонусных баллов в размере Х% от суммы покупки, но не менее Y баллов
• Начисление бонусных баллов в размере Х% от суммы покупки, но не более Y баллов
• Предоставление скидки за 1 день до и 7 дней после дня рождения Участника
• Предоставление скидки, если покупка совершается в течение X дней с даты последней покупки

Обновлена статья Регулярная задача по очистке событий

Список очищаемых таблиц Базы данных расширен.

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

С версии 2022.2 добавлен новый ключ numberOfRecordsToprocess, в котором следует указывать количество клиентов, обрабатываемых при каждом запуске задачи.

Актуализирована статья Обновление Системы

С версии 2023.1 во вкладку Деплой добавлен столбец Название пакета, отображающий название сервиса/адаптера/Cистемы, для которых создан деплой.

Добавлены требования к изображениям в push- и SMS-рассылках в Loymax Smart Communications

• Посмотреть статью Push-рассылки
• Посмотреть статью SMS-рассылки

Опубликована статья с описанием интеграции Loymax Smart Communications с агрегатором мессенджеров Chat2Desk

Посмотреть статью

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

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

Посмотреть статью

Списание по нескольким QR-кодам

Новый параметр конфигурации АРМ CheckExpireQrCode позволяет с версии 2023.1 проводить оплату по нескольким QR-кодам.

Посмотреть статью

Новое в методах API

• С версии Системы 2022.2 к некоторым методам для работы с таргетированным контентом возможен доступ без токена.
• С версии 2024.1 реализована возможность заполнения часового пояса клиента через API:
  • Добавлены общие атрибуты, созданные в Системе по умолчанию: Часовой пояс и Источник установки часового пояса.
  • В Аудите клиента добавлен новый тип аудита: Изменение часового пояса.
  • Добавлен новый метод по установке/изменению часового пояса Участника ПЛ.

Новые типы аудита

С версии 2022.2 добавлены 4 типа аудита действий в Системе:

• Вход в приложение,
• Выход из приложения,
• Успешное формирование QR-кода,
• Ошибка при формировании QR-кода.
  Эти 4 типа аудита доступны для Участника ПЛ. Из них 2 доступны для пользователя АРМ:
• Вход в приложение,
• Выход из приложения.
  Они используются для фиксирования момента авторизации в АРМ и выхода из своей учетной записи в АРМ.

Добавлен обучающий ролик о промокодах

В разделе Обучение работе с Системой Loymax добавлена ссылка на новое видео, посвященное купонам. Это первый из серии обучающих роликов о купонах.

Актуализирована статья Создание и редактирование каталога товаров

• Добавлен раздел с описанием Поиска товаров в каталоге.
• Добавлено примечание об ограничении количества атрибутов товаров в файле: не более 500 000.

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

При пакетной регистрации клиентов событие Завершение регистрации не вызывается. Подробнее см. в статье Алгоритм импорта клиентской базы.

Актуализирована статья Атрибуты клиента

Расширено описание общих атрибутов.

Расчет бонусов по акциям из определенных категорий

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

Опубликованы новые статьи по аналитическим отчетам BI в MS Excel (версия 2024.1)

• Блок Лимиты + Описание релиза блока Лимиты,
• Блок Показатели ПЛ + Описание релиза блока Показатели ПЛ.

Добавлен пример настройки акции Товар дня

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

Актуализирована статья о купонах

Частично скорректировано описание типов купонов, обновлена таблица сравнительных характеристик видов купонов.

Примечание для ограничения на количество обращений к методу объединения карт

В статью Лимиты и в описание метода, который запускает объединение карт, добавлено примечание про ошибку при срабатывании лимита.

Актуализирована информация о несуммируемых акциях

В статье Расчет акций скорректировано описание несуммируемых акций и обновлен пример.

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

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

Обновлена статья с описанием методов для работы с любимыми категориями

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

Обновлен Протокол кассовых ошибок

Добавлен текст сообщения для ошибки с кодом 237.

 IdentifierData в кассовых ответах

Таблица с примерами вывода дополнительных атрибутов в элементе IdentifierData расширена. Посмотреть статью.

Статья со сценариями работы с денежными сертификатами перенесена в отдельный раздел

Посмотреть статью.

Доработка сценария авторизации в API Участника ПЛ с аутентификацией по одноразовому паролю (с версии 2022.2)

• Расширен параметр конфигурации IsPasswordRequired — добавлено значение (2) для аутентификации по одноразовому паролю.
• Дополнен сценарий авторизации при аутентификации по одноразовому паролю. Посмотреть статью.
• Добавлен параметр конфигурации SessionForCustomersValidityTimeMinutes, который задает период валидности сессии Участника ПЛ для некоторых операций (разблокировка карты, замена карты, объединение карт).
• Метод блокировки/разблокировки карт разделен на 2 отдельных метода.
• Дополнен сценарий возобновления прерванной регистрации при аутентификации по одноразовому паролю.

Обновлены статьи по плагину Google Pay

• В статье Настройка Google Pay добавлено примечание о том, что при удалении карты лояльности из электронного кошелька Google Pay идентификатор карты из него не удаляется.
• Актуализирована статья по настройке конфигураций плагина:
  • добавлено уточнение, что для ключа CustomerName нельзя использовать русский алфавит и пробелы;
  • указано, где задаются некоторые из ключей с версии 2022.2.

Актуализированы статьи по Apple Wallet

Обновлены статьи:

• Инструкция по генерации сертификата Apple Development для Apple Wallet;
• Загрузка сертификата Apple WWDR;

• Настройка конфигураций плагина.

Ограничения при импорте групп товаров

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

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

В параметре count следует использовать значение не больше 100.

Обновлена статья Установка минимальной цены в справочнике действий

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

Расширено описание параметра cashback в кассовом протоколе

Обновлен пример запроса и ответа, расширено описание параметра cashback, передающего сумму внешних/кассовых бонусов на позицию. Посмотреть статью.

Обновлена статья Начисления и списания бонусов

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

Обновлена статья Создание push-уведомлений

Добавлено примечание: для корректной работы Системы следует задавать аудиторию для рассылки не более 70 000 клиентов. 

Добавлен пример настройки акции Скидка или оплата бонусами

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

Опубликована статья Омниканальность

Посмотреть статью.

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

В конфигурации АРМ WebApiTrustedProxyIps доверенные IP-адреса прокси-серверов можно указывать в виде единичного адреса, диапазона адресов и подсети адресов.

Опубликована статья Рассылки в Power BI версия 2023.1

Посмотреть статью.

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

• С версии Системы 2023.1 в Управлении покупками отображаются покупки, по которым был отправлен только запрос Расчет скидки (Calculates).
• При просмотре покупки в блоке Бизнес-активности отображаются все запросы Расчет скидки (Calculates), которые происходили в рамках данной покупки.

Внешний идентификатор кассы не генерируется повторно

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

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

Отображение общего количества покупок

С версии Системы 2023.1 отображение общего количества покупок в разделе Управление покупками в блоке Фильтр и в истории покупок в Карточке клиента регулируется конфигурацией ShowPurchaseCount.

Обновлено описание фильтра Дополнительная информация по позиции

• Добавлен пример настройки фильтра;
• В Справочник акций добавлен пример с использованием фильтра Дополнительная информация по позиции: Списание интернет-бонусов только на оформленный в интернет-магазине заказ.

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

Добавлен пример использования в фильтре Скрипт. Посмотреть пример.

Обновлены статьи Бонусы и Скидка

Добавлено уточнение, что именно можно переопределять с помощью параметров расчета.

Обновлена статья Контакты

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

Опубликованы новые статьи по аналитическим отчетам BI

• Описание блока Рассылки в аналитических отчетах в MS Excel + описание релиза блока Рассылки;

• Описание улучшения новой версии аналитических отчетов в Power BI Рассылки;

• Описание улучшения новой версии аналитических отчетов в Power BI Сегментация.

Обновлена статья Жизненный цикл акции

Статья дополнена пунктом 5 — информацией об остановке акции. Посмотреть статью.

Обновлены статьи о действиях Бонусы и Скидка

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

Посмотреть статью Бонусы

Посмотреть статью Скидка

Актуализирована статья Пользовательские права

Для преднастроенных ролей Старший маркетолог и Ведущий маркетолог с версии 2022.2 недоступно право на просмотр данных с магнитной полосы карты (StripNumberBrowse). Посмотреть статью.

Обновлена статья Управление покупками

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

Обновлена статья Создание счетчика

Примечание, добавленное в раздел Создание счетчика, скорректировано. Параметр Товар работает только с действием Разбиение на итерации и фильтром Ограничение на товар (со счетчиком) во вложенном событии Обработка итерации. Посмотреть статью.

Опубликована статья Глобальная контрольная группа

Описана новая функциональность модуля Smart Communications — Глобальная контрольная группа (ГКГ). Она настраивается на уровне Партнера в целом, а не в рамках рассылки или кампании, как обычная контрольная группа. Посмотреть статью.

Обновлена статья Отказ от участия в Программе лояльности через Мобильное приложение

Актуализирована статья с описанием выхода из Программы лояльности через МП. Теперь возможность выходить из ПЛ доступна не только для приложения на iOS, но и для Android. Кнопка Удалить профиль и шаги для удаления профиля клиента для обеих платформ одинаковы. Посмотреть статью.

Обновлена статья Разбиение на наборы

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

Настройка авторизации в АРМ по протоколу LDAP

Добавлена информация о том, как подключать несколько Active Directory в настройках авторизации в АРМ по протоколу LDAP (см. п.3 раздела Установка конфигураций), добавлен пример. Посмотреть статью.

В статье с конфигурациями АРМ для параметра LdapFullPath добавлен формат, в котором задается путь до папки с пользователями в Active Directory (AD). Посмотреть в статье.

Обновлена информация с требованиями для подключения к OLAP-кубу из Microsoft Excel

Внесена поправка по актуальной версии Windows для работы с кубами. Рекомендуется использовать ОС Windows 10 и выше. Посмотреть статью.

Актуализирована статья про настройку соцсети ВКонтакте

Снова обновлена. Поправлено описание, обновлены изображения. Посмотреть статью.

Обновлена статья Создание и загрузка атрибутов клиентов

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

Регулирование количества товаров в рекламных материалах с типом акции Персональные товары

• В статье о создании рекламных материалов добавлено примечание о том, что для типа акции Персональные товары рекомендуется в группу товаров добавлять не более 100 товаров. Посмотреть статью.
• С версии 2023.1 добавлен параметр конфигурации АРМ, который определяет максимальное число товаров в рекламных материалах с типом акции Персональные товары. Значение по умолчанию: 100. Посмотреть статью с описанием конфигурации.

Отмена незавершенной регистрации

С версии 2022.2 в Контакт-центре добавлена функциональность отмены начатой, но не завершенной регистрации клиента.

• Посмотреть статью Отмена незавершенной регистрации.
• Посмотреть описание метода API для отмены начатой регистрации клиента через Контакт-центр.

Добавлено примечание в статью Создание SMPP-шлюза

Для корректной отправки сообщений через Unibell необходимо указывать значение false в параметре SubmitUserMessageReference (см. таблицу Необязательные параметры).

Добавлена возможность получать более подробную информацию по всем сработавшим лимитам

• В статье Доступность метапеременных по контекстам в раздел Лимиты добавлено описание новых переменных. Посмотреть статью.
• Для переменной $Person добавлено поле Phone. Посмотреть статью.
• Для переменной $Merchant добавлены поля Uid и Code. Посмотреть статью.
• Добавлена переменная $Device и ее описание. Посмотреть статью.

Обновлена статья Купоны

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

Обновлена статья Купон по маске

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

Опубликована статья Использование рекомендательных систем для формирования персональных предложений

В статье описан принцип работы рекомендательной системы и процесс ее интеграции с Loymax Loyalty. Посмотреть статью.