Návod k integraci

Shoprenter

Našeptávač adres Launify nasadíte do Shoprenteru bez programátora – vložíte skript do pole pro HEAD skripty v nastavení šablony 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 Shoprenteru vkládá bez programátora, jen skriptem v nastavení šablony.
  • Kód patří do pole HEAD részbe illeszthető scriptek v sekci Megjelenés → Téma testreszabás.
  • Pro maďarské e-shopy se v kódu nastavuje země HU přes funkci updateCountry.
  • 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 Shoprenter od Launify nasadíte bez programátora a bez instalace aplikace, jen vložením krátkého skriptu do nastavení šablony. 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 Shoprenteru vložíte kód do pole pro skripty v hlavičce šablony a namapujete pole adresy v košíku. Celé nastavení zabere zhruba 15 minut.

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

  • 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 názvech ulic a v PSČ, které jsou u maďarských adres častou chybou.
  • Rychlejší objednávka na mobilu. Po výběru návrhu se ulice, město i PSČ vyplní najednou, zákazník nemusí přepínat mezi poli.
  • Méně vrácených zásilek. Správné adresy znamenají méně nedoručených balíků a méně telefonátů zákazníkům kvůli upřesnění adresy.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Přístup do administrace Shoprenteru s oprávněním upravovat vzhled e-shopu.
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. Nezapomeňte přidat i doménu, na které běží košík, pokud se liší od hlavní domény.
  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íč. Pro maďarský e-shop 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('HU');
        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('HU') nastavte cílovou zemi e-shopu (ISO kód, např. HU, SK, CZ).

Krok 2

Vložte našeptávač adres pro Shoprenter do hlavičky šablony

  1. V administraci Shoprenteru otevřete v levém menu Megjelenés (Vzhled) → Téma testreszabás (Přizpůsobení šablony).
  2. Najděte pole HEAD részbe illeszthető scriptek (skripty vkládané do hlavičky).
  3. Vložte do něj kód zkopírovaný z Launify. Pokud pole už obsahuje jiné skripty, například měřicí kódy, přidejte ho na konec.
  4. Uložte změny tlačítkem v pravém horním rohu.

Ve starších verzích administrace může být stejné pole na kartě Egyedi marketing script pod názvem HEAD részbe illeszthető marketing scriptek.

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.

Namapujte tyto tři údaje:

Ú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 (maďarsky Település)
PSČpole pro PSČ (maďarsky Irányítószám)

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 Shoprenter instalovat aplikaci?

Ne. Našeptávač adres Launify se do Shoprenteru vkládá krátkým skriptem do pole pro HEAD skripty v nastavení šablony, takže nemusíte instalovat žádnou aplikaci ani upravovat kód šablony. Stačí přístup do administrace s oprávněním měnit vzhled e-shopu a uložit změny.

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

Zhruba 15 minut. Vytvoření API klíče v administraci Launify zabere pár minut, vložení kódu do nastavení šablony v Shoprenteru další pár minut a zbytek času připadá na namapování polí košíku a otestování objednávky. Pokud máte upravený košík, počítejte s o něco delším mapováním.

Jakou zemi mám v kódu nastavit?

Zemi nastavíte ve funkci updateCountry dvoupísmenným ISO kódem podle trhu, na který e-shop prodává. Pro maďarské e-shopy použijte HU, pro slovenské SK a pro české CZ. Pokud provozujete více e-shopů pro různé země, vložte kód do každého z nich zvlášť se správnou zemí.

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.

Co dělat, když našeptávač v košíku nefunguje?

Nejdřív ověřte, že je doména e-shopu povolená u API klíče v administraci Launify a že jste změny v Shoprenteru uložili. Pak zkontrolujte mapování polí košíku. Pokud vše sedí a návrhy se stále nezobrazují, napište nám na chat nebo e-mail a integraci zkontrolujeme za vás.

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