V kostce
- Našeptávač adres Launify se do BigCommerce vkládá přes Storefront → Script Manager, bez úprav šablony.
- Aby se skript načetl i v košíku, musí e-shop používat Optimized One-Page Checkout a šablonu Stencil.
- Ve Script Manageru zvolte umístění All pages, které pokryje běžné stránky i košík.
- Pole adresy v košíku BigCommerce mají id jako addressLine1Input, cityInput a postCodeInput.
- Celé nastavení včetně mapování polí košíku zabere zhruba 15 minut.
Našeptávač adres pro BigCommerce od Launify nasadíte přes vestavěný Script Manager, bez programátora a bez úprav š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 BigCommerce přidáte skript s umístěním na všech stránkách a namapujete pole adresy v košíku. Podmínkou je šablona Stencil a Optimized One-Page Checkout. Celé nastavení zabere zhruba 15 minut.
Co našeptávač adres přinese e-shopu na BigCommerce
- Našeptávání adres ve střední Evropě. Launify se zaměřuje na adresy ve střední Evropě, takže pomůže i e-shopům na BigCommerce, které prodávají českým, slovenským nebo polským zákazníkům.
- 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ší jednostránkový košík. Po výběru návrhu se adresa vyplní najednou, což ocení hlavně zákazníci na mobilu.
Co budete potřebovat
- Účet v administraci Launify na app.launify.com.
- Přístup do administrace BigCommerce s oprávněním spravovat skripty.
- Šablonu Stencil a zapnutý Optimized One-Page Checkout. Bez něj se vlastní skripty v košíku nenačítají.
Krok 1
Vytvořte API klíč v administraci Launify
- Přihlaste se do administrace Launify.
- Klikněte na Integrace → Vytvořit klíč.
- 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. Pokud košík běží na jiné doméně než zbytek e-shopu, přidejte i ji.
- 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, PL, HU, DE).
Krok 2
Přidejte našeptávač adres pro BigCommerce ve Script Manageru
- V administraci BigCommerce otevřete Storefront → Script Manager. Pokud máte více prodejních kanálů, najdete Script Manager v Channel Manager u daného obchodu.
- Klikněte na Create a Script.
- Do pole Name of script napište například Launify.
- U Placement zvolte Footer.
- U Location zvolte All pages, aby se skript načetl i v košíku.
- U Script category zvolte Essential, aby skript nezablokoval cookie banner.
- U Script type zvolte Script a do pole Script contents vložte kód zkopírovaný z Launify.
- Klikněte na Save.
BigCommerce má v nastavení košíku i vlastní volbu Google Address Autocomplete. Pokud ji máte zapnutou, vypněte ji v Settings → Checkout, aby se zákazníkům nezobrazovaly dva našeptávače najednou.
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.
Optimized One-Page Checkout používá pro adresu tato pole:
| Údaj | Atribut id v košíku |
|---|---|
| Ulice a číslo domu | addressLine1Input |
| Město | cityInput |
| PSČ | postCodeInput |
Doručovací a fakturační adresa se vykreslují v samostatných krocích košíku, proto si názvy ověřte v prohlížeči (pravým tlačítkem na pole → Prozkoumat). 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
- Vložte zboží do košíku a přejděte k vyplňování doručovací adresy.
- Začněte psát ulici do pole adresy. Měly by se objevit návrhy adres.
- Po výběru návrhu zkontrolujte, že se správně doplnilo město a PSČ.
Časté otázky
Proč se skript v košíku BigCommerce nenačítá?
Vlastní skripty ze Script Manageru se v košíku načítají jen tehdy, když e-shop používá Optimized One-Page Checkout a šablonu Stencil. Zkontrolujte také, že jste u skriptu zvolili umístění All pages, a ne jen Storefront pages. Ta varianta košík a potvrzení objednávky vůbec nezahrnuje.
Jak dlouho trvá nasazení našeptávače na BigCommerce?
Zhruba 15 minut. Vytvoření API klíče v administraci Launify zabere pár minut, přidání skriptu ve Script Manageru další pár minut a zbytek času připadá na namapování polí košíku a zkušební objednávku. Pokud ještě nemáte zapnutý Optimized One-Page Checkout, počítejte s časem na jeho kontrolu.
Potřebuji pro BigCommerce instalovat aplikaci?
Ne. Našeptávač adres Launify se do BigCommerce vkládá jako skript přes vestavěný Script Manager, takže nemusíte instalovat žádnou aplikaci z marketplace ani upravovat šablonu. Skript můžete kdykoli upravit nebo smazat ve stejné sekci administrace bez zásahu do zbytku e-shopu.
Můžu Launify používat současně s Google Address Autocomplete?
Nedoporučujeme to. Vestavěná volba Google Address Autocomplete v BigCommerce funguje jen ve vybraných zemích a při současném použití by se zákazníkovi u pole adresy zobrazovaly dva seznamy návrhů. Pokud nasazujete Launify, vestavěnou volbu vypněte v nastavení košíku, aby zákazník viděl vždy jen jeden našeptávač.
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 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ě.