Начало работы с AACSearch за 5 минут

Настроить качественный поиск непросто. Но начать работу — это другое дело. В этом руководстве мы рассмотрим, как добавить AACSearch в ваш проект: от нуля до первого результата поиска менее чем за 5 минут.

Что вам понадобится

Учётная запись AACSearch (бесплатный тариф охватывает до 10 000 документов)
Каталог товаров — CSV, JSON или работающий магазин PrestaShop / Bitrix
5 минут

Шаг 1: Создайте индекс

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

Ваш индекс появится со статусом Активен в течение нескольких секунд.

Шаг 2: Подключите источник данных

Вариант А: Загрузить файл CSV или JSON

Перейдите в Импорт → Загрузить файл. AACSearch автоматически определяет типы полей из ваших данных. Для стандартного каталога товаров он распознаёт поля name, price, description, category и sku без ручного определения схемы.

Загрузите файл с 1000 товарами. Прогресс загрузки отображается в реальном времени — как правило, менее 10 секунд для 1000 документов.

Вариант Б: Подключение через коннектор CMS

Если вы используете PrestaShop или Bitrix, установите нативный модуль-коннектор:

PrestaShop: Администратор → Менеджер модулей → найти «AACSearch» → Установить
Bitrix: Marketplace → AACSearch → Установить

В панели управления AACSearch перейдите в Коннекторы → Новый токен коннектора. Скопируйте токен и вставьте его в настройки модуля в вашей CMS. Нажмите Проверить соединение — вы должны увидеть зелёное подтверждение с именем вашего индекса и количеством документов.

Запустите Полную синхронизацию. Коннектор экспортирует весь ваш каталог товаров, ставит его в очередь и передаёт в индекс. Для каталога из 50 000 товаров ожидайте около 2–3 минут.

Шаг 3: Тестирование поиска на Playground

На панели управления откройте вкладку Playground. Введите название товара или частичный артикул. Вы увидите:

Отсортированные результаты с выделенными совпадениями
Время отклика в миллисекундах (обычно 10–30 мс)
Необработанный JSON-вывод для отладки

Попробуйте ввести слово с опечаткой — AACSearch использует встроенное нечёткое соответствие AACSearch, поэтому aifon всё равно вернёт результаты для iPhone.

Шаг 4: Встройте виджет

Перейдите в раздел Виджет и скопируйте фрагмент кода. Он выглядит следующим образом:

<script
	src="https://app.AACSearch.com/api/widget/widget.js"
	data-index-id="YOUR_INDEX_ID"
	data-api-key="YOUR_SEARCH_KEY"
	data-locale="ru"
	async
></script>

Вставьте этот фрагмент в <head> вашего магазина или перед </body>. Виджет отображает кнопку поиска, которая открывает полноэкранный оверлей поиска — дополнительные CSS или JavaScript не требуются.

Он работает в Shadow DOM, поэтому стили вашего магазина не конфликтуют с внешним видом виджета.

Шаг 5: Проверка в production

Откройте ваш магазин в окне инкогнито и нажмите кнопку поиска. Введите название товара. Вы должны увидеть мгновенные результаты по мере ввода — без перезагрузки страницы, без ожидания.

Поздравляем. Теперь у вас есть полнотекстовый поиск production-уровня.

Что происходит «под капотом»

Когда вы вводите символ, виджет отправляет запрос на публичный endpoint поиска AACSearch, аутентифицированный с помощью API-ключа только для чтения. Запрос обращается к вашей коллекции AACSearch, возвращает отсортированные результаты с поддержкой опечаток и префиксного поиска и отображает их в оверлее — всё это занимает менее 50 мс.

Обновления ваших товаров синхронизируются автоматически. Когда вы меняете цену или добавляете новый товар в CMS, коннектор фиксирует изменение и передаёт его в индекс в течение нескольких минут.

Следующие шаги

Синонимы: Добавьте «телефон → смартфон, мобильный» на вкладке Релевантность, чтобы охватить варианты поисковых запросов
Кюрации: Закрепите конкретные товары, чтобы они отображались первыми по важным запросам
Аналитика: Через неделю трафика изучите отчёты по популярным запросам и нулевым результатам, чтобы найти пробелы

Поиск запущен. Остальное — дело оптимизации.