Rychlý start

Vítejte v dokumentaci UpSearch - inteligentní vyhledávací platformy pro e-shopy. Tato příručka vás provede základním nastavením a integrací.

Co je UpSearch?

UpSearch je cloudová vyhledávací služba navržená speciálně pro e-shopy. Pomáhá zákazníkům rychle najít produkty díky:

• Inteligentnímu autocomplete s fuzzy matching
• Fulltextovému vyhledávání s podporou synonym a překlepů
• Pokročilé relevanci s boostováním značek a kategorií
• Analytice pro pochopení chování zákazníků

Začínáme ve 3 krocích

Krok 1: Získejte přístup

Kontaktujte nás pro vytvoření účtu a získání přístupových údajů:

• Email: info@praguebest.cz
• Web: praguebest.cz

Po vytvoření účtu obdržíte:

• Přístup do administrace
• API token pro integraci
• Jedinečné ID projektu

Krok 2: Importujte produkty

Propojte váš e-shop s UpSearch pomocí XML feedu nebo REST API.

Varianta A: XML Feed (doporučeno)

Stačí nám poskytnout URL vašeho produktového feedu. Podporujeme standardní formáty:

• Heureka XML
• Google Merchant Center
• Facebook Catalog
• Vlastní XML formát

Varianta B: REST API

curl -X POST https://api.upsearch.cz/v2.0.0/products \
  -H "Authorization: Bearer VAS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "12345",
    "name": "Pánské tričko Classic",
    "price": 499,
    "category": "Oblečení > Trička",
    "brand": "Nike",
    "image": "https://vas-eshop.cz/images/tricko.jpg",
    "url": "/produkt/tricko-classic"
  }'

Více v sekci Import dat.

Krok 3: Integrujte do webu

Vložte UpSearch plugin do vašeho e-shopu:

<!-- 1. Styly -->
<link href="https://cdn.upsearch.cz/projects/PROJEKT/upsearch.css" rel="stylesheet" />

<!-- 2. Plugin -->
<script src="https://cdn.upsearch.cz/projects/PROJEKT/upSearchSuggest.js"></script>

<!-- 3. Inicializace -->
<script>
  window.upSearchSuggest('#search-input', {
    resultsPageUrlPath: '/vysledky-hledani',
    apiToken: 'VAS_API_TOKEN',
  });
</script>

Nahraďte:

• PROJEKT - vaše ID projektu
• #search-input - selektor vašeho search inputu
• VAS_API_TOKEN - váš API token

Kompletní průvodce: Instalace pluginu

Klíčové funkce

Funkce	Popis
Autocomplete	Návrhy během psaní s fuzzy matching
Fulltext	Relevantní výsledky s podporou synonym
Varianty	Správa master produktů a variant
Boostování	Zvýraznění značek a kategorií
Filtry	Facetové filtrování výsledků
Analytika	Přehledy hledaných dotazů

Architektura systému

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│     Váš web     │────▶│   UpSearch API  │────▶│  Elasticsearch  │
│   (Frontend)    │     │    (Backend)    │     │    (Search)     │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │                       ▼
        │               ┌─────────────────┐
        │               │   Administrace  │
        │               │  my.upsearch.cz │
        │               └─────────────────┘
        │
        ▼
┌─────────────────┐
│  UpSearch CDN   │
│    (Plugin)     │
└─────────────────┘

Hlavní komponenty:

1. UpSearch CDN - Hostuje frontend plugin (autocomplete, SERP)
2. UpSearch API - Backend pro vyhledávání a správu dat
3. Elasticsearch - Vyhledávací engine
4. Administrace - Webové rozhraní pro konfiguraci

Další kroky

Nastavení vyhledávání

Konfigurace relevance, synonym a boostování pro lepší výsledky.

Pokračovat

API Reference

Kompletní dokumentace REST API s příklady.

Prozkoumat API

Potřebujete pomoc?

• Email: info@praguebest.cz
• Administrace: my.upsearch.cz
• FAQ: Často kladené otázky