Powered by Smartsupp

Własna integracja

Czas wdrożenia : 15 min

Procedura integracji dla wdrożenia na własnym rozwiązaniu:

Integracja naszego autouzupełniania adresów z Twoją platformą jest prosta i przebiega bez komplikacji. Poradzisz sobie z nią nawet bez programisty, jednak idealnym rozwiązaniem jest, aby Twój deweloper wkleił nasz kod wyłącznie na stronie koszyka (checkoutu) e-sklepu.


Dzięki temu zapewnisz, że skrypt nie będzie niepotrzebnie ładowany na stronach, na których nie jest wymagany, i nie będzie w żaden sposób obciążał e-sklepu.


Nasz kod jest oczywiście zoptymalizowany pod kątem szybkości i wydajności, niemniej jednak zalecamy to podejście jako najlepszą praktykę. Będziemy wdzięczni za jej stosowanie.



Administracja Launify:

  1. Zarejestruj się na naszej stronie app.launify.com, a następnie zaloguj się do panelu administracyjnego.
  2. Kliknij w panelu administracyjnym przycisk Integracja -> Utwórz klucz.
  3. Wypełnij nazwę klucza i domeny, które będą mogły komunikować się za pomocą tego klucza, i kliknij Zapisz.
  4. Jeśli masz już utworzony klucz API, w wierszu po prawej stronie zobaczysz symbol </>, kliknij go i skopiuj kod, który pojawi się w oknie pop-up.

Masz teraz utworzony klucz API, który działa tylko na zdefiniowanych przez Ciebie domenach, oraz skopiowany kod do wstawienia do Twojego e-sklepu.


W Twojej platformie e-commerce:

Teraz należy wkleić skopiowany kod z kluczem API do tagu <head> Twojego e-sklepu/aplikacji.


  1. W swoim e-sklepie dodaj do nagłówka nasz kod pomiarowy, który skopiowałeś w poprzednim kroku z panelu administracyjnego Launify.
  2. Jeśli sytuacja na to pozwala, wolelibyśmy, abyś wkleił kod tylko w sekcji, w której klient wypełnia adres dostawy. - W takim przypadku nasz kod można wkleić do szablonu HTML bezpośrednio pod formularzem i nie jest konieczne umieszczanie go w <head>.
  3. Gotowe, Twój e-sklep jest teraz połączony z naszym dodatkiem.


Przykład naszego kodu

Nie zapomnij wymienić YOUR_API_KEY_HERE na swój klucz API i ustawić odpowiedni kraj w updateCountry('CZ'), jeśli kopiujesz ten kod stąd. Listę obsługiwanych krajów znajdziesz tutaj. Kod może zostać zminifikowany po Twojej stronie.

<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'); // tutaj ustawisz docelowy kraj e-sklepu w 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 należy skonfigurować pola formularza (wejścia, wyjścia) do wprowadzania adresów, e-maili i nasłuchiwania wyników.

Mapowanie

  1. Kliknij w panelu administracyjnym przycisk Integracja. Przewiń w dół do sekcji „Mapowanie wejść i wyjść”.
  2. Domyślnie masz już zdefiniowaną pierwszą grupę mapowania. Możesz ją edytować według własnych potrzeb lub dodać kolejne. Nie ma żadnych limitów.
  3. Możesz dodać pola formularza według: id, name, class, data-attribute


Jeśli potrzebujesz pomocy przy mapowaniu pól, skontaktuj się z nami na czacie lub e-mailem, chętnie zrobimy to za Ciebie.