For the complete documentation index, see llms.txt. This page is also available as Markdown.

Raventic

Modul Raventic přináší do vašeho e-shopu:

  • Chytré sémantické vyhledávání produktů

  • Vyhledávací dropdown s našeptávačem přímo ve vyhledávacím poli

  • Přehlednou stránku výsledků hledání s filtry

  • Analytiku chování zákazníků při vyhledávání

  • Zobrazení kategorií a článků ve výsledcích

Kde najdu modul?

Modul je nutné nejprve nainstalovat ve Správci rozšíření.

Co je sémantické vyhledávání?

Na rozdíl od běžného vyhledávání, které hledá pouze přesné shody slov, sémantické vyhledávání rozumí významu dotazu. Když zákazník napíše „červené boty na léto", najde relevantní produkty i když v názvu nemají přesně tato slova.

Kde najdu nastavení

1

Otevřete nastavení

V hlavním menu klikněte na Nastavení.

2

Najděte Raventic

Vyhledejte sekci Raventic (nebo klikněte na ikonu lupy).

3

Otevřete nastavení modulu

Otevře se nastavení modulu s těmito záložkami:

  • Obecné - aktivace a základní nastavení

  • Dropdown - nastavení našeptávače

  • Výsledky hledání - nastavení stránky s výsledky

  • Pokročilé - jazyk, měna a vlastní styly

Aktivace a propojení

1

Získání API klíče

Přihlaste se do administrace Raventic a zkopírujte váš API klíč (typicky začíná prefixem regionu, např. „euc…").

2

Nastavení v e-shopu

Otevřete Nastavení → Raventic.

Na záložce Obecné vyplňte:

  • API klíč - vložte klíč z administrace Raventic

  • Aktivovat Raventic na e-shopu - zapněte přepínač

Klikněte Uložit.

Volba funkcí

Po zadání API klíče si můžete vybrat, které funkce chcete aktivovat:

  • Vyhledávací dropdown - chytré tipy přímo ve vyhledávacím poli

  • Widget na stránce výsledků - přehledná stránka s filtry a výsledky

  • Raventic Analytics - měření a analytika vyhledávání

Všechny funkce lze zapínat a vypínat nezávisle na sobě.

Vyhledávací dropdown

Co je vyhledávací dropdown?

Dropdown je „našeptávač", který se zobrazí pod vyhledávacím polem, jakmile zákazník začne psát. Nabízí:

  • Nalezené produkty s obrázky a cenami

  • Kategorie odpovídající dotazu

  • Články z blogu

  • Doporučené a oblíbené produkty

Nastavení chování

Na záložce Dropdown můžete nastavit:

Zobrazení obsahu:

  • Zobrazit bestsellery / oblíbené produkty - ukáže doporučené produkty před zadáním dotazu

  • Zobrazit stav skladu - u produktů se zobrazí dostupnost

  • Zobrazit kategorie - v dropdownu se objeví i odpovídající kategorie

  • Zobrazit články - zahrne do výsledků i články z blogu

Počet výsledků:

  • Počet výsledků v dropdownu - kolik produktů se zobrazí (výchozí: 10)

Úprava textů

Pokud chcete změnit výchozí texty, zaškrtněte Upravit texty a popisky. Můžete upravit:

  • Placeholder ve vyhledávání - text v prázdném poli (např. „Napište, co hledáte")

  • Uvítací zpráva - zobrazí se před zadáním dotazu

  • Text při žádných výsledcích - když nic nenajdeme

  • Text tlačítka „zobrazit vše" - pro přechod na stránku výsledků

  • Nadpisy sekcí - produkty, kategorie, články, doporučené

  • Popisek tlačítka produktu - typicky „Detail" nebo „Do košíku"

Stránka výsledků hledání

Jak funguje?

Widget na stránce výsledků nahradí standardní zobrazení vyhledávání. Zákazník získá:

  • Přehledný výpis nalezených produktů

  • Filtrování podle kategorií, výrobců a ceny

  • Možnost řazení výsledků

  • Responzivní zobrazení na všech zařízeních

Nastavení chování

Na záložce Výsledky hledání nastavíte:

Základní nastavení:

  • Počet produktů na stránku - kolik produktů se zobrazí najednou (výchozí: 60)

  • Zobrazit filtr výrobců - přidá filtrování podle značek

  • Zobrazit stav skladu - u produktů se zobrazí dostupnost

Úprava textů

Zaškrtněte Upravit texty a popisky pro změnu:

  • Titulek výsledků - text nad výsledky, např. „Hledáte: ..."

  • Titulek bez dotazu - když zákazník otevře stránku bez zadání

  • Nadpisy filtrů - výrobce, cena, filtry

  • Texty tlačítek - zobrazit filtry, zrušit filtry

Analytika

Co měří Raventic Analytics?

Analytika sleduje, jak zákazníci používají vyhledávání:

  • Co zákazníci hledají

  • Na které výsledky klikají

  • Které dotazy nevrací výsledky

  • Jak úspěšné je vyhledávání

Aktivace analytiky

1

Zapněte analytiku

Na záložce Obecné zapněte Zapnout Raventic Analytics.

2

Načtení měřicího kódu

Měřicí kód se automaticky načte na všech stránkách e-shopu.

3

Zobrazte data

Data najdete v administraci Raventic.

Pokročilé nastavení

Jazyk a měna

Na záložce Pokročilé můžete nastavit:

  • Locale - kód jazyka (např. cs-CZ, sk-SK, en-US)

  • Měna - kód měny (např. CZK, EUR)

  • Počet desetinných míst u ceny - kolik míst za čárkou

Pokud necháte prázdné, použijí se hodnoty z nastavení e-shopu.

Query parametr

  • Query parametr (URL) - název parametru v URL pro vyhledávání (výchozí: q)

Příklad: vaseshop.cz/hledat?q=boty

Vlastní styly

Pole Vlastní CSS styly umožňuje upravit vzhled widgetů:

  • Barvy tlačítek a odkazů

  • Velikosti písma

  • Skrytí nebo zobrazení prvků

Často kladené otázky

Obecné

Q: Kde získám API klíč?

A: API klíč získáte v administraci Raventic po registraci a aktivaci účtu.

Q: Musím používat všechny funkce?

A: Ne, každou funkci (dropdown, stránka výsledků, analytika) můžete zapínat a vypínat nezávisle.

Q: Funguje Raventic i na mobilních zařízeních?

A: Ano, všechny widgety jsou plně responzivní a fungují na všech zařízeních.

Vyhledávání

Q: Proč zákazníci nenacházejí některé produkty?

A: Ověřte, že jsou produkty správně naimportované do Raventic. Synchronizace produktů probíhá automaticky.

Q: Mohu ovlivnit, které produkty se zobrazí jako první?

A: Ano, pořadí výsledků můžete ovlivnit v administraci Raventic pomocí pravidel řazení.

Q: Jak dlouho trvá, než se změny projeví?

A: Změny v nastavení se projeví okamžitě. Změny produktů se synchronizují průběžně.

Vzhled

Q: Dropdown se nezobrazuje správně – co dělat?

A: Zkontrolujte, zda máte správně nastavené CSS selektory pro vyhledávací pole. Výchozí hodnoty fungují pro standardní šablonu.

Q: Mohu změnit barvy widgetů?

A: Ano, použijte pole Vlastní CSS styly na záložce Pokročilé.

Q: Widget překrývá jiné prvky na stránce – jak to vyřešit?

A: Pomocí vlastních CSS stylů můžete upravit vrstvení (z-index) nebo pozicování prvků.

Cookies a ochrana osobních údajů

Q: Respektuje Raventic souhlas s cookies?

A: Ano, analytika se načítá pouze pokud zákazník souhlasí s analytickými cookies.

Q: Ukládá Raventic osobní údaje?

A: Raventic zpracovává pouze anonymizovaná data o vyhledávání. Podrobnosti najdete v dokumentaci Raventic.

Last updated