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 9.1.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.
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:
- Jeśli korzystasz z wersji PrestaShop Edition, moduł PrestaShop Automation with Klaviyo jest zainstalowany domyślnie. Jeśli korzystasz z innej wersji PrestaShop, musisz go zainstalować (szczegóły 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.
- Zdecydowanie zaleca się dodanie adresów IP Klaviyo do białej listy dostawcy zapory sieciowej, aby zminimalizować problemy z uwierzytelnianiem i konfiguracją. Więcej informacji na ten temat znajdziesz w artykule na temat umieszczania adresów IP ruchu integracji Klaviyo na białej liście.
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
- W przypadku PrestaShop Edition moduł PrestaShop Automation with Klaviyo jest zainstalowany domyślnie. Wykonaj następujące kroki:
- Zaloguj się do sklepu PrestaShop.
- W sekcji Konfiguruj w menu po lewej stronie wybierz Klaviyo.
- Aby dowiedzieć się, jak skonfigurować moduł, przejdź do następnej sekcji tego artykułu.
- Jeśli nie korzystasz z PrestaShop Edition, przejdź na stronę modułu PrestaShop Automation with Klaviyo na platformie handlowej PrestaShop i przejdź do następnego kroku.

- 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 rozpakowywać pliku ZIP.

- Zaloguj się do sklepu PrestaShop i przejdź do Moduły > Menedżer modułów. Kliknij Prześlij moduł, a następnie przeciągnij i upuść plik ZIP w menedżerze modułów.

- 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
- Trzeba będzie 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.
- 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 (np. w Klaviyo oprócz metryki oznaczonej jako Złożono zamówienie, która będzie synchronizowana co 30 minut, zobaczysz też metrykę oznaczoną jako Złożono zamówienie – wiadomość transakcyjna, która będzie synchronizowana w czasie rzeczywistym).

- 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.
- 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.
- 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.
- Kliknij przycisk Zapisz, aby kontynuować.
- 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.

- 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.
- Jeśli opcja synchronizacji subskrybentów SMS-ów została włączona:
- 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.
- 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.
- 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“).
- Dodaj tekst zgody. Aby zapewnić zgodność z przepisami, musisz dodać tekst zgody. Pamiętaj, aby zamieścić w swoich warunkach świadczenia usług i polityce prywatności warunki marketingu SMS-owego. Pamiętaj, że w polu zgody należy użyć kodu 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>. - 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.

- Kliknij przycisk Zapisz, aby kontynuować.
- 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ń.
- Po zakończeniu konfiguracji statusów zamówień kliknij Zapisz.
- 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.

- 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.
- 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:
- W osobnej karcie przejdź do Moduły > Menedżer modułów w panelu administracyjnym PrestaShop.
- Wyszukaj alerty pocztowe (mail alerts).
- Znajdź moduł i kliknij przycisk Zainstaluj.

- Po zainstalowaniu modułu kliknij przycisk Konfiguruj.

- Upewnij się, że dostępność produktu jest włączona.

- Kliknij Zapisz.
- Wróć do ustawień modułu Klaviyo na pierwotnej karcie. Włącz przełącznik Powiadomienia e-mailowe, aby włączyć wysyłanie e-maili „znów dostępne” w Klaviyo, a następnie kliknij Zapisz. 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”.

- 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
- Włącz na swoim koncie Klaviyo integrację z PrestaShop. W menu nawigacji Klaviyo po lewej stronie wybierz Integracje.
- Kliknij Przeglądaj aplikacje, wyszukaj PrestaShop i wybierz kartę. Następnie kliknij przycisk Zainstaluj.
- Na następnej stronie kliknij Połącz z PrestaShop.

- 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.

- Do pola Klucz usługi sieciowej wklej klucz usługi sieciowej skopiowany z PrestaShop.
- Jeśli chcesz przeliczać zsynchronizowane wartości zamówień z Twoich sklepów na jedną walutę w Klaviyo, zaznacz opcję Przelicz wszystkie waluty na jedną walutę standardową i wybierz walutę z listy rozwijanej Waluta Standard. Klaviyo używa kursu wymiany obowiązującego w momencie przetwarzania danych. Zmiana tego ustawienia nie przeliczy danych, które zostały już zsynchronizowane z Klaviyo.
- 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.
- 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.
- W sekcji Synchronizacja katalogu wybierz Synchronizuj warianty, aby zsynchronizować warianty katalogu (nazywane również kombinacjami) z PrestaShop do Klaviyo. Ta opcja jest wybierana automatycznie dla zgodnych modułów. Jeśli zobaczysz komunikat z prośbą o uaktualnienie, zaktualizuj moduł Klaviyo w PrestaShop, a następnie ponownie kliknij Pobierz listę sklepów. Zalecamy synchronizację wariantów, aby obsługiwać sekwencje znów dostępne, niski stan zapasów i obniżka cen.

- Jeżeli wybierzesz opcję Synchronizuj warianty, opcja Synchronizuj stan zapasów zostanie zaznaczona automatycznie. To ustawienie synchronizuje poziom zapasów dla każdego wariantu co 30 minut–8 godzin, aby obsługiwać sekwencje „Znów dostępne”, „Niski stan zapasów” i „Obniżka cen”. 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.
- Na koniec wybierz opcję Dokończ konfigurację.
- 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 synchronizuje do 5 lat historycznych danych o zamówieniach, klientach i produktach. W zależności od liczby zamówień, klientów i produktów w Twoim sklepie ukończenie synchronizacji historycznej 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.
Aby sprawdzić postęp synchronizacji, otwórz Integracje > PrestaShop i wybierz kartę Dane. Gdy synchronizacja historyczna zostanie ukończona, możesz przez kilka dni lub tydzień porównać łączną liczbę zamówień. Przed rozpoczęciem weryfikacji upewnij się, że strefa czasowa Twojego konta jest zgodna z ustawieniami w PrestaShop. Aby sprawdzić lub zaktualizować strefę czasową Twojego konta:
- W lewym dolnym rogu kliknij nazwę swojej organizacji.
- Wybierz Ustawienia.
- Wybierz kartę Organizacja. W sekcji Strefa czasowa wybierz strefę czasową używaną przez Twój sklep PrestaShop, a następnie kliknij Zapisz.
Wysyłanie e-maili transakcyjnych
Aby wysyłać e-maile transakcyjne z użyciem danych o zamówieniach PrestaShop w czasie rzeczywistym, utwórz w Klaviyo sekwencje wyzwalane metryką. Potrzebujesz płatnego konta Klaviyo, a status transakcyjny ustawia się dla każdego e-maila, a nie dla całej sekwencji. Przeczytaj Jak używać sekwencji do wysyłania e-maili transakcyjnych, aby poznać wymagania i proces zatwierdzania. Używaj e-maili, dla których nie skonfigurowano testu A/B, i zadbaj o to, aby ich treści były wolne od promocji marketingowych.
- Utwórz sekwencję od podstaw, używając jako wyzwalacza odpowiedniej metryki PrestaShop w czasie rzeczywistym, takiej jak Placed Order Transactional, i dodaj wiadomość e-mail.
- Wybierz e-mail, ustaw go na Ręcznie i przygotuj jego treść. Nie wysyłaj go ręcznie, gdy oczekuje na zatwierdzenie transakcyjne, ponieważ zostanie potraktowany jako e-mail marketingowy.
- W sekcji Transakcyjne wybierz Wnioskuj o status transakcyjny. Kliknij Prześlij do weryfikacji, a następnie Prześlij w oknie dialogowym potwierdzenia. Jeśli zamiast tego Twoje konto wyświetla Zapisz, kliknij je, a następnie wybierz Potwierdź, aby potwierdzić, że treść jest transakcyjna.
- Gdy e-mail ma status transakcyjny, wyłącz odpowiadające mu e-maile transakcyjne w PrestaShop, aby uniknąć podwójnej wysyłki. Następnie ustaw e-mail w Klaviyo na Aktywne i kliknij Zapisz. Powtórz kroki dotyczące statusu transakcyjnego dla każdego e-maila, który chcesz wysyłać jako transakcyjny.
Ponowna synchronizacja katalogu
Możesz w dowolnym momencie ponownie zsynchronizować dane katalogu PrestaShop, przechodząc do karty Dane w integracjach:
- W menu nawigacji Klaviyo po lewej stronie wybierz Integracje.
- Wybierz z listy PrestaShop.
- Kliknij kartę Dane.
- W sekcji Zsynchronizuj dane katalogu kliknij Zsynchronizuj ponownie.Rozpocznie się ponowna synchronizacja katalogu.

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.
Uaktualnienie do wersji 1.4.1 lub nowszej zapewnia też dostęp do następujących funkcji:
- Ł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.
- Wysyłanie e-maili transakcyjnych do klientów dzięki synchronizacji zdarzeń w czasie rzeczywistym
- Szybkie generowanie kuponów i ich zbiorczy import do Klaviyo
Aby zaktualizować moduł do najnowszej wersji:
- Zaloguj się do panelu administratora PrestaShop.
- Przejdź do Moduły > Menedżer modułów.
- Przewiń do modułu Klaviyo i wybierz Aktualizuj.

W przypadku aktualizacji z wersji starszej niż 1.3.0 należy pamiętać, że po jej wykonaniu przestaną działać linki do odtwarzania koszyków użyte w e-mailach o porzuconych koszykach zakupowych wysłanych przed aktualizacją. Wszystkie e-maile o porzuconych koszykach wysyłane po aktualizacji będą jednak działać poprawnie.
Aby dowiedzieć się, jakie zmiany wprowadzono do poszczególnych wersji,przejdź do modułu Klaviyo w PrestaShop Marketplace , przewiń w dół 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
Dowiedz się więcej o metrykach i danych klientów synchronizowanych z PrestaShop do Klaviyo. Z PrestaShop do Klaviyo synchronizują się 3 typy zdarzeń:
- Korzystanie w PrestaShop z cen zawierających podatek VAT
Naucz się, jak uwzględnić w cenach w sklepie PrestaShop podatek VAT i synchronizować z Klaviyo dane na ten temat. Dane cen z PrestaShop zostaną zsynchronizowane z katalogiem produktów Klaviyo wraz ze zdarzeniami Wyświetlono produkt i Dodano do koszyka.
- Jak tworzyć kupony statyczne dla PrestaShop
Dowiedz się, jak tworzyć kupony PrestaShop za pomocą modułu Klaviyo w PrestaShop. Możesz przesłać te kupony do Klaviyo i uwzględnić je w wiadomościach, aby wzbudzić u klientów entuzjazm związany z promocjami w Twojej witrynie.