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.
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.
- 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).
Vložte našeptávač adres pro BSSHOP do hlavičky stránek
- 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.
- Vložte do pole kód zkopírovaný z Launify. Pokud pole už obsahuje jiné skripty, přidejte ho na konec.
- 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.
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.
| Údaj | Co v mapování nastavit |
|---|---|
| Ulice a číslo domu | pole, do kterého zákazník píše adresu, je to vstup našeptávače |
| Město | pole 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
- Vložte zboží do košíku a přejděte ke kroku s doručovací adresou.
- 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
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ě.