Odniesienie do danych Magento 1

Czego się dowiesz?

Dowiedz się, jakie dane Twoje istniejące integracje Magento 1 synchronizują z Klaviyo, w tym historyczne zamówienia, rekordy klientów i produkty. Po wstępnej synchronizacji historycznej zamówienia, klienci i produkty synchronizują się co 30 minut.

W Klaviyo przejdź do Analityka > Metryki na lewym pasku bocznym, aby wyświetlić metryki Twojego konta. Metryki z ikoną Magento są synchronizowane z Twojej integracji Magento.

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.

Te zdarzenia obejmują następujące dane zamówienia. Możesz używać właściwości najwyższego poziomu do filtrowania i kierowania zdarzeń; szczegóły atrybutów w sekcji extra są dostępne do treści wiadomości.

• Wartość: Suma całkowita zamówienia z Magento, uwzględniająca podatek i wysyłkę po rabatach.
• Pozycje: nazwy produktów z każdej pozycji zamówienia (np. koszulka lub spodnie). Nazwa może pojawić się więcej niż raz, jeśli występuje w osobnych pozycjach zamówienia.
• Kategorie produktów: Kategorie produktów z zamówienia (np. koszulki, męskie, spodnie i wyprzedaż).
• Liczba pozycji: Liczba pozycji zamówienia (np. 2). To nie jest suma zamówionych ilości.
• Kod waluty: Kod waluty zamówienia (np. USD lub EUR).
• Ze zniżką: Czy do zamówienia zastosowano zniżkę (true lub false).
• Kupon: Zastosowany kod kuponu.
• Unikatowe elementy: Nazwy produktów w zamówieniu, z usuniętymi duplikatami (np. koszule lub spodenki).
• Unikatowe kategorie produktów: Kategorie produktów w zamówieniu, z usuniętymi duplikatami (np. męskie lub wyprzedaż).
• Atrybuty (opcjonalne): Atrybuty produktu w szczegółach pozycji w sekcji dodatkowe. Użyj zdarzeń Ordered Product, aby filtrować według atrybutów poszczególnych produktów.

Zakończono proces płatności

To zdarzenie jest śledzone, gdy klient ukończy realizację zakupu w Twoim sklepie Magento. Zdarzenia Checkout Completed nie synchronizują się historycznie, więc ich łączne wartości mogą nie odzwierciedlać wszystkich wcześniejszych realizacji zakupów. Używaj zdarzeń Placed Order do raportowania przychodów i segmentacji.

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

W przypadku standardowych statusów zamówień Magento to zdarzenie jest rejestrowane, gdy zamówienie osiągnie status ukończone. Klaviyo śledzi powiązane informacje o produktach dotyczące pozycji, które ktoś kupił, w tym nazwy produktów, obrazy oraz informacje o wariancie, których możesz użyć w e-mailach następczych po zakupie.

Te zdarzenia obejmują następujące dane zamówienia. Możesz używać właściwości najwyższego poziomu do filtrowania i kierowania zdarzeń; szczegóły atrybutów w sekcji extra są dostępne do treści wiadomości.

• Wartość: Suma całkowita zamówienia z Magento, uwzględniająca podatek i wysyłkę po rabatach.
• Pozycje: nazwy produktów z każdej pozycji zamówienia (np. koszulka lub spodnie). Nazwa może pojawić się więcej niż raz, jeśli występuje w osobnych pozycjach zamówienia.
• Kategorie produktów: Kategorie produktów z zamówienia (np. koszulki, męskie, spodnie i wyprzedaż).
• Liczba pozycji: Liczba pozycji zamówienia (np. 2). To nie jest suma zamówionych ilości.
• Kod waluty: Kod waluty zamówienia (np. USD lub EUR).
• Ze zniżką: Czy do zamówienia zastosowano zniżkę (true lub false).
• Kupon: Zastosowany kod kuponu.
• Unikatowe elementy: Nazwy produktów w zamówieniu, z usuniętymi duplikatami (np. koszule lub spodenki).
• Unikatowe kategorie produktów: Kategorie produktów w zamówieniu, z usuniętymi duplikatami (np. męskie lub wyprzedaż).
• Atrybuty (opcjonalne): Atrybuty produktu w szczegółach pozycji w sekcji dodatkowe. Użyj zdarzeń Ordered Product, aby filtrować według atrybutów poszczególnych produktów.

Zamówiono produkt

To zdarzenie jest śledzone, gdy klient składa zamówienie. W przypadku ilości wyrażonych liczbami całkowitymi śledzone jest jedno zdarzenie Ordered Product dla każdej zakupionej sztuki — maksymalnie 100 zdarzeń na pozycję w zamówieniu. Na przykład jeśli ktoś kupi koszulkę i parę spodni, rejestrowane jest jedno zdarzenie Placed Order i dwa zdarzenia Ordered Product: jedno dla koszulki i jedno dla spodni. W przypadku produktów sprzedawanych w ilościach dziesiętnych Klaviyo rejestruje jedno zdarzenie dla pozycji w zamówieniu i uwzględnia zakupioną ilość.

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ść: Wartość reprezentowana przez to zdarzenie przed rabatami, z wyłączeniem kosztów wysyłki. W przypadku ilości wyrażonych liczbą całkowitą jest to suma pozycji zamówienia podzielona przez jej ilość. W przypadku ilości dziesiętnych jest to pełna suma pozycji.
• Nazwa: Nazwa nadana temu konkretnemu elementowi.
• SKU: SKU przypisany do elementu (np. REDMEDIUMTSHIRT).
• Kategorie: Kategorie tego produktu (np. koszulki, męskie, spodnie i wyprzedaż).
• Cena: Cena jednostkowa produktu w walucie zamówienia (np. koszulki 25,50 lub buty 50,25).
• Koszt (opcjonalnie): Koszt produktu zapisany w Magento, jeśli jest dostępny (np. koszule 13.85 lub buty 20.00).
• Kod waluty: Kod waluty zamówienia (np. USD lub EUR).
• Z przeceną: Czy do tej konkretnej pozycji zastosowano rabat (tzn. prawda lub fałsz).
• ProductID: identyfikator konkretnego produktu w sklepie.
• Ilość: Ilość reprezentowana przez to zdarzenie: 1 dla ilości wyrażonych liczbami całkowitymi lub zakupiona ilość w przypadku produktu sprzedawanego w ilościach dziesiętnych.
• 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 Twoim sklepie Magento. Klaviyo śledzi powiązane dane, w tym informacje o produktach dotyczące elementów, które ktoś kupił, m.in. nazwy produktów, obrazy i informacje o wariancie, których możesz użyć w e-mailach po zakupie. Te zdarzenia Placed Order obejmują następujące dane zamówienia. Możesz użyć właściwości najwyższego poziomu, aby filtrować i kierować zdarzenia; szczegóły atrybutów w sekcji extra są dostępne dla treści wiadomości.

• Wartość: Suma całkowita zamówienia z Magento, uwzględniająca podatek i wysyłkę po rabatach.
• Pozycje: nazwy produktów z każdej pozycji zamówienia (np. koszulka lub spodnie). Nazwa może pojawić się więcej niż raz, jeśli występuje w osobnych pozycjach zamówienia.
• Kategorie produktów: Kategorie produktów z zamówienia (np. koszulki, męskie, spodnie i wyprzedaż).
• Liczba pozycji: Liczba pozycji zamówienia (np. 2). To nie jest suma zamówionych ilości.
• Kod waluty: Kod waluty zamówienia (np. USD lub EUR).
• Ze zniżką: Czy do zamówienia zastosowano zniżkę (true lub false).
• Kupon: Zastosowany kod kuponu.
• Unikatowe elementy: Nazwy produktów w zamówieniu, z usuniętymi duplikatami (np. koszule lub spodenki).
• Unikatowe kategorie produktów: Kategorie produktów w zamówieniu, z usuniętymi duplikatami (np. męskie lub wyprzedaż).
• Atrybuty (opcjonalne): Atrybuty produktu w szczegółach pozycji w sekcji dodatkowe. Użyj zdarzeń Ordered Product, aby filtrować według atrybutów poszczególnych produktów. Dowiedz się, jak przeglądać niestandardowe atrybuty produktów.

Zwrócono płatność za zamówienie

W przypadku standardowych statusów zamówień Magento to zdarzenie jest rejestrowane, gdy zamówienie osiągnie status zamknięte. Jego wartość to łączna kwota pierwotnego zamówienia, a nie kwota pojedynczego zwrotu.

• Wartość: Suma końcowa pierwotnego zamówienia z Magento, uwzględniająca podatek i wysyłkę po rabatach.
• Kupon: Zastosowany kod kuponu.
• Kod waluty: Kod waluty zamówienia (np. USD lub EUR).
• Ze zniżką: Czy do zamówienia zastosowano zniżkę (true lub false).
• Kategorie produktów: Kategorie produktów z zamówienia (np. koszulki, męskie, spodnie i wyprzedaż).
• Liczba pozycji: Liczba pozycji zamówienia (np. 2). To nie jest suma zamówionych ilości.
• Pozycje: nazwy produktów z każdej pozycji zamówienia (np. koszulka lub spodnie). Nazwa może pojawić się więcej niż raz, jeśli występuje w osobnych pozycjach zamówienia.
• Unikatowe kategorie produktów: Kategorie produktów w zamówieniu, z usuniętymi duplikatami (np. męskie lub wyprzedaż).
• Unikatowe elementy: Nazwy produktów w zamówieniu, z usuniętymi duplikatami (np. koszule lub spodenki).

Przychód z metryki Placed Order wykorzystuje łączną kwotę zamówienia (grand total) z Magento, w tym podatek i koszty wysyłki, po zastosowaniu rabatów. Aby filtrować segment na podstawie wartości $value, użyj opcji Revenue.

Płatność 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 szablonach e-maili w sekwencjach wyzwalanych metryką.

Synchronizowane dane klientów

Klaviyo tworzy lub aktualizuje profile na podstawie zsynchronizowanych zamówień, rekordów klientów i rozpoczętych realizacji zakupu. Informacje dostępne w profilu zależą od danych dostarczanych przez Magento. Może to obejmować:

• 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ć
• Magento WebsiteID (gdy rekord klienta zawiera identyfikator sklepu)

Jeśli zaktualizujesz grupę klientów w Magento, nawet po utworzeniu pierwotnego profilu w Klaviyo, grupa klientów zostanie zaktualizowana w Klaviyo.

Sprawdź niestandardowe atrybuty produktu

Niestandardowe atrybuty produktu zależą od Twojej istniejącej konfiguracji integracji. Skonfigurowane atrybuty pojawiają się w zdarzeniach Ordered Product jako właściwości o nazwie Attribute: po której znajduje się kod atrybutu. Szczegóły atrybutów są też zapisywane dla poszczególnych pozycji w sekcji extra w zdarzeniach zamówienia. Pomoc techniczna Klaviyo nie obsługuje już próśb o włączenie lub zmianę synchronizacji atrybutów Magento 1. Przejrzyj swoje istniejące dane zdarzeń, aby sprawdzić, które atrybuty są dostępne. Ogólne informacje o pomocy technicznej znajdziesz w artykule Jak skontaktować się z pomocą techniczną.

Aby zidentyfikować atrybut niestandardowy w istniejącej konfiguracji, przejdź do Katalog > Atrybuty > Zarządzaj atrybutami w panelu administracyjnym Magento i kliknij ten atrybut.

Znajdź identyfikator atrybutu w adresie URL, jak pokazano poniżej.

Zweryfikuj zsynchronizowane dane zamówień

Aby zweryfikować zsynchronizowane zamówienia, porównaj liczbę zdarzeń Placed Order dla zakończonego dnia z zamówieniami w Magento dla tego samego dnia i sklepów. Zanim porównasz liczby, pozwól, aby historyczna synchronizacja się zakończyła, i aby ukończyła się najnowsza synchronizacja 30-minutowa.

1. Przejdź do Analityka > metryki i wybierz metrykę Placed Order dla Magento.
2. Ustaw zakres dat tak, aby obejmował dzień, który chcesz porównać. Ustaw Wyświetl według na Dziennie, a Pomiar na Łącznie. Usuń każdy filtr, który wykluczałby zamówienia z porównania.
3. Najedź kursorem na punkt danych z danego dnia lub odczytaj jego wartość w tabeli pod wykresem. Porównaj tę liczbę z zamówieniami Magento z tego samego dnia i tych samych sklepów.

Jeśli liczby się różnią, sprawdź, czy oba raporty używają tej samej strefy czasowej i tego samego zakresu sklepu oraz czy synchronizacja została ukończona. Sprawdź też, czy niedopasowane zamówienia Magento nie oczekują na płatność lub czy nie brakuje w nich prawidłowego adresu e-mail klienta. Aby sprawdzić strefę czasową w Klaviyo:

1. W lewym dolnym rogu kliknij nazwę swojego konta.
2. Kliknij przycisk Ustawienia.
3. Wybierz Ogólne > Konto i sprawdź ustawienie Strefa czasowa.
4. Jeśli zmienisz strefę czasową, kliknij Zapisz. Aby zmienić tę wartość, potrzebujesz uprawnień do edytowania ustawień konta.

Przychód z metryki Placed Order w Klaviyo nie odejmuje anulowanych ani zwróconych zamówień. W związku z tym może się różnić od raportu Magento, który odejmuje te zamówienia.

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.

Skorzystaj z tych przykładów, aby zrozumieć nazwy właściwości i zagnieżdżanie zsynchronizowanych zdarzeń. Pokazują starszy format ładunku zdarzenia i nie są instrukcjami wysyłania żądań do obecnych interfejsów API Klaviyo. Przykładowe wartości mają charakter poglądowy; extra zawiera pełne szczegóły zamówienia dla zdarzeń na poziomie zamówienia.

Złożone zamówienia

{
  "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"
    ],
    "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

{
  "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",
    "$value": 9.99,
    "Currency Code": "USD",
    "Name": "Winnie the Pooh",
    "SKU": "WINNIEPOOH",
    "ProductID": "567",
    "Categories": [
      "Fiction",
      "Classics"
    ],
    "Price": 9.99,
    "Discounted": true,
    "Cost": 5.0,
    "Attribute: Color": "Red",
    "$extra": {
      "Product URL Key": "winnie-pooh",
      "Product URL": "https://www.store.com/winnie-pooh",
      "Image URL": "https://cnd.store.com/images/winnie-pooh.png"
    },
    "Quantity": 1
  },
  "time": 1387302423
}

Zrealizowano zamówienie

{
  "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"
    ],
    "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
}

Dodatkowe źródła