Настройка Elasticsearch-синонимов для поиска 1С-Битрикс

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

Синонимы в Elasticsearch — это связка между пользовательским словарём и реальными терминами в индексе. Они реализуются через token filter synonym в анализаторе. Мы настраиваем их под ключ: от сбора словаря до финальной проверки выдачи. Наши сертифицированные инженеры с 5+ лет опыта гарантируют корректную конфигурацию без потери производительности.

Где синонимы в цепочке Elasticsearch

Синонимы добавляются как token filter в анализатор. Они могут работать двумя способами:

Для Битрикс-каталога предпочтительнее contraction на этапе поиска: индексируем как есть, при поиске схлопываем синонимы в канонический термин. Это даёт точную выдачу без размывания релевантности.

Почему contraction лучше для Битрикс-каталога?

Contraction не требует переиндексации данных — синонимы применяются только в search_analyzer. Вы можете менять словарь хоть каждый день, не затрагивая проиндексированные товары. Expansion, напротив, вынуждает индексировать все возможные варианты, что ведёт к неоправданному росту объёма и снижению точности. Официальная документация Elasticsearch рекомендует использовать contraction для продуктивных систем.

Файл синонимов и его формат

Синонимы хранятся в файле на сервере Elasticsearch или передаются inline в настройках индекса. Файловый подход гибче — можно обновлять словарь без пересоздания индекса. Типичный словарь содержит 300–500 пар синонимов.

# Мобильные телефоны
мобильник, сотовый, смартфон => телефон
iPhone, айфон => телефон
Galaxy, галакси => телефон

# Ноутбуки
ноутбук, лэптоп, laptop => ноутбук
MacBook, макбук => ноутбук

# Брендовые синонимы
Samsung, самсунг, самsung => samsung
LG, элджи => lg

# Общие термины
ТВ, телик, теле => телевизор
холодильник, холодос => холодильник

# Аббревиатуры
ПК, персональный компьютер => компьютер
ОЗУ, оперативка, RAM => память

Сравнение способов хранения синонимов

Как настроить индекс с синонимами

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"

Если синонимы работают правильно, поисковый запрос «мобильник» найдёт документы с токеном «телефон» в индексе.

Пошаговая настройка синонимов для Битрикс

1. Соберите семантическое ядро: выделите частотные запросы, по которым товары не находятся.
2. Составьте словарь синонимов в формате contraction, используя файл на сервере.
3. Настройте маппинг индекса: укажите разные анализаторы для индексации и поиска.
4. Примените конфигурацию и перезагрузите поисковые анализаторы.
5. Протестируйте выдачу через _analyze и в Битрикс-админке.
6. Включите мониторинг: отслеживайте пустые выдачи и корректируйте словарь.

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

• Аудит текущей поисковой схемы и выявление «слепых зон»
• Разработка словаря синонимов под специфику каталога (300–500 пар)
• Настройка анализаторов, маппинга и файлов синонимов
• Обновление конфигурации Elasticsearch без простоя
• Документация по добавлению новых синонимов
• Тестирование и корректировка выдачи
• Передача прав доступа к административной панели управления словарём

Сроки: от 2 до 5 рабочих дней в зависимости от объёма каталога. Стоимость рассчитывается индивидуально. Свяжитесь с нами для консультации и закажите настройку прямо сейчас.

Наш опыт и гарантии

Мы работаем с Elasticsearch в связке с 1С-Битрикс более 5 лет. Выполнили больше 50 проектов по настройке поиска для интернет-магазинов. Гарантируем стабильную работу синонимов без потери производительности — все конфигурации проходят нагрузочное тестирование. Предоставляем сертификат соответствия и бесплатную поддержку в течение месяца после сдачи.

Для углублённого изучения рекомендуем официальную документацию Elasticsearch и Wikipedia о полнотекстовом поиске.