Odniesienie do danych Magento 1
Integracja Klaviyo z Magento 1 nie przyjmuje już nowych instalacji i osiągnie pełne zakończenie wsparcia pod koniec 2027 roku. Wsparcie Klaviyo nie jest już w stanie pomóc w zgłoszeniach związanych z Magento 1.
Czego się dowiesz?
Dowiedz się, jakie dane Magento 1 są importowane do Klaviyo po zintegrowaniu tych 2 platform. Integracja Klaviyo z Magento pobiera wszystkie dane historyczne w Twoim sklepie Magento w momencie początkowej synchronizacji danych historycznych. Po włączeniu integracja zacznie synchronizować metryki i dane klientów niemal w czasie rzeczywistym. Przykładami tych danych są informacje powiązane z wcześniej złożonymi zamówieniami, zrealizowanymi zamówieniami itp.
W Klaviyo możesz przejść do karty Analityka na lewym pasku bocznym, aby wyświetlić wszystkie metryki na swoim koncie; metryki z ikoną Magento to te zsynchronizowane z integracji Magento.
Klaviyo ogranicza liczbę unikalnych metryk, które możesz utworzyć, do 200. Gdy zbliżysz się do tego progu, otrzymasz ostrzeżenie na koncie oraz e-mail do właściciela konta.
Metryki Magento
Anulowano zamówienie
To zdarzenie jest rejestrowane, 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 produktach dotyczące elementów, które ktoś kupił. Informacje o produktach obejmują nazwy produktów, obrazy oraz informacje o wariantach, których możesz użyć w e-mailach wysyłanych po zakupie.
Zdarzenia Anulowano zamówienie można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: Łączna wartość zamówienia (suma częściowa + koszt wysyłki – wszelkie rabaty).
- Pozycje: Nazwy produktów z czyjegoś zamówienia.
np.: koszulka lub spodnie. Jeśli zamówiono wielokrotnie, zostanie wyświetlonych kilka takich samych pozycji - Kategorie produktów: Pełny zestaw kategorii produktów z zamówienia; (np. t-shirty, męskie, spodnie oraz wyprzedaż).
- Liczba produktów: Liczba produktów w zamówieniu (np. 2).
- Kod waluty: Konkretna waluta, w której zapłacono za produkt na podstawie kraju (np. USD, EUR).
- Ze zniżką: Czy do tego konkretnego elementu zastosowano zniżkę (tzn. true/false).
- Kupon: Zastosowany kod kuponu.
- Unikatowe elementy: Pojedynczy element uwzględniony w zamówieniu (np. koszule, spodenki). Jeśli zamówiono wiele produktów, unikatowy element zostanie wyświetlony tylko raz.
- Unikatowe kategorie elementów: kategorie, w których są grupowane unikatowe elementy (np. męskie, wyprzedaż).
- Atrybuty (opcjonalnie): niestandardowe atrybuty produktu.
Zakończono proces płatności
To zdarzenie jest śledzone, gdy klient finalizuje proces przejścia przez kasę w Twoim sklepie Magento. Zdarzenie Checkout Completed nie synchronizuje się historycznie, więc nie zawsze jest dokładną miarą podczas analizowania łącznej liczby zdarzeń w czasie. Do śledzenia przychodu i segmentacji użyj zdarzenia Placed Order.
Zdarzenia Zakończono realizację zakupu można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: Łączna wartość zamówienia.
- Kody rabatowe: wszelkie zastosowane kupony lub kody rabatowe.
- Items: Nazwy produktów w czyimś koszyku (np. t-shirt lub pants).
- Liczba produktów: Łączna liczba produktów w koszyku danej osoby.
- Suma rabatów (opcjonalnie): Łączna wartość w dolarach wszystkich kuponów lub rabatów.
Zakupy dodane do kasy
To zdarzenie jest rejestrowane, gdy klient wprowadza swoje dane kontaktowe i wysyłkowe na pierwszej stronie procesu realizacji zakupu w Magento, a następnie klika kontynuuj. Klaviyo śledzi powiązane dane produktu o elementach w czyimś koszyku, w tym nazwy produktów, obrazy i informacje o wariantach, których możesz użyć w e-mailach dotyczących porzuconego koszyka zakupowego. To zdarzenie ma właściwość adresu URL realizacji zakupu, która prowadzi z powrotem do dokładnego koszyka każdego klienta i która może zostać użyta do odtworzenia koszyka, jeśli klient otworzy e-mail na nowym urządzeniu.
Zdarzenia Rozpoczęto realizację zakupu można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: wartość koszyka w momencie realizacji zakupu (suma częściowa + koszt wysyłki – wszelkie rabaty).
- Items: Nazwy produktów w czyimś koszyku (np. t-shirt lub pants).
- Liczba produktów: Łączna liczba produktów w koszyku danej osoby.
- Kody rabatowe (opcjonalnie): wszystkie zastosowane kupony lub kody rabatowe.
- Suma rabatów (opcjonalnie): Łączna wartość w dolarach wszystkich kuponów lub rabatów.
Zrealizowano zamówienie
To zdarzenie jest rejestrowane, gdy oznaczysz zamówienie w sklepie Magento jako wysłane. Klaviyo śledzi powiązane informacje o produktach dotyczące elementów, które ktoś kupił, w tym nazwy produktów, obrazy i informacje o wariantach, które można wykorzystać w wiadomościach e-mail po zakupie.
Zdarzenia Zrealizowane zamówienie można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: Łączna wartość zamówienia (suma częściowa + koszt wysyłki – wszelkie rabaty).
- Items: Nazwy produktów w czyimś zamówieniu (np. t-shirt lub spodnie). W przypadku wielokrotnego zamówienia wielokrotności tego samego elementu będą wyświetlane.
- Kategorie elementów: Kompletny zestaw kategorii elementów w czyimś zamówieniu (np. t-shirty, męskie, spodnie oraz wyprzedaż).
- Liczba pozycji: liczba pozycji w zamówieniu. (np. 2).
- Kod waluty: Konkretna waluta zapłacona za produkt na podstawie kraju (np. USD, EUR).
- Ze zniżką: Czy do tego konkretnego elementu zastosowano zniżkę (tzn. true/false).
- Kupon: Zastosowany kod kuponu.
- Unikalne elementy: Pojedynczy element utworzony w zamówieniu (np. koszulki, szorty). Jeśli zamówiono wiele produktów, unikalny element wyświetli się tylko raz.
- Unikatowe kategorie elementów: kategorie, w których są grupowane unikatowe elementy (np. męskie, wyprzedaż).
- Atrybuty (opcjonalnie): niestandardowe atrybuty produktu.
Zamówiono produkt
To zdarzenie jest śledzone, gdy klient składa zamówienie. Jedno zdarzenie Zamówiono produkt jest śledzone dla każdego elementu, który ktoś kupuje. Na przykład jeśli ktoś kupi koszulkę i parę spodni, śledzone jest jedno zdarzenie Złożono zamówienie i rejestrowane są dwa zdarzenia Zamówiono produkt — jedno zdarzenie dla koszulki i jedno zdarzenie dla spodni.
Zdarzenie Ordered Product zawiera szczegółowe informacje na temat każdego produktu, który ktoś kupuje. 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żono zamówienie. Zdarzenia Zamówiono produkt można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: Łączna cena produktu (nie obejmuje kosztów wysyłki ani żadnych zastosowanych rabatów).
- Nazwa: Nazwa nadana temu konkretnemu elementowi.
- SKU: Konkretne SKU przypisane do śledzenia elementu (np. REDMEDIUMTSHIRT).
- Kategorie: Kompletny zestaw kolekcji produktów w czyimś zamówieniu (np. koszulki, męskie, spodnie i wyprzedaż).
- Cena: Wartość w dolarach danego produktu (np. koszule 25,50, buty 50,25).
- Koszt: Koszt wytworzenia produktu (np. koszule 13,85, buty 20,00).
- Kod waluty: Konkretna waluta, w której opłacono produkt, na podstawie kraju (np. USD, EUR).
- Z przeceną: Czy do tej konkretnej pozycji zastosowano rabat (tzn. prawda lub fałsz).
- ProductID: identyfikator konkretnego produktu w sklepie.
- Ilość: Zamówiona ilość.
- Atrybuty (opcjonalnie): niestandardowe atrybuty produktu.
Złożone zamówienia
To zdarzenie jest śledzone, gdy klient ukończy proces przejścia przez kasę i utworzy zamówienie w sklepie Magento. Klaviyo śledzi powiązane dane, w tym informacje o produktach dotyczące zakupionych przez kogoś artykułów, w tym nazwy produktów, obrazy i informacje o wariantach, które możesz wykorzystać w e-mailach wysyłanych po zakupie. Zdarzenia Złożono zamówienie można filtrować i targetować w oparciu o następujące kryteria:
- Wartość: łączna wartość zamówienia (suma częściowa + wysyłka - wszelkie rabaty).
- Items: Nazwy produktów w czyimś zamówieniu, np. t-shirt lub spodnie. Jeśli zamówiono ją wielokrotnie, zostanie wyświetlonych wiele takich samych pozycji.
- Kategorie produktów: Kompletny zestaw kategorii produktów w czyimś zamówieniu (np. t-shirts, mens, pants i sale).
- Liczba produktów: Liczba produktów w zamówieniu (np. 2).
- Kod waluty: Konkretna waluta, w której zapłacono za produkt, w zależności od kraju (np. USD, EUR).
- Ze zniżką: Czy do tego konkretnego elementu zastosowano zniżkę (tzn. true/false).
- Kupon: Zastosowany kod kuponu.
- Unikatowe pozycje: Pojedyncza pozycja utworzona w zamówieniu (np. koszule, szorty). Jeśli zamówiono wiele produktów, unikatowa pozycja zostanie wyświetlona tylko raz.
- Unikalne kategorie produktów: Kategorie, w których grupowane są unikalne produkty (np. męskie, wyprzedaż).
- Atrybuty (opcjonalnie): Do 10 niestandardowych atrybutów produktów może być synchronizowanych dla złożonych zamówień. Tę synchronizację trzeba włączyć, zanim dane niestandardowych atrybutów zaczną trafiać do Twojego konta Klaviyo. Zobacz poniższą sekcję, aby dowiedzieć się, jak to skonfigurować.
Zwrócono płatność za zamówienie
To zdarzenie jest śledzone w chwili zwrotu pieniędzy za zamówienie w Magento.
- Wartość: łączna wartość zamówienia (suma częściowa + wysyłka - wszelkie rabaty).
- Kupon: Zastosowany kod kuponu.
- Kod waluty: Konkretna waluta, w której zapłacono za produkt, w zależności od kraju (np. USD, EUR).
- Z przeceną: Jeśli na ten konkretny produkt została nałożona zniżka (tj. prawda/fałsz).
- Kategorie produktów: Kompletny zestaw kategorii produktów w czyimś zamówieniu (np. t-shirts, mens, pants i sale).
- Liczba pozycji: Liczba pozycji w zamówieniu (np. 2).
- Items: Nazwy produktów w czyimś zamówieniu (np. t-shirt lub spodnie). Jeśli zamówiono ją wielokrotnie, zostanie wyświetlonych wiele takich samych pozycji.
- Unikatowe kategorie produktów: Kategorie, w których grupowane są unikatowe produkty (np. męskie, wyprzedaż).
- Unique Items: Indywidualny produkt utworzony w zamówieniu, np.: koszule, szorty. Jeśli zamówiono kilka produktów, unikalny produkt zostanie wyświetlony tylko raz.
Przychód, czyli wartość Złożonego zamówienia, jest obliczana w następujący sposób: (cena zamówień + wysyłka – rabaty). Aby filtrować segment na podstawie wartości $, filtruj segment za pomocą Przychód.
Payment jest dostępna jako właściwość drugiego poziomu w polu extra. Nie możesz filtrować według właściwości drugiego poziomu na potrzeby segmentacji, ale możesz użyć tych danych jako zmiennej zdarzenia w swoich szablonach e-maili.
Synchronizowane dane klientów
Klaviyo tworzy kontakt na podstawie utworzenia istniejącego zamówienia, istniejącego rekordu klienta lub po rozpoczęciu realizacji zakupu. Klaviyo utworzy nowy profil Klaviyo dla każdego zsynchronizowanego kontaktu i wypełni ten profil następującymi informacjami:
- Adres e-mail
- Imię i nazwisko
- Miasto, województwo/region, kod pocztowy, kraj
- Numer telefonu
- Utworzenie konta Magento (np. 2015-05-01 00:00:00)
- Grupa klientów Magento (np. Hurt)
- Sklep Magento (np. Sklep US)
- Data urodzenia (np. 1990-01-01)
- Płeć
- Nie zostanie pobrany website_ID
- Ograniczenia nie są kopiowane do Klaviyo, więc nie będą dostępne na platformie Klaviyo
Jeśli zaktualizujesz grupę klientów w Magento, nawet po utworzeniu pierwotnego profilu w Klaviyo, grupa klientów zostanie zaktualizowana w Klaviyo.
- Nie zostaną pobrane dane Website_ID. Ograniczenia nie są kopiowane do Klaviyo, więc nie będą dostępne na platformie Klaviyo.
- Niestandardowe lokalizacje obrazów nie zostaną pobrane. Klaviyo nie może pobierać niestandardowych lokalizacji obrazów.
Synchronizuj niestandardowe atrybuty produktu dla złożonych zamówień
Klaviyo może synchronizować do 10 niestandardowych atrybutów produktu dla metryki Placed Order. Niestandardowe atrybuty produktu nie będą automatycznie przesyłane do Klaviyo; możesz jednak poprosić Klaviyo o ich pobranie. Aby to zrobić, zbierz identyfikator niestandardowego atrybutu (instrukcje poniżej) i wyślij prośbę do naszego zespołu pomocy.
Znajdź niestandardowe identyfikatory produktów w panelu administratora Magento, przechodząc do Katalog > Atrybuty > Zarządzaj atrybutami i klikając atrybut.
Identyfikator można znaleźć w adresie URL w taki sposób:
Zweryfikuj zsynchronizowane dane zamówień
Klaviyo importuje wszystkie Twoje dane z Magento. Aby to zweryfikować, możesz porównać liczbę zamówień w konkretnym dniu z tym, co jest w interfejsie Magento, i potwierdzić, że się zgadzają. Kliknij Analityka na lewym pasku bocznym, znajdź metrykę Placed Order 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ład wyświetlanego wykresu metryki.
Najedź kursorem na wczorajszy punkt danych lub spójrz w tabelę danych pod wykresem, aby zobaczyć, ile zamówień było wczoraj. Porównaj tę liczbę z tym, co jest zapisane w Magento — powinny się dokładnie zgadzać. Jeśli tak nie jest, najbardziej prawdopodobny problem polega na tym, że strefa czasowa konta Klaviyo nie zgadza się ze strefą czasową Magento. Aby sprawdzić ustawienie strefy czasowej:
- W lewym dolnym rogu kliknij nazwę swojej organizacji.
- Kliknij przycisk Ustawienia.
- Wybierz kartę Organizacja.
Może się okazać, że wartość Przychód na pulpicie Klaviyo nie zawsze jest zgodna z wartością przychodu widoczną w Magento; dzieje się tak, ponieważ Klaviyo nie odejmuje anulowanych i zwróconych zamówień z naszych obliczeń przychodu.
Właściwości zsynchronizowanych zamówień Magento
Poniżej znajdują się przykładowe ładunki JSON dla metryk Placed Order, Ordered Product i Fulfilled Order, które odpowiadają właściwościom przechowywanym dla zamówień zsynchronizowanych za pośrednictwem interfejsu Magento SOAP API.
Jest to przydatne do wysyłania właściwych właściwości dla zamówień, które zostaną połączone z danymi zamówień Magento.
Złożone zamówienia
//
// PLACED ORDER
// ------------------------------------------
{
"token" : "PUBLIC_API_KEY",
"service" : "magento",
"event" : "Placed 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. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
"Discounted" : true,
"Coupon" : "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ówiono produkt
//
// ORDERED PRODUCT
// ------------------------------------------
{
"token" : "PUBLIC_API_KEY",
"service" : "magento",
"event" : "Ordered Product",
"customer_properties" : {
"$email" : "john.smith@test.com",
"$first_name" : "John",
"$last_name" : "Smith"
},
"properties" : {
"$event_id" : "123456789", // LineId (unique)
"$value" : 9.99,
"Currency Code" : "USD",
"Name" : "Winnie the Pooh",
"SKU" : "WINNIEPOOH",
"ProductID" : "567",
"Categories" : ["Fiction", "Classics"],
"Price" : 9.99,
"Discounted" : true,
"Cost" : 5.00, // (optional),
"Attribute: Color" : "Red" // product attributes (optional)
"$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ówienie
//
// FULFILLED ORDER
// ------------------------------------------
{
"token" : "PUBLIC_API_KEY",
"service" : "magento",
"event" : "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. For example, someone orders two t-shirts this would be: ["T-Shirt", "T-Shirt"]
"Discounted" : true,
"Coupon" : "COUPON123",
"Unique Items" : ["Winnie the Pooh", "A Tale of Two Cities"],
"Item Categories" : ["Fiction", "Classics", "Children"],
"Unique Item Categories" : ["Fiction", "Classics", "Children"]
},
"time" : 1387302423
}