Odwołanie do danych Magento 2
Dowiedz się, jakie dane Klaviyo importuje z Twojego sklepu Magento 2, gdy integrujesz te dwie platformy. Początkowa synchronizacja historyczna importuje do pięciu lat danych o zamówieniach i klientach, w tym informacje powiązane z wcześniej złożonymi i zrealizowanymi zamówieniami. Po włączeniu integracja synchronizuje też dane o zamówieniach i klientach co 30 minut.
W Klaviyo przejdź do Analityka > Metryki na lewym pasku bocznym, aby wyświetlić wszystkie metryki na Twoim koncie; metryki z ikoną Magento 2 to zdarzenia zsynchronizowane z Twojej integracji Magento 2. Zobaczysz też zdarzenia śledzenia na stronie Klaviyo z ikoną koła zębatego; one również są śledzone przez integrację.


Jak Klaviyo określa metryki Magento 2
Metryki zamówień
Klaviyo rejestruje zdarzenie Placed Order dla każdego zamówienia, które synchronizuje. Wykorzystuje też bieżący status zamówienia i historię statusów w Magento 2, aby rejestrować dodatkowe metryki zamówień.
Gdy zamówienie zostanie utworzone lub zaktualizowane, Klaviyo sprawdza jego bieżący status oraz historię statusów. Poniższa tabela pokazuje standardowe mapowania. Zamówienia ze statusem pending_payment lub ze statusem niestandardowym skonfigurowanym do ignorowania są wykluczane.
Status zamówienia Magento | Metryki uruchomione w Klaviyo |
Gotowe | Zamówienie złożone i zamówienie zrealizowane |
anulowano, anulowano | Złożone zamówienie i anulowane zamówienie |
płatność_przerwana | Złożono zamówienie i anulowano płatność |
Zamknięte | Złożone zamówienie i zwrócone zamówienie |
Wszystkie pozostałe statusy zamówienia, z wyjątkiem ignorowanych statusów | Złożone zamówienia |
Jeśli masz niestandardowe statusy zamówień, które nie powinny wywoływać metryki Złożone zamówienie lub nie są zgodne z tabelą powyżej, daj nam znać, abyśmy mogli skonfigurować niestandardowe statusy tak, by były ignorowane lub mapowane na dodatkowe zdarzenia zamówienia.
Zamówienia ze statusem „pending_payment” zostaną zignorowane.
Metryka Rozpoczęto proces płatności
W standardowym procesie realizacji zakupu w Magento to zdarzenie jest wyzwalane, gdy klient wprowadzi swoje informacje kontaktowe i wysyłkowe na pierwszej stronie procesu realizacji zakupu w Magento i kliknie Kontynuuj.
Zdarzenie Started Checkout opiera się na koszyku (w Magento nazywanym ofertą) z przypisanym adresem e-mail. Klaviyo synchronizuje go tylko wtedy, gdy koszyk jest nadal aktywny i zawiera produkty w momencie uruchomienia synchronizacji.
Jeśli klient ukończy zamówienie, zanim koszyk zostanie zsynchronizowany, koszyk nie jest już aktywny i Klaviyo go pomija. Zdarzenie Placed Order jest rejestrowane, gdy zamówienie zostanie zsynchronizowane, chyba że jego status jest ignorowany. Zdarzenie Started Checkout, które zostało już zsynchronizowane, pozostaje w Klaviyo. Pamiętaj, że synchronizacja zdarzeń Started Checkout do Klaviyo może potrwać do 1 godziny.
Metryka Zrealizowano wysyłkę
Ta metryka jest uruchamiana, gdy w Twoim sklepie Magento 2 zostanie utworzona nowa przesyłka.
Dane metryka Magento 2
Ta sekcja omawia metryki Magento 2 oraz dane dostępne do filtrowania podczas tworzenia segmentów i sekwencji.
Anulowano zamówienie
To zdarzenie jest wyzwalane, gdy status zamówienia zostanie zmieniony na canceled lub canceled w sklepie Magento 2.
- Kategorie produktów
Kategorie produktów w anulowanym zamówieniu. - Wartość
Wartość anulowanego zamówienia. - Objęte rabatem
(Prawda lub fałsz) Status rabatu anulowanego zamówienia. - Nazwy produktów
Nazwy produktów w anulowanym zamówieniu. - ItemCount
Liczba pozycji wiersza w zamówieniu, a nie łączna liczba sztuk. - OrderCurrencyCode
Kod waluty używany w przypadku anulowanego zamówienia. - CartPriceRuleIDs
Tablica identyfikatorów reguł cen koszyka (ciągi identyfikatorów numerycznych), które obejmują reguły stosowane automatycznie oraz regułę dla zastosowanego kuponu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Zrealizowano zamówienie
To zdarzenie jest śledzone, gdy ustawisz status zamówienia na zrealizowane w sklepie Magento 2.
- Kategorie produktów
Kategorie produktów w zamówieniu. - Wartość
Wartość zamówienia. - Zamówienie ze zniżką
Czy zamówienie jest objęte zniżką, czy nie. - Nazwy produktów
Nazwy produktów w zamówieniu. - ItemCount
Liczba pozycji wiersza w zamówieniu, a nie łączna liczba sztuk. - OrderCurrencyCode
Kod waluty używany w zamówieniu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Zrealizowano wysyłkę
To zdarzenie jest śledzone w chwili utworzenia nowej przesyłki w sklepie Magento 2.
- StoreName
Nazwa sklepu, w którym złożono zamówienie. - StoreID
Identyfikator sklepu, w którym złożono zamówienie. - BillingAddress
Adres rozliczeniowy zamówienia. - Śledzenie
Informacje o śledzeniu przesyłki. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Zamówiono produkt
Klaviyo rejestruje 1 zdarzenie Ordered Product na każdą zamówioną jednostkę, maksymalnie do 100 zdarzeń na pozycję wiersza. Na przykład zamówienie 3 takich samych koszulek generuje 3 zdarzenia Ordered Product, każde z ilością (Quantity) równą 1. W przypadku produktów sprzedawanych w ilościach ułamkowych Klaviyo rejestruje 1 zdarzenie z zamówioną ilością.
- SKU
Kod SKU produktu. - OrderCurrencyCode
Kod waluty produktu. - Cena
Wartość produktu. - Kategorie
Kategoria produktu. - Ze zniżką
(Prawda lub Fałsz) Czy do produktu zastosowano zniżkę. - Ilość
Ilość reprezentowana przez to zdarzenie: 1 w przypadku zakupu całych sztuk lub zamówiona ilość w przypadku produktów sprzedawanych w ilościach ułamkowych. - Wartość
Wartość produktu. - ProductID
Identyfikator produktu. - RootProductID
Identyfikator produktu nadrzędnego. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Metryka Ordered Product ma wiele innych pól danych dostępnych do śledzenia. Wyświetl nieprzetworzone dane pojedynczego zdarzenia Ordered Product, aby zobaczyć wszystkie dostępne dane dla tego zdarzenia.
Złożone zamówienia
To zdarzenie jest śledzone, gdy użytkownik składa zamówienie.
- Kategorie produktów
Kategorie produktów w zamówieniu. - Wartość
Wartość zamówienia. - Zamówienie ze zniżką
Czy zamówienie jest objęte zniżką, czy nie. - Nazwy produktów
Nazwy produktów w zamówieniu. - ItemCount
Liczba pozycji wiersza w zamówieniu, a nie łączna liczba sztuk. - OrderCurrencyCode
Kod waluty używany w zamówieniu. - CartPriceRuleIDs
Tablica identyfikatorów reguł cen koszyka (ciągi identyfikatorów numerycznych), które obejmują reguły stosowane automatycznie oraz regułę dla zastosowanego kuponu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Zwrócono płatność za zamówienie
To zdarzenie jest wyzwalane, gdy status zamówienia w Magento 2 zostanie zmieniony na zamknięte. Częściowy zwrot, który pozostawia zamówienie w innym statusie, nie wyzwala zdarzenia Refunded Order przy użyciu standardowego mapowania statusów.
- Wartość
Wartość zamówienia. - Zamówienie ze zniżką
Czy zamówienie jest objęte zniżką, czy nie. - Nazwy produktów
Nazwy wszystkich produktów w zamówieniu. - ItemCount
Liczba pozycji wiersza w zamówieniu, a nie łączna liczba sztuk. - OrderCurrencyCode
Kod waluty używany w zamówieniu. - Kategorie produktów
Kategorie produktów w zamówieniu. - CartPriceRuleIDs
Tablica identyfikatorów reguł cen koszyka (ciągi identyfikatorów numerycznych), które obejmują reguły stosowane automatycznie oraz regułę dla zastosowanego kuponu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Rozpoczęto proces płatności
To zdarzenie jest wyzwalane, gdy klient z rozpoznanym adresem e-mail rozpoczyna realizację zakupu, a koszyk jest nadal aktywny i zawiera produkty, gdy Klaviyo go synchronizuje. Na standardowej stronie realizacji zakupu klient wpisuje swoje dane kontaktowe i dane wysyłkowe, a następnie klika Kontynuuj. Jeśli zakończy realizację zakupu, zanim koszyk zostanie zsynchronizowany, Klaviyo pomija Started Checkout i rejestruje Placed Order, gdy zamówienie zostanie zsynchronizowane, chyba że jego status jest ignorowany. Zakończenie zamówienia nie usuwa zdarzenia Started Checkout, które zostało już zsynchronizowane.
- Wartość
Wartość zamówienia podczas realizacji zakupu. - ItemCount
Liczba pozycji w koszyku, a nie łączna liczba jednostek. - Pozycje
Pozycje w zamówieniu. - Kategorie produktów
Kategorie produktów w zamówieniu. - Nazwy produktów
Nazwy produktów w zamówieniu. - NazwaSklepu
Nazwa sklepu, w którym rozpoczęto zamówienie. - StoreID
Identyfikator sklepu, w którym rozpoczęto zamówienie. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii
Dodano do koszyka
Pamiętaj, że ta metryka jest śledzona tylko wtedy, gdy korzystasz z wersji rozszerzenia Klaviyo 4.0.0 lub nowszej. Ta metryka jest śledzona, gdy klient, dla którego Klaviyo ustawiło plik cookie, doda produkt do koszyka.
Zawiera szczegółowe informacje o elemencie, który został dodany. To przydaje się podczas tworzenia segmentów na podstawie produktów dodanych do koszyka lub podczas budowania sekwencji porzuconego koszyka zakupowego. Metrykę Dodano do koszyka można filtrować i targetować w oparciu o następujące kryteria:
- MaskedQuoteId
MaskedQuoteId lub unikalny identyfikator dla zalogowanych klientów. - AddedItemCategories
Kategorie, do których należy element. - AddedItemProductName
Nazwa produktu w Twoim sklepie (np. czerwona koszulka). - AddedItemDescription
Opis elementu. - AddedItemImageURLKey
Adres URL obrazu elementu. - AddedItemPrice
Cena elementu. - AddedItemProductID
Niestandardowy identyfikator produktu w sklepie Magento 2, np. 1234. - AddedItemSKU
SKU produktu w Twoim sklepie (np. REDMEDIUMTSHIRT). - AddedItemURL
Adres URL elementu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii - integration_key
Twoja platforma e-commerce (Magento 2).
Użyj wartości MaskedQuoteId ze zdarzenia Added To Cart, aby utworzyć link, który odtworzy koszyk klienta, gdy ten wróci z e-maila na innym urządzeniu. Użyj następującego adresu URL:
{{ organization.url|trim_slash }}/reclaim/checkout/cart?quote_id={{ event.MaskedQuoteId }}Przeglądany produkt
Ta metryka jest śledzona, gdy Klaviyo może zidentyfikować, że klient wyświetla produkt w Twojej witrynie. Metryki Wyświetlono produkt można filtrować i targetować w oparciu o następujące kryteria:
- ProductID
Identyfikator produktu. - Name
Nazwa produktu. - SKU
Kod SKU zamówionego produktu. - URL
Adres URL produktu. - Cena
Cena produktu. - Cena końcowa
Cena końcowa po uwzględnieniu wszelkich zniżek. - Kategorie
Tablica zawierająca kategorie, do których należy produkt. - Adres URL obrazu
Adres URL obrazu produktu. - external_catalog_id
Umożliwia organizować w Klaviyo katalogii - integration_key
Twoja platforma e-commerce (Magento 2).
Aktywność na stronie
Ta metryka jest śledzona, gdy klient, którego Klaviyo potrafi zidentyfikować, jest aktywny w Twojej witrynie. Możesz używać aktywności aktywni on Site w segmentach i sekwencjach, ale poniższe właściwości zdarzenia nie są dostępne dla filtrów segmentów ani filtrów sekwencji. Możesz je sprawdzić w surowych danych zdarzenia:
- utm_medium
Nośnik parametru śledzenia UTM (np. kampania). - kx_present
Wartość true, gdy w adresie URL występuje parametr kx. Pole jest pomijane, gdy parametr nie występuje. - os
System operacyjny urządzenia użytkownika. - initial_page_path
Ścieżka URL strony początkowej, na którą trafił użytkownik. - przeglądarka
Typ przeglądarki użytkownika. - strona
Adres URL strony, na której użytkownik był aktywny. - utm_campaign
Parametr metoda śledzenia UTM dla kampanii. - utm_source
Źródło UTM (np. Klaviyo).
Synchronizowane dane klientów
Klaviyo tworzy lub aktualizuje profile na podstawie zsynchronizowanych zamówień, rekordów klientów i rozpoczętych realizacji zakupu. Poniższe informacje są dodawane, gdy są dostępne w danych źródłowych:
- Adres e-mail
- Imię i nazwisko
- Miasto, województwo/region, kod pocztowy, kraj
- Numer telefonu
- Utworzono konto Magento (np. YYYY-mm-dd hh:mm:ss; 2015-05-21 13:04:00)
- Grupa klientów Magento (np. Hurt)
- Sklep Magento (np. Sklep US)
- Data urodzenia (np. YYYY-mm-dd; 1990-03-25)
- Płeć
Jeśli zaktualizujesz grupę klientów w Magento 2, to nawet po utworzeniu pierwotnego profilu w Klaviyo grupa klientów zostanie zaktualizowana w Klaviyo.
MagentoWebsiteID jest synchronizowany, gdy klient lub zamówienie ma powiązany sklep Magento. Ograniczenia nie są kopiowane do Klaviyo.
Klaviyo obsługuje niestandardowy główny adres URL multimediów dla obrazów produktów hostowanych pod innym bazowym adresem URL. Zobacz przewodnik konfiguracji Magento 2, aby zapoznać się z instrukcjami konfiguracji.
Wartość przychodu
Gdy używasz metryki Placed Order w Magento 2 do mierzenia przychodu, anulowane i zwrócone zamówienia nie są automatycznie odejmowane. To może sprawić, że przychód wyświetlany w Klaviyo będzie się różnić od przychodu wyświetlanego w Magento.
Dodatkowe źródła
- Pierwsze kroki z Magento 2.x (CE i EE)
Dowiedz się, jak zintegrować Klaviyo ze sklepem Magento 2 CE lub EE. Musisz zainstalować rozszerzenie Klaviyo w Magento, skonfigurować rozszerzenie i OAuth, a następnie włączyć integracje w Klaviyo. W tym przewodniku omawiamy wszystkie wymagane kroki integracji, a także potwierdzamy, jak potwierdzić pomyślną synchronizację danych historycznych.
- Jak rozwiązać problem z integracją z Magento 2?
Dowiedz się, jak rozwiązać problemy z konfiguracją OAuth w Magento 2, wykonując poniższe kroki rozwiązywania problemów. Jeśli po wykonaniu tych kroków nadal występują problemy, skontaktuj się z nami w Społeczności lub z naszym Zespołem wsparcia.