Kde se doporučení na e-shopu zobrazují, jak je nastavíte, podle čeho Revelor vybírá produkty a jak poznáte, kolik vám doporučování vydělalo.

Vyhledávání odhalí to, co zákazník hledá. Doporučování odhalí to, co ho zajímá, ale ještě o tom neví. Revelor doporučuje na hlavní stránce, v detailu produktu, po přidání do košíku i v samotném košíku — a vždy tak, aby blok vypadal jako přirozená součást vašeho e-shopu.

Doporučení bez widgetu

Revelor je doporučovací jádro, ne widget. Engine vrací čistá data o produktech — název, cena, cena s DPH, obrázek, odkaz, dostupnost, štítky — a vykreslení HTML je plně v režii šablony e-shopu.

Co to znamená v praxi:

Stoprocentní shoda s designem. Blok se skládá ze stejných produktových karet jako zbytek e-shopu. Podle šablony může být mřížka i karusel, s vašimi štítky, cenami i tlačítkem „do košíku".
Žádná externí závislost. Doporučení se nenačítají z cizí CDN a nemohou zablokovat vykreslení stránky.
Nadpis sekce se vrací v jazyce e-shopu, takže bloky fungují i na vícejazyčných e-shopech.

Kde se doporučení zobrazují

Revelor podporuje pět umístění (placementů). Každé má jiný cíl, a proto i jinou logiku výběru.

Umístění	Kde na e-shopu	Cíl a obsah
Hlavní stránka	Homepage, blok „Doporučujeme" / „Trending"	Objevování — trendy, kurátorský výběr, personalizace podle návštěvníka
Detail produktu	Pod produktem, „Mohlo by vás také zajímat"	Cross-sell a up-sell — podobné produkty a alternativy
Po přidání do košíku	Popup „Zboží bylo vloženo do košíku"	Doplňky k právě přidanému produktu
Košík	Košík a pokladna, „Vybráno pro Vás"	Komplementární zboží k aktuálnímu obsahu košíku
Zákazníci také koupili	Detail produktu	Produkty reálně nakupované společně

Jak se umístění konfiguruje

Vše se nastavuje v dashboardu v sekci Doporučení → Nastavení, bez zásahu do kódu e-shopu:

Zapnutí a vypnutí jednotlivých umístění. Umístění „Po přidání do košíku" je ve výchozím stavu vypnuté — dokud ho nezapnete, endpoint vrací prázdný seznam a v popupu zůstane nativní obsah Shoptetu.
Sekce doporučení. Každá sekce je jeden „balík" doporučení s vlastním názvem (např. „Mohlo by se vám líbit"). Sekce může být automatická (podobné produkty, zákazníci také koupili) nebo ruční.
Ruční výběr obsahu. U ruční sekce vyberete konkrétní produkty, kategorie nebo štítky — Revelor pak zobrazuje jen z nich.
Počet produktů. Výchozí počet je 8, maximum 50 na jeden blok.
Váhy a filtry — viz níže.

Přidání ruční sekce: + Přidat sekci → typ obsahu (Produkty / Kategorie / Štítky) → vyhledat a přidat položky → pojmenovat sekci → uložit.

Jak systém vybírá produkty

Výběr není černá skříňka. Každé umístění má vlastní strategii, na ni navazuje bodování a nakonec tvrdá pravidla, přes která produkt neprojde.

1. Strategie podle místa

Detail produktu — podobnost v kontextu. Revelor vychází z produktu, na který se zákazník právě dívá, a hledá k němu nejbližší zboží: silně upřednostní stejnou kategorii, pak stejnou značku a nakonec shodu v parametrech (barva, materiál, rozměr). Zboží, které není skladem, do výběru nevstupuje. Výrazně dražší produkty jsou penalizované, aby nabídka dávala smysl.

Po přidání do košíku. Kotvou je právě přidaný produkt — nabídka doplňuje to, co si zákazník vybral před vteřinou, tedy v momentě nejvyšší ochoty nakoupit.

Košík — komplementární nákup. Pokud je v košíku dražší zboží, Revelor nabízí příslušenství a doplňky v odpovídající cenové hladině. U smíšeného nebo prázdného košíku sáhne po nejúspěšnějších produktech v nižší ceně. Co už zákazník v košíku má, se nikdy nenabízí znovu.

Hlavní stránka — objevování. Nejdřív váš kurátorský výběr, pokud je nastavený. Pak produkty, které aktuálně táhnou. Nový návštěvník bez historie tak vidí trendy a sezónní výběr, vracející se návštěvník výběr přizpůsobený svému chování.

Zákazníci také koupili. Revelor prochází historii dokončených objednávek a hledá zboží, které se reálně kupuje ve stejném nákupu. Když u konkrétního produktu ještě není dost objednávek, tiše se přepne na podobné produkty — sekce nikdy nezůstane prázdná.

2. Bodování: relevance, marže, prodejnost

Kandidáti se seřadí podle skóre, které kombinuje tři složky:

Složka	Co znamená
Relevance	Jak moc produkt sedí do kontextu — kategorie, značka, parametry, obsah košíku
Maržovost	Jak moc chcete tlačit ziskové zboží
Prodejnost	Jak si produkt vede v reálném provozu e-shopu

Poměr mezi nimi si volíte podle obchodního cíle. V dashboardu jsou připravené strategie:

Strategie	Kdy ji zvolit
Vyvážená	Výchozí nastavení — relevance rozhoduje, obchodní cíle dolaďují
Maximalizovat obrat	Chcete zvyšovat hodnotu objednávky
Maximalizovat zisk	Chcete upřednostnit produkty s vyšší marží
Popularita	Chcete tlačit to, co se prodává nejlépe

Bodování má pojistku proti „přebití relevance": obchodní boost nikdy nepřepíše kontext natolik, aby se v doporučeních objevilo nesouvisející zboží. Proto je například nasazená penalizace pro výrazně dražší produkty, než je ten prohlížený.

3. Tvrdá pravidla (co se nikdy nezobrazí)

Nad bodováním stojí pravidla typu ANO/NE, která platí vždy:

Pravidlo	Efekt
Dostupnost	Vyprodané zboží se nedoporučuje
Vyloučené štítky	Zboží s vybranými štítky (např. „II. jakost") se nedoporučuje nikde
Minimální cena	Zboží pod nastavenou hranicí se nedoporučuje (nevyplatí se kvůli dopravě)
Obsah košíku	Produkty, které zákazník už v košíku má, se z nabídky vyřadí

4. Personalizace návštěvníka

Revelor si při první návštěvě založí stabilní identitu návštěvníka uloženou v technické cookie (platnost 1 rok) a vydrží mu i po zavření prohlížeče. Každá interakce — zobrazení bloku, proklik, přidání do košíku, nákup — profil návštěvníka na pozadí aktualizuje. Následující požadavky na doporučení pak vrací výsledky přeřazené podle tohoto profilu.

Když se zákazník na e-shopu přihlásí, Revelor propojí jeho dosavadní anonymní chování s účtem e-shopu, takže personalizace pokračuje napříč zařízeními i návštěvami.

Celé to běží v souladu se souhlasy návštěvníka: bez uděleného souhlasu Revelor žádnou trvalou identitu nezakládá a personalizace se nespouští. Po odvolání souhlasu se identita zneplatní a doporučení se vrátí do neosobního režimu. Podrobnosti k datům a soukromí najdete v kapitole Analytika a měření.

5. Když ještě nejsou data

Doporučování dává smysl od prvního dne, ne až po měsících sbírání dat:

Nový návštěvník dostane doporučení odvozená z kontextu stránky — podobné produkty v detailu, bestsellery v kategorii, trendy a sezónní výběr na homepage, pravidlový cross-sell v košíku.
Nový produkt se prosadí přes podobnost parametrů a kategorie, i když ještě nemá žádné kliky ani prodeje.
Nový e-shop startuje z katalogu — kategorie, parametry, ceny, dostupnost, štítky — a doplňkově z ručního výběru, který si nastavíte v dashboardu. Jakmile začnou přibývat reálné signály, jejich váha automaticky roste.

Bezpečné nasazení: nejdřív si to zkontrolujete vy

Doporučení nemusíte pouštět naostro naslepo.

Testovací nástroj v dashboardu (Doporučení → Testování) ukáže, co Revelor zákazníkovi skutečně vrátí, aniž byste museli otevřít e-shop. Zvolíte umístění, u detailu produktu zadáte konkrétní produkt, u košíku poskládáte modelový obsah košíku, spustíte test a uvidíte výsledek včetně důvodu, proč se produkt vybral. Doporučujeme testovat pokaždé, když měníte nastavení — ověříte si vše dřív, než to uvidí zákazníci.

Umístění se zapínají jednotlivě. Integrace může být v šabloně hotová a připravená, zatímco umístění zůstává vypnuté — na e-shopu se pak nic nezobrazí, dokud ho v dashboardu nezapnete.

Tiché nasazení pro administrátora. Widget jde navíc pustit v režimu, kdy ho na ostrém e-shopu vidí jen přihlášený administrátor. Doporučení si vyladíte na skutečném provozu a skutečných datech — a zákazníkům je zpřístupníte, až budete spokojeni.

Výpadek nikdy nerozbije e-shop. Doporučovací API má tvrdý časový limit 200 ms a je navržené tak, aby vždy vrátilo platnou odpověď — nikdy chybu, která by zasekla stránku.

Situace	Co se stane na e-shopu
Odpověď se nestihne v limitu	Blok se skryje, stránka běží dál
Pro daný kontext není co doporučit	Blok se skryje
Umístění je vypnuté	Blok se nezobrazí; v popupu po přidání do košíku zůstane nativní obsah Shoptetu
Cokoli selže	Zákazník nic nepozná — žádná chyba, žádné zaseknutí

Košík se přepočítává průběžně

Doporučení v košíku pracují s aktuálním obsahem košíku, ne s tím, co v něm bylo při načtení stránky. Seznam položek se sbírá při otevření košíku a znovu při každé jeho změně, takže po přidání nebo odebrání zboží se nabídka přepočítá na nový obsah. Pokud by informace o obsahu košíku chyběla, Revelor bezpečně sklouzne k nejprodávanějším produktům — nabídka tedy nikdy nezůstane prázdná, jen bude méně cílená.

Jak se měří přínos

Doporučování v Reveloru je měřitelné od zobrazení až po zaplacenou objednávku. Každá odpověď nese vlastní identifikátor, přes který se řetězí celá cesta:

Událost	Kdy se zaznamená
Zobrazení	Blok s doporučeními se dostal do viditelné části obrazovky
Proklik	Zákazník klikl na doporučený produkt
Přidání do košíku	Doporučený produkt skončil v košíku
Nákup	Objednávka byla dokončena — včetně její hodnoty

Co uvidíte v dashboardu

V sekci Doporučení → Přehled a Doporučení → Analytika:

Počet zobrazení doporučovacích bloků
Proklikovost (CTR) doporučení — zdravá hodnota se pohybuje nad 5–8 %
Přidání do košíku pocházející z doporučení
Atribuovaný obrat — celková hodnota nákupů, které začaly klikem na doporučení
Počet nákupů, které z doporučení vznikly
Podíl na tržbách — kolik z celkového obratu e-shopu jde za doporučeními
Nejúspěšnější doporučované produkty

Pokud jsou čísla nízká, obvykle pomůže změnit obsah sekcí, jejich pořadí nebo umístění bloku na stránce.

Vyhledávání vs. doporučení — kdo objednávku přinesl

Revelor u každého přidání do košíku zaznamenává, odkud přišlo. Rozlišuje mimo jiné vyhledávání, výsledkovou stránku, doporučení, hlavní stránku, detail produktu a košík. K tomu se drží první zdroj v návštěvě a celý řetězec interakcí, kterými zákazník prošel.

Díky tomu se dá odpovědět na otázku, kterou samotný počet prokliků nezodpoví: přinesla objednávku vyhledávání, nebo doporučení? A když obojí — v jakém pořadí. Vedle toho dashboard porovnává konverzní poměr návštěvníků, kteří vyhledávali, s těmi, kteří ne. Detailně to popisuje kapitola Analytika a měření.

Data do GA4 a GTM

Doporučení posílají do datové vrstvy standardní e-commerce události, takže je můžete číst v GA4 nebo přes Google Tag Manager posílat dál:

view_item_list — když se blok s doporučeními načte (včetně identifikace umístění a seznamu produktů)
select_item — když zákazník na doporučený produkt klikne

Měření v Reveloru a měření v GA4 tak běží vedle sebe: v dashboardu máte čísla vázaná na konkrétní umístění a strategii, v GA4 je zapojíte do svých vlastních reportů a atribučních modelů.

Integrace na e-shopu

Doporučení se do šablony vkládají jako prázdný kontejner, který si Revelor naplní daty; vykreslení je na straně šablony. Integraci zpravidla nemusíte řešit sami — zajistí ji tým Webotvůrců při nasazení.

Pro vývojáře: doporučení vrací veřejný endpoint, který nevyžaduje API klíč, jen identifikaci e-shopu. Minimální podoba požadavku vypadá takto:

GET /api/public/recommendations/smart
  ?placement=product_detail
  &product_id=<guid-produktu>
  &visitor_id=<id-navstevnika>

{
  "items": [
    {
      "id": "<guid-produktu>",
      "name": "Název produktu",
      "price": 1299.0,
      "currency": "CZK",
      "image_url": "https://…",
      "url": "https://…",
      "in_stock": true,
      "reason_code": "similar_category"
    }
  ],
  "strategy_used": "similar_products",
  "tracking_id": "rec_…",
  "fallback_used": false
}

Pole tracking_id je klíčové — provazuje zobrazení, proklik, přidání do košíku i nákup do jednoho měřitelného řetězce. Pole reason_code a strategy_used říkají, proč se produkt zobrazil; nejde o černou skříňku.

Doporučování produktů