Пользователь вводит «мобильник» — товар не найден. Пробует «сотовый» — снова пусто. Каталог из 50 000 позиций, но поиск упёрся в лексический барьер: в названиях товаров только «телефон». Такая ситуация — типичная боль интернет-магазинов на 1С-Битрикс. Результат — потерянные продажи и высокий процент отказов. Наш опыт показывает: добавление синонимов Elasticsearch сокращает число пустых выдач на 30–50% и увеличивает конверсию поиска на 15–25%. Для магазина со средним чеком $27–39 и 10 000 запросов в день это дополнительная выручка до $140–200 в сутки.
Синонимы в Elasticsearch — это связка между пользовательским словарём и реальными терминами в индексе. Они реализуются через token filter synonym в анализаторе. Мы настраиваем их под ключ: от сбора словаря до финальной проверки выдачи. Наши сертифицированные инженеры с 5+ лет опыта гарантируют корректную конфигурацию без потери производительности.
Где синонимы в цепочке Elasticsearch
Синонимы добавляются как token filter в анализатор. Они могут работать двумя способами:
| Способ | Описание | Пример использования |
|---|---|---|
| Expansion | «мобильник» → «мобильник телефон смартфон» — все варианты расширяются до полного набора | Подходит для тегов, где нужен перебор вариантов |
| Contraction | «мобильник», «сотовый», «телефон» → «телефон» — все синонимы схлопываются в базовую форму | Оптимален для каталогов товаров, где важен точный результат |
Для Битрикс-каталога предпочтительнее contraction на этапе поиска: индексируем как есть, при поиске схлопываем синонимы в канонический термин. Это даёт точную выдачу без размывания релевантности.
Почему contraction лучше для Битрикс-каталога?
Contraction не требует переиндексации данных — синонимы применяются только в search_analyzer. Вы можете менять словарь хоть каждый день, не затрагивая проиндексированные товары. Expansion, напротив, вынуждает индексировать все возможные варианты, что ведёт к неоправданному росту объёма и снижению точности. Официальная документация Elasticsearch рекомендует использовать contraction для продуктивных систем.
Файл синонимов и его формат
Синонимы хранятся в файле на сервере Elasticsearch или передаются inline в настройках индекса. Файловый подход гибче — можно обновлять словарь без пересоздания индекса. Типичный словарь содержит 300–500 пар синонимов.
Пример словаря синонимов
Файл /etc/elasticsearch/analysis/synonyms_ru.txt:
# Мобильные телефоны мобильник, сотовый, смартфон => телефон iPhone, айфон => телефон Galaxy, галакси => телефон # Ноутбуки ноутбук, лэптоп, laptop => ноутбук MacBook, макбук => ноутбук # Брендовые синонимы Samsung, самсунг, самsung => samsung LG, элджи => lg # Общие термины ТВ, телик, теле => телевизор холодильник, холодос => холодильник # Аббревиатуры ПК, персональный компьютер => компьютер ОЗУ, оперативка, RAM => память Формат файла: term1, term2, term3 => canonical_form для contraction, или term1, term2, term3 для expansion.
Сравнение способов хранения синонимов
| Параметр | Файловый способ | Inline-способ |
|---|---|---|
| Обновление без переиндексации | Да (с updateable: true) | Нет |
| Удобство редактирования | Высокое (через SSH) | Среднее (через API) |
| Размер словаря | Неограничен | Ограничен размером запроса |
| Производительность | Стабильная | Может снижаться при большом словаре |
Как настроить индекс с синонимами
curl -X PUT http://localhost:9200/bitrix_search_s1 \ -H "Content-Type: application/json" \ -d '{ "settings": { "analysis": { "filter": { "russian_stemmer": { "type": "stemmer", "language": "russian" }, "russian_synonyms": { "type": "synonym", "synonyms_path": "analysis/synonyms_ru.txt", "updateable": true } }, "analyzer": { "bitrix_search": { "type": "custom", "tokenizer": "standard", "filter": [ "lowercase", "russian_stemmer", "russian_synonyms" ] }, "bitrix_index": { "type": "custom", "tokenizer": "standard", "filter": [ "lowercase", "russian_stemmer" ] } } } }, "mappings": { "properties": { "title": { "type": "text", "analyzer": "bitrix_index", "search_analyzer": "bitrix_search" }, "body": { "type": "text", "analyzer": "bitrix_index", "search_analyzer": "bitrix_search" } } } }' Ключевое: analyzer (для индексации) и search_analyzer (для поиска) разные. Синонимы только в search_analyzer — это правильная практика. При индексации лишние токены не нужны, расширяем выдачу только при поиске.
Как обновить синонимы без переиндексации?
Параметр updateable: true в фильтре синонимов (Elasticsearch 7.3+) позволяет обновить словарь без пересоздания индекса:
# Редактируем файл синонимов nano /etc/elasticsearch/analysis/synonyms_ru.txt # Перезагружаем анализаторы без переиндексации curl -X POST "http://localhost:9200/bitrix_search_s1/_reload_search_analyzers" Это работает только для search_analyzer. Если синонимы в index analyzer — нужна полная переиндексация.
Синонимы через API (без файла)
Для небольших словарей — inline-синонимы прямо в маппинге:
"russian_synonyms": { "type": "synonym", "synonyms": [ "мобильник, сотовый => телефон", "ноутбук, лэптоп => ноутбук", "телик, ТВ => телевизор" ] } Минус: для обновления нужно пересоздать индекс и переиндексировать данные.
Проверка работы синонимов
# Проверить, как search_analyzer обрабатывает запрос curl -X POST "http://localhost:9200/bitrix_search_s1/_analyze" \ -H "Content-Type: application/json" \ -d '{ "analyzer": "bitrix_search", "text": "мобильник самсунг" }' # Ожидаемый ответ: токены "телефон", "samsung" Если синонимы работают правильно, поисковый запрос «мобильник» найдёт документы с токеном «телефон» в индексе.
Пошаговая настройка синонимов для Битрикс
- Соберите семантическое ядро: выделите частотные запросы, по которым товары не находятся.
- Составьте словарь синонимов в формате contraction, используя файл на сервере.
- Настройте маппинг индекса: укажите разные анализаторы для индексации и поиска.
- Примените конфигурацию и перезагрузите поисковые анализаторы.
- Протестируйте выдачу через _analyze и в Битрикс-админке.
- Включите мониторинг: отслеживайте пустые выдачи и корректируйте словарь.
Что входит в настройку синонимов под ключ
- Аудит текущей поисковой схемы и выявление «слепых зон»
- Разработка словаря синонимов под специфику каталога (300–500 пар)
- Настройка анализаторов, маппинга и файлов синонимов
- Обновление конфигурации Elasticsearch без простоя
- Документация по добавлению новых синонимов
- Тестирование и корректировка выдачи
- Передача прав доступа к административной панели управления словарём
Сроки: от 2 до 5 рабочих дней в зависимости от объёма каталога. Стоимость рассчитывается индивидуально. Свяжитесь с нами для консультации и закажите настройку прямо сейчас.
Наш опыт и гарантии
Мы работаем с Elasticsearch в связке с 1С-Битрикс более 5 лет. Выполнили больше 50 проектов по настройке поиска для интернет-магазинов. Гарантируем стабильную работу синонимов без потери производительности — все конфигурации проходят нагрузочное тестирование. Предоставляем сертификат соответствия и бесплатную поддержку в течение месяца после сдачи.
Для углублённого изучения рекомендуем официальную документацию Elasticsearch и Wikipedia о полнотекстовом поиске.