Ten poradnik pomoże Ci wdrożyć integrację Universal Integration na platformie sklepowej jaką jest Idosell.
Integracja składa się z 3 kroków tj.
1. Dodanie skryptu inicjalizującego
2. Wygenerowanie feedu produktowego na platformie oraz zaimplementowanie go w panelu edrone
3. Dodanie skryptu na Thank You Page Twojego sklepu, czyli na stronie potwierdzającej dokonanie zakupów.
Wszystkie skrypty, które należy dodać znajdziesz w dokumentacji edrone na stronie docs.edrone.me, w sekcji Other, a następnie w zakładce “Integrate with universal integration” (LINK). Znajdziesz tu też, krótką i ogólną instrukcję wyjaśniającą.
Krok 1. Dodanie skryptu inicjalizującego.
UWAGA: NA KOŃCU PUNKTU PIERWSZEGO ZNAJDZIESZ JUŻ GOTOWY SKRYPT DO SKOPIOWANIA, W KTÓRYM WYSTARCZY PODMIENIĆ SWOJE APP_ID
Idosell udostępnia na swojej platformie specjalną zakładkę o nazwie “Dodatki HTML i Javascript” w sekcji Moderacja -> Wygląd sklepu w której z łatwością można taki skrypt dodać.
Przejdź do tej zakładki na platformie.
W tej zakładce masz możliwość dodania skryptów w różnych elementach kodu HTML strony. W pierwszej kolejności musisz dodać kampanię i określić jej parametry.
Uzupełnij nazwę kampanii, zaznacz status aktywności na "tak", oraz określ na której domenie chcesz wdrożyć integrację (jeżeli masz ich więcej).
Gdy utworzyłeś już kampanię to powinna ona się pojawić na Twojej liście.
Gdy widzisz już swoją kampanię, to w kolejnym kroku należy kliknąć "edytuj dodatki", a następnie "Nowy dodatek". W tej sekcji dodasz właśnie potrzebny skrypt.
Na początku należy ustawić odpowiednie parametry dodatku jakim będzie nasz skrypt inicjalizujący. Zrób to zgodnie z poniższym screenem.
W kolejnym kroku musimy wkleić nasz skrypt, który znajdziesz w dokumentacji (link znajdziesz na początku instrukcji) do konsoli poniżej:
W tym skrypcie należy dokonać pewnej modyfikacji, czyli usunąć niepotrzebne elementy, podmienić identyfikator jakim jest APP ID, oraz parametr email, oraz first_name, oraz usunąć.
Na początek usuń dwa znaczniki, które nie są potrzebne, ponieważ platforma Idosell automatycznie dodaje je dla każdego skryptu dodanego przez tę zakładkę:
Twój skrypt po usunięciu tych dwóch znaczników powinien wyglądać tak:
Teraz czas, by zastąpić pola określające APP ID danymi z Twojego sklepu.
APP ID swojego sklepu znajdziesz w panelu edrone w zakładce Ustawienia -> Integracja -> Platformy.
Po skopiowaniu należy go podmienić w dwóch miejscach w skrypcie.
Następnie musisz zmienić parametry email i first_name:
Są to dane zmienne - te dane przesyłane do systemu edrone będą się różnić adresem
e-mail i imieniem (przy implementacji drugiego skryptu w punkcie 3 jeszcze innymi, dodatkowymi danymi, ale do tego punktu dopiero dojdziemy), a więc oznacza to, że musimy określić odpowiedni parametr, który będzie wyświetlał tę zmienną wartość.
Do podmiany tych pól musisz wykorzystać dokumentację, którą przygotował Idosell. Wystarczy, że klikniesz sobie link poniżej okna konsoli tekstowej i otworzy Ci się odpowiednia zakładka.
Poszukaj zmiennej odpowiedzialnej za wyświetlanie adresu e-mail i skopiuj go w całości, włącznie z nawiasami. Podmień go w odpowiedniej linijce. Z parametrem first_name zrób dokładnie to samo. Gdy podmienisz odpowiednio potrzebne pola nie zapomnij zapisać skryptu, wciskając przycisk “ZAPISZ”.
Tak powinien wyglądać skrypt po podmianie danych (poza APP ID, ponieważ tam wklejasz swój unikalny identyfikator):
Poniżej konsoli znajdziesz jeszcze dodatkowe ustawienia. Powiel je ze screenu poniżej, a następnie wciśnij przycisk "Dodaj":
Wróć do widoku wszystkich kampanii i upewnij się, że kampania odpowiedzialna za Universal Integration ma status aktywny.
Poniżej znajdziesz gotowy kod, w którym wystarczy, że podmienisz swoje APP ID na swoje unikalne.
(function (srcjs) {
window._edrone = window._edrone || {};
_edrone.app_id = 'YOUR_APP_ID';
_edrone.platform = 'universal';
_edrone.email = '[iai:client_email]';
_edrone.first_name = '[iai:client_name]';
let doc = document.createElement('script');
doc.type = 'text/javascript';
doc.async = true;
doc.src = ('https:' === document.location.protocol ? 'https:' : 'http:') + srcjs;
let s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(doc, s);
})("//d3bo67muzbfgtl.cloudfront.net/edrone_2_0.js?app_id=YOUR_APP_ID");
Zakończyliśmy punkt pierwszy, czyli wdrożenie skryptu inicjalizującego.
Krok 2. Wygenerowanie feedu produktowego i implementacji w systemie edrone.
Najprostszym sposobem jest wygenerowanie go w formacie CENEO, który jest akceptowalny przez edrone. Przejdź do zakładki “Marketing i Integracje”, a następnie "Porównywarki cen, pasaże handlowe i katalogi" na platformie Idosell, a następnie wybierz sklep i wciśnij przycisk "Dodaj nowy serwis".
Po wciśnięciu przycisku pojawi Ci się okno wyboru, w którym należy wybrać wygenerowanie feedu CENEO.
Ustaw parametry zgodnie ze screenem poniżej i wciśnij "Zapisz"
Wygenerowanie feedu może trwać nawet do 24 godzin. Dostaniesz informację o tym, że plik eksportu jest już wygenerowany. Gdy feed produktowy jest już gotowy musisz kliknąć przycisk "Wybierz" -> "Plik eksportu"
Otworzy Ci się okienko, z którego będziesz mógł skopiować link do Twojego feedu.
Teraz musisz zaimplementować go w edrone, tak więc przejdź do panelu głównego Twojego sklepu w edrone, a następnie do sekcji Ustawienia -> Product Feed.
Kliknij przycisk "IMPORTUJ NOWY FEED" i wklej link który wygenerował Ci się na platformie. Następnie zaznacz "OK" i feed jest zaimplementowany - uwaga jego przeprocesowanie może potrwać od kilku minut do kilku godzin - w zależności od jego wielkości i ilości produktów, które zawiera.
Krok 3. Implementacja skryptu na Twojej stronie, która wyświetla się po złożeniu zamówienia.
UWAGA: NA KOŃCU PUNKTU TRZECIEGO ZNAJDZIESZ JUŻ GOTOWY SKRYPT DO SKOPIOWANIA, W KTÓRYM WYSTARCZY PODMIENIĆ SWOJE APP_ID
Skrypt jest ten troszkę bardziej skomplikowany niż poprzedni, dlatego pokażę Ci jak powinien on wyglądać i możesz odtworzyć go, prawie że 1 do 1 na swojej platformie.
Ponownie przejdź na platformę sklepową, do zakładki “Dodatki HTML i Javascript” w sekcji Moderacja -> Wygląd sklepu. Ponownie kliknij przycisk "edytuj dodatek" dla kampanii Universal Integration edrone i dodaj nowy dodatek.
Ponownie pokaże Ci się znane już z poprzednich etapów okno. Dokonaj wstępnych ustawień dodatku zgodnie z poniższym screenem.
Przekopiuj sobie skrypt z dokumentacji - tym razem kolejny z nich, który się tam znajduje i wklej go do konsoli.
Tak jak w przypadku pierwszego skryptu, wymaga on modyfikacji zmiennych wartości, oraz usunięcia znaczników otwierającego i kończącego skrypt.
Pierwszą z nich jest podmiana w polu APP ID, dokładnie w ten sam sposób jak w poprzednim skrypcie.
W następnych krokach musisz podmienić pozostałe pola, czyli email, first_name, product_id, order_id oraz order_value za pomocą odpowiednich znaczników, które są akceptowalne przez platformę sklepową Idosell - dokładnie tak jak w przypadku pierwszego skryptu inicjalizującego. Przejdź ponownie do dokumentacji platformy.
Bardziej złożone jest pole odpowiedzialne za product_ids - bez większych szczegółów, ale informacje o produkcie są przekazywane w pętli, dlatego to pole będzie wyglądać trochę inaczej, ale nie martw się - możesz odtworzyć dokładnie to co zrobię i będzie to poprawne.
Do określenia ID produktów potrzebujemy dokumentacji z drugiego odnośnika.
W przypadku product_ids mamy znacznik początkowy i końcowy, pomiędzy którymi musi się wyświetlać znacznik określający id produktu i, który musimy rozdzielić jeszcze znakiem PIPE (znajdziesz go pod backspacem na klawiaturze).
Pozostałe pole podmieniamy dokładnie tak jak zmienną e-mail, czyli szukamy w dokumentacji odpowiednie znaczniki i wklejamy do naszego skryptu.
Tak powinien wyglądać Twój skrypt (poza polami z APP ID - tam powinieneś mieć dane ze swojego sklepu).
Poniżej konsoli znajdziesz kolejne parametry, które należy ustawić. Dokonaj tego zgodnie z poniższym screenem.
Następnie potwierdź swoje zmiany klikając przycisk "Zmień" u dołu strony.
Upewnij się, że oba dodatki w Twojej kampanii Universal Integration są aktywne.
Poniżej znajdziesz gotowy kod, w którym wystarczy, że podmienisz swoje APP ID na swoje unikalne.
(function () {
window._edrone = window._edrone || {};
_edrone.app_id = 'YOUR_APP_ID';
_edrone.email = '[iai:client_email]'
_edrone.first_name = '[iai:client_name]';
_edrone.platform = 'universal';
_edrone.action_type = 'universal_order'
_edrone.product_ids = '[iai:foreach_products_begin][iai:product_id]|[iai:product_id][iai:foreach_products_end]'; // use "|" sign to separate products from each other
_edrone.order_id = '[iai:order_id]';
_edrone.base_payment_value = '[iai:order_worth_cpa2]';
_edrone.order_payment_value = '[iai:order_worth_cpa2]';
})();
Weryfikacja
Jeżeli chcesz zweryfikować poprawność wykonanej integracji, w panelu edrone przejdź do zakładki USTAWIENIA > INTEGRACJE > EVENT MONITOR. Możesz tutaj sprawdzić jakie zdarzenia są przesyłane do edrone.
Skontaktuj się również ze swoim opiekunem lub napisz na hello@edrone.me. Sprawdzimy dla Ciebie poprawność wykonanej integracji oraz wykonamy podpięcia pod wszystkie formularze zapisu do newslettera dostępne na stronie sklepu.
Potrzebujesz pomocy?
Jeżeli masz jeszcze jakieś wątpliwości na temat integracji Idosell z edrone, napisz do nas na hello@edrone.me