Integracja z Shopware

Integracja z Shopware

Shopware to przodująca niemiecka platforma eCommerce przeznaczona do działań B2B i B2C. Platforma Shopware oferuje szerokie możliwości konfiguracji sklepu online oraz rozbudowy funkcjonalności o liczne wtyczki i integracje. Dzięki integracji z SALESmanago możliwa jest wymiana danych między platformami. Integracja jest dostępna w trzech językach – EN/DE/PL.

WSKAZÓWKA: Wtyczka jest w kompatybilna z Shopware 5.2 i nowszych, w przypadku starszych wersji część funkcji może nie działać zgodnie z opisem.

Zakres integracji:

  • Monitorowanie strony sklepu na Shopware przy pomocy kodu monitorującego SALESmanago
  • Obsługa formularzy zapisu na newsletter
    • tworzenie nowych kart kontaktu w SALESmanago,
    • monitorowanie kontaktów zapisanych przez formularz zakupu i rejestracji
    • przy logowaniu system sprawdza, czy kontakt ma ciastko śledzące. Jeżeli nie – wysyła żądanie o dodanie ciastka. Jeżeli kontakt nie ma karty w systemie, to jest ona tworzona na podstawie danych z bazy Shopware.
  • Synchronizacja rejestracji klientów i ich danych z kartami kontaktów (dane są przekazywane przy rejestracji, logowaniu i zakupie):
    • imię i nazwisko,
    • adres fizyczny,
    • adres e-mail,
    • numer telefonu,
    • data urodzin,
    • nazwa firmy
    • status subskrypcji (opt-in/opt-out)
    • synchronizacja w przypadku modyfikacji powyższych danych
    • możliwość ustawienia tagów, z jakimi kontakty mają być przesyłane do systemu,
    • dodatkowo każdy kontakt, który wypełni formularz, dostaje tag SHOPWARE, oraz detal z wersją platformy,
  • Przekazywanie zdarzeń zewnętrznych typu Zakup i Koszyk dla wszystkich kontaktów
    • dla zdarzeń typu Koszyk przekazywanie danych o dodanych i usuniętych przedmiotach.
    • możliwość definiowania tagów: po rejestracji, zakupie lub zapisie na newsletter.


Instrukcja integracji

1. Pobierz wtyczkę.

2. Zaloguj się na swoje konto Shopware. Otwórz zakładkę Configuration i wybierz z listy Plugin Manager.
plugin-manager
3. W Plugin Manager wybierz Installed:
installed
4. Kliknij Upload Plugin, wybierz plik wtyczki integrującej i potwierdź. Wtyczka zostanie wczytana do Shopware.
choose
5. Na liście integracji pojawi się wtyczka SALESmanago.
lista1
6. Po prawej znajdż przycisk instalacji (plus) i kliknij go. Poczekaj, aż wtyczka się zainstaluje. Po udanej instalacji otworzy się okno konfiguracji. Wypełnij pola danymi. Następnie kliknij Save. Od tego momentu SALESmanago i Shopware będą zintegrowane.

WSKAZÓWKA: Pierwsze 4 pola muszą być wypełnione – jeśli któreś z nich zostanie puste, przy próbie aktywacji wtyczki wystąpi błąd.
CONFIG1

CONFIG-form

 

Specyfikacja Shopware

Shopware Download
Shopware GitHub Repository
Developer Guides
REST API Guide


Mechanizm przesyłania zdarzeń zewnętrznych

W tej integracji, do przesyłania informacji o zdarzeniach zewnętrznych służy metoda AddExtEvent. Może ona przyjmować różne typy zdarzeń – CART (dodawaniu produktu do koszyka) i PURCHASE (zakup produktów).

1. W polu Products przesyłane jest ID wszystkich produktów dodanych do koszyka (zdarzenie typu CART) lub kupowanych (zdarzenie typu PURCHASE) za każdym razem, kiedy produkt jest dodawany do koszyka lub kupowany. Jeśli dodawany jest koleiny produkt, przesyłane jest zdarzenie z ID wszystkich produktów, które są w tym momencie w koszyka / kupowane.

2. ID produktów powinny być oddzielone przecinkiem, mogą zawierać cyfry i litery alfabetu łacińskiego, nie mogą być dłuższe niż 32 znaki. ID produktów powinny pokrywać się z iD zawartymi w pliku XML.

3. Pole Value to wartość sumy produktów dodanych do koszyka (zdarzenie CART) / zakupu (zdarzenie PURCHASE).

4. W polu Lokalizacja możesz podać dowolną nazwę sklepu. Przy integracji z platformami sklepowymi najwygodniej będzie podać domenę, na której dokonywany jest zakup lub nazwę sklepu w platformie.