Код SearchBooster

Код SearchBooster — небольшой скрипт, который вставляется на все страницы сайта один раз. Через него работают поисковый виджет, кнопки «Похожие» по фото, ИИ-консультант и «Спросить о товаре». Что показывать на сайте, вы включаете и настраиваете в личном кабинете — код при этом переустанавливать не нужно.

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

Код на сайте сам ничего не рисует. Он подгружает файлы вашего проекта с нашего CDN, а они — всё остальное:

Ваш сайт
 └─ Код SearchBooster (вставлен один раз)
     └─ main.js — настройки вашего проекта, публикуются из личного кабинета
         └─ init.js — общее ядро виджетов SearchBooster
             ├─ поисковый виджет (если настроен)
             └─ widgets-config.js — модули из кабинета:
                 ├─ кнопки «Похожие» по фото
                 ├─ ИИ-консультант
                 └─ кнопка «Спросить о товаре»

main.js обновляется, когда вы публикуете поисковый виджет (раздел Поисковый виджет). Если поиск SearchBooster вам не нужен, опубликуйте базовый код: раздел Код SearchBooster → Опубликовать без поиска. Он не рисует ничего сам — только подключает модули. Уже опубликованный поиск можно выключить переключателем Поиск в списке модулей там же: трекер и остальные модули продолжат работать, а включить поиск обратно можно тем же переключателем.
widgets-config.js обновляется при каждом сохранении модуля в кабинете. Изменения видны на сайте в течение 5 минут.

Установка

В личном кабинете откройте Код SearchBooster и нажмите Скопировать.

Вставьте код в <head> всех страниц сайта:

<script data-skip-moving="true">
  var sbRegionId = '';   // регион посетителя, как в фиде
  var sbUserId = '';     // ваш ID пользователя (необязательно)
  var sbSegmentId = '';  // сегмент (необязательно)
  var sbScript = document.createElement('script');
  sbScript.src = 'https://cdn2.searchbooster.net/scripts/widget/PROJECT_UUID/main.js';
  sbScript.setAttribute('data-sb-init-script', 1);
  sbScript.async = true;
  document.head.appendChild(sbScript);
</script>

Через Google Tag Manager — тег «Пользовательский HTML» с триггером «All Pages». В 1С-Битрикс оставьте атрибут data-skip-moving="true": без него Битрикс переносит скрипт в конец страницы.

Если ещё не публиковали поиск — настройте его в разделе Поисковый виджет или нажмите Опубликовать без поиска на странице Код SearchBooster.
Включите нужные модули в кабинете и проверьте установку (ниже).

Необязательно: строки <link rel="preconnect"> в начале <head> заранее открывают соединение с нашими серверами и ускоряют первую загрузку. Они есть в кабинете под кодом, в блоке Ускорить загрузку.

Переменные

Переменная	Зачем
`sbRegionId`	ID региона из фида — цены и наличие в выдаче, регион каталога для ИИ-консультанта. Подробнее — Регионы.
`sbUserId`	Ваш ID пользователя. Если не задан, создаётся свой и хранится в cookie `searchbooster_v2_user_id`.
`sbSegmentId`	Сегмент посетителя (опт/розница, VIP) — для правил мерчандайзинга.

Проверка

В кабинете на странице Код SearchBooster вставьте адрес страницы сайта в блок Проверить установку. Быстрая проверка за несколько секунд найдёт код в HTML, полная откроет сайт в браузере и проверит, что виджеты появились.
Справа на той же странице — список модулей и их состояние: что включено, то и работает через код.
Сами: во вкладке Network браузера должны загрузиться main.js, init.js и widgets-config.js с кодом 200, а в консоли window.searchbooster — не undefined.

Трекер событий

Трекер собирает просмотры, корзину и покупки для рекомендаций и статистики. Через Код SearchBooster его можно подключить без отдельного тега: в кабинете на странице Код SearchBooster включите Трекер событий. У новых проектов переключатель включён сразу; в проектах, созданных раньше, включите его сами. Если трекер уже стоит на сайте отдельно, второй раз он не запустится, так что переключатель можно не трогать.

Свой код

Через Код SearchBooster можно запускать и свой JavaScript на выбранных страницах, с проверкой в одном браузере перед публикацией — см. Свой код.