W skrócie
- Podpowiadanie adresów Launify działa na każdej platformie, na której można dodać własny JavaScript.
- Kod z kluczem API wstawia się do <head> stron, najlepiej tylko na stronie koszyka.
- Klucz API działa tylko na domenach dozwolonych w panelu Launify.
- Pola adresu mapuje się po atrybucie id, name, class lub data w sekcji Integracje.
- Cała konfiguracja zajmuje około 15 minut i poradzisz sobie bez programisty.
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:
- Zarejestruj się na naszej stronie app.launify.com, a następnie zaloguj się do panelu administracyjnego.
- Kliknij w panelu administracyjnym przycisk Integracja -> Utwórz klucz.
- Wypełnij nazwę klucza i domeny, które będą mogły komunikować się za pomocą tego klucza, i kliknij Zapisz.
- 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.
- W swoim e-sklepie dodaj do nagłówka nasz kod pomiarowy, który skopiowałeś w poprzednim kroku z panelu administracyjnego Launify.
- 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>.
- 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
- Kliknij w panelu administracyjnym przycisk Integracja. Przewiń w dół do sekcji „Mapowanie wejść i wyjść”.
- 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.
- 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.
Potrzebujesz pomocy?
Napisz do nas, a skonfigurujemy integrację razem.