AI поиск

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

В разделе AI поиск отображается демонстрация виджета с примером поисковой выдачи. В верхней части страницы доступны кнопки Настройки и Код размещения:

Настройка поисковых атрибутов

Нажмите Настройки. Откроется страница настроек с двумя вкладками: В поиске и В фильтрах.

На вкладке В поиске находится раздел «Поиск по атрибутам». Здесь задаются атрибуты каталога, по которым будет производиться поиск, и их приоритеты:

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

Таблица настроек содержит поля:

• Атрибут — название атрибута.
• Пример значения — первое заполненное значение в атрибуте.
• Тип — тип данных: строка, число, булевый.
• Приоритет — вес атрибута при поиске.
• Искать по полю — тумблер, включающий атрибут в поиск.

Приоритет в поиске

Приоритет определяет вес атрибута при поиске. Чем выше приоритет, тем выше в выдаче окажется товар с совпадением по этому атрибуту.

Приоритет	Пояснение	Примеры атрибутов
Максимальный	Наибольший вес при поиске	Артикул, SKU, точный код товара
Высокий	Основной идентификатор	Бренд, модель, название
Умеренный	Важная характеристика	Категория, тип, подкатегория
Слабый	Уточняющий параметр	Цвет, материал, размер, вес
Минимальный	Дополнительная информация	Описание, теги, комментарии, мета-данные

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

Настройка фильтров

Перейдите на вкладку В фильтрах. В разделе «Фильтры в выдаче» настраиваются фильтры, которые покупатель увидит вместе с результатами поиска:

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

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

Таблица настроек содержит поля:

• Порядок — последовательность фильтров, задается перетаскиванием строк.
• Атрибут — название атрибута.
• Пример значения — пример значения атрибута.
• Тип — тип данных: строка, число, булевый.
• Включить фильтр — тумблер, включающий атрибут в фильтры.

Настройка карточки

Настраивается внешний вид карточки товара в результатах поиска.

По умолчанию включены следующие элементы карточки:

• Название
• Изображение
• Цена (старая и базовая, скидка)
• Рейтинг
• Отзывы

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

Размещение виджета на сайте

Нажмите Код размещения в верхней части раздела. На открывшейся странице настраивается встраивание виджета на сайт:

• Селектор поля поиска на сайте клиента;
• Размещение результатов;
• Параметры API;
• Дополнительные опции;
• Код подключения.

Подключение

В поле Селектор поля поиска на сайте клиента укажите CSS-селектор поискового поля, к которому привяжется виджет, например #search.

Размещение результатов

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

• В контейнер — выдача рендерится в указанный DOM-контейнер на странице клиента. В поле Селектор контейнера результатов укажите селектор контейнера, например #search-results. Если элемент на сайте не найден, виджет принудительно откроет fixed overlay и напишет ошибку в консоль.
• Fixed overlay — выдача отображается поверх страницы отдельным слоем.

API

• Базовый URL API — необязательное поле, адрес API сервиса.
• API-ключ (для встраивания на сайт) — ключ проекта. Передается в заголовке x-moodrec-api: в интерфейсе MoodRec используется токен сессии, на внешнем сайте — этот ключ.

Дополнительно

• Кэшировать ответы API — кэширует ответы API при поисковых запросах.
• Синхронизировать запрос и фильтры с URL — записывает поисковый запрос и выбранные фильтры в query-параметры страницы (q, f*).

Код подключения

Скопируйте код и вставьте его на страницу сайта перед закрывающим тегом </body>. Виджет подтянет стили и настройки сам:

html

<script src="https://example.com/static/search-widget/widget.loader.js" async></script>

Завершите настройку кнопкой Опубликовать в верхней части страницы.