Shopsys Platform

1. Přihlaste se do administrace Launify.
2. Klikněte na Integrace → Vytvořit klíč.
3. Vyplňte název klíče a všechny domény e-shopu, na kterých má klíč fungovat, a klikněte na Uložit.
4. Na řádku s klíčem klikněte na symbol </> a zkopírujte kód z vyskakovacího okna.

Zkopírovaný kód už obsahuje váš API klíč. Vypadá zhruba takto:

<script>
(function(){
  function init() {
    if(window.Launify) return;
    var s = document.createElement("script");
    s.src = "https://cdn.launify.com/launify.min.js?t=" + Date.now();
    s.async = true;
    s.onload = function() {
      try {
        var launifyInstance = new Launify('YOUR_API_KEY_HERE');
        launifyInstance.updateCountry('CZ');
        launifyInstance.init();
      } catch(e) { console.error(e); }
    };
    document.head.appendChild(s);
  }
  if(document.readyState === "loading") {
    document.addEventListener("DOMContentLoaded", init);
  } else {
    init();
  }
})();
</script>

Pokud kód kopírujete odsud, nahraďte YOUR_API_KEY_HERE svým klíčem a v updateCountry('CZ') nastavte cílovou zemi e-shopu (ISO kód, např. SK, PL, HU, DE). Pro každou doménu s jinou zemí vytvořte samostatný tag.

Storefront Shopsys Platform načítá GTM na všech stránkách včetně košíku. ID kontejneru se nastavuje proměnnou prostředí GTM_ID, případně pro jednotlivé domény GTM_ID_1, GTM_ID_2 a dalšími. Pokud ji máte nastavenou, stačí:

1. V Google Tag Manageru otevřete kontejner e-shopu a klikněte na Tagy → Nový.
2. Jako typ tagu zvolte Vlastní HTML a vložte kód zkopírovaný z Launify.
3. Jako spouštěč vyberte All Pages.
4. Tag uložte a kontejner publikujte tlačítkem Odeslat.

Storefront je aplikace v Next.js a mezi stránkami přechází bez úplného načtení. Kód Launify obsahuje pojistku, aby se při opakovaném spuštění nenačetl vícekrát. Po nasazení proto ověřte, že se návrhy adres zobrazí i po přechodu do košíku z jiné stránky e-shopu. Podrobnější popis nastavení tagu najdete v návodu Google Tag Manager.

Tento krok přeskočte, pokud jste použili GTM.

• Shopsys Platform 13 a novější (storefront v Next.js): vývojář vloží skript do <Head> v souboru project-base/storefront/pages/_document.tsx, nebo ho přidá jako komponentu next/script do AppPageContent.tsx, která obaluje všechny stránky. Jako vzor poslouží existující PageHeadScripts.tsx.
• Shopsys Framework 12 a starší (šablony Twig): v administraci otevřete Nastavení → Měřící skripty → Přehled skriptů, přidejte nový skript, vložte kód a u Umístění skriptu zvolte Po obsahu (na všech stránkách).

V administraci Launify klikněte na Integrace a sjeďte k části Mapování vstupů a výstupů. První mapovací skupina je už připravená, upravte ji podle polí vašeho košíku nebo přidejte další. Pole můžete zadat podle atributu id, name, class nebo data atributu.

V aktuálním storefrontu je adresa ve formuláři kontaktních údajů (/objednavka/kontaktni-udaje) a pole mají tyto atributy name:

Pro fakturační a doručovací adresu vytvořte dvě samostatné mapovací skupiny. Pokud máte košík upravený, ověřte si názvy v prohlížeči (pravým tlačítkem na pole → Prozkoumat). Když si nebudete vědět rady, napište nám a mapování nastavíme za vás.