Integracja Hummerce z Klaviyo przekazuje do tej platformy e-mail marketingu profile klientów zapisanych do newslettera, ich zamówienia, zachowanie w sklepie (obejrzane produkty, koszyk, rozpoczęte zamówienie) oraz katalog produktów. Dzięki temu w Klaviyo działają kampanie i automatyzacje oparte na prawdziwych danych sklepu - powitanie nowego subskrybenta, porzucony koszyk, wiadomości posprzedażowe. Sklep jest dla Klaviyo źródłem danych; wysyłkę, scenariusze i treść wiadomości prowadzi się w Klaviyo.
Stan na: aktualizacja 2026-10-29.
- Automatyzacje Klaviyo - powitanie po zapisie (welcome flow) i porzucony koszyk - dostają dane ze sklepu bez ręcznego eksportu: profil i zgodę, dodanie do koszyka i rozpoczęcie zamówienia.
- Zamówienia trafiają do Klaviyo z serwera sklepu, a nie z przeglądarki - blokery reklam ani przerwany powrót z płatności nie gubią sprzedaży w raportach przychodu.
- Wiadomości mogą pokazywać zdjęcie, nazwę i cenę produktu z katalogu sklepu, a rekomendacje pomijają towary niedostępne.
- Wypisanie się z maila w Klaviyo wraca do sklepu - zgoda na newsletter na koncie klienta gaśnie automatycznie.
- Zmiana danych klienta w sklepie trafia do profilu w Klaviyo w ciągu kilku minut.
- Przy zmianie systemu e-mail marketingu istniejący subskrybenci mogą przejść do Klaviyo z oryginalną datą zgody i bez wysyłki powitalnej.
- Obsługa w panelu sklepu widzi na karcie klienta i zamówienia, czy dane trafiły do Klaviyo, a zamówienie z błędem wysyłki jest oznaczone na liście zamówień.
Sklep przekazuje do Klaviyo wyłącznie klientów ze zgodą na newsletter. Osoba bez zapisu nie trafia tam w żadnej postaci - ani jej dane, ani jej zamówienia. Dlatego przychód i segmenty w Klaviyo obejmują sprzedaż od osób zapisanych, a nie cały obrót sklepu - to zamierzone zachowanie.
Wyjątkiem jest samo przeglądanie: anonimowe zdarzenia (np. obejrzenie produktu przed podaniem adresu e-mail) zbiera skrypt Klaviyo dla każdego, kto zgodził się na pliki cookie. Klaviyo wiąże je z profilem dopiero wtedy, gdy sklep pozna adres e-mail osoby zapisanej.
Dla klienta sklepu integracja jest niewidoczna - nie zmienia wyglądu sklepu.
- Sklep w tle wysyła do Klaviyo profil klienta ze zgodą: e-mail, imię i nazwisko, telefon, nazwę firmy, adres (ulica, kod, miasto, kraj, województwo), a także płeć, datę urodzenia, informację o koncie firmowym i NIP jako własne właściwości profilu.
- Puste pola nie są wysyłane - nie nadpisują danych, które Klaviyo już ma.
- Numer telefonu bez prefiksu kraju dostaje prefiks z ustawień sklepu. Numeru, którego nie da się poprawić, sklep nie wysyła - profil trafia do Klaviyo bez telefonu, a nie z błędem.
- Profil jest rozpoznawany po identyfikatorze klienta w sklepie i adresie e-mail. Profil, który Klaviyo założyło samo (np. z formularza lub importu), jest aktualizowany, a nie dublowany.
- Wycofanie zgody w sklepie wycofuje zgodę w Klaviyo.
Konto założone formularzem newslettera wnosi na start tylko adres e-mail i imię. Gdy taka osoba złoży zamówienie bez logowania i zaznaczy w nim zgodę marketingową, sklep uzupełnia jej konto danymi kupującego z zamówienia (bez adresu dostawy), a pełny profil trafia do Klaviyo. Danych konta zarejestrowanego, chronionego hasłem, zamówienie gościa nie zmienia.
- Dla każdego zamówienia zapisanego klienta sklep wysyła zdarzenie złożenia zamówienia (Placed Order) z numerem, wartością, kategoriami, nazwami produktów, kosztem dostawy, metodą płatności i wartością rabatu, a dla każdej pozycji zdarzenie zamówionego produktu (Ordered Product) z symbolem, nazwą, ilością, ceną, adresem i zdjęciem produktu.
- Wartość zamówienia niesie tylko zdarzenie złożenia zamówienia - przychód nie liczy się podwójnie.
- Ponowna wysyłka tego samego zamówienia nie tworzy duplikatu w Klaviyo.
- W zdarzeniu zamówienia profil jest wskazany tylko identyfikatorami kupującego - dane odbiorcy przesyłki (np. obdarowanego przy zakupie prezentu) nie trafiają do profilu.
- Przychód z kampanii Klaviyo przypisuje po profilu w oknie konwersji ustawionym na koncie Klaviyo (domyślnie 5 dni).
Zdarzenia z przeglądarki przekazuje skrypt Klaviyo uruchamiany przez Google Tag Manager na tej samej warstwie danych, z której korzysta Google Analytics 4:
| Zdarzenie w Klaviyo |
Kiedy |
| Viewed Product (i lista ostatnio oglądanych) |
wejście na kartę produktu |
| Added to Cart |
dodanie produktu do koszyka |
| Started Checkout |
pierwszy krok składania zamówienia |
| identyfikacja profilu |
sklep poznaje adres e-mail klienta |
| Active on Site |
rejestruje je sam skrypt Klaviyo |
Skrypt działa po zgodzie klienta na pliki cookie statystyczne i marketingowe (obie naraz). Zmiana zgody w trakcie wizyty działa od następnej otwartej strony; zdarzeń sprzed zgody sklep nie wysyła wstecz. W skrypcie na stronie jest tylko publiczny klucz Klaviyo.
- Klaviyo pobiera katalog ze sklepu jako plik XML (feed) - z identyfikatorem, nazwą, adresem, zdjęciem, opisem, ceną, kategoriami i dostępnością. Plik generuje moduł feedów - zob. Feedy produktowe i porównywarki.
- Katalog obejmuje wszystko, co można obejrzeć i zamówić - szerzej niż feedy reklamowe. Wiadomość, która odwołuje się do produktu spoza katalogu, nie zostanie wysłana.
- Towar chwilowo niedostępny zostaje w katalogu i wypada tylko z rekomendacji; znika dopiero towar wycofany z oferty.
- Artykuł z wariantami trafia do katalogu jako jedna pozycja z ceną "od".
- Klaviyo odświeża katalog co 6 godzin - to tempo narzuca Klaviyo.
Raz na godzinę sklep pobiera z Klaviyo profile, które się wypisały, i gasi zgodę na newsletter na koncie klienta o tym samym adresie e-mail. To jedyny kierunek przepływu danych z Klaviyo do sklepu.
Sklep, który wcześniej prowadził newsletter w innym systemie, może jednorazowo przenieść do Klaviyo istniejących subskrybentów:
- zgoda jest nadawana od razu, z oryginalną datą zgody (data potwierdzenia zapisu, a gdy jej brak - data założenia konta), bez wysyłki potwierdzającej i bez scenariusza powitalnego,
- osoba, która w międzyczasie wypisała się w Klaviyo, nie jest zapisywana ponownie,
- integracja z poprzednim systemem, która zmienia te same zgody, jest wyłączana na czas działania integracji z Klaviyo.
- Wysyłka działa w tle, w kolejce: profile i zamówienia co 5 minut, wypisania co godzinę.
- Na karcie klienta i zamówienia parametry zaczynające się od Klaviyo pokazują status wysyłki, liczbę błędów, treść ostatniego błędu i identyfikator profilu w Klaviyo.
- Rekord, którego nie udało się wysłać, jest ponawiany do Limitu ponowień. Po jego przekroczeniu zamówienie jest oznaczone na liście zamówień, z treścią błędu na karcie. Oznaczenie gaśnie samo, gdy zamówienie zostanie wysłane.
- Tryb testowy pozwala sprawdzić konfigurację bez wysyłania czegokolwiek do Klaviyo.
- Sklep (Hummerce) dostarcza dane: profile, zgody, zdarzenia zamówień, zdarzenia przeglądarkowe i katalog, w uzgodnionym zakresie pól. Odbiór jest obiektywny: uzgodnione zdarzenie dociera do Klaviyo z kompletem pól i poprawnymi wartościami.
- Sklep po stronie Klaviyo konfiguruje scenariusze (flow), kampanie, segmenty, szablony i treść wiadomości, listy i tryb potwierdzania zapisu (double opt-in), okno przypisywania przychodu, nadawcę i dostarczalność. Za skuteczność wysyłek (otwarcia, konwersje) odpowiada sklep.
Moduł działa na wersji Hummerce 2.35.
- Konto Klaviyo z prywatnym kluczem API i listą docelową - poza Hummerce, na warunkach Klaviyo. Każdy sklep (np. każda wersja językowa z osobnym kontem) ma własny klucz i listę.
- Newsletter - wymagany. Zgoda na newsletter, potwierdzenie zapisu i data zgody pochodzą z modułu newslettera. Pola formularza newslettera (np. imię) muszą zapisywać się na koncie klienta - inaczej profil w Klaviyo ma sam adres e-mail.
- Google Tag Manager i warstwa danych Google Analytics 4 - dla zdarzeń z przeglądarki.
- Narzędzie do zarządzania zgodami na pliki cookie - zob. Zgody cookies i Consent Mode.
- Moduł feedów - dla katalogu produktów.
- Parametry klienta: płeć, data urodzenia (typu data), województwo, konto firmowe - nazwy wskazuje się w ustawieniach zgodnie z konfiguracją danego sklepu.
- Brak innej aktywnej integracji newslettera, która zmienia te same zgody.
- Wymaga wdrożenia - moduł włącza się w konfiguracji sklepu i wymaga danych konta Klaviyo. Zakres:
- wpisanie klucza API, listy docelowej i prefiksu telefonu,
- wskazanie parametrów klienta (płeć, data urodzenia, województwo, konto firmowe) zgodnie z konfiguracją sklepu i sprawdzenie formularza newslettera,
- feed katalogu produktów i podłączenie go w panelu Klaviyo,
- zdarzenia z przeglądarki w kontenerze Google Tag Manager, z uruchamianiem po zgodzie na cookies,
- testy w trybie testowym, potem na koncie Klaviyo: profil i zgoda, zamówienie, zdarzenia z przeglądarki, katalog, wypisanie,
- ustawienie daty, od której wysyłane są zamówienia (zwykle data uruchomienia integracji), i włączenie wysyłki.
- Minimalny szacowany czas: od 16 h. Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- przeniesienie bazy subskrybentów z innego systemu e-mail marketingu (wyceniane osobno),
- liczba sklepów i kont Klaviyo (np. osobne wersje językowe),
- narzędzie zgód i kontener Google Tag Manager (gotowe w sklepie czy do wdrożenia),
- import historii zamówień (opcja wyceniana osobno),
- wersja sklepu - aktualizacja wyceniana osobno.
- Dobra praktyka przy starcie:
- konto produkcyjne Klaviyo powinno być czyste od początku - nazw metryk utworzonych w Klaviyo (także testowych) nie da się usunąć, a druga metryka o podobnej nazwie rozdziela raporty przychodu,
- tryb potwierdzania zapisu (double opt-in) list docelowych w Klaviyo warto sprawdzić przed uruchomieniem - ustawienie konta nie zmienia list już istniejących,
- scenariusz powitalny warto włączyć dopiero po przeniesieniu istniejącej bazy - inaczej obejmie wszystkich przenoszonych subskrybentów.
- Do Klaviyo trafiają tylko subskrybenci newslettera i ich zamówienia - przychód i segmenty w Klaviyo nie obejmują całego obrotu sklepu.
- Zamówienia sprzed uruchomienia integracji nie są przenoszone, więc automatyzacje posprzedażowe działają w pełni po kilku tygodniach. Import historii to osobna opcja.
- Klaviyo odświeża katalog co 6 godzin. Artykuł z wariantami jest w katalogu jedną pozycją z ceną "od".
- Zdarzenia z przeglądarki wymagają zgody klienta na cookies statystyczne i marketingowe.
- Scenariusze, kampanie, segmenty i treść wiadomości konfiguruje się w Klaviyo.
- Import historii zamówień do Klaviyo.
- Warianty towaru jako osobne pozycje katalogu.
- Zasilanie katalogu przez API Klaviyo zamiast feedu.
Czy Hummerce ma integrację z Klaviyo?
Tak. Sklep przekazuje do Klaviyo profile subskrybentów ze zgodą, zamówienia, zachowanie w sklepie (oglądane produkty, koszyk, rozpoczęte zamówienie) i katalog produktów, a wypisania z Klaviyo wracają do sklepu.
Czy do Klaviyo trafiają wszyscy klienci sklepu?
Nie. Trafiają tylko osoby zapisane do newslettera, razem ze swoimi zamówieniami. Dlatego przychód w Klaviyo obejmuje sprzedaż od subskrybentów, a nie cały obrót sklepu.
Czy integracja obsługuje porzucony koszyk?
Tak. Sklep przekazuje zdarzenia dodania do koszyka i rozpoczęcia zamówienia, a scenariusz porzuconego koszyka konfiguruje się w Klaviyo.
Czy przy przejściu na Klaviyo można zachować dotychczasowych subskrybentów?
Tak. Subskrybenci z poprzedniego systemu e-mail marketingu przechodzą jednorazowo z oryginalną datą zgody, bez maila potwierdzającego i bez scenariusza powitalnego.
Dlaczego zmiany ceny w sklepie nie widać od razu w mailu?
Klaviyo pobiera katalog produktów co 6 godzin - zmiany ceny i dostępności docierają z takim opóźnieniem.
Ile trwa wdrożenie integracji z Klaviyo?
Od 16 h - obejmuje konfigurację konta, parametrów klienta, feedu katalogu, zdarzeń w Google Tag Manager i testy. Przeniesienie bazy z innego systemu i import historii zamówień wyceniamy osobno.
Chcesz sprawdzić, jak integracja z Klaviyo może wspierać marketing Waszego sklepu? Umów bezpłatną prezentację.
- Konfiguracja w panelu: Ustawienia > Klaviyo:
- połączenie: Adres API (domyślnie adres API Klaviyo), Wersja API, Prywatny klucz API, Identyfikator listy docelowej, Prefiks telefonu (numery w formacie międzynarodowym), Tryb testowy (domyślnie włączony, działa bez restartu),
- parametry profilu: Nazwa parametru płci, Nazwa parametru daty urodzenia, Nazwa parametru województwa, Nazwa parametru konta firmowego - bez wartości domyślnych, nazwy z konfiguracji danego sklepu,
- wysyłka: Uruchom task osobno dla wysyłki zamówień, synchronizacji klientów, przeniesienia bazy z innego systemu, pobierania wypisań i czyszczenia logów (wyłączenie działa bez restartu); Limit rekordów na przebieg (domyślnie 100), Limit ponowień (domyślnie 10), Wysyłaj zamówienia utworzone po (data, od której wysyłane są zamówienia),
- przeniesienie bazy: nazwa parametru, który oznacza subskrybentów do przeniesienia,
- audyt komunikacji: Zapisuj komunikację na FTP, Rozszerzone logi, dane serwera plików, Przechowywanie audytu (dni) (domyślnie 30).
- Przy uruchomieniu sklep sprawdza konfigurację i zapisuje w logu braki (np. brak listy docelowej, brak nazwy parametru zgody) z opisem skutków.
- REST API: brak osobnych operacji dla Klaviyo.
- MCP: ogólne narzędzia konfiguracji modułu (
ec2_module_describe, ec2_config_search, ec2_config_get, ec2_config_set); wymagają konta z uprawnieniami administratora - zob. Asystent AI - serwer MCP.
Moduł nie ma tekstów w sklepie ani szablonów maili - maile wysyła Klaviyo.
Moduł sam zakłada parametry widoczne w panelu na karcie klienta i zamówienia:
| Parametr |
Na obiekcie |
Znaczenie |
| Status wysyłki do Klaviyo |
klient, zamówienie |
stan kolejki: do wysłania, do aktualizacji, do wypisania, wysłane, nie wysyłać, błąd |
| Liczba błędów wysyłki do Klaviyo |
klient, zamówienie |
licznik ponowień |
| Komunikat błędu Klaviyo |
klient, zamówienie |
treść ostatniego błędu z Klaviyo |
| Identyfikator profilu Klaviyo |
klient |
identyfikator profilu w Klaviyo |
| Wysłano do Klaviyo |
klient, zamówienie |
czy obiekt jest już w Klaviyo |