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

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.
  1. Jeśli korzystasz z wersjonowanego API Spree (V1), zaznacz Korzystam z wersjonowanego API Spree (V1).
  2. 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.
  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 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.

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

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
Metrics tab in Klaviyo filtered by Spree showing metrics such as Fufilled Order and Ordered Product

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

Czy ten artykuł był pomocny?
Ten formularz służy tylko do przesyłania opinii na temat artykułów. Dowiedz się, jak skontaktować się z zespołem ds. pomocy.

Dowiedz się od Klaviyo więcej

Społeczność
Nawiązuj kontakty z osobami na podobnych stanowiskach, partnerami oraz ekspertami i ekspertkami Klaviyo – inspirujcie się nawzajem, wymieniajcie spostrzeżeniami i pomagajcie szukać odpowiedzi na nurtujące Was pytania.
Partnerzy
Zatrudnij certyfikowanego eksperta Klaviyo, który pomoże Ci w konkretnym zadaniu lub w ciągłym zarządzaniu marketingiem.
Pomoc

Uzyskaj wsparcie za pośrednictwem konta.

E-mail do zespołu ds. pomocy (konta w bezpłatnym okresie próbnym oraz konta płatne) Całodobowa dostępność

Czat/wirtualna pomoc
Dostępność różni się w–zależności od lokalizacji i typu planu.