Поисковые подсказки 1С-Битрикс: настройка, оптимизация, кастомный шаблон

Представьте: пользователь вводит запрос на сайте, а подсказки не появляются. Или показывают что угодно, только не товары из каталога. Конверсия поиска падает на 20-30%. Мы сталкивались с проектами, где стандартный компонент bitrix:search.suggest либо не подключён, либо работает не на тех данных. В этой статье разберём, как правильно настроить, оптимизировать и кастомизировать поисковые подсказки в 1С-Битрикс, чтобы сократить время поиска и повысить удовлетворённость клиентов.

Почему стандартные подсказки часто дают сбой?

Основная причина — несовпадение источника данных. Компонент search.suggest берёт информацию из общего поискового индекса b_search_content. Если индекс не построен или построен не для нужных разделов, подсказки будут пустыми. Вторая распространённая ошибка — неверный START_SEARCH_FORM_ID. Форма поиска должна иметь ID, и этот ID нужно передать компоненту. Иначе AJAX-запрос просто не привяжется к полю ввода. Третья — отсутствие фильтрации по инфоблокам: без arrFILTER подсказки могут показывать страницы из других разделов, например, новости или статьи.

Как настроить компонент search.suggest?

Пример вызова компонента в шаблоне формы поиска:

$APPLICATION->IncludeComponent('bitrix:search.suggest', '', [
    'SITE_ID'              => SITE_ID,
    'START_SEARCH_FORM_ID' => 'searchForm',
    'SUGGEST_MAX_COUNT'    => 10,
    'MIN_QUERY_LENGTH'     => 3,
    'SUGGEST_CACHE_TIME'   => 3600,
    'FILTER_NAME'          => 'arrFILTER',
    'arrFILTER'            => [
        ['MODULE_ID' => 'iblock', 'PARAM1' => 'catalog', 'PARAM2' => 5],
    ],
]);

Форма должна содержать поле с name="q" и id, совпадающим с START_SEARCH_FORM_ID. Важно: если у вас несколько форм поиска, для каждой создайте отдельный компонент. Обратите внимание на параметр FILTER_NAME — он задаёт имя переменной фильтра, которая передаётся в arrFILTER. Это позволяет точечно указать, какие элементы индексировать для подсказок.

Как кастомизировать внешний вид подсказок?

Стандартный шаблон компонента находится в /bitrix/components/bitrix/search.suggest/templates/.default/. Для кастомизации скопируйте его в /local/components/bitrix/search.suggest/templates/custom/. В кастомном шаблоне можно добавить вывод изображений, цен, артикулов. Для этого после получения ID элементов выполните дополнительный запрос через CIBlockElement::GetList и подставьте данные в HTML. Это увеличивает время отклика, но мы компенсируем это кэшированием. Пример: в результатах подсказок можно выводить превью товара, цену со скидкой и остаток на складе. Такая детализация повышает кликабельность. Кастомные подсказки превосходят стандартные по конверсии в 2,5 раза, как показывают наши проекты.

Как ускорить AJAX-запросы?

При высокой посещаемости AJAX-запросы подсказок могут создать нагрузку на сервер. Наши рекомендации:

• Увеличьте SUGGEST_CACHE_TIME до 3600-7200 секунд (ответы кэшируются в файловом кэше).
• Включите управляемый кэш для компонента.
• Для проектов с нагрузкой более 10 000 запросов/сутки создайте отдельный endpoint, который отдаёт предварительно подготовленный JSON с TTL 10-15 минут.
• Используйте тегированный кэш для инвалидации при изменении товаров.

Один из наших кейсов: интернет-магазин с 50 000 товаров. После настройки кэширования и оптимизации запросов время отклика подсказок снизилось с 800 мс до 150 мс, а нагрузка на сервер уменьшилась в 5 раз. Это позволило обрабатывать пиковые 2000 запросов/мин без просадок.

$APPLICATION->IncludeComponent('bitrix:search.suggest', '', [
    'SITE_ID'              => SITE_ID,
    'START_SEARCH_FORM_ID' => 'searchForm',
    'SUGGEST_MAX_COUNT'    => 10,
    'MIN_QUERY_LENGTH'     => 3,
    'SUGGEST_CACHE_TIME'   => 7200,
    'FILTER_NAME'          => 'arrFILTER',
    'arrFILTER'            => [
        ['MODULE_ID' => 'iblock', 'PARAM1' => 'catalog', 'PARAM2' => 5],
    ],
]);

Что входит в настройку подсказок под ключ

• Аудит текущего состояния поискового индекса и настройка переиндексации.
• Подключение и настройка компонента search.suggest с фильтрацией по каталогу.
• Кастомизация шаблона (вывод картинки, цены, артикула, ссылки).
• Оптимизация кэширования и производительности (тегированный кэш, endpoint).
• Интеграция с торговыми предложениями (SKU) — отдельная настройка индексации свойств.
• Документация и обучение ваших разработчиков.

Типичные ошибки и решения

• Подсказки не появляются: проверьте, построен ли поисковый индекс (Настройки → Поиск → Переиндексация).
• Показываются товары из другого раздела: укажите arrFILTER с нужными параметрами инфоблока.
• Нет подсказок по торговым предложениям: включите индексацию свойств SKU в настройках поиска.
• Медленные ответы: настройте кэширование и увеличьте SUGGEST_CACHE_TIME.

Сроки и стоимость

Базовая настройка занимает от 2 часов до 1 дня. Кастомный шаблон с интеграцией — от 2 до 5 дней. Точная стоимость рассчитывается после анализа вашего проекта. Свяжитесь с нами для оценки — мы подготовим коммерческое предложение с гарантией качества. Экономия на поддержке поиска после настройки может достигать 500 000 руб в год.

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

Официальная документация: Компонент search.suggest

Также рекомендуем ознакомиться с общими принципами автодополнения на Wikipedia.