Nasazení na e-shop

Revelor běží nezávisle na vašem e-shopu. Do Shoptetu se neinstaluje, nepotřebuje FTP ani přístup k databázi a jeho provoz zajišťujeme na naší straně.

Aby mohl zákazníkům správně zobrazovat vaše produkty, potřebuje přístup k datům vašeho katalogu. Podle tarifu Shoptetu se napojíme buď přes API, nebo přes XML feedy.

Z vaší strany potřebujeme pět věcí, které najdete hned v následující sekci. O zbytek se postaráme my. Napojíme data, načteme katalog, nastavíme Revelor podle vašeho e-shopu, otestujeme ho a připravíme ke spuštění.

123456Zvětšit

1. 1Napojení na vaše vyhledáváníRevelor se zobrazí přímo ve vašem e-shopu
2. 2Reklamní prostorVlastní banner přímo ve výsledcích vyhledávání
3. 3Produkty, kategorie i obsahVyhledávání nemusí končit u produktů
4. 4Zvýrazněná shodaZákazník vidí, proč produkt odpovídá jeho dotazu
5. 5Cena a dostupnostKlíčové informace vidí ještě před otevřením produktu
6. 6Značky a výrobciRelevantní značky se zobrazí u výsledků

Co od vás potřebujeme

Pět věcí. Když nám je pošlete pohromadě, nasazení se nikde nezdrží.

🔒 Token neposílejte běžným e-mailem ani chatem. Napište nám a předání domluvíme bezpečnou cestou. Adresy XML feedů citlivé nejsou, ty klidně e-mailem. Token můžete v Shoptetu kdykoli zneplatnit, jen nám o tom dejte vědět, ať víme, proč přestala chodit data.

💡 Prodáváte i velkoobchodně? Přibude jen oprávnění Zákazníci (čtení) a přehled ceníků a zákaznických skupin. Podrobně v sekci Prodáváte i velkoobchodně?

Nevíte, jaký tarif máte nebo co přesně vytvořit? Napište nám adresu e-shopu na jsme@webotvurci.cz, zkontrolujeme to za vás a řekneme, co bude potřeba.

Jak se Revelor napojí na váš katalog

Stačí e-shop na Shoptetu a možnost upravit HTML kód šablony, ať už sami nebo přes svého kodéra. Způsob napojení pak závisí na tarifu.

Vyberte, co máte

Mám Shoptet PremiumDoporučenonapojení přes APIMám jiný tarif Shoptetunapojení přes XML feedy

V administraci Shoptetu vytvořte privátní API token a povolte mu pouze čtecí přístup k potřebným datům. Sloupec Zápis nechte prázdný u všech skupin. Revelor data z vašeho e-shopu pouze čte a produkty, ceny ani objednávky neupravuje.

Oprávnění, která potřebujeme:

• Produkty — povinné. Katalog, kategorie, značky, varianty, dostupnost a štítky.
• Ceny a slevy — povinné. Aby ve výsledcích seděly ceny i přeškrtnuté akční ceny.
• Sklady — povinné. Skladem, vyprodáno a množství.
• Objednávky — doporučené pro analytiku a řazení podle bestsellerů. Bez nich Revelor funguje, jen nepozná, co se opravdu prodává.
• Informace o článcích — volitelné, pokud má vyhledávání nabízet i blog a poradnu.
• Zákazníci — pouze pro velkoobchodní scénáře s cenami podle zákazníka. Běžný e-shop tuto skupinu nepotřebuje.

Ostatní skupiny oprávnění, tedy Nastavení, Doklady, Hodnocení a Zásilky, nepotřebujeme.

Zvětšit

Po uložení nám token předejte bezpečným způsobem, tedy ne běžným e-mailem ani chatem. Napište nám a předání domluvíme. Token můžete v administraci Shoptetu kdykoli zneplatnit, jen nám o tom dejte vědět, ať víme, proč přestala chodit data.

Co tím získáte: změny v katalogu se propisují během minut, dostupnost je průběžně aktuální, doporučování pracuje naplno a v analytice uvidíte i tržby z vyhledávání.

Nevíte, jaký tarif nebo způsob napojení máte? Napište nám adresu e-shopu na jsme@webotvurci.cz, zkontrolujeme to za vás a řekneme, co bude potřeba.

Jak nasazení probíhá

Nasazení má osm kroků a u každého je vidět, kdo ho má na starosti. Rozklikněte si ty, které vás zajímají.

1

Podklady k založení e-shopuVyAdresa e-shopu, přístup k datům a e-maily lidí, kteří budou Revelor používat.

Abychom mohli váš e-shop založit v Reveloru, potřebujeme tohle:

Co	K čemu to je
Adresa e-shopu	Podle ní e-shop založíme. Interní identifikátory si dohledáme sami.
Přístup k datům	API token, nebo adresy XML feedů podle vašeho tarifu
E-maily lidí, kteří budou Revelor používat	Na ně založíme účty do administrace Reveloru
Způsob, jak se do e-shopu dostane kód	Buď ho vložíte sami (krok 4), nebo nám dáte přístup do administrace a vložíme ho my

Než nám cokoli pošlete, ověřte si dvě věci:

• Přístup patří k tomu e-shopu, který nasazujeme. U více domén nebo jazykových mutací se to snadno splete a pozná se to až podle toho, že se ve výsledcích objeví cizí sortiment.
• Přístup je čtecí. Revelor si data z e-shopu jen čte a produkty, ceny ani objednávky neupravuje.

Chcete vložení kódu nechat na nás? Pak nám v administraci Shoptetu vytvořte účet s přístupem jen k šabloně a HTML kódům, tedy k sekci Vzhled a obsah. Přístup k objednávkám, zákazníkům, fakturaci ani k nastavení plateb a dopravy nepotřebujeme. Účet můžete zrušit, jakmile je nasazeno.

💡 Chcete si přístupy podržet celé u sebe? Nemusíte nám dávat do administrace nic. Stačí přístup k datům a čtyři řádky do šablony si vložíte sami.

2

Účty do ReveloruMyÚčty zakládáme my na e-maily, které nám pošlete. Vy si pak změníte heslo a zapnete dvoufázové ověření.

Účty do Reveloru si nezakládáte sami. Vytvoříme je my na e-maily, které nám pošlete, a přístupové údaje vám předáme.

Co udělejte hned po prvním přihlášení:

1. Změňte si heslo ve svém profilu na takové, které používáte jen tady.
2. Zapněte si dvoufázové ověření. V profilu se zobrazí QR kód, který načtete do ověřovací aplikace v telefonu, například Google Authenticator, Microsoft Authenticator nebo 1Password. Od té chvíle se kromě hesla zadává i šestimístný kód.

Kdo co smí:

Role	Co může
Klient	Pracovat s vyhledáváním a doporučováním svého e-shopu, tedy nastavení, analytika a běžný provoz
Správce	To co klient, a navíc přidávat a spravovat kolegy s rolí klient
Prohlížející	Jen se dívat. Vhodné pro externisty a agentury, které mají vidět čísla, ale nemají do nastavení sahat

Chcete-li přidat dalšího kolegu a nemáte roli správce, napište nám.

ℹ️ Přidání dalšího e-shopu jde vždy přes nás. Nový e-shop ani jazykovou mutaci si do Reveloru nepřidáte sami, protože potřebuje napojení na data a přípravu na naší straně. Napište nám a postupujeme podle tohoto průvodce znovu, jen s tím rozdílem, že účty už máte.

3

Napojení a načtení kataloguMyNapojíme e-shop, načteme produkty a nastavíme jazyk, měnu a vzhled výsledků.

Tenhle krok je celý na nás a u velkých katalogů zabere i několik hodin.

Co v něm děláme:

• načteme produkty, kategorie, značky a články a zkontrolujeme, že sedí počty,
• nastavíme jazyk vyhledávání a formát cen podle vašeho e-shopu,
• připravíme podobu výsledků a našeptávače tak, aby odpovídala designu vašeho webu,
• projdeme první testovací dotazy a doladíme, co nesedí.

Ozveme se vám, až bude připravený kód pro šablonu.

4

Vložení kódu do šablonyVyČtyři řádky do hlavičky šablony. FTP ani programátor nejsou potřeba.

Od nás dostanete čtyři řádky. Vloží se v administraci Shoptetu do Vzhled a obsah → HTML kód → Hlavička a uloží. VAS-ESHOP v ukázce nahrazuje označení, které dostanete od nás.

<link rel="stylesheet" href="https://cdn.revelor.app/VAS-ESHOP/revelor.min.css">
<link rel="stylesheet" href="https://cdn.revelor.app/VAS-ESHOP/revelor-additional.css">
<script src="https://cdn.revelor.app/VAS-ESHOP/revelor.min.js"></script>
<script src="https://cdn.revelor.app/VAS-ESHOP/revelor-additional.js"></script>

Víc není potřeba. Skript si sám najde vyhledávací pole v šabloně a napojí se na něj.

Na co si dát pozor:

• Každá jazyková mutace má vlastní kód. Prodáváte-li na více doménách nebo v mutacích, dostanete pro každou samostatné čtyři řádky. Nezaměňujte je, jinak by mutace hledala v cizím katalogu. Jak Revelor pracuje s jazyky, popisuje kapitola Jazyky a mutace.
• Vkládejte jen jednou. Vložíte-li kód omylem na dvě místa, může se našeptávač zobrazit dvakrát.
• Řádky nepřepisujte ani nezkracujte. Adresy vypadají podobně, liší se ale označením e-shopu a názvem souboru.
• Máte-li šablonu na míru, předejte řádky svému kodérovi s tím, že patří do hlavičky na všech stránkách e-shopu.

ℹ️ FTP už není potřeba. Dřívější verze Reveloru vyžadovaly nahrání souborů na FTP e-shopu. Dnes se soubory načítají z naší strany, takže nové verze naskakují samy a vložený kód se v čase nemění.

5

Testovací režimMy + vyRevelor běží na ostrém e-shopu, ale vidíte ho jen vy. Zákazníci nakupují postaru.

Nový vyhledávač nechcete pustit na zákazníky naslepo. Proto e-shop zpravidla nasazujeme nejdřív v testovacím režimu. Revelor uvidí jen ten, kdo je přihlášený do administrace Shoptetu. Ostatní návštěvníci mezitím používají původní vyhledávání.

Jak si to ověříte:

1. Přihlaste se do administrace svého e-shopu.
2. Ve stejném prohlížeči otevřete e-shop a začněte psát do vyhledávacího pole. Uvidíte našeptávač Reveloru.
3. Otevřete e-shop v anonymním okně, kde přihlášení nejste. Tam zůstává původní vyhledávání.

Testovací režim zapínáme a vypínáme my, takže nám stačí napsat a nastavíme ho podle toho, jak nasazení potřebujete rozvrhnout.

💡 Přecházíte z jiného vyhledávače? Nechte si testovací režim, dokud si nové výsledky neprojdete. Obě řešení můžou po dobu testu běžet vedle sebe, zákazníci vidí to staré a vy to nové.

6

Kontrola před spuštěnímVyProjdete e-shop jako zákazník a řeknete nám, co vám nesedí.

Nemusí to být důkladný test. Projděte to, co byste u sebe nechtěli vidět.

• Našeptávač — vyskočí při psaní a nabízí produkty, kategorie i značky.
• Výsledky — vyzkoušejte pět svých typických dotazů, jeden s překlepem a jeden podle katalogového čísla.
• Ceny — formát i výše odpovídají e-shopu, u zlevněných produktů sedí i přeškrtnutá cena.
• Dostupnost — skladem i nedostupné odpovídá skutečnosti.
• Odkazy — kliknutí na výsledek vede na správný produkt, u variant na správnou variantu.
• Mobil — otevřete vyhledávání i na telefonu.
• Jazykové mutace — každá hledá ve svém katalogu, ve svém jazyce a ve své měně.
• Souhlas s cookies — projděte si, jak má váš souhlasový panel nastavenou analytiku, a podle toho nás nasměrujte. Co se v Reveloru děje na které úrovni souhlasu, rozebírá kapitola Soukromí a souhlas.

Co vám nesedí, napište nám jedním souhrnem a ideálně přidejte dotaz, který jste zadali, a co jste čekali.

7

Ostrý startMy + vyVypneme testovací režim, vy vypnete původní vyhledávání.

Když je vše odsouhlasené, pustíme Revelor všem zákazníkům.

1. Vypneme testovací režim. Od té chvíle vidí Revelor každý návštěvník.
2. Vy vypnete původní vyhledávání. Používáte-li jiné vyhledávací řešení, ukončete ho až teď a ne dřív, ať e-shop není ani minutu bez vyhledávání. Nativní vyhledávání Shoptetu vypínat nemusíte, Revelor ho nahradí a v případě výpadku se zákazník vrátí k němu.
3. První dny sledujte přehled v Reveloru, hlavně podíl dotazů bez výsledků a nejhledanější dotazy.

8

Nastavení a správa v ReveloruVyJeden účet, všechny vaše e-shopy, u každého vlastní nastavení i analytika.

Máte-li e-shopů víc, případně víc jazykových mutací, najdete je všechny pod jedním přihlášením a přepínáte mezi nimi jedním kliknutím v záhlaví.

Každý e-shop je samostatný. Má vlastní data, vlastní analytiku i vlastní nastavení. Když u jednoho změníte pravidla řazení nebo přidáte synonymum, ostatních se to nedotkne.

Co si nastavujete sami:

Chci…	Kam jít
vidět, co zákazníci hledají a co nenacházejí	Přehled a Analytika
aby zákazník našel produkt i pod jiným názvem	Synonyma, Přepsání dotazu
dostat vybrané produkty ve výsledcích nahoru	Pravidla řazení
změnit, co se zákazníkovi nabízí a kde	Doporučení
upravit filtry a texty ve vyhledávacím poli	Filtry, Nastavení vyhledávače

Nemusíte se to učit dopředu. U každé sekce je v Reveloru nápověda, která vysvětlí, co dělá a jak ji nastavit, a než cokoli pustíte ven, ukáže vám náhled, jak to dopadne. Podrobnosti najdete i tady v dokumentaci, v kapitolách Vyhledávání, Doporučování a Analytika.

Celé technické nasazení zajišťujeme my. Z vaší strany jsou potřeba přístupy k datům, krátký zásah do šablony a závěrečná kontrola.

Jak vypadá administrace

Takhle vypadá úvodní přehled po přihlášení.

1234Zvětšit

1. 1Všechny e-shopy pod jedním účtemPřepnutí jedním kliknutím
2. 2Přehled na první pohledKolik lidí hledá, co našli a co koupili
3. 3Cesta zákazníka k objednávceVidíte, kde se návštěvníci ztrácejí
4. 4Sekce pro každou oblastVyhledávání, doporučování, reklama i data produktů

Co funguje hned a co si můžete doladit

Revelor je použitelný hned a nemusíte kvůli tomu nic nastavovat, protože se to podstatné odvodí při napojení podle vašeho e-shopu.

• jazyk a měna včetně formátu cen a textů v našeptávači,
• vyhledávání odolné vůči překlepům a tvarům slov,
• filtry poskládané z parametrů, které u produktů reálně máte,
• řazení podle relevance a průběžné učení podle toho, na co zákazníci klikají,
• doporučování na hlavní stránce, v detailu produktu i v košíku.

Zároveň platí, že přenastavit jde prakticky všechno, od synonym a přepsání dotazů přes pořadí výsledků a vzhled filtrů až po to, co a kde se doporučuje.

Čím začít

Po prvním přihlášení vás v Reveloru přivítá průvodce První kroky, pár minut čtení o tom, co má smysl udělat nejdřív. Pokud ho zavřete, najdete ho kdykoli přes vyhledávání v administraci (Ctrl+K).

Doporučené pořadí vypadá takhle.

1. První dny se jen dívejte. Přehled a Analytika vám ukážou, kolik lidí hledá a co nenacházejí.
2. Pak dotazy bez výsledků. Za každým je buď chybějící synonymum, nebo produkt, který v nabídce nemáte.
3. Potom pořadí výsledků. Když víte, co se hledá nejčastěji, má smysl doladit, co se u těch dotazů zobrazí nahoře.
4. Nakonec doporučování a doplňky. Oblíbené, porovnání a doporučené produkty mají smysl, až když samotné vyhledávání sedí.

Prodáváte i velkoobchodně?

Pokud vedle koncových zákazníků obsluhujete i velkoobchod, na způsobu napojení to nic nemění. Variantu si vyberete podle tarifu stejně jako ostatní a přibude jen pár věcí navíc.

Co k tomu potřebujeme:

• Oprávnění Zákazníci (čtení), aby přihlášený zákazník viděl cenu podle svého ceníku a skupiny.
• Přehled ceníků a zákaznických skupin, tedy kdo má co vidět a za kolik.
• Rozhodnutí o nepřihlášeném návštěvníkovi. Uvidí ceny, nebo výzvu k přihlášení? Smí přidat do košíku?
• Vyhrazený sortiment, tedy jestli část zboží nemá být vidět nikomu mimo velkoobchod.

Co pak Revelor umí: skrýt ceny nepřihlášeným, respektovat ceníky a zákaznické skupiny, ukázat každému segmentu jiné výsledky, schovat vyhrazený sortiment, nahradit tlačítko do košíku výzvou k registraci a odlišit velkoobchodní režim barvou. Podrobně to popisuje stránka B2B režim vyhledávání.

ℹ️ Máte velkoobchod na samostatné doméně nebo mutaci? Pak je to v Reveloru samostatný e-shop s vlastními daty, nastavením i analytikou. Najdete ho pod stejným přihlášením a přepnete se do něj jedním kliknutím.

Bezpečnost

Bezpečnost bereme vážně, a proto od vás potřebujeme jen minimum oprávnění. Přístup k datům je čtecí, do e-shopu Revelor nezasahuje a heslo k vaší administraci k ničemu nepotřebujeme.

Co po vás nebudeme chtít:

• heslo k vašemu hlavnímu účtu v administraci,
• právo zápisu do dat e-shopu,
• údaje platební karty,
• kód z SMS nebo z ověřovací aplikace.

Jak poznáte, že píšeme opravdu my. Naše zprávy chodí z domén @webotvurci.cz a @revelor.cz, systémové z adresy noreply@revelor.cz. Pokud dostanete zprávu z jiné adresy, i kdyby vypadala podobně, ověřte si ji u nás dřív, než na ni zareagujete. Kontakt najdete na faktuře nebo na těchto stránkách.

Přístupy zůstávají pod vaší kontrolou. Token v Shoptetu můžete kdykoli zneplatnit a účet zrušit, jen nám o tom dejte vědět, ať víme, proč přestala chodit data.

🔒 Zapněte si dvoufázové ověření. V Reveloru i v administraci Shoptetu. Je to nejjednodušší způsob, jak si přidat druhou pojistku pro případ, že by heslo někam uniklo.

Změny na e-shopu po nasazení

Časem se e-shop mění. Přijde nová šablona, přibude jazyková mutace, občas se změní i doména. Následující přehled shrnuje, co to pro Revelor znamená.

Nasazujete novou šablonu. Po nasazení zkontrolujte, že v ní zůstaly čtyři řádky Reveloru. Při výměně šablony se vlastní úpravy nemusí přenést. Dejte nám vědět předem a projdeme to s vámi.

Měníte doménu. Napište nám dřív, než se změna projeví. Přenastavíme napojení i adresy, na které Revelor odkazuje ve výsledcích.

Přidáváte jazykovou mutaci nebo další e-shop. Založíme ho jako samostatný e-shop v Reveloru a dostanete pro něj vlastní čtyři řádky. Účty už máte, takže jde jen o napojení dat.

Měníte tarif Shoptetu. Pokud přejdete na Premium, můžeme datové napojení převést z XML feedů na API. Kód v šabloně zůstává beze změny.

Chcete Revelor vypnout. Odeberete čtyři řádky ze šablony a e-shop se vrátí k vyhledávání Shoptetu. V šabloně po Reveloru nic nezůstane. Jak naložit s daty, která u nás k vyhledávání vznikla, si domluvíme.

Připraveni začít?

O zbytek se postaráme my. Pokud si nejste jistí, jaký tarif nebo způsob napojení máte, napište nám adresu e-shopu na jsme@webotvurci.cz. Zkontrolujeme to za vás a řekneme přesně, co bude potřeba.