---
title: "Jak zintegrować ze Spree"
description: "Dowiedz się, jak zintegrować Spree z Klaviyo. Po wykonaniu tych kroków będzie można personalizować i targetować wiadomości e-mail na podstawie zakupów i aktywności na stronie każdego klienta. Oto dane, które synchronizujemy ze Spree:"
canonical_url: "https://help.klaviyo.com/hc/pl-pl/articles/115005255448"
markdown_url: "https://help.klaviyo.com/hc/pl-pl/articles/115005255448.md"
locale: "pl-pl"
category: "Integracje"
section: "Spree"
updated: "2025-07-30"
---

# Jak zintegrować ze Spree

## Czego się dowiesz?

Dowiedz się, jak zintegrować Spree z Klaviyo. Po wykonaniu tych kroków będzie można personalizować i targetować wiadomości e-mail na podstawie zakupów i aktywności na stronie każdego klienta. Oto dane, które synchronizujemy ze Spree:

- Dane sprzedaży i zamówień, w tym informacje o tym, które produkty zostały zakupione, zdjęcia produktów, szczegóły wariantu oraz wszelkie zastosowane rabaty

- Informacje o kliencie, w tym imię, nazwisko i lokalizacja

- Dane zrealizowanego zamówienia



**📝 Note:** Poprawka zabezpieczeń wdrożona dla wersji Spree 2.2.14, 2.3.13, 2.4.10 i 3.0.4 wymusza dodanie parametrów wyszukiwania do białej listy. Właściwość `updated_at` produktów i zamówień nie została uwzględniona na domyślnej białej liście. Integracje Klaviyo opierają się na tym parametrze, dlatego musisz wdrożyć aktualizację, aby dodać tę właściwość do białej listy i zapewnić płynne działanie integracji. Jeśli nie dodasz właściwości `updated_at` dla zamówień do białej listy, zdarzenia *Started Checkout* mogą nie synchronizować się do momentu złożenia zamówienia.

## Dodaj integrację Spree w Klaviyo

1. W Klaviyo wybierz kartę **Integracje**.

2. Kliknij **Przeglądaj aplikacje**, wyszukaj Spree i kliknij kartę. Następnie kliknij przycisk **Zainstaluj**.

3. Na następnej stronie trzeba podać URL sklepu oraz klucz API Spree / zaszyfrowane hasło. Można wygenerować ten klucz API w panelu administratora Spree, przechodząc do sekcji **Użytkownicy**, wybierając konto, a następnie wybierając **Wygeneruj klucz API**.

4. Wróć do Klaviyo i wklej adres URL sklepu oraz klucz API/zaszyfrowane hasło w odpowiednie pola.




![Image](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/70b5c7d9db63927cd11a91ae447b4e4a818ebf36-1166x970.png?auto=format)

5. Jeśli korzystasz z wersjonowanego API Spree (V1), zaznacz **Korzystam z wersjonowanego API Spree (V1)**.

6. Kliknij **Połącz ze Spree**.



Poniższe ustawienie listy dodaje klientów zsynchronizowanych z zamówień i realizacji zakupu w Spree bez sprawdzania ich statusu opt-in na e-maile w Spree. Członkostwo na liście nie oznacza zgody na e-mail.

1. Opcjonalnie: aby dodać zsynchronizowanych klientów Spree do listy Klaviyo, na następnej stronie zaznacz **Dodaj nowych klientów Spree do listy Klaviyo**, a następnie wybierz listę.

2. Gdy wszystko będzie gotowe, kliknij **Dokończ konfigurację**. Następnie powinien wyświetlić się komunikat o powodzeniu, wskazujący, że integracja przebiegła pomyślnie.



## Zainstaluj śledzenie aktywności na stronie przez Klaviyo

Aby zainstalować śledzenie na stronie dla *Active on Site* i *Viewed Product*, najpierw znajdź swój publiczny klucz API. Zaloguj się do swojego konta Klaviyo i przejdź do **Nazwa konta > Ustawienia > klucze API**. Twój klucz publiczny ma długość 6 znaków. Bezpiecznie skopiuj ten klucz, aby użyć go w następnym kroku. 

Możesz wykorzystać dwa rodzaje śledzenia na stronie:

- **Aktywność na stronie**
Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka odwiedza Twoją witrynę

- **Przeglądany produkt**
Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka wyświetli stronę produktu w Twojej witrynie



### „Aktywni na stronie” śledzenie

Ta metryka jest śledzona za każdym razem, gdy możliwa do zidentyfikowania przeglądarka odwiedza Twoją witrynę.

1. Aby rozpocząć śledzenie aktywności *Active on Site*, dodaj następujący fragment kodu do głównego szablonu sklepu, aby był uwzględniony na wszystkich stronach. Umieść ten fragment albo wraz z innymi skryptami analitycznymi, których używasz, albo tuż przed zamykającym znacznikiem *</body>*.

2. Pamiętaj, aby zastąpić `PUBLIC_API_KEY` publicznym kluczem API konta w Klaviyo:



```text
<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript"> 
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>
```

1. Opcjonalnie: aby identyfikować klientów, gdy logują się do Twojego sklepu, dodaj wywołanie `klaviyo.identify()` z adresem e-mail zalogowanego klienta oraz — jeśli jest dostępne — imieniem i nazwiskiem. Użyj języka szablonów Twojego sklepu, aby uwzględnić to wywołanie tylko wtedy, gdy odwiedzający jest zalogowany. Więcej informacji o niestandardowym śledzeniu dla zalogowanych użytkowników znajdziesz w [przewodniku po śledzeniu na stronie](https://help.klaviyo.com/hc/pl-pl/articles/115005076767.md).

2. Zapisz i opublikuj szablon swojego sklepu. Ten kod śledzenia rejestruje zdarzenia *aktywni on Site* dla znanych przeglądarek, abyś mógł/mogła używać danych o wizytach w witrynie i zachowaniu odwiedzających w Klaviyo.

3. Aby sprawdzić, czy śledzenie na Twojej stronie jest skonfigurowane prawidłowo, przejdź na stronę w Twoim sklepie i dodaj `?utm_email=email@example.com` na końcu adresu URL, zastępując *email@example.com* swoim adresem e-mail. Jeśli adres URL zawiera już znak zapytania, użyj zamiast tego `&utm_email=email@example.com`. Odśwież stronę, a następnie wyszukaj swój adres e-mail w Klaviyo. Otwórz swój profil i sprawdź, czy jest zdarzenie *aktywni on Site*.



### Śledzenie "Wyświetlony produkt"

Jeśli chcesz skonfigurować [sekwencję porzuconego przeglądania](https://help.klaviyo.com/hc/pl-pl/articles/115005255408.md) lub utworzyć segmenty na podstawie danych przeglądania produktów, dodaj śledzenie zdarzeń JavaScript dla metryki *Wyświetlony produkt*.

1. W szablonie strony produktu dodaj poniższy przykład po głównym fragmencie kodu śledzenia onsite. Przed opublikowaniem dostosuj symbole zastępcze do swojego sklepu:



```text
<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>
```

1. Zastąp symbole zastępcze `{{ }}` wartościami renderowanymi dynamicznie dla oglądanego produktu, używając języka szablonów w Twoim sklepie. Zakoduj dynamiczne ciągi znaków i tablice w formacie JSON, aby cudzysłowy w nazwach produktów nie powodowały błędów w JavaScript. Usuń otaczające przykład cudzysłowy podczas wstawiania wartości zakodowanych w formacie JSON. Renderuj `Categories` jako tablicę ciągów znaków oraz renderuj ceny i status promocji jako prawidłowe wartości JavaScript.

2. Zapisz i opublikuj szablon strony produktu. Aby to przetestować, zidentyfikuj swoją przeglądarkę za pomocą powyższego testu z adresem e-mail, a następnie odwiedź stronę produktu i sprawdź swój profil Klaviyo pod kątem zdarzenia *Viewed Product*. Po skonfigurowaniu te dane będą się uzupełniać, gdy znani odwiedzający będą przeglądać strony Twoich produktów.



Podczas dodawania szczegółów produktu do e-maila w sekwencji porzuconego przeglądania użyj nazw właściwości z Twojego własnego zdarzenia *Viewed Product*. W przykładzie powyżej tytuł produktu to `Title`, obraz to `ImageUrl`, a cena to `Metadata.Price`.

### Jak działa śledzenie aktywności na stronie

Klaviyo używa zidentyfikowanej przeglądarki, aby powiązać aktywność na stronie z profilem. Sama wcześniejsza wizyta nie identyfikuje przeglądarki. Istnieją 2 typowe sposoby, dzięki którym Klaviyo może zidentyfikować osobę odwiedzającą stronę:

- Jeśli w którymś momencie ktoś kliknął link w Klaviyo Email, aby przejść na Twoją stronę

- Jeśli w którymś momencie ktoś subskrybował lub wyraził zgodę za pomocą formularza Klaviyo



Gdy włączone jest uzupełnianie aktywności anonimowych odwiedzających, Klaviyo może przechowywać zdarzenia na stronie w przeglądarce odwiedzającego przed identyfikacją i dodać je do jego profilu, gdy zostanie zidentyfikowany. Wymaga to dostępności lokalnej pamięci przeglądarki. Dowiedz się więcej o [uzupełnianiu aktywności anonimowych odwiedzających](https://help.klaviyo.com/hc/pl-pl/articles/17928628922395.md).

## Monitoruj synchronizację Klaviyo 

Aby sprawdzić integrację:

1. Otwórz **Integracje**, wybierz **Spree**, a następnie wybierz **Dane**. W sekcji **Dane historyczne** sprawdź postęp synchronizacji. Gdy import się zakończy, karta potwierdzi, że Twoje dane historyczne zostały zsynchronizowane.

2. Kliknij menu rozwijane **Analityka** w Klaviyo i wybierz **Metryki**. Tutaj możesz filtrować, aby wyświetlić wszystkie metryki Spree.

3. Otwórz metrykę Spree *Złożone zamówienie*, a następnie wybierz kartę **Źródło aktywności**. Jeśli Twoja integracja zaczęła synchronizować dane, zobaczysz tutaj zdarzenia *Placed Order*.

4. Klaviyo automatycznie importuje historyczne dane o zamówieniach. Gdy import się zakończy, wybierz kartę **Wykres** dla *Złożonego zamówienia*. Wybierz **Zakres dat**, który obejmuje dzień, który chcesz sprawdzić, ustaw **Wyświetl według** na **Dziennie**, a **Miara** na **Łącznie**. Na przykład najedź kursorem na wczorajszy punkt danych lub użyj tabeli poniżej wykresu, aby zobaczyć, ile zamówień zarejestrowano wczoraj.

5. Porównaj tę liczbę z ukończonymi zamówieniami w Spree z tego samego dnia. Zamówienia muszą mieć prawidłowy adres e-mail klienta i co najmniej 1 pozycję, aby można je było zsynchronizować. Jeśli liczby się różnią, potwierdź, że import historyczny został zakończony, uwzględnij synchronizację wykonywaną co godzinę i sprawdź, czy strefy czasowe Klaviyo i Spree są zgodne.

6. Aby sprawdzić ustawienie strefy czasowej w Klaviyo:

   - W lewym dolnym rogu kliknij nazwę swojego konta.

   - Wybierz **Ustawienia > Konto**.

   - Przewiń w dół do **Strefa czasowa**.



## Dane zsynchronizowane ze Spree

**📝 Note:** Integracja Spree synchronizuje się z Klaviyo co godzinę.

Poniżej znajduje się lista metryk, które Spree synchronizuje z Klaviyo. Wszystkie metryki Spree, które synchronizują się z Twoim kontem, możesz wyświetlić w sekcji **Dane analityczne > Metryki**. 

![Metrics tab in Klaviyo filtered by Spree showing metrics such as Fufilled Order and Ordered Product](https://cdn.sanity.io/images/6ct6b26e/help-center-prod/50530a903e6792f1070ff71bce4d431eff79adcf-780x371.png?auto=format)

### Złożone zamówienia 

Ta metryka rejestruje zdarzenie, gdy zamówienie w Spree zostanie ukończone, czyli gdy klient zakończy proces realizacji zakupu. Nie potwierdza to powodzenia płatności. Dzięki tej metryce możesz łatwo tworzyć segmenty osób na podstawie liczby złożonych zamówień lub ich wartości życiowej. Możesz też tworzyć e-maile, aby ponownie zaangażować wcześniejszych klientów, lub wysyłać e-maile z podziękowaniem dla klientów, którzy kupują po raz pierwszy. Zdarzenia *Złożono zamówienie* możesz filtrować i targetować w oparciu o następujące kryteria:

- **IsDiscounted**
Jeśli do zamówienia zastosowano rabat, np. *true* lub *false*.

- **ItemNames**
Nazwy produktów zakupionych w tym zdarzeniu.



### Zamówiono produkt

Ta metryka jest podobna do metryki *Placed Order*, jednak zdarzenie jest rejestrowane dla każdej sztuki produktu zamówionej przez daną osobę. Na przykład, jeśli ktoś kupił koszulkę i parę krótkich spodenek, w Klaviyo pojawi się to jako 1 zdarzenie *Placed Order* i 2 zdarzenia *Ordered Product*: jedno dla koszulki i jedno dla pary krótkich spodenek. Ta metryka jest przydatna do tworzenia segmentów kierowanych do klientów, którzy kupili (lub nie kupili) konkretne produkty albo produkty z określonych kategorii. Możesz też użyć metryki *Ordered Product* jako wyzwalacza sekwencji, aby wysyłać e-maile o powiązanych produktach, które naturalnie do siebie pasują, ale których część klientów jeszcze nie kupiła.

- **Categories**
Kategorie, do których należy zamówiony produkt, np. *Shirts,* *Mens* lub *Sale*.

- **Nazwa**
Nazwa zakupionego produktu, np. *Męski czerwony T-shirt*.

- **ProductId**
Identyfikator produktu ustawiony w Twoim sklepie, np. *2022, 2023, 2024*.

- **Ilość**
Ilość reprezentowana przez to zdarzenie, która wynosi 1. Zamówienie na 3 sztuki tego samego produktu tworzy 3 zdarzenia Ordered Product.

- **SKU**
SKU produktu ustawione w Twoim sklepie.

- **Opcja wariantu: Kolor**
Kolor produktu, jeśli jest dostępny, np. *Czerwony* lub *Niebieski*.

- **Opcja wariantu: Rozmiar**
Rozmiar produktu, jeśli jest dostępny, np. *Średni* lub *Duży*.



### Zrealizowano zamówienie

Ta metryka rejestruje zdarzenie, gdy zrealizowane zamówienie zostanie oznaczone jako wysłane w Spree. Zdarzenie w Klaviyo zawiera numer śledzenia dla każdej przesyłki, więc możesz użyć tej metryki jako wyzwalacza wiadomości e-mail z potwierdzeniem wysyłki. Inny popularny e-mail oparty na metryce *Zrealizowane zamówienie* to e-mail z prośbą o recenzję produktu, w którym prosisz klientów o wystawienie opinii o produktach, które ostatnio kupili. Korzystanie z metryki *Zrealizowane zamówienie* pozwala Ci ustawić czas wysyłki tych e-maili na podstawie momentu nadania przesyłki, ale nie potwierdza dostarczenia. Dodaj opóźnienie, aby dać czas na dostawę przed wysłaniem prośby o recenzję produktu. Zdarzenia *Zrealizowane zamówienie* można filtrować i targetować w oparciu o następujące kryteria:

- **IsDiscounted**
Jeśli do zamówienia zastosowano rabat, np. *true* lub *false*.

- **ItemNames**
Nazwy elementów zakupionych w tym zdarzeniu.



### Rozpoczęto proces płatności

Ta metryka rejestruje zdarzenie dotyczące realizacji zakupu z prawidłowym adresem e-mail klienta i co najmniej 1 pozycją. Główne zastosowanie tej metryki to wysyłanie e-maili dotyczących porzuconego koszyka zakupowego. Z Klaviyo możesz łatwo skonfigurować e-mailową sekwencję, która wyśle przypomnienie o porzuconym koszyku, jeśli ktoś rozpoczął realizację zakupu, ale po kilku godzinach nie złożył zamówienia. Zdarzenie *Rozpoczęto realizację zakupu* zawiera wszystkie informacje o czyimś koszyku, więc możesz wyświetlać produkty w jego koszyku, a także obrazy tych produktów. Dla bardziej zaawansowanych użytkowników możesz skonfigurować 2 sekwencje porzuconego koszyka zakupowego: jedną dla nowych klientów, która zawiera kod rabatowy, oraz jedną dla klientów powracających, która nie zawiera kodu rabatowego. Zdarzenia *Rozpoczęto realizację zakupu* można filtrować i targetować w oparciu o następujące kryteria:

- **IsDiscounted**
Jeśli do zamówienia zastosowano rabat, np. *true* lub *false*.

- **ItemNames**
Nazwy produktów w koszyku przy kasie.



### dane klienta

Oprócz metryk synchronizowanych przez Klaviyo ze Spree, do profilów Klaviyo są także dodawane właściwości klienta, jeśli są dostępne w danych zamówienia. Możesz używać tych właściwości w segmentach i sekwencjach. Oto właściwości synchronizowane ze Spree. Imię i nazwisko, lokalizacja oraz dane telefonu pochodzą z adresu rozliczeniowego zamówienia:

- Adres e-mail

- Imię

- Nazwisko

- Miejscowość

- Państwo/region

- Kod pocztowy

- Kraj

- Numer telefonu



## Rezultat

Masz teraz zintegrowane konto Klaviyo ze Spree, zainstalowane śledzenie w witrynie i sprawdzone zsynchronizowane dane.

## Dodatkowe źródła

- [Jak często integracje synchronizują dane referencyjne](https://help.klaviyo.com/hc/pl-pl/articles/115005253208.md)
  Dowiedz się, jakie dane synchronizują się z określonej integracji Klaviyo i jak często uruchamia się synchronizacja. Zorganizowaliśmy te integracje według platform e-commerce, dostawca usług e-mailowych (ESP) oraz innych integracji danych. 
- [Klaviyo's Agency Partners](https://klaviyo.partnerpage.io/?utm_source=helpcenter&utm_medium=integrations)
