Powered by Smartsupp

Vlastná integrácia

Doba implementácie : 15 min

Postup integrácie pre nasadenie na vlastné riešenie:

Integrácia nášho našepkávača do vašej platformy je jednoduchá a prebieha bez komplikácií. Zvládnete ju aj bez programátora, avšak ideálnym riešením je, aby váš vývojár vložil náš kód iba do stránky košíka (checkoutu) e-shopu.


Tým zaistíte, že sa skript nebude zbytočne načítavať na stránkach, kde nie je potrebný, a nebude tak e-shop nijak zaťažovať.


Náš kód je samozrejme optimalizovaný s ohľadom na rýchlosť a výkon, napriek tomu odporúčame tento postup ako najlepšiu prax. Budeme radi, ak sa ním budete riadiť.



Administrácia Launify:

  1. Zaregistrujte sa na našom webe app.launify.com a potom sa prihláste do našej administrácie.
  2. Kliknite v našej administrácii na tlačidlo Integrácia -> Vytvoriť kľúč.
  3. Vyplňte názov kľúča a domény, s ktorými bude možné týmto kľúčom komunikovať, a kliknite na Uložiť.
  4. Ak už máte vytvorený api kľúč, v riadku vpravo uvidíte symbol </>, kliknite naň a skopírujte kód, ktorý sa objaví vo vyskakovacom okne.

Teraz máte vytvorený api kľúč, ktorý funguje iba na vami definovaných doménach a máte skopírovaný kód pre vloženie do vášho e-shopu.


Vo vašej e-shopovej platforme:

Teraz je potrebné skopírovaný kód s API kľúčom vložiť do <head> tagu vášho e-shopu/aplikácie.


  1. Vo vašom eshope pridajte do hlavičky eshopu náš merací kód, ktorý ste si skopírovali v predchádzajúcom kroku z našej administrácie Launify.
  2. Ak to situácia dovolí, budeme radšej, ak kód vložíte iba do sekcie, kde zákazník vypĺňa doručovaciu adresu. - V tomto prípade je možné náš kód vložiť do HTML šablóny priamo pod formulár a nie je nutné vkladať ho do <head>.
  3. Máte hotovo, týmto je váš e-shop prepojený s naším doplnkom


Ukážka nášho kódu

Nezabudnite vymeniť YOUR_API_KEY_HERE za váš API kľúč a nastaviť správnu krajinu v updateCountry('CZ'), ak tento kód skopírujete odtiaľto. Zoznam podporovaných krajín nájdete tu. Kód je možné nechať minifikovať na vašej strane.

<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'); // tu nastavíte cieľovú krajinu 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>


Teraz je teda potrebné nastaviť vaše formulárové polia (inputy, outputy) na zadávanie adries, e-mailov a na počúvanie výsledkov.

Mapovanie

  1. Kliknite v našej administrácii na tlačidlo Integrácia. Prejdite v tejto sekcii nižšie na "Mapovanie vstupov a výstupov".
  2. V predvolenom stave už máte vopred definovanú prvú mapovaciu skupinu. Túto skupinu si môžete upraviť podľa svojich potrieb alebo pridať ďalšie. Limitmi nie ste obmedzení.
  3. Pridať môžete inputy formulára podľa: id, name, class, data-attribute


V prípade, že si neviete rady pri mapovaní inputu, neváhajte sa na nás obrátiť na chate alebo e-mailom, radi všetko namapujeme za vás.