Jak Revelor funguje

Revelor nahrazuje výchozí vyhledávání na vašem Shoptet e-shopu a odhaluje zákazníkům přesně to, co hledají — i když udělají překlep, použijí jiné slovo nebo hledají podle katalogového čísla. Tahle kapitola vysvětluje, z čeho se celé řešení skládá, odkud bere data a co se stane, když se něco nepovede.

Co Revelor umí

Funkce	Co to znamená pro vás
Chytré vyhledávání	Zákazníci najdou produkt i při překlepu nebo synonymu
Okamžité návrhy	Našeptávač zobrazuje výsledky už při psaní
Doporučování produktů	Automaticky nabízí příbuzné a doplňkové produkty
Analytika	Víte, co zákazníci hledají a kde nenacházejí výsledky
Pravidla řazení	Vy rozhodujete, které produkty se zobrazí přednostně
Synonyma	Zákazník napíše „mobil" a najde „smartphone"

Zákazník, který nenajde produkt, odchází jinam. Revelor zajistí, že vyhledávání na vašem e-shopu funguje tak dobře jako na těch největších e-shopech — inteligentně, rychle a bez nutnosti technických znalostí z vaší strany.

Co běží na e-shopu a co na serveru

Revelor je API-first (headless) řešení. To znamená, že veškerá logika běží na serveru Reveloru a e-shop dostává jen čistá data, která si vykreslí ve vlastním designu. Žádné vložené widgety, žádné cizí vizuální prvky, žádná závislost na externím CDN.

Na e-shopu běží jeden JavaScriptový skript, který se vloží do šablony. Ten se stará o:

• napojení na vyhledávací pole e-shopu (našeptávač i stránku s výsledky),
• volání Revelor API a vykreslení výsledků v designu vašeho e-shopu,
• vykreslení bloků s doporučenými produkty tam, kde je chcete mít,
• odesílání anonymních událostí pro analytiku (vyhledávání, kliknutí, přidání do košíku, objednávka).

Na serveru Reveloru běží všechno ostatní — index vašich produktů, vyhodnocení dotazu (synonyma, přepsání dotazu, klíčová slova, fuzzy hledání), pravidla řazení, doporučovací engine, sběr a vyhodnocení analytiky a administrace, do které se přihlašujete.

Praktický důsledek pro vás: vzhled výsledků je 100% v režii šablony e-shopu, takže vyhledávání vypadá jako přirozená součást webu, ne jako přilepený cizí prvek. A protože se nic nevykresluje z cizího widgetu, nemůže výpadek doporučování rozbít načítání stránky.

🔒 Soukromí: Události, které skript odesílá, jsou anonymní. Záznamy vyhledávání neobsahují informace o konkrétních zákaznících — žádnou IP adresu ani identifikátor uživatele. Návštěvník je pro Revelor jen náhodné ID platné po dobu jedné návštěvy.

Jak se data z e-shopu dostávají do Reveloru

Revelor si data z vašeho Shoptetu stahuje sám přes datové feedy. Nemusíte nic exportovat ani nahrávat.

Feed	Co obsahuje
Produkty	Celý produktový katalog včetně cen, dostupnosti, parametrů a štítků
Kategorie	Stromová struktura kategorií
Články	Blogové a informační články (aby je zákazník našel ve výsledcích)
Značky	Přehled výrobců a značek

Synchronizace probíhá automaticky. U každého feedu je v administraci vidět čas poslední synchronizace, počet načtených položek a případné chyby. Po velké hromadné úpravě sortimentu lze synchronizaci spustit i ručně tlačítkem Synchronizovat nyní — v běžném provozu to ale potřebovat nebudete.

Za jak dlouho se změna projeví

Typ změny	Čas projevení
Synonyma, klíčová slova, pravidla řazení	Okamžitě (do 1 minuty)
Nový produkt v Shoptetu	5–15 minut (automatická synchronizace)
Hromadná aktualizace produktů	15–60 minut (nebo ručně přes Synchronizovat nyní)

Provozní jistoty

Když služba neodpoví, e-shop běží dál

Revelor je navržený tak, aby nikdy nerozbil e-shop. Frontend má pro odpověď pevný časový limit (200 ms u doporučení). Pokud Revelor v limitu neodpoví, vrátí chybu nebo je vypnutý, nastane jedna ze dvou věcí:

• příslušný blok se nevykreslí (zákazník prostě nevidí doporučení), nebo
• zobrazí se výchozí výstup Shoptetu — tedy nativní vyhledávání, resp. nativní doporučování.

Stránka se v žádném případě nezasekne a zákazník výpadek nepozná. Služba v takové situaci vrací prázdný výsledek, ne chybu, takže se šablona e-shopu nemá o co „zaseknout".

Zálohování nastavení

Revelor zálohuje nastavení, které jste v administraci nakonfigurovali:

• synonyma, přepsání dotazů a pravidla řazení,
• konfigurační parametry vyhledávače,
• nastavení doporučování.

Zálohu využijete před větší změnou nastavení (jako pojistku), při návratu k funkčnímu stavu po nepovedeném experimentu nebo při přenosu nastavení na jinou instanci. Zálohování spravuje tým Webotvůrců.

Ověření změn dřív, než je uvidí zákazníci

Revelor je stavěný tak, abyste si důsledky změn ověřili ještě před tím, než se projeví na e-shopu:

• Náhled řazení — u pravidel řazení si přímo v administraci zobrazíte, jak se výsledky reálně seřadí, a teprve pak uložíte.
• Testování doporučení — pro zvolené místo (produktová stránka, košík, hlavní stránka) si necháte vypsat, co by Revelor zákazníkovi doporučil a proč, aniž byste museli otevřít e-shop.
• Preview režim na ostrém e-shopu — Revelor i jeho nové funkce lze na produkčním e-shopu zpřístupnit v náhledovém režimu, který vidí jen vy. Zákazníci nakupují postaru, dokud změnu sami nepustíte ven.
• Testovací prostředí — pokud chcete Revelor vyzkoušet nanečisto, nastavíme vám testovací e-shop; stačí napsat na jsme@webotvurci.cz.

Přehled (Dashboard) — co uvidíte po přihlášení

Úvodní stránka administrace shrnuje stav vašeho vyhledávače na první pohled.

Stav vyhledávače

• 🟢 Zelená — vše funguje správně
• 🟡 Žlutá — menší problém, který neovlivňuje funkčnost
• 🔴 Červená — kontaktujte podporu

Klíčové metriky za posledních 7 dní

• Počet vyhledávání — kolikrát zákazníci použili vyhledávač
• Nulové výsledky — procento dotazů bez výsledků (ideálně pod 5 %)
• Proklikovost — jak často zákazníci kliknou na nalezený produkt
• Počet indexovaných produktů — kolik vašich produktů Revelor „zná"

Nejhledanější dotazy — rychlý přehled toho, co zákazníci nejčastěji hledají.

💡 Tip: Vysoké procento nulových výsledků je nejlevnější příležitost ke zlepšení, jakou máte. Podívejte se do záznamů vyhledávání, co zákazníci hledali a nenašli, a doplňte synonymum nebo klíčové slovo.

Orientace v administraci

Sekce	K čemu slouží
Přehled	Stav vyhledávače a klíčové metriky za 7 dní
Metriky & Analytika	Vývoj vyhledávání v čase, top dotazy, dotazy bez výsledků
Vyhledávání (záznamy)	Jednotlivé dotazy zákazníků včetně počtu výsledků
Synonyma	Rozšíření hledání o další výrazy + AI návrhy
Přepsání dotazu	Náhrada překlepů a variant zápisu
Meta & klíčová slova	Skrytá klíčová slova u konkrétních produktů
Nastavení vyhledávače	Placeholder text a počty výsledků v našeptávači
Dostupnost	Práce se skladovou dostupností ve výsledcích
Vyhledávání & Filtry	Filtry, které zákazník vidí u výsledků
Pravidla řazení	Co se má zobrazovat nahoře — přetahovací dlaždice
CTR Scoring	Automatické učení pořadí podle chování zákazníků
Doporučení	Doporučované produkty, jejich testování a analytika
Shoptet feedy	Stav synchronizace dat z e-shopu
Zálohování	Zálohy a obnova nastavení
Systém	Technické metriky a přístupové tokeny pro integrace

Poslední tři sekce jsou technické — jako majitel e-shopu je ovládat nemusíte, stará se o ně tým Webotvůrců.