Интеграция поиска на сайт

После того как проект создан и фид проиндексирован (см. «Фиды → Быстрый старт»), поиск подключается к сайту одним скриптом. Виджет даёт две вещи:

• Поисковую строку с подсказками (autocomplete) — выпадающая панель с товарами, категориями, историей и популярными запросами прямо под полем ввода;
• Полностраничную выдачу (fullpage) — страницу результатов с фильтрами, фасетами и сортировкой.

Виджет — это один самодостаточный JavaScript-файл: стили вшиты внутрь, сборка на стороне сайта не нужна, отдельный CSS подключать не требуется. Работает на любой платформе (1С-Битрикс, Tilda, InSales, CS-Cart, самописная витрина).

Как это устроено

Браузер посетителя                     Searchforce
──────────────────                     ─────────────────────────────
1. <script src=…> ──(HTTP GET)──▶  отдаёт searchforce-widget.js
2. скрипт ждёт DOM и сам
   монтирует виджет по разметке
   (селекторы вшиты при сборке)
3. пользователь ищет  ──(HTTP)──▶  API поиска: apiUrl/api/v1/{projectId}/…
                                    выдача, фасеты, подсказки

Скрипт подключается один раз на все страницы и сам решает, что показать на конкретной: строку поиска в шапке, страницу выдачи или и то и другое — по селекторам привязки.

Два шага установки

1. Подключить скрипт — две строки в <head> (общие для всего сайта).
2. Разметка — пометить поле поиска и контейнер выдачи (или задать селекторы вашей разметки в настройках проекта). Кода инициализации на странице не требуется.

Полная инструкция и ручной режим (SPA) — в «Установке на сайт».

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

Что	Где взять
projectId	Идентификатор проекта в личном кабинете.
Код для установки	Готовый блок для <head> — в личном кабинете: Виджет → «Публикация» → «Код для установки». Внутри адрес скрипта под ваш проект: https://platform.searchforce.ru/widget/{projectId}/searchforce-widget.js.
apiUrl	Адрес API платформы — https://platform.searchforce.ru.
Доступ к шаблонам сайта	Возможность добавить код в <head> и в шаблон страницы поиска.

Внешний вид (карточка товара, тема, скрипты) и состав виджета настраиваются в личном кабинете — в редакторе виджета. Правки публикуются на тот же адрес скрипта автоматически, без изменений на сайте.

С чего начать

• Клиенту — передайте разработчику или интегратору ссылку на «Установку на сайт»: там всё, что нужно вставить, готовым блоком.
• Разработчику / интегратору — начните с «Установки», затем сверьтесь со справочником параметров виджетов и, если нужен свой сценарий перехода по поиску, с «Событиями виджета».
• Чтобы изменить внешний вид — «Редактор виджета»: тема, карточка, скрипты и состав сборки прямо в личном кабинете.
• Чтобы видеть поиск в своей аналитике — «Яндекс.Метрика»: готовый набор целей включается в кабинете, писать код не нужно.
• Чтобы собрать подборку или витрину без виджета — «Подборки и витрины через API»: один запрос к поиску, разметку рисуете сами.
• Если что-то не работает — «Частые ошибки».