Návod k integraci

PepperShop

Našeptávač adres Launify nasadíte do PepperShopu přes vestavěnou integraci Google Tag Manageru v modulu Analytics 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 PepperShopu nasazuje přes Google Tag Manager, bez programátora.
  • GTM se v PepperShopu zapíná v Moduly → Analytics volbou pro integraci Google Tag Manageru a zadáním ID kontejneru.
  • Kód Launify se v GTM vloží jako tag typu Vlastní HTML a projeví se až po publikování kontejneru.
  • Pokud e-shop používá Consent Manager, musí tag Launify smět běžet i bez marketingového souhlasu.
  • Celé nastavení včetně mapování polí košíku zabere zhruba 20 minut.

Našeptávač adres pro PepperShop od Launify nasadíte přes Google Tag Manager (GTM), který PepperShop podporuje přímo v modulu Analytics. 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 PepperShopu zapnete integraci 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 PepperShopu

  • 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.
  • Bez úpravy šablon. PepperShop nemá obecné pole pro vlastní kód, ale přes vestavěný GTM přidáte našeptávač bez přístupu k souborům na serveru.

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 PepperShopu.
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ř. DE, SK, PL).

Krok 2

Zapněte Google Tag Manager v PepperShopu

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

  1. V administraci PepperShopu otevřete Moduly → Analytics.
  2. Zaškrtněte aktivaci modulu a zvolte možnost Použít integraci Google Tag Manageru (v německé administraci Google Tag Manager Integration verwenden).
  3. Do pole pro ID kontejneru vložte identifikátor ve tvaru GTM-XXXXXXX.
  4. Nastavení uložte.
Krok 3

Přidejte našeptávač adres pro PepperShop 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.
  4. Tag uložte a klikněte na Odeslat, aby se kontejner publikoval.

Pokud máte v PepperShopu zapnutý Consent Manager, ověřte, že tag Launify se spouští i bez souhlasu s marketingovými cookies. Našeptávač slouží k vyplnění objednávky, ne k měření. Podrobnější popis nastavení tagu 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.

ÚdajPole v košíku (německá administrace)
Ulice a číslo domuStrasse und Nr., vstup našeptávače
MěstoOrt
PSČPLZ

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 PepperShopu vkládá přes Google Tag Manager?

PepperShop nemá v administraci obecné pole pro vlastní kód v hlavičce, ale má vestavěnou integraci Google Tag Manageru v modulu Analytics. Přes GTM tak na stránky e-shopu dostanete vlastní skript bez úprav šablon a bez přístupu k souborům na serveru. Skript pak můžete kdykoli vypnout přímo v GTM.

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

Zhruba 20 minut. Pokud už máte v PepperShopu zapnutou integraci Google Tag Manageru, 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.

Načte se Google Tag Manager i v košíku PepperShopu?

Integrace GTM v PepperShopu posílá do dataLayeru i události z objednávkového procesu, například zahájení objednávky, takže se kontejner načítá i v košíku. Ověřit to můžete v režimu Náhled v Google Tag Manageru. Pokud by se tag Launify v košíku nespustil, ozvěte se nám a najdeme řešení.

Funguje našeptávač i pro německé a švýcarské adresy?

Cílovou zemi nastavíte v kódu přes funkci updateCountry dvoupísmenným ISO kódem. Launify se zaměřuje na střední Evropu a seznam podporovaných zemí najdete v administraci Launify. Pokud prodáváte do země, kterou v seznamu nenajdete, napište nám a povíme vám, kdy a jak ji můžeme podpořit.

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