Niniejszy przewodnik odnosi się do integracji Klaviyo' Magento 1, która nie przyjmuje już nowych instalacji. Nasze integracje Magento 1 nie będą już obsługiwane od 15 sierpnia 2025 roku.
Czego się dowieszCzego się dowiesz
Dowiedz się, jakie dane Magento 1 są importowane do Klaviyo podczas integracji obu platform. KlaviyoIntegracja z Magento pobiera wszystkie dane historyczne z Twojego sklepu Magento w momencie początkowej synchronizacji historycznej. Po włączeniu integracje zaczną synchronizować metrykę i dane klienta w czasie zbliżonym do rzeczywistego. Przykłady tych danych obejmują informacje związane z wcześniej złożonymi zamówieniami, zrealizowanymi zamówieniami itp.
W Klaviyo możesz przejść do zakładki dane analityczne na swoim koncie w lewym pasku bocznym, aby wyświetlić wszystkie metryki na swoim koncie; metryki z ikoną Magento to te zsynchronizowane z integracjami Magento.

Klaviyo ogranicza liczbę unikalnych metryk, które możesz utworzyć, do 200. Gdy zbliżysz się do tego progu, otrzymasz ostrzeżenie na swoim koncie oraz wiadomość e-mail do właściciela konta.
Magento metrykaMagento metryka
Anulowane zamówienieAnulowane zamówienie
To zdarzenie jest śledzone, gdy klient tworzy zamówienie w Twoim sklepie Magento, a następnie anuluje je przed realizacją. Klaviyo śledzi powiązane dane, w tym wszystkie informacje o zakupionych produktach. Informacje o produkcie obejmują nazwy produktów, zdjęcia i warianty informacji, które możesz wykorzystać w wiadomości e-mail dotyczącej zakupu.
Możesz filtrować i kierować zdarzenia anulowanych zamówień na podstawie następujących kryteriów:
-
Wartość: Całkowita wartość zamówienia (suma częściowa + koszt wysyłki - wszelkie rabaty).
-
Pozycje: Nazwy produktów w czyimś zamówieniu.
Na przykład: t-shirt lub spodnie. W przypadku wielokrotnego zamówienia pojawi się kilka sztuk tego samego produktu.
-
Kategorie przedmiotów: Kompletny zestaw kategorii przedmiotów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
-
Liczba pozycji: Liczba pozycji w zamówieniu (np. 2).
-
Kod waluty: Konkretna waluta zapłacona za przedmiot w zależności od kraju (np. USD, EUR).
-
Zniżka: Jeśli ta konkretna pozycja ma zastosowany rabat (tj. prawda/fałsz).
-
kupon: Zastosowano kod kuponu.
-
Unikalne przedmioty: Pojedynczy przedmiot zawarty w zamówieniu (np. koszulki, spodenki). W przypadku zamówienia wielu produktów unikalny element zostanie wyświetlony tylko raz.
-
Kategorie unikalnych przedmiotów: Kategorie, w których pogrupowane są unikalne przedmioty (np. męskie, wyprzedaż).
-
Atrybuty (opcjonalnie): Niestandardowe atrybuty produktu.
Zakończono proces płatnościZakończono proces płatności
To zdarzenie jest śledzone, gdy klient ukończy stronę płatności
kasa w Twoim sklepie Magento. Strona płatności
kasa Ukończone wydarzenie nie jest historycznie zsynchronizowane, więc nie zawsze jest dokładną miarą, gdy patrzysz na sumę wydarzeń w czasie. Do śledzenia przychodów / przychodu i segmentacji użyj zdarzenia Złożone zamówienie.
Możesz filtrować i kierować zdarzenia na stronę płatności
kasa Completed na podstawie następujących kryteriów:
-
Wartość: Całkowita wartość zamówienia.
-
Kody rabatowe: Zastosowano dowolny kupon lub kody rabatowe.
-
Przedmioty: Nazwy produktów w koszyku danej osoby (np. koszulka lub spodnie).
-
Liczba przedmiotów: Całkowita liczba przedmiotów w koszyku użytkownika.
-
Łączna wartość rabatów (opcjonalnie): Łączna wartość w dolarach wszelkich kuponów lub rabatów.
Zakupy dodane do kasyZakupy dodane do kasy
To zdarzenie jest śledzone, gdy klient wprowadzi swoje dane kontaktowe i informacje o wysyłce na pierwszej stronie procesu Magento strona płatności
kasa, a następnie kliknie przycisk Kontynuuj. Klaviyo śledzi powiązane dane o produktach znajdujących się w czyimś koszyku, w tym nazwy produktów, obrazy i warianty informacji, których możesz użyć w wiadomości e-mail dotyczącej porzuconego koszyka zakupowego. To zdarzenie ma właściwość strona płatności
kasa URL, która łączy powrót do dokładnego koszyka każdego klienta i która może być użyta do odbudowania koszyka, jeśli klient otworzy wiadomość e-mail z nowego urządzenia.
Możesz filtrować i kierować zdarzenia na stronę płatności
kasa Started w oparciu o następujące kryteria:
-
Wartość: Wartość koszyka w momencie strony płatności
kasa (suma częściowa + koszt wysyłki - wszelkie rabaty).
-
Przedmioty: Nazwy produktów w koszyku danej osoby (np. koszulka lub spodnie).
-
Liczba przedmiotów: Całkowita liczba przedmiotów w koszyku użytkownika.
-
Kody rabatowe (opcjonalnie): Wszelkie zastosowane kupony lub kody rabatowe.
-
Łączna wartość rabatów (opcjonalnie): Łączna wartość w dolarach wszelkich kuponów lub rabatów.
Zrealizowano zamówienieZrealizowano zamówienie
To zdarzenie jest śledzone, gdy oznaczysz zamówienie w sklepie Magento jako wysłane. Klaviyo śledzi powiązane informacje o zakupionych produktach, w tym nazwy produktów, obrazy i informacje wariantowe, które można wykorzystać w wiadomości e-mail dotyczącej zakupu.
Możesz filtrować i kierować zdarzenia Fulfilled Order na podstawie następujących kryteriów:
-
Wartość: Całkowita wartość zamówienia (suma częściowa + koszt wysyłki - wszelkie rabaty).
-
Pozycje: Nazwy produktów w czyimś zamówieniu (np. koszulka lub spodnie). W przypadku wielokrotnego zamówienia pojawią się wielokrotności tego samego produktu.
-
Kategorie przedmiotów: Kompletny zestaw kategorii przedmiotów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
-
Liczba pozycji: Liczba pozycji w zamówieniu. (np. 2).
-
Kod waluty: Konkretna waluta zapłacona za przedmiot w zależności od kraju (np. USD, EUR).
-
Zniżka: Jeśli ta konkretna pozycja ma zastosowany rabat (tj. prawda/fałsz).
-
kupon: Zastosowano kod kuponu.
-
Unikalne przedmioty: Pojedynczy element utworzony w zamówieniu (np. koszulki, spodenki). Jeśli zamówiono wiele produktów, unikalny element zostanie wyświetlony tylko raz.
-
Kategorie unikalnych przedmiotów: Kategorie, w których pogrupowane są unikalne przedmioty (np. męskie, wyprzedaż).
-
Atrybuty (opcjonalnie): Niestandardowe atrybuty produktu.
Zamówiony produktZamówiony produkt
To zdarzenie jest śledzone, gdy klient składa zamówienie. Dla każdego zakupionego produktu śledzone jest jedno zdarzenie Ordered Product. Na przykład, jeśli ktoś kupuje koszulkę i parę spodni, śledzone jest jedno zdarzenie złożonego zamówienia i rejestrowane są dwa zdarzenia zamówionego produktu - jedno zdarzenie dla koszulki i jedno zdarzenie dla spodni.
Zdarzenie Ordered Product zawiera szczegółowe informacje na temat każdego zakupionego produktu. Jest to przydatne podczas tworzenia segmentów behawioralnych opartych na opcjach wariantu produktu i innych szczegółowych informacjach, które nie są dostępne w zdarzeniu złożonego zamówienia. Możesz filtrować i kierować zdarzenia Ordered Product na podstawie następujących kryteriów:
-
Wartość: Całkowita cena przedmiotu (nie obejmuje kosztów wysyłki ani udzielonych rabatów).
-
Nazwa: Nazwa nadana temu konkretnemu elementowi.
-
SKU: Konkretny SKU przypisany do śledzenia przedmiotu (np. REDMEDIUMTSHIRT).
-
Kategorie: Kompletny zestaw kolekcji produktów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
-
Cena: Wartość konkretnego produktu w dolarach (np. koszule 25,50, buty 50,25).
-
Koszt: Koszt wytworzenia produktu (np. koszulki 13,85, buty 20,00).
-
Kod waluty: Konkretna waluta zapłacona za przedmiot w zależności od kraju (np. USD, EUR).
-
Zniżka: Jeśli ta konkretna pozycja ma zastosowany rabat (tj. prawda lub fałsz).
-
ProductID: ID konkretnego produktu w Twoim sklepie.
-
Ilość: Zamówiona ilość.
-
Atrybuty (opcjonalnie): Niestandardowe atrybuty produktu.
Złożone zamówienieZłożone zamówienie
To zdarzenie jest śledzone, gdy klient zakończy proces strony płatności
kasa i utworzy zamówienie w Twoim sklepie Magento. Klaviyo śledzi powiązane dane, w tym informacje o produktach zakupionych przez daną osobę, w tym nazwy produktów, obrazy i informacje wariantowe, które możesz wykorzystać w wiadomości e-mail dotyczącej zakupu. Możesz filtrować i kierować zdarzenia złożonych zamówień na podstawie następujących kryteriów:
-
Wartość: Całkowita wartość zamówienia (suma częściowa + wysyłka - wszelkie rabaty).
-
Przedmioty: Nazwy produktów w czyimś zamówieniu, np. koszulka lub spodnie. W przypadku wielokrotnego zamówienia pojawi się kilka sztuk tego samego produktu.
-
Kategorie przedmiotów: Kompletny zestaw kategorii przedmiotów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
-
Liczba pozycji: Liczba pozycji w zamówieniu (np. 2).
-
Kod waluty: Konkretna waluta zapłacona za przedmiot w zależności od kraju (np. USD, EUR).
-
Zniżka: Jeśli ta konkretna pozycja ma zastosowany rabat (tj. prawda/fałsz).
-
kupon: Zastosowano kod kuponu.
-
Unikalne przedmioty: Pojedynczy element utworzony w zamówieniu (np. koszulki, spodenki). W przypadku zamówienia wielu produktów unikalny element zostanie wyświetlony tylko raz.
-
Kategorie unikalnych przedmiotów: Kategorie, w których pogrupowane są unikalne przedmioty (np. męskie, wyprzedaż).
-
Atrybuty (opcjonalnie): Można zsynchronizować do 10 niestandardowych atrybutów produktu dla złożonych zamówień. Ta synchronizacja musi zostać włączona przed niestandardową sekwencją danych atrybut ów na Twoim koncie Klaviyo. Zobacz sekcję poniżej, jak to skonfigurować.
Zwrócono płatność za zamówienieZwrócono płatność za zamówienie
To zdarzenie jest śledzone, gdy zamówienie jest zwracane w Magento.
-
Wartość: Całkowita wartość zamówienia (suma częściowa + wysyłka - wszelkie rabaty).
-
kupon: Zastosowano kod kuponu.
-
Kod waluty: Konkretna waluta zapłacona za przedmiot w zależności od kraju (np. USD, EUR).
-
Zniżka: Jeśli ta konkretna pozycja miała zastosowany rabat (tj. prawda/fałsz).
-
Kategorie przedmiotów: Kompletny zestaw kategorii przedmiotów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
-
Liczba pozycji: Liczba pozycji w zamówieniu (np. 2).
-
Pozycje: Nazwy produktów w czyimś zamówieniu (np. koszulka lub spodnie). W przypadku wielokrotnego zamówienia pojawi się kilka sztuk tego samego produktu.
-
Kategorie unikalnych przedmiotów: Kategorie, w których pogrupowane są unikalne przedmioty (np. męskie, wyprzedaż).
-
Unikalne przedmioty: Pojedynczy przedmiot utworzony w zamówieniu, np. koszulki, spodenki. W przypadku zamówienia wielu produktów unikalny element zostanie wyświetlony tylko raz.
Przychody / przychód, czyli wartość złożonego zamówienia, jest obliczana w następujący sposób: (cena zamówienia + wysyłka - rabaty). Aby przefiltrować segment na podstawie $value, przefiltruj segment używając przychody / przychód.
Płatność jest dostępna jako właściwość drugiego poziomu w polu dodatkowym. Nie możesz odfiltrować właściwości drugiego poziomu dla segmentacji, ale możesz użyć tych danych jako zmiennej zdarzenia w szablonach e-mailowych.
Synchronizowane dane klientówSynchronizowane dane klientów
Klaviyo tworzy kontakt w wyniku utworzenia istniejącego zamówienia, istniejącego rekordu klienta lub po uruchomieniu strony płatności
kasa. Klaviyo utworzy nowy profil Klaviyo dla każdego zsynchronizowanego kontaktu i wypełni ten profil następującymi informacjami:
- E-mail
- Imię i nazwisko
- Miasto, stan/region, kod pocztowy, kraj
- Numer telefonu
- Utworzone konto Magento (np. 2015-05-01 00:00:00)
- Grupa klientów Magento (np. sprzedaż hurtowa)
- Magento sklep (np. US sklep)
- Data urodzenia (np. 1990-01-01)
- Płeć
- website_ID nie będzie pobierany
- ograniczenia nie są kopiowane do Klaviyo, więc nie będzie ich na platformie Klaviyo
Jeśli zaktualizujesz grupę klientów w Magento, nawet po utworzeniu oryginalnego profilu w Klaviyo, grupa klientów zostanie zaktualizowana w Klaviyo.
- Website_ID nie będzie pobierany. ograniczenia nie są kopiowane do Klaviyo, więc nie będzie ich na platformie Klaviyo.
- Niestandardowe lokalizacje obrazów nie będą pobierane. Klaviyo nie może pobierać niestandardowych lokalizacji obrazów.
Synchronizuj niestandardowe atrybuty produktów dla złożonych zamówieńSynchronizuj niestandardowe atrybuty produktów dla złożonych zamówień
Klaviyo możesz zsynchronizować do 10 niestandardowych atrybutów produktu dla metryki złożonego zamówienia. Niestandardowe atrybuty produktu nie będą automatycznie sekwencjonowane w Klaviyo; możesz jednak poprosić Klaviyo o ich pobranie. Aby to zrobić, powinieneś pobrać niestandardowy identyfikator atrybutu (instrukcje poniżej) i wysłać żądanie do naszego zespołu ds. pomocy.
Znajdź niestandardowe identyfikatory produktów w panelu administratora Magento, przechodząc do katalogu > Atrybuty > Zarządzaj atrybutami i klikając atrybut.
Identyfikator można znaleźć w adresie url w następujący sposób:

Zweryfikuj zsynchronizowane dane zamówieniaZweryfikuj zsynchronizowane dane zamówienia
Klaviyo importuj
importuj wszystkie swoje Magento dane. Aby to zweryfikować, możesz porównać liczbę zamówień w danym dniu z danymi w interfejsie Magento i potwierdzić ich zgodność. Kliknij Dane analityczne na lewym pasku bocznym, znajdź metrykę Złożone zamówienie i kliknij ją. Spowoduje to przejście do strony wykresu metryki i domyślnie wyświetli dane z ostatnich 30 dni. Poniżej możesz zobaczyć przykładowy wykres metryki.
Najedź kursorem na wczorajszy punkt danych lub spójrz na tabelę danych poniżej wykresu, aby zobaczyć, ile miałeś wczoraj zleceń. Porównaj tę liczbę z tym, co jest sklepem w Magento i powinieneś zobaczyć, że dokładnie się zgadzają. Jeśli tak się nie stanie, najprawdopodobniej strefa czasowa Twojego konta Klaviyo nie jest zgodna ze strefą czasową Magento. Aby sprawdzić ustawienia strefy czasowej:
- Kliknij nazwę swojej organizacji w lewym dolnym rogu.
- Kliknij Ustawienia.
- Wybierz organizację.

Możesz zauważyć, że wartość przychody / przychód na pulpicie Klaviyo nie zawsze zgadza się z wartością przychody / przychód, którą widzisz w Magento; dzieje się tak, ponieważ Klaviyo nie odejmuje anulowanych i zwróconych zamówień od naszych obliczeń przychody / przychód.
Właściwości zsynchronizowanych zamówień MagentoWłaściwości zsynchronizowanych zamówień Magento
Poniżej znajdują się przykładowe ładunki JSON dla metryki Złożonego zamówienia, Zamówionego produktu i Zrealizowanego zamówienia, które odpowiadają właściwościom, które sklepujemy dla zamówień synchronizowanych przez Magento SOAP API.
Jest to przydatne do wysyłania prawidłowych właściwości dla zamówień, które zostaną połączone z danymi zamówienia Magento.
Złożone zamówienieZłożone zamówienie
//
// ZŁOŻONE ZAMÓWIENIE
// ------------------------------------------
{
" token": "PUBLIC_API_KEY",
" usługa": "Magento",
" zdarzenie": "Złożono zamówienie",
" customer_properties": {
"$email" : "john.smith@test.com",
"$first_name" : "John",
"$last_name" : "Smith"
},
" properties": {
" $event_id": "1234",
" $value": 29.98,
" $extra": {},
" Currency Code": "USD,
" Liczba przedmiotów": 2,
" Przedmioty": ["Kubuś Puchatek", "Opowieść o dwóch miastach"], // Jeśli przedmiot został zamówiony więcej niż raz, zduplikuj go. Na przykład, ktoś zamówi dwie koszulki, będzie to: ["T-Shirt", "T-Shirt"]
" Zniżka": true,
" kupon": "COUPON123",
" Unique Items": ["Winnie the Pooh", "A Tale of Two Cities"],
" Item Categories": ["Fiction", "Classics", "Children"],
" Unique Item Categories": ["Fiction", "Classics", "Children"]
}, "time": 1387302423
}
Zamówiony produktZamówiony produkt
//
// ZAMÓWIONY PRODUKT
// ------------------------------------------
{
" token": "PUBLIC_API_KEY",
" usługa": "Magento",
" zdarzenie": "Zamówiony produkt",
" customer_properties": {
"$email" : "john.smith@test.com",
"$first_name" : "John",
"$last_name" : "Smith"
},
" properties": {
" $event_id": "123456789", // LineId (unikalny)
" $value": 9.99,
" Currency Code": "USD",
Nazwa": "Kubuś Puchatek",
" SKU": "WINNIEPOOH",
" ProductID": "567",
" Kategorie": ["Beletrystyka", "Klasyka"],
" Cena": 9.99,
" Zniżka": true,
" Koszt": 5.00, // (opcjonalnie),
" Atrybut: Kolor": "Czerwony" // atrybuty produktu (opcjonalnie)
" $extra": {
"Product URL Key" : "winnie-pooh",
"Product URL" : "https://www.store.com/winnie-pooh",
"Image URL" : "https://cnd.store.com/images/winnie-pooh.png",
}
}, " time": 1387302423
}
Zrealizowano zamówienieZrealizowano zamówienie
//
// SPEŁNIONE ZAMÓWIENIE
// ------------------------------------------
{
" token": "PUBLIC_API_KEY",
" usługa": "Magento",
" zdarzenie": "Fulfilled Order",
" customer_properties": {
"$email" : "john.smith@test.com",
"$first_name" : "John",
"$last_name" : "Smith"
},
" properties": {
" $event_id": "1234",
" $value": 29.98,
" $extra": {},
" Currency Code": " USD",
" Item Count": 2,
" Items": ["Winnie the Pooh", "A Tale of Two Cities"], // If an item is ordered more than once, duplicate it. Na przykład, ktoś zamówi dwie koszulki, będzie to: ["T-Shirt", "T-Shirt"]
" Zniżka": true,
" kupon": "COUPON123",
" Unique Items": ["Winnie the Pooh", "A Tale of Two Cities"],
" Item Categories": ["Fiction", "Classics", "Children"],
" Unique Item Categories": ["Fiction", "Classics", "Children"]
}, "time": 1387302423
}
Dodatkowe źródłaDodatkowe źródła