Návod k integraci

BSSHOP

Našeptávač adres Launify nasadíte do BSSHOPu vložením skriptu do hlavičky všech stránek nebo přes Google Tag Manager a namapujete pole košíku.

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

V kostce

  • Našeptávač adres Launify se do BSSHOPu vkládá jako skript do hlavičky všech stránek, bez programátora.
  • Košík BSSHOPu běží na doméně e-shopu ve třech krocích, takže se skript načte i tam.
  • Pokud v BSSHOPu používáte Google Tag Manager, můžete kód přidat jako tag typu Vlastní HTML.
  • 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 15 minut.

Našeptávač adres pro BSSHOP od Launify nasadíte bez programátora vložením krátkého skriptu do hlavičky všech stránek e-shopu. 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 BSSHOPu vložíte kód do sekce pro vlastní kód v hlavičce nebo ho přidáte přes Google Tag Manager a namapujete pole adresy v košíku. Celé nastavení zabere zhruba 15 minut.

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

  • 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ší tříkrokový košík. Po výběru návrhu se adresa vyplní najednou, zákazník se rychleji dostane k dokončení objednávky.
  • 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 BSSHOPu s oprávněním měnit nastavení aplikace.
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 BSSHOP do hlavičky stránek

  1. V administraci BSSHOPu otevřete Nastavení aplikace a najděte sekci, která umožňuje vložit vlastní kód do hlavičky všech stránek. Nastavení kódů třetích stran najdete v části Podpora třetích stran.
  2. Vložte do pole kód zkopírovaný z Launify. Pokud pole už obsahuje jiné skripty, přidejte ho na konec.
  3. Změny uložte.

Některé funkce BSSHOP zapíná na požádání. Pokud pole pro vlastní kód ve své administraci nenajdete, napište podpoře BSSHOP přes zákaznické centrum a požádejte o vložení kódu do hlavičky všech stránek.

Používáte Google Tag Manager? Místo vkládání do hlavičky můžete v GTM vytvořit tag typu Vlastní HTML s kódem Launify, spouštěčem All Pages a kontejner publikovat. Postup popisuje návod Google Tag Manager.

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Č

Košík BSSHOPu má tři kroky na adresách /objednat-krok1/ až /objednat-krok3/ a některé prvky stránky mají automaticky generované id. Pro mapování proto použijte raději atribut name, který se nemění.

Atribut zjistíte v prohlížeči: pravým tlačítkem na pole adresy → 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 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 ke kroku s doručovací adresou.
  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

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

Ano. Košík BSSHOPu běží na stejné doméně jako zbytek e-shopu a kód vložený do hlavičky všech stránek se načte i ve všech jeho krocích. Stejně tak se tam načítá Google Tag Manager. Pokud by se návrhy adres přesto nezobrazovaly, ozvěte se nám a integraci zkontrolujeme.

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

Zhruba 15 minut, pokud máte v administraci pole pro vlastní kód nebo napojený Google Tag Manager. Vytvoření API klíče a vložení kódu zabere pár minut, zbytek času připadá na namapování polí košíku. Pokud musíte o vložení kódu žádat podporu BSSHOP, přičtěte čas na její odpověď.

Co když v administraci nenajdu pole pro vlastní kód?

BSSHOP některé funkce zpřístupňuje až na žádost přes zákaznické centrum. Napište podpoře BSSHOP, že potřebujete vložit skript do hlavičky všech stránek, a přiložte kód z administrace Launify. Pokud už máte napojený Google Tag Manager, můžete kód přidat rovnou tam.

Funguje našeptávač i pro slovenský BSSHOP?

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 provozujete českou i slovenskou verzi e-shopu na různých doménách, vložte do každé z nich kód 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. 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.

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