Návod k integraci

Shopio

Našeptávač adres Launify nasadíte do Shopia přes vestavěný modul Google Tag Manager – přidáte tag s kódem Launify a namapujete pole košíku.

Doba implementace
20 min
Způsob nasazení
JS Snippet
Aktualizováno
4. listopadu 2026

V kostce

  • Našeptávač adres Launify se do Shopia nasazuje přes Google Tag Manager, bez programátora.
  • Modul Google Tag Manager je od verze Shopio 3.0 součástí základní verze e-shopu.
  • Kód Launify se v GTM vloží jako tag typu Vlastní HTML a projeví se až po publikování kontejneru.
  • Košík Shopia běží na doméně e-shopu, takže se skript načte i tam.
  • Celé nastavení včetně mapování polí košíku zabere zhruba 20 minut.

Našeptávač adres pro Shopio od Launify nasadíte přes Google Tag Manager (GTM), který Shopio podporuje jako vestavěný modul. Launify je našeptávač adres pro e-shopy: zákazník v košíku začne psát ulici, vybere adresu z návrhů a Launify doplní město a PSČ. V Shopiu zapnete GTM, v kontejneru přidáte tag s kódem Launify a namapujete pole adresy v košíku. Celé nastavení zabere zhruba 20 minut a nepotřebujete k němu programátora.

Co našeptávač adres přinese e-shopu na Shopiu

  • Méně chybných adres. Zákazník vybírá z existujících adres místo ručního psaní, takže ubude překlepů v ulici, čísle domu i PSČ.
  • Rychlejší košík. Po výběru návrhu se adresa vyplní najednou, což ocení hlavně zákazníci na mobilu.
  • Plná kontrola v GTM. Našeptávač můžete omezit jen na košík nebo kdykoli vypnout, aniž byste sahali do administrace e-shopu.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Účet v Google Tag Manageru s kontejnerem pro váš web. Pokud GTM už používáte, použijte stávající kontejner.
  • Přístup do administrace Shopia.
Krok 1

Vytvořte API klíč v administraci Launify

  1. Přihlaste se do administrace Launify.
  2. Klikněte na Integrace → Vytvořit klíč.
  3. Vyplňte název klíče a domény vašeho 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).

Krok 2

Zapněte Google Tag Manager v Shopiu

Pokud máte GTM v Shopiu už zapnutý, tento krok přeskočte.

  1. V administraci Shopia otevřete nastavení modulů a najděte modul Google Tag Manager v části analytiky.
  2. Modul aktivujte a zadejte ID svého kontejneru ve tvaru GTM-XXXXXXX.
  3. Nastavení uložte.

Od verze Shopio 3.0 je modul Google Tag Manager součástí základní verze e-shopu. Pokud ho ve své administraci nenajdete, kontaktujte podporu Shopia.

Krok 3

Přidejte našeptávač adres pro Shopio jako tag v GTM

  1. V Google Tag Manageru otevřete svůj kontejner 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, nebo pro úspornější variantu spouštěč omezený na URL košíku obsahující /kosik.
  4. Tag uložte a klikněte na Odeslat, aby se kontejner publikoval.

Pokud na e-shopu používáte cookie lištu Shopia, která předává souhlasy do GTM, ověřte, že se tag Launify spouští i bez souhlasu s marketingovými cookies. Našeptávač slouží k vyplnění objednávky, ne k měření. Podrobnosti najdete v návodu Google Tag Manager.

Krok 4

Namapujte pole košíku

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.

ÚdajCo v mapování nastavit
Ulice a číslo domupole, do kterého zákazník píše adresu, je to vstup našeptávače
Městopole pro město nebo obec
PSČpole pro PSČ

Přesné atributy polí zjistíte v prohlížeči: v košíku klikněte pravým tlačítkem na pole a zvolte Prozkoumat. Pokud má košík zvlášť doručovací a fakturační adresu, přidejte pro každou samostatnou mapovací skupinu. Když si nebudete vědět rady, napište nám na chat nebo e-mail a mapování nastavíme za vás.

Jak ověřit, že našeptávač funguje

  1. Vložte zboží do košíku a přejděte k vyplňování doručovací adresy.
  2. Začněte psát ulici do pole adresy. Měly by se objevit návrhy adres.
  3. Po výběru návrhu zkontrolujte, že se správně doplnilo město a PSČ.

Časté otázky

Proč se našeptávač do Shopia vkládá přes Google Tag Manager?

Shopio má Google Tag Manager jako vestavěný modul, takže je to nejjednodušší cesta, jak na stránky e-shopu dostat vlastní skript bez úprav šablony a bez programátora. Navíc můžete v GTM přesně určit, na kterých stránkách se kód načte, a skript kdykoli vypnout bez zásahu do administrace e-shopu.

Jak dlouho trvá nasazení našeptávače na Shopio?

Zhruba 20 minut. Pokud už máte v Shopiu zapnutý modul Google Tag Manager, zvládnete to rychleji, protože stačí vytvořit API klíč, přidat jeden tag a kontejner publikovat. Zbytek času zabere namapování polí košíku a zkušební vyplnění adresy.

Můžu použít kontejner GTM, který už na webu mám?

Ano. Pokud už GTM v Shopiu používáte například pro měření nebo reklamy, žádný nový kontejner nezakládejte. Stačí do stávajícího kontejneru přidat nový tag typu Vlastní HTML s kódem Launify a kontejner publikovat. Ostatní tagy tato změna nijak neovlivní.

Funguje našeptávač i na slovenském Shopiu?

Ano. Cílovou zemi nastavíte v kódu přes funkci updateCountry dvoupísmenným ISO kódem, tedy SK pro Slovensko a CZ pro Česko. Pokud provozujete e-shopy pro oba trhy na různých doménách, vytvořte pro každou samostatný tag se správnou zemí a obě domény povolte u API klíče.

Zpomalí skript Launify můj e-shop?

Ne výrazně. Skript se načítá asynchronně, takže neblokuje vykreslení stránky, a je optimalizovaný na rychlost. Pokud chcete zátěž minimalizovat úplně, nastavte v Google Tag Manageru spouštěč jen pro stránky košíku. Na ostatních stránkách se pak skript vůbec nenačte a zákazník rozdíl nepozná.

Hledáte obecný postup pro jinou platformu? Podívejte se na návod Vlastní integrace. Přehled všech podporovaných platforem najdete v článku Launify teď funguje na více než 20 e-shopových platformách.

Nebudete si vědět rady?

Napište nám a integraci nastavíme společně.

Napsat podpoře

Zdroje