PrestaShop: pierwsze kroki

Czego się dowiesz?

Nauczysz się, jak zintegrować swój sklep PrestaShop z Klaviyo. Klaviyo to rekomendowany partner PrestaShop w zakresie automatyzacji marketingu. Proces integracji obejmuje dwa kroki: instalację bezpłatnego modułu (PrestaShop Automation with Klaviyo) w PrestaShop oraz włączenie integracji w Klaviyo. Ten artykuł zawiera również informacje na temat monitorowania synchronizacji danych, konfigurowania e-maili transakcyjnych oraz aktualizacji modułu, co pozwoli Ci lepiej wykorzystywać możliwości Klaviyo. 

Kilka słów na początek

Aby korzystać z modułu Klaviyo, musisz mieć jedną z następujących wersji PrestaShop:

• PrestaShop od 1.7.0 do 8.x (z wersją PHP 7.1 lub nowszą)
  • Pamiętaj, że aby korzystać z naszej funkcji zgody na wysyłkę SMS-ów po przejściu na stronę płatności, musisz używać wersji 1.7.6 lub nowszej.
• PrestaShop Edition 8.0 lub nowsza
• PrestaShop Project 8.0 lub nowsza

Klaviyo nie jest obecnie kompatybilne z PrestaShop 9.

Jeśli korzystasz z PrestaShop w wersji starszej niż 1.7.0 i chcesz ją zaktualizować, tak by móc korzystać modułu Klaviyo, zapoznaj się z przewodnikiem PrestaShop na temat aktualizowania sklepu.

Przed integracją zapoznaj się z poniższymi informacjami:

• Moduł PrestaShop Automation with Klaviyo jest zainstalowany domyślnie w wersji PrestaShop Edition. Musisz go zainstalować, jeżeli korzystasz z innej wersji PrestaShop (więcej informacji znajdziesz w następnej sekcji). 
• PrestaShop Automation with Klaviyo ma na celu integrację z funkcjami panelu administracyjnego PrestaShop takimi jak PrestaShop Account. Podczas instalacji PrestaShop Automation w panelu administracyjnym otrzymasz prośby o zainstalowanie modułów PrestaShop Account, PrestaShop EventBus oraz PrestaShop Marketplace – dzięki temu możliwe będzie korzystanie z modułu Klaviyo.
• Nie planujesz integracji z funkcjami panelu administracyjnego sklepu PrestaShop? Możesz użyć naszego modułu Klaviyo by PrestaShop Partners, który zawiera ten sam zestaw funkcji co PrestaShop Automation with Klaviyo i nie wymaga modułu PS_MBO.

Chcesz zaktualizować swój obecny moduł Klaviyo? Więcej informacji na ten temat znajdziesz na końcu tego artykułu. 

Wideo instruktażowe

Instalacja modułu Klaviyo w PrestaShop

1. W przypadku PrestaShop Edition moduł PrestaShop Automation with Klaviyo jest zainstalowany domyślnie. Wykonaj następujące kroki:
   1. Zaloguj się do sklepu PrestaShop.
   2. W sekcji Konfiguruj w menu po lewej stronie wybierz Klaviyo.
   3. Aby dowiedzieć się, jak skonfigurować moduł, przejdź do następnej sekcji tego artykułu.
2. Jeśli nie korzystasz z PrestaShop Edition, przejdź na stronę modułu PrestaShop Automation with Klaviyo w PrestaShop Marketplace.
   
3. Na stronie modułu kliknij przycisk Pobierz. W razie potrzeby potwierdź swoje dane, a następnie wybierz wersję PrestaShop, z której korzystasz, i pobierz plik ZIP. Nie musisz go rozpakowywać.
   
4. Zaloguj się do sklepu PrestaShop i przejdź do Moduły > Menedżer modułów. Kliknij Prześlij moduł, a następnie przeciągnij plik ZIP do Menedżera modułów i go tam upuść.
   
5. Po instalacji moduł wyświetli komunikat o jej pomyślnym ukończeniu. Kliknij przycisk Konfiguruj i przejdź do następnej sekcji.

Konfiguracja modułu w PrestaShop

1. Koniecznie będzie trzeba pobrać publiczny klucz API Klaviyo (nazywany również identyfikatorem witryny), a także wygenerować prywatny klucza API Klaviyo do użytku w PrestaShop. 
   • Zaloguj się na stronie Klaviyo, a następnie w lewym dolnym rogu kliknij nazwę swojej organizacji.
   • Wybierz Ustawienia > Klucze API.
   • Skopiuj swój publiczny klucz API ze strony i wklej go w odpowiednim miejscu w PrestaShop.
   • W Klaviyo kliknij Utwórz prywatny klucz API, nadaj mu nazwę, wybierz Pełny klucz dostępu i kliknij Utwórz.
   • Bezpiecznie skopiuj nowo utworzony prywatny klucz API i wklej go w odpowiednim miejscu w PrestaShop.
2. Jeżeli chcesz, aby transakcyjne zdarzenia zamówień były synchronizowane w czasie rzeczywistym, włącz opcję Wysyłaj zdarzenia zamówień do Klaviyo w czasie rzeczywistym. Zdarzenia te mogą być używane do wysyłania wiadomości transakcyjnych i będą wyświetlane jako drugi zestaw zdarzeń oznaczonych jako transakcyjne (przykładowo oprócz synchronizowanej co 30 minut metryki Złożono zamówienie w Klaviyo pojawi się również metryka oznaczona jako Złożono zamówienie – wiadomość transakcyjna, która będzie synchronizowana w czasie rzeczywistym).
   
3. W razie potrzeby możesz aktywować opcję Wyłącz e-maile transakcyjne dotyczące zamówień generowane w PrestaShop. Zalecamy jednak, by do czasu skonfigurowania w Klaviyo e-maili transakcyjnych opcję tę pozostawić wyłączoną. Aby wyłączyć wysyłanie wiadomości z PrestaShop możesz w dowolnym momencie wrócić na tę stronę i aktywować tę funkcję. Uwaga: jeśli to zrobisz, e-maile transakcyjne powiązane ze zdarzeniami Złożono zamówienie, Zrealizowano zamówienie, Anulowano zamówienie i Zwrócono płatność za zamówienie, zostaną zablokowane. Tak samo będzie także w przypadku e-maili z przypomnieniem o płatności. 
4. Jeżeli chcesz synchronizować subskrybentów e-maili pozyskanych na stronie płatności lub za pomocą formularzy rejestracyjnych, włącz opcję Synchronizuj subskrybentów e-maili PrestaShop z Klaviyo.

5. Jeśli chcesz umożliwić użytkownikom wyrażanie zgody opt-in na marketing SMS-owy podczas finalizacji zamówienia, włącz opcję Synchronizuj subskrybentów SMS-ów PrestaShop z Klaviyo.

   Aby synchronizacja subskrybentów SMS-ów była możliwa, musisz wcześniej skonfigurować funkcję SMS w Klaviyo.

   

6. Kliknij przycisk Zapisz, aby kontynuować.
7. Jeżeli opcja synchronizacji subskrybentów e-maili została włączona, pojawi się komunikat z prośbą o wybranie listy z konta Klaviyo, do której chcesz dodawać subskrybentów i subskrybentki e-maili. Do wybranej listy dodawane będą wszystkie nowe osoby. Najlepiej skorzystać z listy e-mailowej.
8. Jeśli chcesz subskrybować profile na listę Klaviyo za pomocą modułu Newsletter Subscription PrestaShop, upewnij się, że moduł został włączony i jest w wersji 2.6.0 lub nowszej.
9. Jeśli opcja synchronizacji subskrybentów SMS-ów została włączona:
   1. Otrzymasz prośbę o wybranie listy z konta Klaviyo, do której chcesz dodawać subskrybentów SMS-ów. Do wybranej listy dodawane będą wszystkie nowe osoby. Zalecamy, by korzystać z osobnych list dla subskrybentów e-maili i SMS-ów.
   2. Wybierz Kiedy klienci dokonują subskrypcji? Może to mieć miejsce po przejściu na stronę płatności lub po złożeniu zamówienia.
   3. Dodaj etykietę zgody dla pola wyboru opcji marketingu. Użyj jasnego opisu informującego użytkowników, na co się zgadzają (np. „Zapisz się na otrzymywanie SMS-ów marketingowych“).
   4. Dodaj tekst zgody. Odpowiednia treść zgody jest wymagana ze względu na obowiązujące przepisy. Pamiętaj, aby zamieścić w swoich warunkach świadczenia usług i polityce prywatności warunki marketingu SMS-owego. Zwróć uwagę, że w polu zgody należy używać języka HTML. Przykładowa treść zgody:
      Zaznaczając to pole i wpisując swój numer telefonu powyżej, wyrażasz zgodę na otrzymywanie na podany numer marketingowych wiadomości tekstowych (np. informacji o promocji, przypomnień o porzuconym koszyku itd.) od [nazwa firmy]. Mogą obowiązywać opłaty za wiadomości i transmisję danych. Częstotliwość otrzymywania wiadomości jest różna. Możesz w dowolnym momencie zrezygnować z subskrypcji, odpowiadając STOP lub klikając link rezygnacji z subskrypcji (jeśli jest on dostępny). <a href="link">Polityka prywatności</a> i <a href="link">Warunki</a>.
   5. Aby dodać treść zgody w wersjach językowych obsługiwanych przez Twój sklep, możesz użyć opcji przełączania języka po prawej stronie pola. 
      
10. Kliknij przycisk Zapisz, aby kontynuować.
11. W następnym kroku wypełnij formularz mapowania statusów zamówienia, akceptując wartości domyślne lub wybierając inne. Statusy zamówień określają, które zdarzenia zamówień są rejestrowane w Klaviyo. Dla każdego zdarzenia zamówienia można wybrać wiele wartości. Aby zaznaczyć wiele z nich, klikaj je z wciśniętym klawiszem Cmd lub Ctrl. Ta sama wartość nie może zostać wybrana w więcej niż jednym zdarzeniu zamówienia. Zduplikowanie wartości spowoduje wyświetlenie komunikatu o błędzie i uniemożliwi zapisanie. Zarówno zdarzenia transakcyjne, jak i nietransakcyjne będą zgodne z wybranym mapowaniem zamówień.
12. Po zakończeniu konfiguracji statusów zamówień kliknij Zapisz.
13. Zobaczysz sekcję Kupony, w której możesz generować kupony. W polu Limit reguł koszyka wybierz opcję Jedna reguła koszyka na prefiks  lub Jedna reguła koszyka na zamówienie, aby ograniczyć sposoby użycia kuponów przez klientów. Domyślnie wybrana jest opcja Jedna reguła koszyka na prefiks, która uniemożliwia klientowi dodanie podczas finalizacji zakupu więcej niż jednego kodu z tym samym prefiksem.
    
14. Jeśli kody kuponów chcesz również generować za pomocą pola Liczba do wygenerowania, możesz wrócić do tej strony później. Aby dowiedzieć się więcej, przeczytaj o tym, jak tworzyć kupony statyczne dla PrestaShop.
15. W sekcji Znów dostępne zobaczysz przełącznik Powiadomienia e-mailowe, który aktywuje dostęp do wysyłki e-maili „znów dostępne“ w Klaviyo. Aby aktywować tę opcję, musisz mieć zainstalowany w PrestaShop moduł alertów pocztowych (mail alerts) i włączoną dostępność produktów:
    1. W osobnej karcie przejdź do Moduły > Menedżer modułów w panelu administracyjnym PrestaShop.
    2. Wyszukaj alerty pocztowe (mail alerts).
    3. Znajdź moduł i kliknij przycisk Zainstaluj.
       
    4. Po zainstalowaniu modułu kliknij przycisk Konfiguruj.
       
    5. Upewnij się, że opcja Dostępność produktów jest włączona.
       
    6. Kliknij Zapisz.
16. Aby umożliwić wysyłanie e-maili „Znów dostępne“ w Klaviyo, włącz przycisk Powiadomienia e-mailowe. Pamiętaj, że aktywowanie tej opcji wyłączy wysyłkę e-maili „Znów dostępne“ z poziomu PrestaShop. Aby rozpocząć wysyłanie, musisz jeszcze skonfigurować w Klaviyo sekwencję „Znów dostępne“.
    
17. Następnie w sekcji Konfiguruj w menu nawigacyjnym po lewej stronie kliknij Parametry zaawansowane. Następnie wybierz Usługi sieciowe. Skopiuj wygenerowany klucz usługi sieciowej Klaviyo i przejdź do następnej sekcji. 
    • Klucz ten zostanie użyty podczas włączania integracji w Klaviyo w kolejnym kroku. Warto sprawdzić, czy klucz usługi sieciowej ma prawidłowe uprawnienia Klaviyo: kliknij w tym celu ikonę ołówka znajdującą się obok klucza. Przewiń w dół listę wszystkich uprawnień i znajdź Klaviyo. Upewnij się, że wszystkie pola wyboru uprawnień są zaznaczone. Aby zastosować wszelkie zmiany, wybierz Zapisz.

Włączanie integracji w Klaviyo

1. Włącz na swoim koncie Klaviyo integrację z PrestaShop. W menu nawigacji Klaviyo po lewej stronie wybierz Integracje.
2. Kliknij Przeglądaj aplikacje, wyszukaj PrestaShop i wybierz kartę. Następnie kliknij przycisk Zainstaluj.
3. Na następnej stronie kliknij Połącz z PrestaShop.
   
4. Na kolejnej stronie w polu Adres URL sklepu wprowadź adres URL sklepu PrestaShop. Znajdziesz go na koncie PrestaShop w sekcji Parametry sklepu > Ruch i SEO > Adresy URL sklepu. Możesz też kliknąć Wyświetl mój sklep, aby z dowolnej strony na koncie szybko przejść do swojej witryny PrestaShop i uzyskać adres URL sklepu.
   
5. Do pola Klucz usługi sieciowej wklej klucz usługi sieciowej skopiowany z PrestaShop.
6. Jeśli chcesz przeliczać waluty używane w swoich sklepach na jedną walutę w Klaviyo, zaznacz opcję Przeliczaj wszystkie waluty na jedną walutę standardową i wybierz międzynarodowy kod waluty z rozwijanej listy.
   • To działanie nie spowoduje zmiany waluty na koncie Klaviyo. Informacje o tym, jak zmienić używaną na koncie walutę, znajdziesz w przewodniku na temat zmieniania waluty na koncie.
7. Pobierz listę swoich dostępnych sklepów PrestaShop, wybierając opcję Pobierz listę sklepów. Następnie zaznacz sklepy, które chcesz zintegrować. Aby kontynuować, musisz wybrać co najmniej jeden sklep.
8. Jeśli chcesz zsynchronizować warianty katalogów (nazywane również kombinacjami) PrestaShop z Klaviyo, zaznacz opcję Synchronizuj warianty. Warto to zrobić, ponieważ synchronizacja wariantów umożliwia korzystanie z sekwencji „Znów dostępne”, „Niski stan zapasów” i „Obniżka cen”.
   
9. Jeżeli wybierzesz opcję Synchronizuj warianty, opcja Synchronizuj stan zapasów zostanie zaznaczona automatycznie. Ustawienie to pozwoli okresowo synchronizować stany zapasów dla każdego z wariantów – dzięki temu sekwencje „Znów dostępne”, „Niski stan zapasów” i „Obniżka cen”. będą działać prawidłowo. Jeśli wybierzesz opcję Synchronizuj warianty, ale odznaczysz Synchronizuj stan zapasów, korzystanie z tych sekwencji nie będzie możliwe. Będziesz mieć jednak dostęp do danych dotyczących wariantów, które można wykorzystywać w e-mailach.
10. Na koniec wybierz opcję Dokończ konfigurację.
11. Na ekranie pojawi się komunikat o pomyślnym połączeniu kont.
    

Dane PrestaShop w Klaviyo

Z Klaviyo synchronizowane są trzy typy zdarzeń PrestaShop: 

• Zdarzenia zamówień, które są synchronizowane co 30 minut (np. Złożono zamówienie).
• Transakcyjne zdarzenia zamówień, które przy włączeniu są synchronizowane w czasie rzeczywistym (np. Złożono zamówienie – wiadomość transakcyjna).
• Zdarzenia Klaviyo w witrynie (n.p. Aktywność na stronie, Wyświetlono produkt i Dodano do koszyka). 

Dodatkowo z profilami Klaviyo synchronizowane są dane klientów z Prestashop takie jak adres e-mail, numer telefonu czy status zgody na wysyłkę e-maili albo SMS-ów. 

Wszystkie te zdarzenia można wyświetlić w Klaviyo, przechodząc do sekcji Dane analityczne > Metryki. Ustaw filtr na PrestaShop, aby zobaczyć standardowe i transakcyjne zdarzenia zamówień (będą oznaczone ikoną PrestaShop), lub na API, aby zobaczyć zdarzenia Klaviyo w witrynie (będą oznaczone ikoną koła zębatego). Pełną listę synchronizowanych metryk z PrestaShop znajdziesz w Informacjach dotyczących danych z PrestaShop.

Podczas pierwszej integracji z PrestaShop Klaviyo zsynchronizuje dane z ostatnich 90 dni, dzięki czemu możesz od razu angażować najnowszych klientów i klientki. Po synchronizacji danych z ostatnich 90 dni Klaviyo rozpocznie pełną synchronizację danych historycznych. W zależności od liczby zamówień, klientów i produktów w sklepie synchronizacja wszystkich danych może zająć od kilku minut do kilku dni.

Zalecamy, by do synchronizacji danych historycznych przydzielić co najmniej 1024 MB pamięci PHP. Umożliwi to jej szybsze zakończenie. Jeśli zajdzie taka potrzeba, po zakończeniu synchronizacji będzie można zmniejszyć wymagany przydział pamięci.

Gdy proces integracji dobiegnie końca, pozycja Integracja z PrestaShop w karcie Integracje zostanie oznaczona jako zakończona. Aby upewnić się, że wszystkie dane z PrestaShop zostały zsynchronizowane pomyślnie, możesz przez kilka dni lub tydzień sprawdzać łączną liczbę zamówień. Przed weryfikacją upewnij się, że strefa czasowa Twojego konta jest zgodna z ustawieniami w PrestaShop. Aby sprawdzić lub zaktualizować strefę czasową konta:

1. W lewym dolnym rogu kliknij nazwę swojej organizacji.
2. Wybierz Ustawienia.
3. Wybierz kartę Organizacja. 

Wysyłanie e-maili transakcyjnych

Chcesz wysyłać e-maile transakcyjne, wykorzystując dane zamówień synchronizowane w czasie rzeczywistym z PrestaShop? Aby to zrobić, musisz utworzyć w Klaviyo sekwencje od podstaw. Przeczytaj artykuł o tym, jak używać sekwencji do wysyłania e-maili transakcyjnych,i dowiedz się, jak działają w Klaviyo tego typu wiadomości. Skonfiguruj swoje sekwencje, a następnie skontaktuj się z zespołem Klaviyo ds. pomocy, aby je zatwierdzić. Kiedy to nastąpi, będzie można wyłączyć wysyłanie e-maili transakcyjnych w PrestaShop i aktywować sekwencje transakcyjne w Klaviyo. 

Ponowna synchronizacja katalogu

Możesz w dowolnym momencie ponownie zsynchronizować dane katalogu PrestaShop, przechodząc do karty Dane w integracjach:

1. W menu nawigacji Klaviyo po lewej stronie wybierz Integracje.
2. Wybierz z listy PrestaShop.
3. Kliknij kartę Dane.
4. W sekcji Zsynchronizuj dane katalogu kliknij Zsynchronizuj ponownie.Rozpocznie się ponowna synchronizacja katalogu.
   
5.  

Aktualizacja modułu

Używasz modułu PrestaShop w wersji starszej niż 1.4.1? Zalecamy natychmiastową aktualizację do wersji 1.4.1 lub nowszej. W starszych wersjach modułu korzysta się z interfejsów API Klaviyo w wersjach v1 i v2, które zostały wycofane i nie działają już prawidłowo.

Ponadto aktualizacja do wersji 1.4.1 lub nowszej umożliwi Ci korzystanie z poniższych funkcji wprowadzonych w wersji 1.3.0:

1. Łatwe wyświetlanie rzeczywistej ceny i podatku VAT dla produktów promowanych w e-mailach: pamiętaj, że aktualizacja z wersji starszej niż 1.2.10 do wersji 1.2.10 lub nowszej może wpłynąć na poprawne działanie szablonów e-mailowych. Co zrobić w takiej sytuacji dowiesz się z tego artykułu.
2. Wysyłanie e-maili transakcyjnych do klientów dzięki synchronizacji zdarzeń w czasie rzeczywistym
3. Szybkie generowanie kuponów i ich zbiorczy import do Klaviyo

Aby zaktualizować moduł do najnowszej wersji:

1. Zaloguj się do panelu administratora PrestaShop.
2. Przejdź do Moduły > Menedżer modułów.
3. Przewiń do modułu Klaviyo i wybierz Aktualizuj. 
   

Aby dowiedzieć się, jakie zmiany wprowadzono do poszczególnych wersji, przejdź do modułu Klaviyo w PrestaShop Marketplace, przewiń do sekcji Co nowego i kliknij Pokaż historię zmian. 

Rezultat 

Narzędzie PrestaShop zostało pomyślnie zintegrowane z Klaviyo. Od teraz możesz już używać Klaviyo do swoich działań marketingowych. 

Dodatkowe źródła

• Informacje dotyczące danych z PrestaShop
• Włączanie w PrestaShop ceny z VAT
• Tworzenie kuponów dla PrestaShop