Návod k integraci

IdoSell

Našeptávač adres Launify nasadíte do IdoSellu přes Dodatki HTML/JS – vytvoříte kampaň, přidáte doplněk s kódem do hlavičky 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 IdoSellu vkládá přes Dodatki HTML/JS, bez programátora.
  • Kód se přidává jako doplněk typu HTML do začátku sekce head a lze ho omezit na stránky košíku.
  • Automatickou kontrolu a vypínání doplňku je vhodné nastavit na nie, aby ho IdoSell sám nevypnul.
  • Změny v doplňcích se na e-shopu projeví až za zhruba 60 minut.
  • Celé nastavení včetně mapování polí košíku zabere zhruba 15 minut.

Našeptávač adres pro IdoSell od Launify nasadíte bez programátora přes vestavěnou sekci Dodatki HTML/JS. 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 IdoSellu (dříve IAI-Shop) založíte kampaň s doplňkem, který vloží kód do hlavičky stránek, a namapujete pole adresy v košíku. Celé nastavení zabere zhruba 15 minut, změna se na e-shopu projeví do hodiny.

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

  • 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.
  • Jeden postup pro více trhů. Pokud prodáváte z IdoSellu do Polska, Česka i na Slovensko, stačí v kódu nastavit zemi pro každý obchod.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Přístup do administračního panelu IdoSellu s oprávněním upravovat vzhled obchodu.
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íč. Pro polský 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('PL');
        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('PL') nastavte cílovou zemi e-shopu (ISO kód, např. PL, CZ, SK).

Krok 2

Založte kampaň v Dodatki HTML/JS

  1. V administraci IdoSellu otevřete Sklep → Dodatki HTML/JS (Doplňky HTML/JS). Ve starších verzích panelu najdete sekci pod názvem Dodatki HTML i JavaScript.
  2. Klikněte na Dodaj kampanię (Přidat kampaň).
  3. Vyplňte Nazwa w panelu, například Launify, nastavte Aktywna na tak a vyberte obchod.
  4. Klikněte na Zapisz (Uložit).
Krok 3

Přidejte našeptávač adres pro IdoSell jako doplněk

  1. U nové kampaně klikněte na Edytuj dodatki a pak na Nowy dodatek.
  2. Vyplňte Tytuł, nastavte Aktywny na tak a u Pokazuj na urządzeniach zvolte běžná i mobilní zařízení.
  3. Automatyczna kontrola i wyłączanie nastavte na nie, aby IdoSell doplněk sám nevypnul.
  4. U Typ dodatku zvolte HTML a u Wyświetlaj w zvolte początek sekcji head (začátek sekce head).
  5. Načítání nastavte na Razem z treścią strony (spolu s obsahem stránky).
  6. U stránek nechte všechny stránky, nebo zvolte Wybranych a označte stránky košíku: Koszyk, Dostawa i płatności a Potwierdzenie danych.
  7. Do pole Edycja (HTML) vložte kód zkopírovaný z Launify a klikněte na Dodaj.

IdoSell změny v doplňcích propisuje na e-shop s prodlevou, obvykle do 60 minut. Našeptávač proto testujte až po hodině.

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 IdoSellu (polsky)
Ulice a číslo domuUlica i numer, vstup našeptávače
MěstoMiejscowość
PSČKod pocztowy

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č v IdoSellu neprojevil hned?

IdoSell změny v sekci Dodatki HTML/JS nepropisuje na e-shop okamžitě, ale s prodlevou, která obvykle trvá do 60 minut. Po uložení doplňku proto chvíli počkejte a teprve potom našeptávač v košíku otestujte. Pokud se ani po hodině nenačte, zkontrolujte, že je aktivní kampaň i samotný doplněk.

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

Samotné nastavení zabere zhruba 15 minut: vytvoření API klíče, založení kampaně s doplňkem v Dodatki HTML/JS a namapování polí košíku. K tomu přičtěte až hodinu, než IdoSell změnu propiše na e-shop. Test v košíku proto naplánujte až po této prodlevě.

Proč vypnout automatickou kontrolu doplňku?

IdoSell umí doplněk automaticky vypnout, když externí zdroj opakovaně neodpoví do dvou sekund. Při krátkodobém výpadku spojení by tak mohl našeptávač vypnout natrvalo a vy byste o tom nevěděli. Nastavením Automatyczna kontrola i wyłączanie na nie zajistíte, že zůstane zapnutý.

Můžu místo toho použít Google Tag Manager?

Ano. IdoSell podporuje Google Tag Manager nativně, ID kontejneru zadáte v sekci nastavení Google na kartě Tag Manager. Kód Launify pak přidáte v GTM jako tag typu Vlastní HTML a kontejner publikujete. Postup popisuje náš návod Google Tag Manager, mapování polí košíku zůstává stejné.

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ě, omezte doplněk v IdoSellu jen na 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 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