Powered by Smartsupp

Vlastní integrace

Doba implementace : 15 min

Postup integrace pro nasazení na vlastní řešení:

Integrace našeho našeptávače do vaší platformy je jednoduchá a probíhá bez komplikací. Zvládnete ji i bez programátora, nicméně ideálním řešením je, aby váš vývojář vložil náš kód pouze do stránky košíku (checkoutu) e-shopu.


Tím zajistíte, že se skript nebude zbytečně načítat na stránkách, kde není potřeba, a nebude tak e-shop nijak zatěžovat.


Náš kód je samozřejmě optimalizovaný s ohledem na rychlost a výkon, přesto doporučujeme tento postup jako nejlepší praxi. Budeme rádi, pokud se jím budete řídit.



Administrace Launify:

  1. Registrujte se na našem webu app.launify.com, a poté si přihlašte do naší administrace.
  2. Klikněte v naší administraci na tlačítko Integrace -> Vytvořit klíč.
  3. Vyplňte název klíče a domény, kterých bude možné tímto klíčem komunikovat a klikněte na Uložit.
  4. Pokud již máte vytvořený api klíč, na řádku vpravo uvidíte symbol </>, klikněte na něj a zkopírujte kód, který se objeví ve vyskakovacím okně.

Nyní máte vytvořený api klíč, který funguje pouze na vámi definovaných doménách a máte zkopírovaný kód pro vložení, do vašeho e-shopu.


Ve vaší e-shopové platformě:

Nyní je potřeba zkopírovaný kód s API klíčem vložit do <head> tagu vašeho e-shopu/aplikace.


  1. Ve vašem eshopu přidejte do hlavičky eshopu náš měřící kód, který jste si zkopírovali v předchozím kroku z naší administrace Launify.
  2. Pokud to situace dovolí, budeme radši pokud kód vložíte pouze do sekce, kde zákazník vyplňuje doručovací adresu. - V tomto případě, lze náš kód vložit do HTML šablony přímo pod formulář a není nutné vkládat do <head>.
  3. Máte hotovo, tímto je váš e-shop propojený s naším doplňkem


Ukázka našeho kódu

Nezapomeňte vyměnit YOUR_API_KEY_HERE za váš API klíč a nastavit správnou zemi do updateCountry('CZ'), pokud tento kód zkopírujete odtud. Seznam podporovaných zemí najdete zde. Kód lze nechat minifikovat na vaší straně.

<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'); // zde nastavíte cílovou zemi e-shopu v ISO-CODE-2
launifyInstance.init();
} catch(e) { console.error(e); }
};
document.head.appendChild(s);
}
if(document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init);
} else {
init();
}
})();
</script>


Nyní je potřeba tedy nastavit vaše formulářové políčka (inputy, outputy) na zadávání adres, emailů a pro naslouchání výsledků.

Mapování

  1. Klikněte v naší administraci na tlačítko Integrace. Sjeďte v této sekci níže na "Mapování vstupů a výstupů".
  2. Ve výchozím stavu již máte předem definovanou první mapovací skupinu. Tuto skupinu si můžete upravit, dle svých potřeb, nebo přidat další. Limitně nejste omezeni.
  3. Přidat můžete inputy formuláře dle: id, name, class, data-attribute


V případě, že si nevíte rady při mapování inputu, neváhejte se na nás obrátit na chatu nebo emailem, rádi vše namapujeme za vás.