Перейти до основного вмісту

Підключення через фіди

Детальна покрокова інструкція для підключення Spefix через XML-фід товарів. Підходить для будь-якої платформи.

⏱ Час: 15-20 хвилин

Крок 1: Реєстрація​

Через email​

  1. Перейдіть на spefix.com
  2. Натисніть "Спробувати безкоштовно" або "Увійти" (в верхньому меню)
  3. Заповніть форму:
    • Email — обов'язково
    • Номер телефону — обов'язково (для зв'язку з менеджером)
    • ПІБ — опційно
  4. Перевірте пошту → скопіюйте пароль → увійдіть в кабінет

Через Google​

  1. Натисніть "Увійти через Google"
  2. Виберіть акаунт
  3. Введіть номер телефону (обов'язкове поле)
  4. Готово — ви в кабінеті

Крок 2: Створити домен​

  1. У кабінеті знайдіть кнопку "Створити домен" (в хедері)

Кнопка створення домену

  1. У модальному вікні введіть URL вашого сайту
    Приклад: https://myshop.com.ua

Модальне вікно створення домену

  1. Натисніть "Створити"
Важливо

Вказуйте справжній домен сайту, на якому хочете підключити пошук. Віджет працюватиме тільки на цьому домені.

Якщо потрібно підключити пошук на кілька сайтів — створіть окремий домен для кожного.

Крок 3: Підготувати фід товарів​

Spefix працює з XML-фідами товарів у двох форматах:

Варіант 1: Google Merchant Center (рекомендовано)​

Якщо у вас вже є фід для Google Shopping — він підійде.

📖 Вимоги до фіду Google Merchant

Варіант 2: Формат Spefix​

Можете створити фід за нашими правилами для кращої релевантності.

📖 Формат Spefix

Де взяти фід?

Зазвичай фід генерується автоматично у вашій CMS:
Налаштування → Експорт → Google Merchant / Розетка / Prom

Не розумієте що таке фід?

Або не знаєте де його взяти? Зверніться до нашої підтримки — проконсультуємо і допоможемо отримати фід для вашої платформи.

💬 Telegram: @spefix_pm • 📧 [email protected]

Крок 4: Додати фід у Spefix​

  1. У кабінеті перейдіть: Налаштування пошуку → Інтеграція
  2. Натисніть "Додати фід"

Кнопка додавання фідів

  1. У формі заповніть:
    • URL фіду — посилання на ваш XML-файл
      Приклад: https://myshop.com.ua/feed.xml
    • Мова фіду — виберіть зі списку (українська, російська...)

Кнопка завантаження фідів

  1. Натисніть "Створити"
Важливо

Вказуйте справжнє посилання на фід, яке генерує ваша CMS. Не просто додавайте /feed.xml до домену — це не спрацює.

Фід має бути доступний за посиланням і містити XML-дані ваших товарів.

Виникли труднощі?

Немає вашої мови в списку? Або фід не додається через помилку?

Зверніться до підтримки — додамо мову індивідуально та допоможемо розібратись з помилками фіду.

💬 Telegram: @spefix_pm • 📧 [email protected]

Крок 5: Дочекатись завантаження​

Після додавання фід почне завантажуватись та індексуватись.

Статус можна побачити в розділі Інтеграція:

  • Опрацювання — фід завантажується (5-15 хв для великих каталогів)
  • Готово — можна тестувати пошук
  • Помилка — зверніться до менеджера

Перевірити роботу пошуку​

Коли фід завантажено, у профілі з'явиться кнопка "Демо" — можете протестувати пошук по вашим товарам прямо в кабінеті.

Помилка завантаження?

Якщо фід не додається — зверніться до менеджера в Telegram або через чат. Допоможемо розібратись.

Крок 6: Встановити код на сайт​

  1. Перейдіть у розділ "Підключення"
  2. Скопіюйте код віджету з вашого кабінету:

Поле для копіювання скрипта

<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=uk"></script>
  1. Вставте код перед закриваючим тегом </body> на вашому сайті
Важливо

Копіюйте код тільки з вашого особистого кабінету — для кожного сайту генерується індивідуальний токен. Код з прикладів не спрацює!

Для багатомовних сайтів​

Якщо у вас кілька мовних версій сайту, для кожної потрібен окремий код з відповідним параметром lang=:

  • Українська версія: lang=uk
  • Російська версія: lang=ru
  • Англійська версія: lang=en

Приклад:

<!-- Для української версії -->
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=uk"></script>

<!-- Для англійської версії -->
<script async src="https://smartsearch.spefix.com/spefix.js?token=YOUR_TOKEN&lang=en"></script>
Виникли проблеми?

Не знаєте де вставити код або виникли помилки? Зверніться до підтримки — допоможемо з встановленням.

💬 Telegram: @spefix_pm • 📧 [email protected]

Крок 7: Налаштувати селектори кнопки​

Щоб віджет відкривався при кліку на вашу кнопку пошуку, потрібно прописати селектор цієї кнопки.

Знайти селектор кнопки​

  1. Відкрийте ваш сайт
  2. Натисніть F12 (консоль розробника)
    Або клікніть правою кнопкою миші → "Переглянути код"

Відкриття консолі розробника

  1. Виберіть інструмент "Вибрати елемент" (стрілка в лівому верхньому куті)

  2. Клікніть на кнопку пошуку на вашому сайті

  3. У коді знайдіть class або id цієї кнопки

Знаходження селектора в коді

Приклади селекторів:

  • .search__input — клас
  • #search-btn — ID

Додати селектор у Spefix​

  1. Перейдіть: Налаштування пошуку → Встановлення
  2. Знайдіть блок "Список селекторів при кліку на який відображається віджет"
  3. Натисніть "Додати селектор"

Додавання селектора в Spefix

  1. Введіть ваш селектор (наприклад, .search__input)
  2. Натисніть галочку праворуч від поля (завершити редагування)
  3. Якщо кнопок пошуку кілька — додайте кожен селектор окремо

Додавання селектора в Spefix - крок 2

Зберегти зміни​

  1. Прокрутіть вниз сторінки
  2. Натисніть "Зберегти" (кнопка з'явиться після змін)

Зберегти налаштування

Не впевнені в селекторах?

Якщо виникли труднощі зі знаходженням або додаванням селекторів — зверніться до підтримки. Ми допоможемо знайти правильні селектори або налаштуємо їх за вас.

💬 Telegram: @spefix_pm • 📧 [email protected]

Крок 8: Перевірити роботу​

  1. Відкрийте сайт в анонімній вкладці (Ctrl+Shift+N / Cmd+Shift+N)
    Це потрібно, щоб обійти кеш браузера

  2. Клікніть на кнопку пошуку → має відкритися віджет Spefix ✅

  3. Спробуйте різні варіанти пошуку

Віджет не відкривається?

Перевірте в анонімній вкладці — через кеш браузера зміни можуть не відобразитись одразу.

Якщо не допомагає — зверніться до менеджера, допоможемо налаштувати селектори.

Готово! 🎉​

Spefix працює на вашому сайті.

Що далі?​

Потрібна допомога?​

💬 Telegram: @spefix_pm
📧 Email: [email protected]

Ваш персональний менеджер проконсультує, допоможе з налаштуваннями або підключить пошук за вас.

Тестовий період

14 днів безкоштовно — без картки, скасувати можна будь-коли