Настройка модуля «Рекомендации (AI/RecSys)»

Умная рекомендательная система (User2Item, Item2Item) для увеличения вовлеченности пользователей. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

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

Что изменится на сайте

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

Что подготовить заранее

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

• Определите, где именно модуль должен работать: объявления, блог, модерация, рекомендации, поиск или изображения.
• Подготовьте несколько тестовых объектов без персональных и коммерчески чувствительных данных.
• Проверьте лимиты, стоимость обработки и правила хранения данных у внешнего сервиса, если он используется.
• Заранее решите, какие результаты можно публиковать автоматически, а какие должен подтвердить администратор.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Рекомендации (AI/RecSys)» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

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

• «Personalized feed на главной». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true.
• «Похожие на детальной странице». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: true.
• «Глубина истории (дни)». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 30.
• «Вес контакта». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 10.
• «Вес избранного». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 5.
• «Вес поиска». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 2.
• «Вес просмотра». Укажите числовое значение. Для TTL, лимитов и таймаутов используйте разумное стартовое значение и проверьте результат на тестовом сценарии. Значение по умолчанию: 1.

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

Проверка перед запуском

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

Частые ошибки

• Результат пустой. Проверьте входные данные, лимиты и доступ к внешнему сервису.
• Обработка идет слишком долго. Уменьшите объем тестовых данных и проверьте очередь задач.
• Модуль применяет действие слишком широко. Уточните категории, роли и правила запуска.
• Результат требует контроля. Включите ручную проверку перед публичной публикацией результата.

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