Skorzystaj z możliwości połączenia swojego sklepu internetowego na WooCommerce z Ecomailem i przesyłaj dane o klientach oraz ich zakupach.
Integracja Ecomail z WordPress za pomocą wtyczki WooCommerce
Spis treści:
1. Wymagania
WordPress 7.0 lub nowszy
WooCommerce 10.9 lub nowszy
PHP 8.2 lub nowszy z rozszerzeniem OpenSSL
działający WP-Cron (wtyczka przetwarza dane w tle za pomocą harmonogramu WooCommerce)
Wtyczka obsługuje nowy sposób przechowywania zamówień WooCommerce (HPOS) oraz blokowy checkout. WordPress Multisite nie jest na razie obsługiwany.
Uwaga ⚠️: Jeśli Twoja strona działa na starszej wersji PHP, WordPressa lub WooCommerce, WordPress nie zaproponuje aktualizacji do wersji 2.5.0, a wtyczka pozostanie w wersji 2.4.3. Poproś swój hosting o aktualizację PHP.
2. Funkcje wtyczki
Synchronizacja kontaktów
Zapisanie kontaktu do newslettera przy składaniu zamówienia, jeśli klient nie zaznaczy pola o rezygnacji. Działa w klasycznym i blokowym checkoucie oraz przy późniejszym opłaceniu zamówienia.
Zapisanie i wypisanie klienta w sekcji Moje konto.
Wybór listy kontaktów, do której przenoszone są kontakty.
Wybór przenoszonych danych: imię, nazwisko, adres, firma, telefon i język sklepu.
Własna nazwa źródła kontaktu (źródło API), dzięki której rozróżnisz kontakty w Ecomailu.
Własny tekst pola rezygnacji z newslettera.
Możliwość pominięcia double opt-in, uruchamiania automatyzacji, aktualizacji danych kontaktu oraz ponownego zapisania po nowym zamówieniu.
Synchronizacja początkowa istniejących klientów i zamówień, która działa w tle. W trakcie jej trwania możesz zamknąć stronę.
Śledzenie i automatyzacje e-commerce (tylko plany Marketer+ i CDP)
Przenoszenie zamówień i zmian ich statusów.
Śledzenie zawartości koszyka na potrzeby automatyzacji porzuconego koszyka.
Przenoszenie do 20 kategorii dla każdego produktu, maksymalnie 100 znaków na kategorię.
Śledzenie ostatnio oglądanego produktu (dla merge tagu ECM_LAST_VIEW).
Wstawienie kodu śledzącego do monitorowania odwiedzin strony.
Identyfikacja zalogowanego klienta podczas śledzenia.
Śledzenie na stronie (kod śledzący, koszyk i ostatnio oglądany produkt) działa tylko w przypadku odwiedzających, którzy wyrazili zgodę na marketingowe pliki cookie. Więcej w rozdziale 5.2.
Ustawienia, zarządzanie i konserwacja
Przełącznik całej integracji. Wyłączając go, wstrzymasz całą komunikację z Ecomailem bez dezaktywacji wtyczki. Rozpoczęte zadania po ponownym włączeniu będą kontynuowane od miejsca, w którym zostały przerwane.
Klucz API jest przechowywany w postaci zaszyfrowanej.
Przyciski do testowania połączenia i odświeżania list kontaktów.
Podgląd komunikacji z Ecomailem (Logi żądań API) bezpośrednio w ustawieniach wtyczki. Nie zawiera danych osobowych klientów ani klucza API i jest przechowywany przez 7 dni.
Bardziej szczegółowe logi dla działu wsparcia znajdziesz w WooCommerce → Status → Logi.
Panel administracyjny wtyczki jest dostępny w języku czeskim, słowackim, polskim i angielskim, zgodnie z językiem WordPressa.
Obsługa WP Consent API i banerów cookie, np. Complianz.
Dwukierunkowa synchronizacja statusu zapisu
Status zapisu do newslettera synchronizuje się w obu kierunkach (Ecomail ⇆ WooCommerce). Wymaga to skonfigurowania webhooka, patrz rozdział 5.3.
W widoku Użytkownicy w WordPressie widzisz status zapisu każdego klienta (1) i możesz według niego filtrować (2).
Klient widzi swój status w sekcji Moje konto i może się tam zapisać lub wypisać.
3. Jakie kontakty są przenoszone do Ecomaila?
Od momentu instalacji wtyczki przenoszeni są:
klienci z zamówień (zarejestrowani i kupujący bez rejestracji), jeśli nie zaznaczyli rezygnacji z newslettera,
klienci, którzy zapiszą się w sekcji Moje konto.
Sama rejestracja w sklepie nie przenosi kontaktu do Ecomaila.
Klientów i zamówienia, które już masz w sklepie, prześlesz za pomocą synchronizacji początkowej (rozdział 5.4) lub importu kontaktów.
Tagi
wp – kontakt przeniesiony z WooCommerce,
wp_order – kontakt z zamówieniem,
wp_newsletter – kontakt zapisany do newslettera.
Wtyczka tagi wyłącznie dodaje. Tagi, które kontakt ma w Ecomailu z innych źródeł, zostają zachowane. Gdy klient się wypisze, usuwany jest tag wp_newsletter.
Uwaga ⚠️: Od wersji 2.2.0 klient jest zawsze zapisywany do newslettera, o ile nie zaznaczy pola „Nie chcę otrzymywać newslettera”. Tekst pola możesz zmienić w ustawieniach wtyczki. Jeśli pole wyłączysz, zapisany zostanie każdy klient. Upewnij się, że masz podstawę prawną do wysyłania newsletterów.
4. Instalacja i aktualizacja
Wtyczkę zainstalujesz bezpośrednio z panelu WordPressa albo pobierzesz ją z wordpress.org i wgrasz ręcznie.
4.1. Instalacja z panelu administracyjnego
W panelu WordPressa otwórz Wtyczki → Dodaj wtyczkę i w polu wyszukiwania wpisz „ecomail”. Przy wtyczce Ecomail kliknij Zainstaluj teraz, a następnie Włącz. Jeśli wtyczka jest już zainstalowana, przycisk pokazuje status Aktywna.
Przejdź do konfiguracji opisanej w rozdziale 5.
4.2. Instalacja ręczna
Pobierz wtyczkę z wordpress.org. W panelu WordPressa otwórz Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer, wybierz pobrany plik i kliknij Włącz wtyczkę.
4.3. Aktualizacja ze starszej wersji
Przed aktualizacją wykonaj kopię zapasową strony.
Aktualizacja nie usuwa ustawień, klientów ani zamówień. Klucz API zostanie automatycznie przekonwertowany do postaci zaszyfrowanej.
Po aktualizacji otwórz Ustawienia → Ecomail, kliknij Przetestuj połączenie z Ecomailem i sprawdź wybraną listę kontaktów.
Sprawdź, czy adres URL webhooka w Ecomailu odpowiada adresowi URL wyświetlanemu we wtyczce (rozdział 5.3).
Sprawdź ustawienia zgody na pliki cookie (rozdział 5.2). Bez nich śledzenie na stronie nie jest wysyłane.
Złóż zamówienie testowe i sprawdź, czy dotarło do Ecomaila.
Jeśli z jakiegokolwiek powodu wrócisz do starszej wersji 2.4.3, wprowadź klucz API ponownie. Starsza wersja nie odczyta zaszyfrowanego klucza.
5. Konfiguracja
Ustawienia znajdziesz w panelu WordPressa w sekcji Ustawienia → Ecomail.
5.1. Połączenie z Ecomailem
W polu Klucz API wklej klucz API z Ecomaila. Znajdziesz go w aplikacji Ecomail w sekcji Zarządzanie kontem → Dla programistów.
W polu App ID wpisz nazwę swojego konta, czyli pierwszą część adresu, pod którym korzystasz z Ecomaila (np. dla adresu mojsklep.ecomailapp.pl jest to „mojsklep”).
Kliknij Zapisz zmiany na pasku, który po zmianie ustawień pojawi się u góry strony.
Kliknij Przetestuj połączenie z Ecomailem. U góry powinien pojawić się status połączenia „połączono”.
Kliknij Odśwież listy kontaktów i w polu Lista do zapisu w checkoucie wybierz listę, do której mają być przenoszone kontakty.
W polu Pola w checkoucie wybierz dane, które mają być przenoszone do kontaktów.
Pozostałe opcje ustaw według swoich potrzeb i zapisz zmiany.
Po zapisaniu pole Klucz API pozostaje puste, mimo że klucz jest zapisany. Ze względów bezpieczeństwa klucz nie jest już wyświetlany. Jeśli pozostawisz pole puste, zapisany klucz nie zostanie zmieniony.
💡 WSKAZÓWKA: W polu Źródło API możesz ustawić własną nazwę źródła kontaktów (domyślnie „woocommerce”). Dzięki niej łatwo rozróżnisz i posegmentujesz kontakty w Ecomailu. Nazwa może zawierać małe litery bez znaków diakrytycznych, cyfry i podkreślnik.
5.2. Zgoda na pliki cookie
Śledzenie na stronie (odwiedziny stron, zawartość koszyka i ostatnio oglądany produkt) jest wysyłane tylko w przypadku odwiedzających, którzy wyrazili zgodę na marketingowe pliki cookie. Wtyczka rozpoznaje zgodę na jeden z dwóch sposobów:
WP Consent API – jeśli masz zainstalowaną wtyczkę WP Consent API i baner cookie, który ją obsługuje (np. Complianz), wtyczka przejmie zgodę automatycznie i nie musisz niczego więcej konfigurować.
Nazwa i wartość pliku cookie – w przeciwnym razie w sekcji Zgoda na śledzenie zachowań wypełnij pola Nazwa marketingowego pliku cookie i Wartość marketingowego pliku cookie. Dla wtyczki Complianz wpisz nazwę cmplz_marketing i wartość allow. W przypadku innego banera cookie lub własnego rozwiązania wpisz nazwę i wartość pliku cookie, który jest zapisywany przy zgodzie na marketingowe pliki cookie.
W sekcji Zgoda na śledzenie zachowań wtyczka pokazuje, który sposób rozpoznała na Twojej stronie.
Uwaga ⚠️: Od wersji 2.5.0 obowiązuje zasada, że jeśli zgody nie da się zweryfikować (nie jest zainstalowane WP Consent API, a pola dotyczące pliku cookie są puste), śledzenie na stronie nie jest wysyłane w ogóle. Zamówienia i zapisy do newslettera są przenoszone również bez zgody na pliki cookie.
5.3. Synchronizacja dwukierunkowa (webhook)
W Ustawienia → Ecomail znajdź sekcję Webhook dla zmian subskrypcji i skopiuj cały adres URL webhooka.
W aplikacji Ecomail otwórz listę kontaktów, której używasz dla WooCommerce, i przejdź do Ustawienia listy → Ustawienia webhooka.
Włącz opcję Wysyłaj informacje na webhook, wklej skopiowany adres URL i zapisz zmiany.
Od tej chwili zmiana statusu kontaktu będzie przenoszona z Ecomaila (wypisanie z kampanii, automatyzacja itp.) do WooCommerce i odwrotnie – z WooCommerce (zapis lub wypisanie w sekcji Moje konto) do Ecomaila.
Adres URL webhooka zawiera tajny klucz, dlatego nikomu go nie przesyłaj. Jeśli zmienisz go, klikając Wygeneruj ponownie token webhooka, stary adres URL przestanie działać i nowy trzeba będzie wkleić również w Ecomailu.
5.4. Synchronizacja początkowa
Sekcję Synchronizacja początkowa znajdziesz pod głównymi ustawieniami w Ustawienia → Ecomail. Do wyboru masz:
Synchronizuj klientów – przesyła zarejestrowanych klientów oraz użytkowników, którzy mają zamówienie,
Synchronizuj klientów i zamówienia – przesyła klientów oraz ich dotychczas nieprzeniesione zamówienia,
Aktualizuj znane zamówienia – aktualizuje zamówienia, które już są w Ecomailu.
Synchronizacja działa w tle, a jej postęp jest zapisywany. Możesz zamknąć stronę i wrócić później. Nieudaną synchronizację możesz wznowić od miejsca, w którym się zatrzymała, przyciskiem Ponów zadanie. Po zakończeniu kliknij Usuń zakończone zadanie, aby móc uruchomić kolejne. Rekordy, których nie udało się przenieść, znajdziesz w ramce Rekordy wymagające sprawdzenia.
Warto wiedzieć:
Klienci, którzy się wypisali lub przy ostatnim zamówieniu zrezygnowali z newslettera, są pomijani.
Kupujący bez rejestracji nie są przesyłani w ramach synchronizacji początkowej. Ich nowe zamówienia są przenoszone na bieżąco, jeśli masz włączone śledzenie zamówień.
Zarejestrowany klient bez zamówienia i bez znanej zgody na newsletter zostanie przesłany jako wypisany. Status kontaktów, które już są w Ecomailu, się nie zmienia.
Zbiorczo przesłane zamówienia nie uruchamiają automatyzacji z wyzwalaczem „Złoży zamówienie”.
Zbiorcze przesyłanie pomija double opt-in. Przed uruchomieniem upewnij się, że masz zgodę na wysyłanie newsletterów.
Jeśli synchronizacja na wolniejszym hostingu nie postępuje, zmniejsz rozmiary partii w sekcji Ustawienia partii i sprawdź, czy na stronie działa WP-Cron.
6. Najczęściej zadawane pytania
1. Dlaczego do zamówienia nie zostało przeniesione ID produktu?
Jako ID produktu do Ecomaila przenoszony jest kod SKU, który uzupełniasz przy produkcie w WooCommerce. Jeśli produkt nie ma SKU, przenoszony jest wewnętrzny numer produktu (lub wariantu) z WooCommerce. Jeśli chcesz widzieć w Ecomailu własne oznaczenia produktów, uzupełnij SKU przy produktach. W ustawieniu SKU pomoże Ci wsparcie WooCommerce.
2. W jakich sytuacjach do kontaktu będą wysyłane dane o porzuconym koszyku?
Aby do kontaktu były przenoszone zdarzenia dodania produktu do koszyka, wtyczka musi znać adres e-mail odwiedzającego, a odwiedzający musi wyrazić zgodę na marketingowe pliki cookie. Szczegóły znajdziesz w artykule o automatyzacji porzuconego koszyka.
W WooCommerce wtyczka zna adres e-mail odwiedzającego w następujących przypadkach:
odwiedzający jest zalogowany na swoje konto klienta w sklepie,
odwiedzający wpisał swój e-mail w checkoucie.
Odwiedziny strony śledzi niezależnie kod śledzący. Może on rozpoznać kontakt również po kliknięciu w link z newslettera – więcej w artykule o implementacji kodu śledzącego.
3. Dlaczego pole Klucz API jest po zapisaniu puste?
Klucz jest przechowywany w postaci zaszyfrowanej i ze względów bezpieczeństwa nie jest już wyświetlany. Jeśli nie chcesz zmieniać klucza, pozostaw pole puste. Nowy klucz zapiszesz, wklejając go do pola i zapisując zmiany.
4. Po przeniesieniu strony przestało działać połączenie z Ecomailem. Co zrobić?
Klucz API jest szyfrowany za pomocą kluczy bezpieczeństwa Twojego WordPressa. Jeśli się zmienią (np. przy przeniesieniu strony na inny hosting lub po interwencji bezpieczeństwa), wtyczka nie odczyta zapisanego klucza i wyświetli ostrzeżenie. Wystarczy ponownie wkleić klucz API, zapisać go i przetestować połączenie.
5. Dlaczego nie jest wysyłane śledzenie koszyka lub odwiedzin strony?
Sprawdź, czy masz włączone odpowiednie śledzenie w ustawieniach i czy Twój plan obsługuje śledzenie (Marketer+ i CDP).
Sprawdź ustawienia zgody na pliki cookie (rozdział 5.2). Bez zweryfikowanej zgody śledzenie nie jest wysyłane.
Przetestuj to w oknie incognito przeglądarki: zaakceptuj marketingowe pliki cookie w banerze cookie, a następnie dodaj produkt do koszyka.
6. Zamówienie lub kontakt nie zostały przeniesione do Ecomaila. Jak sprawdzić dlaczego?
W Ustawienia → Ecomail kliknij Przetestuj połączenie z Ecomailem.
W tych samych ustawieniach otwórz Logi żądań API i wyszukaj numer zamówienia. Zobaczysz, czy Ecomail przyjął żądanie, czy zwrócił błąd.
W WooCommerce → Status → Zaplanowane działania sprawdź, czy działania wtyczki Ecomail są przetwarzane. Jeśli długo czekają, na stronie nie działa WP-Cron. Skontaktuj się ze swoim hostingiem.
Jeśli kontaktujesz się z naszym działem wsparcia, prześlij nam czas i identyfikator (correlation ID) z logu. Nigdy nie przesyłaj nam klucza API ani adresu URL webhooka.
7. Dlaczego WordPress nie proponuje mi aktualizacji do wersji 2.5.0?
Wersja 2.5.0 wymaga PHP 8.2, WordPressa 7.0 i WooCommerce 10.9 lub nowszych. Jeśli Twoja strona działa na starszej wersji, WordPress nie zaproponuje aktualizacji, a wtyczka pozostanie w wersji 2.4.3. Zaktualizuj WordPressa i WooCommerce oraz poproś hosting o nowszą wersję PHP.
8. Czy odinstalowanie wtyczki usunie dane sklepu?
Nie. Klienci, zamówienia ani produkty nigdy nie są usuwane. Ustawienia wtyczki i logi zostaną usunięte tylko wtedy, gdy wyraźnie włączysz tę opcję w sekcji Odinstalowanie.
❓
Jeśli masz pytania, napisz do nas na [email protected]