Shoper to jedna z wiodących polskich platform e-commerce. Jednym z rozwiązań oferowanych przez tę platformę jest Shoper Storefront, które umożliwia tworzenie sklepu internetowego poprzez układanie gotowych modułów na zasadzie drag & drop, czyli “przeciągnij i upuść”. Sklepy oparte na szablonie Storefront wymagają specjalnego procesu integracji z platformą SALESmanago, który opisano poniżej.

Jeżeli nie korzystasz z Shoper Storefront, przeprowadź integrację zgodnie z artykułem: Integracja z platformą Shoper >>

---

Proces integracji

1. Zainstaluj wtyczkę SALESmanago na platformie Shoper.
   Na panelu administratora na platformie Shoper, przejdź do Appstore (Aplikacje) i wyszukaj wtyczkę SALESmanago. Kliknij Zainstaluj aplikację.

• Po zainstalowaniu wtyczki, w menu po lewej stronie ekranu, w sekcji Dodatki i integracje, wybierz Moje aplikacje. Kliknij przycisk ustawień:

• Wprowadź adres e-mail oraz hasło, których używasz przy logowaniu się do systemu SALESmanago.

2. W menu po lewej stronie ekranu, w sekcji Wygląd i treści, przejdź do Wygląd sklepu → Twoje szablony graficzne. Znajdź na liście szablon Storefront, który chcesz zintegrować z SALESmanago. Najedź kursorem na pasek na dole kafelka i wybierz ikonę edycji:

• Przejdź do zakładki Moduły własne i kliknij Dodaj moduł.

• Sekcję Informacje podstawowe skonfiguruj w następujący sposób:

• W sekcji Kod źródłowy modułu, w polu JS, umieść Kod Monitorujący skopiowany z platformy SALESmanago (Menu → Integracje → Kod Monitorujący → Dodaj Kod Monitorujący). Po wklejeniu Kodu Monitorującego usuń z niego znacznik , który zostanie dodany automatycznie przez platformę Shoper.

• UWAGA: Pola Twig, Konfiguracja JSON oraz Tłumaczenia JSON pozostaw puste.
  Kliknij Zapisz, aby dodać nowy moduł.

3. Kliknij poniższy link, aby pobrać plik potrzebny na kolejnym etapie konfiguracji:
   Pobierz plik


4. Dodaj kolejny moduł własny.
   Sekcję Informacje podstawowe skonfiguruj tak samo jak w przypadku poprzedniego modułu (Moduł integracji, Moduł można przeciągnąć na dowolną stronę, Nie pozwól na wyłączanie modułu w SVE).
   W sekcji Kod źródłowy modułu, w polu JS, umieść całą treść pliku pobranego w punkcie 3. Następnie edytuj wartości następujących kluczy:

• [A] location – Podaj wartość pola location zdefiniowaną w ustawieniach wtyczki SALESmanago na platformie Shoper.

• [B] owner – Jako wartość tego klucza wprowadź adres e-mail użytkownika SALESmanago, który będzie właścicielem Kontaktów przesyłanych z platformy Shoper.

• [C] tags – Zdefiniuj tagi, które będą dodawane do Kontaktów w następstwie określonych zdarzeń:

• loginTag – Tag dodawany do Kontaktu po każdym zalogowaniu do twojego e-sklepu.
• registerTag – Tag dodawany do Kontaktu po rejestracji w twoim e-sklepie.
• purchaseTag – Tag dodawany do Kontaktu za każdym razem, gdy Kontakt dokona zakupu jako zalogowany użytkownik.
• guestPurchaseTag – Tag dodawany do Kontaktu za każdym razem, gdy Kontakt dokona zakupu jako gość.
• newsletterTag – Tag dodawany do Kontaktu po wyrażeniu zgody na otrzymywanie wiadomości marketingowych drogą mailową.

• [D] doubleOptin – Domyślna wartość tego klucza to 1, ponieważ Shoper nie umożliwia wyłączenia mechanizmu double opt-in.

• [E] debug – Jeżeli chcesz sprawdzić poprawność integracji w narzędziach deweloperskich integracji, zmień wartość tego klucza na true.

• UWAGA: Pola Twig, Konfiguracja JSON oraz Tłumaczenia JSON pozostaw puste.
• Kliknij Zapisz, aby dodać nowy moduł.

5. Dodaj domenę swojego e-sklepu na listę dozwolonych domen w systemie SALESmanago.
   Na platformie SALESmanago, przejdź do Menu → Integracje → Kod Monitorujący → Dozwolone domeny. Wpisz domenę swojego e-sklepu i kliknij Zapisz.

• UWAGA: Jeżeli nie widzisz na tym ekranie zakładki Dozwolone domeny poproś o włączenie tej funkcjonalności dla twojego konta. W tym celu napisz do nas na adres: support@salesmanago.com.
  UWAGA: Dodanie domeny do listy może trochę potrwać, dlatego odczekaj 1 godzinę, zanim przejdziesz do kolejnego kroku konfiguracji.

6. Dodaj domenę swojego e-sklepu do listy Frontend SDK.
   Na platformie SALESmanago przejdź do Menu → Integracje → API → zakładka Frontend SDK.
   UWAGA: Jeżeli nie widzisz na tym ekranie zakładki Frontend SDK, poproś o włączenie tej funkcjonalności dla twojego konta. W tym celu napisz do nas na adres: support@salesmanago.com.

• Kliknij Skonfiguruj nową domenę [A].
  Na kolejnym ekranie, wybierz z listy domenę swojego sklepu na platformie Shoper (jeżeli nie widzisz tej domeny na liście, oznacza to, że na twojej stronie nie ma wdrożonego Kodu Monitorującego – zob. punkt 2 powyżej). Wybierz właściciela Kontaktów (tego samego, który został wpisany w kluczu owner w punkcie 4 powyżej). Następnie określ uprawnienia dodawanej domeny.

Gotowe! Twoje konto SALESmanago zostało zintegrowane ze sklepem na platformie Shoper używającym szablonu typu Storefront.