Пользователь вводит «мобильник» — товар не найден. Пробует «сотовый» — снова пусто. Каталог из 50 000 позиций, но поиск упёрся в лексический барьер: в названиях товаров только «телефон». Такая ситуация — типичная боль интернет-магазинов на 1С-Битрикс. Результат — потерянные продажи и высокий процент отказов. Наш опыт показывает: добавление синонимов Elasticsearch сокращает число пустых выдач на 30–50% и увеличивает конверсию поиска на 15–25%. Для магазина со средним чеком 3 000 ₽ и 10 000 запросов в день это дополнительная выручка до 15 000 ₽ в сутки.
Синонимы в 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 о полнотекстовом поиске.