Přeskočit na obsah
Platformy

Shopsys

Jak přidat chat Otta do obchodu na Shopsys přes Google Tag Manager nebo agenturu a jak ho povolit v hlavičce Content-Security-Policy.

Na této stránce

Shopsys Platform je systém pro větší internetové obchody, které obvykle staví a spravuje agentura. Pole pro vlastní kód administrace nemá, kód chatu proto přidá agentura přes Google Tag Manager nebo přímo do kódu obchodu a od verze 19 povolí Otta i v hlavičce Content-Security-Policy. Samotné nastavení zabere asi 10 minut.

Co budete potřebovat

  • Účet v Ottovi. Kód chatu najdete v panelu v Přehledu, na kartě Instalace a integrace, na dlaždici Shopsys. Je pod dlaždicí Další platformy, najdete ji i vyhledáváním.
  • Kontakt na agenturu nebo vývojáře, kteří obchod spravují.
  • Pro změnu hlavičky Content-Security-Policy účet superadministrátora. Běžný administrátor část Superadmin nevidí.
  • Při cestě přes Google Tag Manager přístup do kontejneru, který obchod používá.

Kód chatu

Google Tag Manager z vložených značek vyhodí atributy data-, takže by chat neznal svůj klíč. Dlaždice Shopsys vám proto dá krátký zavaděč, který chat spustí i s klíčem. Klikněte na Zkopírovat kód:

<script>(function(){var s=document.createElement('script');s.src='https://ottoai.sk/widget.js';s.async=true;s.setAttribute('data-otto-key','pk_vas_kluc');(document.head||document.documentElement).appendChild(s);})();</script>
V ukázce je místo klíče pk_vas_kluc, dlaždice vám dá kód s vaším klíčem. Klíč není heslo, netřeba ho tajit. Kód stačí vložit jednou, platí pro celý web.

Vložení kódu

Přes Google Tag Manager

  1. V Google Tag Manageru otevřete kontejner obchodu a klikněte na Značky a Nová.
  2. Klikněte na Konfigurace značky, zvolte Vlastní HTML a vložte kód chatu.
  3. V části Spouštění vyberte pravidlo All Pages a značku uložte.
  4. Klikněte na Odeslat a potom na Publikovat.
  5. U Shopsys 19 a novějšího otevřete v administraci Nastavení, Superadmin, Hlavička Content-Security-Policy.
  6. V části script-src přidejte za poslední zdroj mezeru a https://ottoai.sk. Pokud hlavička obsahuje i connect-src, přidejte do něj stejně https://ottoai.sk wss://ottoai.sk.
  7. Klikněte na Uložit změny.

Přímo do kódu obchodu

  1. Pošlete agentuře kód chatu spolu s připraveným e-mailem z této stránky.
  2. Agentura vloží kód do společné šablony obchodu před </body>, aby byl na všech stránkách, a změnu nasadí.
  3. U Shopsys 19 a novějšího otevřete v administraci Nastavení, Superadmin, Hlavička Content-Security-Policy.
  4. V části script-src přidejte za poslední zdroj mezeru a https://ottoai.sk. Pokud hlavička obsahuje i connect-src, přidejte do něj stejně https://ottoai.sk wss://ottoai.sk.
  5. Klikněte na Uložit změny.

Při uložení hlavičky Shopsys sám vymaže uložená nastavení obchodu z cache, cache proto není potřeba mazat ručně.

Shopsys v administraci doporučuje každou změnu hlavičky Content-Security-Policy nejdřív vyzkoušet na vývojovém serveru. Chyba v hlavičce může zablokovat i jiné části obchodu.
Pokud hlavička část connect-src nemá, nepřidávejte ji jen s adresami Otta. Zablokovala by se tím ostatní spojení, která obchod potřebuje.

Postup najdete i v oficiální nápovědě platformy Shopsys.

E-mail pro podporu

Kód vkládá podpora, agentura nebo vývojář? Pošlete jim tento e-mail a pod text vložte kód chatu z dlaždice.

Dobrý den,

prosím o vložení přiloženého kódu chatu Otto na všechny stránky našeho obchodu na Shopsys. Můžete ho přidat přes Google Tag Manager jako značku Vlastní HTML s pravidlem All Pages, nebo do společné šablony před </body>. Kód prosím vložte přesně v tomto tvaru.

Pokud máme Shopsys 19 nebo novější, prosím ještě v Nastavení, Superadmin, Hlavička Content-Security-Policy doplnit https://ottoai.sk do script-src a, pokud hlavička obsahuje connect-src, doplnit do něj https://ottoai.sk a wss://ottoai.sk.

Děkuji.

Ověření

  1. Otevřete svůj web v novém okně prohlížeče a obnovte stránku. Vpravo dole má naskočit bublina chatu.
  2. Napište do chatu zkušební otázku. Otto odpoví za pár sekund.
  3. V panelu v Nastavení, v části Propojení, řádek Váš web ukáže doménu, na které chat běží.
Při cestě přes Google Tag Manager se chat ukáže až po publikování kontejneru.

Katalog produktů

Shopsys má v základu feedy pro Heureku, Zboží, Google a Mergado. Jejich adresy jsou v Integrace, XML Feedy, ve starších verzích v Marketing, XML Feedy. Adresa obsahuje náhodný token, zkopírujte ji celou.

Adresu feedu vložte v panelu v Nastavení, v části Katalog, a klikněte na Ověřit feed. Panel řekne, kolik produktů našel, a Otto si feed pak obnovuje sám. Více v části Katalog produktů.

Když něco nefunguje

V administraci nevidím část Superadmin

Část Superadmin vidí jen účet superadministrátora, který má obvykle agentura. Pošlete jí e-mail z této stránky, hlavičku upraví za vás.

Konzole hlásí, že Content-Security-Policy blokuje widget.js

V části script-src chybí https://ottoai.sk. Doplňte ho v Nastavení, Superadmin, Hlavička Content-Security-Policy a klikněte na Uložit změny.

Konzole hlásí zablokované spojení na wss://ottoai.sk

Výchozí hlavička Shopsys 19 nemá connect-src, pro spojení proto platí default-src a ten spojení přes wss:// nemusí povolit. Přidejte connect-src se stejnými zdroji, jaké má default-src, a k nim wss://ottoai.sk.

Značka v Tag Manageru je publikovaná, ale chat se neukáže

Do Tag Manageru vložte kód přesně ve tvaru z dlaždice Shopsys. Běžný řádek s atributem data-otto-key by Tag Manager pokazil a chat by neznal svůj klíč.

Dále zkontrolujte

  • Obnovte stránku bez mezipaměti klávesami Ctrl+F5 nebo ji otevřete v anonymním okně.
  • Kód má být na stránce jen jednou, druhý se ignoruje.
  • Lišta souhlasu s cookies může skripty zablokovat až do souhlasu. Pokud se chat ukáže až po souhlasu, podívejte se do části Souhlas s cookies.
  • Pokud má web hlavičku Content-Security-Policy, povolte v ní https://ottoai.sk, postup je v části Content-Security-Policy.
  • V konzoli prohlížeče (klávesa F12) hledejte zprávy začínající [Otto]. Řeknou, co chatu chybí.
  • Pořád nic? Napište nám na podpora@ottoai.sk a pošlete adresu webu.

Odstranění chatu

Značku chatu v Google Tag Manageru odstraňte a kontejner znovu publikujte, nebo požádejte agenturu, aby kód odstranila ze šablony. Potom můžete https://ottoai.sk smazat i z hlavičky Content-Security-Policy.