Wtyczka SALESmanago dla platformy Shoper to kompleksowe narzędzie umożliwiające integrację Twojego e-sklepu z systemem Customer Engagement. Dzięki niemu automatycznie zsynchronizujesz dane o Kontaktach oraz ich aktywnościach zakupowych, co pozwala na budowanie zaawansowanych scenariuszy Workflow i personalizację komunikacji.
1. Wstęp
W ramach integracji dostępne są następujące funkcjonalności:
- Automatyczna implementacja Kodu Monitorującego;
- Przesyłanie danych Kontaktów oraz informacji o ich zamówieniach;
- Bieżąca synchronizacja statusu subskrypcji newslettera;
- Obsługa procesu potwierdzenia subskrypcji (double opt-in);
- Przesyłanie zdarzeń typu KOSZYK i ZAKUPY;
- Automatyczne przypisywanie Tagów do Kontaktów na podstawie ich aktywności w sklepie;
- Pełne wsparcie techniczne dla środowisk typu multistore.
Integrację świetnie uzupełnia Storefront, który umożliwia błyskawiczne renderowanie nowoczesnego interfejsu sklepu oraz intuicyjne zarządzanie wyglądem za pomocą wizualnego edytora treści.
2. Instrukcja instalacji wtyczki
- Zaloguj się do swojego Panelu administracyjnego Shoper.
Szczegółowe informacje na temat uzyskiwania dostępu do konta znajdziesz w oficjalnej dokumentacji platformy: Jak zalogować się do Panelu administracyjnego sklepu? - Przejdź do sekcji menu: Dodatki i integracje > Aplikacje i wyszukaj: SALESmanago Platform na liście, a następnie kliknij: ZAINSTALUJ APLIKACJĘ
3. Zapoznaj się z opisem aplikacji oraz regulaminem App Store, zaakceptuj regulamin (A) i kliknij: Instaluj (B).
4. Po zainstalowaniu aplikacji znajdziesz ją w sekcji Panelu administracyjnego sklepu: Dodatki i integracje > Moje aplikacje. Kliknij ikonę konfiguracji, aby przejść do jej ustawień.

3. Opis konfiguracji wtyczki
Po przejściu do ustawień aplikacji, na ekranie zostanie wyświetlony ekran logowania do SALESmanago. Zaloguj się przy użyciu danych dostępowych do istniejącego konta w systemie SALESmanago.
UWAGA: Możesz użyć linku poniżej formularza logowania “Skorzystaj z darmowego okresu próbnego!“, aby utworzyć nowe konto.
Interfejs konfiguracyjny pluginu podzielony jest na dwie główne sekcje: Ustawienia integracji oraz Ustawienia Shoper.
Zakładka Ustawienia integracji
W tej zakładce znajdziesz parametry niezbędne do skonfigurowania połączenia między Shoperem a Twoim kontem SALESmanago.
Adresy callback dla Opt-in i Opt-out
Sekcja ta pozwala na dwukierunkową synchronizację statusu subskrypcji. Dzięki temu, gdy klient zapisze się do newslettera lub wypisze z niego w sklepie, informacja ta natychmiast trafi do systemu.
INFO: Synchronizacja działa w obie strony – jeśli status subskrypcji zostanie zmieniony ręcznie w SALESmanago, zmiana ta zostanie automatycznie odzwierciedlona w sklepie Shoper.
- Skopiuj wygenerowane linki i wklej je w systemie SALESmanago, przechodząc do Integracje > Callbacki.
Dane integracji SALESmanago
Pola w tej sekcji są uzupełniane automatycznie i zazwyczaj nie wymagają ręcznej edycji.
- ID Klienta: Unikalny identyfikator Twojego konta. Znajdziesz go w SALESmanago w panelu Integracje > API.
- Endpoint: Wskazuje na lokalizację Twojego konta w SALESmanago. Znajdziesz go w SALESmanago w panelu Integracje > API.
- ID sklepu (pole Location): Jest to identyfikator e-sklepu, który przesyłany jest w Zdarzeniach Zewnętrznych jako wartość pola Location.
WAŻNE: Ten sam numer musi zostać wpisany w SALESmanago w polu „Location” podczas dodawania pliku XML z Feedem produktowym w panelu Integracje > Katalogi i Feedy Produktowe oraz podczas dodawania Katalogu produktowego przez API. - Właściciel Kontaktów: Określa, do którego użytkownika w SALESmanago zostaną przypisane nowe Kontakty. Domyślnie jest to adres głównego konta, ale możesz go zmienić na inny adres e-mail widoczny na liście. Możesz zarządzać kontami użytkowników w SALESmanago przechodząc do Ustawienia > Konto > Użytkownicy.
Zakładka Ustawienia Shoper
Ta sekcja pozwala na doprecyzowanie, w jaki sposób system ma interpretować zachowania użytkowników na stronie.
Czas wygaśnięcia zdarzenia KOSZYK
W momencie dodania produktu do koszyka, system generuje zdarzenie KOSZYK w SALESmanago oraz tworzy ciasteczko SM_EVENT w przeglądarce klienta. Przez wybrany czas (np. 12h), każde kolejne działanie klienta w koszyku będzie aktualizować to samo, istniejące już zdarzenie.
Po upływie zdefiniowanego czasu (np. po 12 godzinach), ciasteczko SM_EVENT zostaje automatycznie usunięte. Każda kolejna aktywność klienta po tym terminie zostanie potraktowana jako zupełnie nowa sesja zakupowa. W efekcie dla kontaktu zostanie utworzone nowe zdarzenie KOSZYK oraz świeże ciasteczko SM_EVENT.
- Wybierz jak długo chcesz, aby jedno zdarzenie KOSZYK było ważne.
Ignorowane domeny email
Możesz wprowadzić domeny adresów e-mail, które nie będą przesyłane do SALESmanago.
- Wprowadź domeny oddzielone przecinkami (np. domena.pl, inna-domena.com).
Tagi przypisywane do Kontaktów
Ustaw Tagi, które będą automatycznie przypisywane do Kontaktów wysyłanych do SALESmanago w zależności od wykonanej akcji:
- Tagi przypisywane przy rejestracji: Przypisywane w momencie założenia konta w sklepie.
- Tagi przypisywane przy zapisie do newslettera: Przypisywane po wypełnieniu formularza newslettera.
- Tagi przypisywane przy zakupie: Przypisywane zalogowanym klientom po dokonaniu zakupu.
- Tagi przypisywane przy zakupie bez rejestracji: Pozwalają oznaczyć osoby kupujące jako goście.
UWAGA: W górnym pasku menu znajdziesz również przycisk Dezaktywuj wtyczkę.
Po kliknięciu przycisku Dezaktywuj wtyczkę, aplikacja pozostaje zainstalowana i widoczna na liście Twoich aplikacji w Shoperze, ale staje się nieaktywna. Oznacza to, że wszelka synchronizacja statusów oraz przesył danych między platformami zostają wstrzymane a skrypt monitorujący przestaje działać.





