Návod k integraci

Shopion

Našeptávač adres Launify nasadíte do Shopionu bez programátora – vložíte skript do pole Obsah před </head> a namapujete pole košíku.

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

V kostce

  • Našeptávač adres Launify se do Shopionu vkládá bez programátora, jen skriptem v administraci.
  • Kód patří do pole Kód v sekci Nastavení → Obsah před </head>.
  • Uložení kódu v Shopionu vyžaduje zadání hesla k účtu a potvrzení tlačítkem AKTUALIZOVAT.
  • API klíč funguje jen na doménách, které u něj v administraci Launify povolíte.
  • Celé nastavení včetně mapování polí košíku zabere zhruba 10 minut.

Našeptávač adres pro Shopion od Launify nasadíte bez programátora a bez instalace doplňku. 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 Shopionu vložíte krátký skript do pole Obsah před </head> a namapujete pole adresy v košíku. Skript se pak načte na všech stránkách e-shopu a celé nastavení zabere zhruba 10 minut.

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

  • 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.
  • Méně práce s objednávkami. Správné adresy znamenají méně ručních oprav před odesláním zásilky a méně vrácených balíků.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Přístup do administrace Shopionu a heslo k účtu, které Shopion vyžaduje při ukládání kódu.
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

Vložte našeptávač adres pro Shopion do hlavičky stránek

  1. V administraci Shopionu najeďte v horním menu na Nastavení a zvolte Obsah před </head>.
  2. Do pole Kód vložte kód zkopírovaný z Launify. Pokud pole už obsahuje jiné skripty, přidejte ho na konec.
  3. Do políčka vedle tlačítka zadejte heslo ke svému účtu v Shopionu.
  4. Klikněte na AKTUALIZOVAT.

Při vkládání kódu nepřepisujte skripty, které už v poli jsou (například měřicí kódy). Kód Launify vždy přidejte na nový řádek na konec pole.

Krok 3

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

Potřebuji pro Shopion instalovat doplněk?

Ne. Našeptávač adres Launify se do Shopionu vkládá krátkým skriptem do pole Obsah před </head> v nastavení e-shopu. Nemusíte instalovat žádný doplněk ani upravovat šablonu. Stačí přístup do administrace a heslo k účtu, které Shopion vyžaduje při každé změně vloženého kódu.

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

Zhruba 10 minut. Vytvoření API klíče v administraci Launify zabere pár minut, vložení kódu do pole Obsah před </head> v Shopionu necelé dvě minuty a zbytek času připadá na namapování polí košíku a zkušební vyplnění adresy. Shopion patří mezi nejrychlejší platformy na nasazení.

Načte se skript i v košíku?

Ano. Kód vložený do pole Obsah před </head> Shopion vkládá do hlavičky všech podstránek e-shopu, tedy i do košíku a kroků, kde zákazník vyplňuje doručovací adresu. Pokud by se návrhy adres v košíku přesto nezobrazovaly, ozvěte se nám a integraci zkontrolujeme za vás.

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. Zákazník si jeho načítání na běžných stránkách nevšimne a v košíku mu našeptávač naopak ušetří čas při vyplňování adresy a sníží počet překlepů v doručovacích údajích.

Funguje našeptávač i pro slovenské zákazníky?

Ano. Cílovou zemi nastavíte v kódu přes funkci updateCountry dvoupísmenným ISO kódem, tedy CZ pro Česko a SK pro Slovensko. Pokud prodáváte na obou trzích z jednoho e-shopu, napište nám a pomůžeme vám nastavit integraci tak, aby našeptávač správně fungoval pro zákazníky z obou zemí.

Hledáte obecný postup pro jinou platformu? Podívejte se na návod Vlastní integrace nebo na nasazení přes Google Tag Manager. 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