v2025.4.75

v2025.4.75.0 — Программы лояльности, новая сегментация, обновление интерфейса

предупреждение

Для корректной работы платформы требуется провести миграцию. Для этого:

1. Замените файлы платформы на файлы из новой сборки;
2. Запустите ./akd upgrade и согласитесь с выполнением миграции;
3. Полностью перезапустите платформу командой ./akd restart.

Также необходимо добавить следующие обязательные объекты в файл конфигурации main.json:

• SYSTEM_REDIS — основная конфигурация Redis-хранилища
• LOYALTY_CACHE — конфигурация Redis-хранилища, используемого для работы программ лояльности
• PROCWORKFLOW_DISTRIBUTED_CACHE_DB — параметры распределённого кэш-хранилища, используемого процессом procworkflow
• CAMP_DUPLICATESDB — конфигурация Redis для базы дубликатов

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

Программы лояльности

В этом обновлении в платформу Altcraft добавлен модуль «Программы лояльности». Программа лояльности — это система поощрения клиентов за целевые действия: покупки, регистрацию, просмотр контента и другое. Клиенты получают баллы, которые могут потратить на скидки, фильмы, тарифы и услуги.

Участниками программы лояльности могут стать все профили в базе или же определенный сегмент. Также можно добавлять участников вручную или при помощи API-запросов:

Участникам программ лояльности можно начислять баллы. Баллы делятся на стандартные и квалификационные. Стандартные используются для вознаграждений, квалификационные — для определения уровня участника. Каждому типу баллов можно задать эквивалент в реальной валюте:

Управление начислениями и списаниями баллов осуществляется при помощи триггерных промоакций:

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

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

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

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

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

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

Обновленная сегментация

Крупные изменения внесены в механизм сегментации профилей в платформе. Главное нововведение — переработка типов сегмента:

• Статический сегмент — представляет собой сущность для хранения профилей, заполняемую вручную или по API. Сегмент не пересчитывается при использовании и автоматически не обновляется. Сегмент можно сохранить пустым, главное вписать имя и выбрать БД.
• Динамический сегмент — этот сегмент по сути является набором условий, а не списком профилей. Динамический сегмент просчитывается перед каждым новым использованием. Он также может показать результаты выборки без сохранения сегмента.
• Обновляемый сегмент — такой сегмент нельзя наполнять вручную или по API. Сегмент наполняется по заданным условиям согласно установленному расписанию или при ручном пересчете.
• Быстрые сегменты были убраны из платформы. Вместо них применяется динамический сегмент, для этого при настройке сегмента нажмите кнопку «Рассчитать».

Также существенно переработан внешний вид меню настройки сегментов:

Интерфейс стал более современным и интуитивно понятным. Более подробная информация по сегментации доступна в этом разделе документации.

Продуктовые сегменты

Теперь в рамках Маркета вы можете объединять продукты в продуктовые сегменты. Это наборы продуктов и их модификаторов (SKU), объединенных в группу по определенному признаку:

Сегменты бывают двух видов: статические (объединенные через API или вручную при помощи условий отбора) и обновляемые (пересчитываемые автоматически по расписанию). Готовый сегмент можно выгрузить и использовать для анализа данных о ваших продажах.

Инструкция по настройке сегментов продуктов доступна в этой статье документации по Маркету.

Обновления интерфейса

Вместе с обновлением мы улучшили интерфейс:

• Обновлена цветовая палитра элементов платформы;
• Изменили внешний вид некоторых компонентов, таких как выбор диапазона дат;
• Улучшили отображение боковых вспомогательных меню (например, стратификации в ГКГ);
• Теги и атрибуты в списках теперь выглядят органичнее и не выбиваются из общего дизайна;
• Исправлены некоторые ошибки, связанные с отображением таблиц.

Цветовая палитра

До:

После:

Диапазоны дат

До:

После:

Отображение в списках

До:

После:

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

Интеграция с Keycloak

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

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

Прочее

• Изменения в настройках виртуального сендера снова сохраняются корректно.
• Устранена ошибка, вследствие которой параметр CLICKHOUSE_SYSTEM.CONN_TIMEOUT действовал на общий таймаут подключения к хостам, а не на конкретную попытку.
• ГКГ более не вызывает ошибки при работе после ее повторного создания.
• Исправлена ошибка, из-за которой обязательное поле пользовательского канала могло становиться необязательным.
• Email-адрес теперь корректно приводится к нижнему регистру при создании LDAP-пользователя.
• Устранена ошибка, при которой регулярное выражение для массивов проверяло только первый объект массива и не давало пройти валидацию в JSON-фильтре.
• Превью шаблона для Telegram в сценариях теперь отображается корректно.
• Улучшено отображение ошибок и предупреждений в платформе.
• Письма-дубликаты с предупреждением о достижении лимита по импорту профилей больше не генерируются.
• Устранена ошибка, при которой некоторые сценарии не могли сохраняться в платформе.
• Оптимизирована скорость импорта профилей в платформу.
• Удаленные пользовательские события теперь не отображаются в списке захвата событий и не активируют триггеры.

References

v2025.4.75.0: PL-20429 PL-20573 PL-20313 PL-20551 PL-20498 PL-20474 PL-20485 PL-20095 PL-19769 PL-20192 PL-19817 PL-16969 PL-20344 PL-20141 PL-20057 PL-19157 PL-19942 PL-20372 PL-20306 PL-17956 PL-20270 PL-20273 PL-19106 PL-20266 PL-19173 PL-19937 PL-19087 PL-18576 PL-20170 PL-19912 PL-19289 PL-19935 PL-19938 PL-19762 PL-20032 PL-20060 PL-19785 PL-19941 PL-18104 PL-18357 PL-19455 PL-18995 PL-19781 PL-19639 PL-17787 PL-18173 PL-19851 PL-19548 PL-17393 PL-18637 PL-19101 PL-19064 PL-17906

---

v2025.4.75.1005 — Исправления лояльности, мелкие улучшения

Улучшено

• Добавлена возможность ожидания определённой даты в узле «Ожидание события».
• Добавлена валидация наличия шаблона при запуске рассылки, а также запрет на удаление шаблона, привязанного к рассылке.

Прочее

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

• Создание рассылки не мастер-пользователем теперь не вызывает ошибок.
• Устранена ошибка, при которой некоторые сценарии не прикреплялись к кампаниям.
• Ограничение на повторное заполнение формы снова работает корректно
• Добавлена валидация и наследование параметров конфигурации, отвечающих за Redis-хранилище.
• Исправлены ошибки в сборе и отображении аналитики программ лояльности.
• События в журнале кампаний теперь отображаются корректно.
• Улучшена стабильность процесса webcontrol.
• Добавлена фильтрация по статусам в списках кампаний.
• Устранена ошибка, возникавшая при попытке сохранить кампанию.
• Платформа теперь отображает корректную информацию об ошибке при проблемах с подключением к Yandex.Audience.
• Переход к шаблону из превью в списке шаблонов теперь работает корректно.
• Устранена ошибка, из-за которой при экспорте данных формы не передавался ID профиля.
• Теперь время в узле сценария «Пауза» изменяется корректно.
• Устранена ошибка, не позволявшая вставить значение менее 100% в правилах виртуальных сендеров.
• Фильтрация по группам в списке программ лояльности снова работает корректно.
• Исправлены ошибки, возникавшие при открытии email-шаблона.
• Деактивация рассылки во время отправки снова работает корректно.
• Исправлены некоторые ошибки в работе визуального редактора.
• Превью AMP-версии email-шаблона теперь открывается и отображается корректно.
• Устранена ошибка, при которой в событиях жалоб не указывался провайдер.
• Дата в захвате событий и API снова передаётся корректно.
• Исправлена ошибка, из-за которой превью в пользовательских каналах всегда отображалось как HTML-сообщение.
• Переменная subscription_fields теперь корректно передается в тестовых отправках.
• Расчёт быстрого сегмента с запросом к внешней БД снова работает корректно.
• Добавлена валидация на привязку к несуществующей в платформе группе.

References

v2025.4.75.1005: PL-20912 PL-20916 PL-20899 PL-20826 PL-20881 PL-20624 PL-20847 PL-20791 PL-20794 PL-20752 PL-20756 PL-20753 PL-20767 PL-19819 PL-20760 PL-20205 PL-20757 PL-20744 PL-20754 PL-20749 PL-20718 PL-20644 PL-20724 PL-20730 PL-20732 PL-20725 PL-20041 PL-20469 PL-20705 PL-20632 PL-20704 PL-20552 PL-20702 PL-20635 PL-20683 PL-20693 PL-20684 PL-20190 PL-20618 PL-19500 PL-20380 PL-20674 PL-20099 PL-20669 PL-20651 PL-20671 PL-20648 PL-20668 PL-20666 PL-20620 PL-20665 PL-17606 PL-20659 PL-20650 PL-20069 PL-20653 PL-20649 PL-20647 PL-20637 PL-19347 PL-20233 PL-20148 PL-20625 PL-20606 PL-20314 PL-19211 PL-20523 PL-20572 PL-20534 PL-19602 PL-20500 PL-18808 PL-20376 PL-20169 PL-20377 PL-20073 PL-19950 PL-19940 PL-19822 PL-18473 PL-19411 PL-18360 PL-19802 PL-19688 PL-18742 PL-19370 PL-19619 PL-16670 PL-18771 PL-19338 PL-19174 PL-18741 PL-18918 PL-16688 PL-16687

---

v2025.4.75.2408 — React Native mSDK, улучшения продуктовых сегментов

Миграция

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

1. Остановите процессы webcontrol, api и proctask.
2. Запустите миграцию командой ./aktool segments run-separation-migration --config=путь-к-файлу-конфигурации.
3. Запустите остановленные процессы.

mSDK Altcraft для React Native

В мобильном SDK Altcraft была добавлена поддержка кроссплатформенного фреймворка React Native. Его применение позволит использовать SDK одновременно для iOS- и Android-приложений.

Подробнее узнать о подключении и использовании mSDK Altcraft на React Native можно здесь. NPM-пакет доступен по этой ссылке.

Улучшено

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

Прочее

• Атрибуты теперь корректно отображаются в предпросмотре шаблона рассылки.
• JSON из полей Объект и Массив объектов в узле API-запроса снова подставляется корректно.
• Устранены ошибки с Viber-отправками через SMSTraffic, возникавшие из-за UTC-времени в параметре start_date.
• Улучшены сбор и отображение отчётности по программам лояльности.
• Фильтр по типу событий в карточке профиля снова работает корректно.
• В email о заполнениях формы больше не содержатся недопустимые спецсимволы.
• Исправлены некоторые ошибки, связанные с атрибутами.
• Лимит в пайпе http_request пользовательских каналов теперь работает корректно.
• Устранены ошибки при клонировании шаблона пользовательских каналов.
• Условие «существует» по строковым полям в быстром сегменте снова работает корректно.
• Улучшена стабильность процессов webadmin, proctask и api.
• Увеличена скорость разбора очереди trk_pixel_def.
• Ссылки в push-шаблонах в бета-редакторе теперь работают корректно.
• Устранены проблемы с подключением к платформе по LDAP.
• Исправлена ошибка, из-за которой превью шаблонов не сохранялись в FileDB.
• Обработка пользовательского поля с названием системного поля теперь проходит корректно.
• Пользовательские каналы снова могут использоваться в сценариях.
• Устранена ошибка, при которой выгрузка журнала аудита содержала время, указанное не в часовом поясе аккаунта.
• Теперь UTM-параметр utm_medium обновляется в карточке профиля при регистрации цели по API.
• Исправлена ошибка, из-за которой не регистрировались hard bounce из рассылок Telegram-бота.
• Политики отправки теперь применяются при массовой триггерной отправке профилей в сценарий.
• Теперь ограничение по количеству символов не будет учитываться при использовании динамических переменных с длинными логическими условиями.
• Устранена ошибка, при которой API-метод /profiles/list возвращал не все профили из базы.
• Исправлены ошибки отображения значения External object в шаблонах пользовательских каналов.

References

v2025.4.75.2408: PL-20956 PL-21090 PL-21117 PL-21116 PL-21118 PL-21115 PL-19263 PL-21087 PL-21089 PL-18153 PL-21062 PL-21046 PL-17906 PL-20943 PL-21038 PL-20987 PL-21023 PL-20499 PL-20999 PL-20641 PL-21008 PL-20971 PL-20986 PL-20636 PL-20542 PL-20865 PL-18467 PL-20802 PL-20846 PL-20780 PL-18407 PL-17935 PL-19747 PL-20682 PL-20719 PL-20652 PL-20312 PL-18757 PL-18575 PL-18663 PL-21027 PL-21009 PL-20990 PL-18111 PL-20914 PL-20980 PL-21025 PL-20968 PL-20970 PL-21002 PL-21005 PL-20984 PL-20860 PL-20833 PL-20966 PL-20931 PL-20953 PL-17662 PL-20896 PL-20875 PL-20862 PL-20541 PL-20764 PL-20738 PL-20553 PL-19277 PL-20428 PL-19278 PL-20201 PL-17754 PL-18981 PL-21018 PL-20992 PL-20815 PL-20967 PL-20963 PL-20456 PL-20962 PL-20934 PL-20893 PL-20825 PL-20540 PL-20588 PL-20236 PL-18822 PL-20901 PL-20525 PL-19672 PL-20751 PL-17954 PL-20980 PL-20965 PL-20891 PL-20954 PL-20958 PL-20951 PL-20908 PL-20955 PL-20927 PL-20935 PL-20922 PL-20297 PL-2087 PL-20879 PL-20886 PL-20866 PL-20830 PL-20804 PL-20831 PL-20761 PL-20814 PL-20789 PL-20720 PL-19344 PL-20808 PL-20714 PL-20803 PL-20707 PL-20790 PL-20786 PL-20759 PL-20433 PL-20539 PL-20688 PL-20709 PL-20685 PL-18299 PL-20712 PL-20623 PL-20408 PL-20164 PL-20677 PL-20160 PL-20594 PL-20622 PL-20056 PL-20247 PL-18498 PL-16893

---

v2025.4.75.2774 — Пользовательская аутентификация, улучшения блочного редактора

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

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

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

Список таких рассылок можно получить с помощью команды ./aktool campaigns upgrade-blocker-list или ./aktool campaigns upgrade-blocker-list --account-id 12345 (для конкретного аккаунта).

Добавлено

Добавлен новый вид коннекторов для внешних подключений — Custom Authentication. Такое подключение позволяет настроить пользовательские HTTP-заголовки для API-запросов, включая предустановленный заголовок Authorization. Это решение предоставляет гибкость в настройке и отправке API-запросов, а также поддерживает валидацию и обработку ошибок.

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

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

Улучшено

Улучшен блочный редактор для email-шаблонов:

• добавлена возможность вставлять ссылки и emoji в таблицы;
• обновлён UI сохранения и экспорта;
• исправлено проксирование пустых изображений;
• визуальные и UI улучшения некоторых элементов интерфейса.

Больше о блочном редакторе можно прочесть в этой статье.

Прочее

• Команда Altcraft продолжает работу над исправлением ошибок модуля Лояльности и улучшением его стабильности.
• Исправлена ошибка, при которой директория data/segment не очищалась автоматически.
• Пароли со спецсимволами к подключению PostgreSQL теперь корректно работают.
• Устранена ошибка, из-за которой невозможно было создать транзакцию с большим сроком сгорания баллов.
• Редактирование рассылок, сценариев и кампаний теперь невозможно, если им назначен обязательный атрибут без выбранного значения.
• Улучшена стабильность работы платформы при выполнении нескольких API-вызовов триггера.
• Исправлены проблемы с отображением аналитики и отчетов в платформе.
• Значения полей в шаблонах для external object теперь сохраняется корректно.
• Устранены некоторые ошибки, связанные с атрибутами и передачей их значений.
• Теперь кампания корректно деактивируется даже ессли момент деактивации совпадает с моментом формирования аудитории.

References

v2025.4.75.2774: PL-20989 PL-21186 PL-20844 PL-21107 PL-21228 PL-21163 PL-19018 PL-19865 PL-21208 PL-21194 PL-20755 PL-21189 PL-21051 PL-21145 PL-21154 PL-16968 PL-21074 PL-21130 PL-21111 PL-20834 PL-20870 PL-21106 PL-21093 PL-21048 PL-21100 PL-20807 PL-21102 PL-21099 PL-18812 PL-21064 PL-20938 PL-21000 PL-20071 PL-20932 PL-20066 PL-20973 PL-21015 PL-20972 PL-20824 PL-20828 PL-20774 PL-20858 PL-20809 PL-20703 PL-21205 PL-18625 PL-20952