К содержимому
Записаться

Напишите нам

hello@searchforce.io

Записаться на демо

30 минут онлайн, покажем поиск на вашем каталоге

Как подключить

От вас нужна ссылка на фид каталога. Если фида нет, поможем его настроить: подскажем, что выгрузить, или сделаем сами. Остальное сделаем мы, а если у вас свои разработчики, подключим поиск вместе с ними.

План подключения по дням: что делаете вы и что делаем мы
  1. День 0  после демо Вы: ссылка на фид Мы: каталог, скрипт, дизайн под сайт, заказы
  2. Дни 1–3  Мы: синонимы и правила под каталог
  3. Проверка  Вы: смотрите поиск по ссылке Мы: правим по замечаниям
  4. Запуск  Мы: открываем поиск покупателям
  5. Каждую неделю  Мы: разбираем запросы и правим выдачу

Подключение по дням в рабочем чате

  1. День 0

    Магазин · 10:02

    Вот фид, который отдаём в Маркет: ваш‑магазин.ru/yml.xml

    Команда SearchForce · 12:40

    Каталог загрузили, поставили скрипт и сделали поиск под ваш дизайн. Покупатели его пока не видят, посмотрите по ссылке: ваш‑магазин.ru/?sf_widget_demo=1

    Магазин · 13:05

    Доступ к Метрике нужен?

    Команда SearchForce · 13:12

    Желательно, хватит гостевого: сравним месяц до поиска и месяц с поиском. Корзины и заказы настроим в скриптах виджета, в шаблоны сайта ничего добавлять не придётся.

  2. Дни 1–3

    Команда SearchForce · ср 11:30

    Завели синонимы и правила под ваш каталог. Например, по «треникам» теперь находятся спортивные брюки.

  3. Проверка

    Магазин · чт 16:40

    На телефоне карточки крупноваты.

    Команда SearchForce · чт 17:05

    Поправили и опубликовали, обновите страницу по той же ссылке.

  4. Запуск

    Команда SearchForce · пт 10:00

    Открыли поиск всем покупателям.

  5. Каждую неделю

    Команда SearchForce · пн 09:12

    Отчёт за неделю

    «подарочная карта»
    связали с сертификатами
    «кеды на липучке»
    показываем похожие
Пример переписки в рабочем чате. Отчёт приходит по понедельникам в Telegram и на почту.

Подключаем на любой платформе

Нужен только стандартный фид каталога в формате YML, на любой CMS и на самописном сайте. Скорее всего, он у вас уже есть: тот же, что для Яндекс Маркета или Директа. Для 1С‑Битрикс есть готовый модуль, он сам собирает фид.

  • 1С-Битрикс модуль
  • WordPress
  • WooCommerce
  • Tilda
  • OpenCart
  • InSales
  • MODX
  • Shopify
  • CS-Cart

Данные и безопасность

Для поиска нужен только товарный фид. Имена, телефоны и адреса покупателей остаются у вас.

Покупатели
Посетителя поиск различает только по анонимному идентификатору в браузере, без имени и контактов.
Сайт
Поиск работает на наших серверах в России, база сайта не нагружается. Скрипт грузится в фоне и не задерживает страницу.
Если отключиться
Уберите скрипт, и поле поиска снова работает по-старому. Корзины и заказы мы настраиваем в скриптах виджета, так что в шаблонах сайта убирать больше нечего.

Для разработчиков

Подключение можем сделать мы. Если у проекта свои разработчики, вот что им доступно.

Базовое подключение. Две строки в <head>. Поле поиска виджет находит сам по настройкам в кабинете, товары с фильтрами открываются поверх страницы, отдельная страница выдачи не нужна. Код с адресом вашего проекта есть в кабинете.

<link rel="preconnect" href="https://platform.searchforce.ru/">
<script async src="https://platform.searchforce.ru/widget/ВАШ-PROJECT-ID/searchforce-widget.js"></script>

SPA. Ручной режим: приложение само подключает поиск к своим элементам и снимает его при смене экрана.

<script>
  let search
  function sfInit() {
    search = SearchForceWidget.autocomplete.init({ input: '.my-search' })
  }
  // при смене экрана: search.dispose(), на новом экране снова sfInit()
</script>
<script async data-sf-manual onload="SearchForceWidget.ready(sfInit)"
  src="https://platform.searchforce.ru/widget/ВАШ-PROJECT-ID/searchforce-widget.js"></script>

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

// Кабинет → Виджет → Код виджета → Скрипты
import { defineTenantScripts } from '@searchforce/runtime'

const track = (event) => (window.SearchForceWidget = window.SearchForceWidget || []).push(event)

export default defineTenantScripts(() => {
  // кнопка «В корзину» на сайте
  document.addEventListener('click', (e) => {
    const btn = e.target.closest('.add-to-cart')
    if (btn) track(['addToCart', { objectId: btn.dataset.id, amount: btn.dataset.price }])
  })

  // страница «Спасибо за заказ»
  const order = document.querySelector('[data-order-id]')
  if (order) track(['purchase', { orderId: order.dataset.orderId, amount: order.dataset.total }])
})

Обновление каталога. Выгрузка пересобрала фид, сайт попросил его обновить, и поиск забирает новые цены и наличие. Токен проекта есть в кабинете.

curl -X POST https://platform.searchforce.ru/api/v1/ВАШ-PROJECT-ID/feed/refresh \
  -H "Authorization: Bearer ВАШ-ТОКЕН"

API поиска. Тот же поиск, что у виджета, для своих витрин и приложений.

curl -X POST https://platform.searchforce.ru/api/v1/ВАШ-PROJECT-ID/search \
  -H "Content-Type: application/json" \
  -d '{ "query": "кросовки", "hitsPerPage": 8 }'
Документация для разработчиков →

Сайт и код

Сайт на Vue или React. Подойдёт?

Да.

Для сайтов-приложений есть ручной режим, пример кода во вкладке «SPA» выше, подробности в документации.

Нужен ли токен для API поиска?

Нет.

Запросы к поиску открыты, как у виджета на сайте. Токен нужен только сайту, чтобы попросить нас обновить каталог.

Каталог

Фид закрыт паролем. Это проблема?

Нет.

Укажите логин и пароль или заголовок авторизации, и мы будем забирать фид с ними.

Каталог большой и часто меняется. Когда поиск увидит изменения?

После обновления фида: по расписанию или по сигналу сайта.

Если фид однажды придёт пустым, в поиске останется прежний каталог.

У нас разные города, склады или оптовый прайс. Это учтётся?

Да, по наличию.

Если в фиде у товара указан город, склад или прайс, сайт сообщает виджету выбор покупателя, и поиск показывает только доступные ему товары.

Доступы

Какие доступы нужны и кто их получает?

Ссылка на фид обязательна, остальное по ситуации.

Доступ к админке сайта или по SSH нужен, если скрипт ставим мы; если ставят ваши разработчики, он не нужен. Гостевой доступ к Метрике желателен: по нему сравниваем месяц до поиска и месяц с поиском. Доступы получает команда подключения SearchForce.

Полная инструкция по подключению есть в документации, а всё, что умеет поиск, на странице «Возможности».

Покажем на демо, как подключим ваш магазин

30 минут онлайн. Заранее посмотрим ваш сайт и каталог и на демо пройдём план подключения по дням.

Ближайшее время, по Москве

или напишите нам на  hello@searchforce.io

Запись на демо

30 минут онлайн. Перед встречей посмотрим поиск на вашем сайте и покажем, где он теряет покупателей.

День и время по Москве

Посмотрим поиск заранее и придём с разбором

Как с вами связаться

Пришлём сюда ссылку на встречу

Не подходит время? Напишите нам на hello@searchforce.io