Magento 1-Datenreferenz

Übersicht

Erfahre, welche Magento 1-Daten in Klaviyo importiert werden, wenn du die beiden Plattformen integrierst. Klaviyo Integrationen mit Magento ziehen zum Zeitpunkt deiner ersten historischen Synchronisierung alle historischen Daten aus deinem Magento-Shop. Nach der Aktivierung beginnt die Integration damit, Metriken und Kund*innendaten nahezu in Echtzeit zu synchronisieren. Beispiele für diese Daten sind Informationen, die mit früheren aufgegebenen Bestellungen, erfüllten Bestellungen usw. verknüpft sind.

In Klaviyo kannst du in der linken Seitenleiste zur Registerkarte Analytics deines Kontos navigieren, um alle Metriken in deinem Konto anzuzeigen. Die Metriken mit einem Magento-Symbol sind die, die aus deiner Magento-Integrationen synchronisiert werden.

Magento-Metriken

Bestellung storniert

Dieses Event wird erfasst, wenn Kund*innen in deinem Magento-Shop eine Bestellung erstellen, die Bestellung dann aber vor der Fulfillment storniert wird. Klaviyo erfasst zugehörige Daten, einschließlich aller Produktinformationen zu den Artikeln, die jemand gekauft hat. Produktinformationen umfassen Produktnamen, Bilder und Varianteninformationen, die du in Follow-up-E-Mails nach dem Kauf verwenden kannst.

Du kannst Ereignisse für stornierte Bestellungen anhand der folgenden Kriterien filtern und anvisieren:

• Wert: Gesamtwert der Bestellung (Zwischensumme + Versandkosten - alle Rabatte).
• Items: Die Namen der Produkte in der Bestellung einer Person.
  Bsp.: T-Shirt oder Hose. Wenn mehrfach bestellt, werden mehrere Exemplare desselben Artikels angezeigt
• Artikel-Kategorien: die vollständige Kategorieauswahl der Artikel in der Bestellung einer Person (z. B. t-shirts, mens, pants und sale).
• Artikelanzahl: Die Anzahl der Artikel in der Bestellung (z. B. 2).
• Währungscode: Die spezifische Währung, mit der ein Artikel basierend auf dem Land bezahlt wird (z. B. USD, EUR).
• Rabattiert: Ob auf diesen spezifischen Artikel ein Rabatt angewendet wird (d. h. true/false).
• Gutschein: Der angewendete Gutscheincode.
• Unique Items: Der einzelne Artikel, der in einer Bestellung enthalten ist (z. B. Shirts, Shorts). Wenn mehrere Produkte bestellt werden, wird der Unique Item nur einmal angezeigt.
• Eindeutige Artikelkategorien: Die Kategorien, in denen eindeutige Artikel gruppiert sind (z. B. Herren, Sale).
• Attribute (optional): Benutzerdefinierte Produktattribute.

Bezahlvorgang abgeschlossen

Dieses Ereignis wird aufgezeichnet, wenn Kund*innen in deinem Magento-Shop einen Checkout abschließen. Das Ereignis „Checkout Completed“ wird nicht historisch synchronisiert und ist daher nicht immer ein genaues Maß, wenn du dir Ereignissummen über einen längeren Zeitraum ansiehst. Verwende für Umsatz-Tracking und Segmentierung das Ereignis „Placed Order“.

Du kannst Ereignisse für Checkout abgeschlossen nach den folgenden Kriterien filtern und für das Targeting nutzen:

• Wert: Der Gesamtwert der Bestellung.
• Rabattcodes: Alle angewendeten Gutschein- oder Rabattcodes.
• Items: Die Bezeichnung der Produkte im Warenkorb einer Person (z. B. T-Shirt oder Hose).
• Anzahl der Artikel: Die Gesamtzahl der Artikel in jemandes Warenkorb.
• Gesamtrabatte (optional): Gesamter Dollarwert aller Gutschein oder Rabatte.

Bezahlvorgang gestartet

Dieses Ereignis wird erfasst, wenn Kund*innen ihre Kontakt- und Versandinformationen auf der ersten Seite des Magento-Bezahlvorgangs eingeben und dann auf weiter klicken. Klaviyo erfasst zugehörige Produktdaten zu Artikeln im Warenkorb einer Person, einschließlich Produktnamen, Bildern und Varianteninformationen, die du in deinen E-Mails zu Warenkorbabbruch verwenden kannst. Dieses Ereignis hat eine Eigenschaft für die Checkout-URL, die zurück zum exakten Warenkorb jeder*s Kund*in führt und verwendet werden kann, um den Warenkorb wiederherzustellen, wenn Kund*innen die E-Mail auf einem neuen Gerät öffnen.

Du kannst Ereignisse vom Typ „Checkout Started“ anhand der folgenden Kriterien filtern und für das Targeting nutzen:

• Wert: Der Wert des Warenkorbs zum Zeitpunkt des Checkouts (Zwischensumme + Versandkosten - Rabatte).
• Items: Die Bezeichnung der Produkte im Warenkorb einer Person (z. B. T-Shirt oder Hose).
• Anzahl der Artikel: Die Gesamtzahl der Artikel in jemandes Warenkorb.
• Rabattcodes (optional): Alle angewendeten Gutschein- oder Rabattcodes.
• Gesamtrabatte (optional): Gesamter Dollarwert aller Gutschein oder Rabatte.

Bestellung erfüllt

Dieses Ereignis wird getrackt, wenn du eine Bestellung in deinem Magento-Shop als versandt markierst. Klaviyo trackt zugehörige Produktinformationen zu den Artikeln, die jemand gekauft hat, einschließlich Produktnamen, Bildern und Varianteninformationen, die in Follow-up-E-Mails nach dem Kauf verwendet werden können.

Du kannst Ereignisse für Erfüllte Bestellungen anhand der folgenden Kriterien filtern und anvisieren:

• Wert: Gesamtwert der Bestellung (Zwischensumme + Versandkosten - alle Rabatte).
• Items: Die Namen der Produkte in der Bestellung einer Person (z. B. T-Shirt oder Hose). Bei mehrfacher Bestellung werden mehrere Exemplare desselben Artikels angezeigt.
• Artikelkategorien: Der vollständige Satz an Kategorien der Artikel in der Bestellung einer Person (z. B. T-Shirts, Herren, Hosen und Sale).
• Item Count: Die Anzahl der Artikel in der Bestellung. (z. B. 2).
• Währungscode: Die spezifische Währung, mit der ein Artikel basierend auf dem Land bezahlt wurde (z. B. USD, EUR).
• Rabattiert: Ob auf diesen spezifischen Artikel ein Rabatt angewendet wird (d. h. true/false).
• Gutschein: Der angewendete Gutscheincode.
• Eindeutige Artikel: Der einzelne Artikel, der in einer Bestellung erstellt wird (z. B. Shirts, Shorts).Wenn mehrere Produkte bestellt werden, wird der eindeutige Artikel nur einmal angezeigt.
• Eindeutige Artikelkategorien: Die Kategorien, in denen eindeutige Artikel gruppiert sind (z. B. Herren, Sale).
• Attribute (optional): Benutzerdefinierte Produktattribute.

Produkt bestellt

Dieses Ereignis wird getrackt, wenn Kund*innen ihre Bestellung aufgeben. Für jeden Artikel, den jemand kauft, wird ein Ereignis „Ordered Product“ getrackt. Wenn jemand zum Beispiel ein T-Shirt und eine Hose kauft, wird ein Ereignis „Placed Order“ getrackt und zwei Ereignisse „Ordered Product“ werden aufgezeichnet – ein Ereignis für das T-Shirt und ein Ereignis für die Hose.

Das Ereignis „Ordered Product“ enthält detaillierte Informationen zu jedem Produkt, das jemand kauft. Dies ist nützlich, wenn du verhaltensbezogene Segmente basierend auf Optionen für Produktvarianten und anderen detaillierten Informationen erstellst, die im Ereignis „Bestellung aufgegeben“ nicht verfügbar sind. Du kannst Ereignisse für Bestelltes Produkt nach den folgenden Kriterien filtern und für das Targeting nutzen:

• Wert: Gesamtpreis des Artikels (enthält keine Versandkosten und keine in Anspruch genommenen Rabatte).
• Name: Der Name, der diesem spezifischen Element zugewiesen wurde.
• SKU: Die spezifische SKU, die zugewiesen wird, um einen Artikel zu verfolgen (z. B. REDMEDIUMTSHIRT).
• Kategorien: die vollständige Sammlung der Kollektionen der Produkte in der Bestellung einer Person (z. B. T-Shirts, Herren, Hosen und Sale).
• Preis: Der Dollarwert des spezifischen Produkts (z. B. Shirts 25,50, Schuhe 50,25).
• Kosten: Die Kosten, um ein Produkt herzustellen (z. B. Shirts 13,85, Schuhe 20,00).
• Währungscode: Die spezifische Währung, die für einen Artikel je nach Land bezahlt wurde (z. B. USD, EUR).
• Rabattiert: Ob auf diesen bestimmten Artikel ein Rabatt angewendet wird (d. h. wahr oder falsch).
• ProductID: ID des jeweiligen Produkts in deinem Shop.
• Menge: Bestellte Menge.
• Attribute (optional): Benutzerdefinierte Produktattribute.

Bestellung aufgegeben

Dieses Ereignis wird erfasst, wenn ein*e Kund*in den Bezahlvorgang abschließt und eine Bestellung in deinem Magento-Shop erstellt. Klaviyo erfasst zugehörige Daten, einschließlich Produktinformationen zu den Artikeln, die jemand gekauft hat, einschließlich Produktnamen, Bildern und Varianteninformationen, die du in Follow-up-E-Mails nach dem Kauf verwenden kannst. Du kannst Ereignisse für platzierte Bestellungen anhand der folgenden Kriterien filtern und anvisieren:

• Wert: Gesamtwert der Bestellung (Zwischensumme + Versand - alle Rabatte).
• Items: Die Namen der Produkte in der Bestellung einer Person, z. B. T-Shirt oder Hose. Wenn er mehrfach bestellt wird, wird derselbe Artikel mehrfach angezeigt.
• Artikelkategorien: Die vollständige Menge an Kategorien der Artikel in der Bestellung einer Person (z. B. T-Shirts, Herren, Hosen und Sale).
• Artikelanzahl: Die Anzahl der Artikel in der Bestellung (z. B. 2).
• Währungscode: Die spezifische Währung, in der ein Artikel je nach Land bezahlt wird (z. B. USD, EUR).
• Rabattiert: Ob auf diesen spezifischen Artikel ein Rabatt angewendet wird (d. h. true/false).
• Gutschein: Der angewendete Gutscheincode.
• Eindeutige Artikel: Der einzelne Artikel, der in einer Bestellung erstellt wird (z. B. Hemden, Shorts). Wenn mehrere Produkte bestellt werden, wird der eindeutige Artikel nur einmal angezeigt.
• Eindeutige Artikelkategorien: Die Kategorien, in denen eindeutige Artikel gruppiert sind (z. B. Herren, Sale).
• Attribute (optional): Bis zu 10 benutzerdefinierte Produktattribute können für aufgegebene Bestellungen synchronisiert werden. Diese Synchronisierung muss aktiviert werden, bevor benutzerdefinierte Attributdaten in dein Klaviyo-Konto fließen. Siehe den folgenden Abschnitt dazu, wie du das einrichtest.

Bestellung erstattet

Dieses Ereignis wird aufgezeichnet, wenn eine Bestellung in Magento erstattet wird.

• Wert: Gesamtwert der Bestellung (Zwischensumme + Versand - alle Rabatte).
• Gutschein: Der angewendete Gutscheincode.
• Währungscode: Die spezifische Währung, in der ein Artikel je nach Land bezahlt wird (z. B. USD, EUR).
• Discounted: Ob für diesen spezifischen Artikel ein Rabatt angewendet wurde (d. h. true/false).
• Artikelkategorien: Die vollständige Menge an Kategorien der Artikel in der Bestellung einer Person (z. B. T-Shirts, Herren, Hosen und Sale).
• Anzahl der Artikel: Die Anzahl der Artikel in der Bestellung (z. B. 2).
• Items: Die Namen der Produkte in der Bestellung einer Person (z. B. T-Shirt oder Hose). Wenn er mehrfach bestellt wird, wird derselbe Artikel mehrfach angezeigt.
• Eindeutige Artikelkategorien: Die Kategorien, in denen eindeutige Artikel gruppiert sind (z. B. Herren, Sale).
• Unique Items: Der einzelne Artikel, der in einer Bestellung erstellt wurde, z. B.: Hemden, Shorts. Wenn mehrere Produkte bestellt werden, wird der Unique Item nur einmal angezeigt.

Umsatz bzw. der Wert Placed Order wird wie folgt berechnet: (Preis der Bestellungen + Versand - Rabatte). Um ein Segment nach $value zu filtern, filtere das Segment mit Umsatz.

Payment ist als Eigenschaft der zweiten Ebene unter dem Feld extra verfügbar. Du kannst für die Segmentierung nicht nach Eigenschaften der zweiten Ebene filtern, aber du kannst diese Daten als Ereignisvariable in deinen E-Mail-Vorlagen verwenden.

Synchronisierte Kundendaten

Klaviyo erstellt einen Kontakt, wenn eine bestehende Bestellung erstellt wird, ein bestehender Kund*innendatensatz vorhanden ist oder ein Checkout gestartet wird. Klaviyo erstellt für jeden synchronisierten Kontakt ein neues Klaviyo-Profil und füllt dieses Profil mit den folgenden Informationen:

• E-Mail
• Vor- und Nachname
• Stadt, Bundesland/Region, PLZ, Land
• Phone Number
• Magento-Konto erstellt (z. B. 2015-05-01 00:00:00)
• Magento-Kund*innengruppe (z. B. Großhandel)
• Magento-Store (z. B. US-Store)
• Geburtsdatum (z. B. 1990-01-01)
• Geschlecht
• website_ID wird nicht abgerufen
• Unterdrückungen werden nicht in Klaviyo kopiert, daher sind sie nicht in der Klaviyo-Plattform vorhanden.

Wenn du die Kund*innengruppe in Magento aktualisierst, wird die Kund*innengruppe auch in Klaviyo aktualisiert, selbst nachdem das ursprüngliche Profil in Klaviyo erstellt wurde.

Benutzerdefinierte Produktattribute für aufgegebene Bestellungen synchronisieren

Klaviyo kann bis zu 10 benutzerdefinierte Produktattribute für die Metrik Bestellung aufgegeben synchronisieren. Benutzerdefinierte Produktattribute werden nicht automatisch an Klaviyo weitergeleitet. Du kannst Klaviyo jedoch auffordern, sie zu übernehmen. Dazu solltest du die benutzerdefinierte Attribut-ID erfassen (Anleitung unten) und eine Anfrage an unser Support-Team senden.

Suche die benutzerdefinierten Produkt-IDs im Administrator von Magento, indem du zu Katalog > Attribute > Attribute verwalten gehst und auf das Attribut klickst.

Die ID findest du in der URL wie folgt:

Überprüfe deine synchronisierten Bestelldaten

Klaviyo importiert alle deine Magento-Daten. Um das zu überprüfen, kannst du die Anzahl der Bestellungen an einem bestimmten Tag mit der in der Magento-Oberfläche vergleichen und bestätigen, dass sie übereinstimmen. Klicke in der linken Seitenleiste auf Analytics, suche die Metrik „Placed Order“ und klicke darauf. Dadurch gelangst du zur Seite „Metrik-Diagramm“ und siehst standardmäßig die Daten der letzten 30 Tage. Unten siehst du ein Beispiel für das angezeigte Metrik-Diagramm.

Fahre mit der Maus über den Datenpunkt von gestern oder sieh in der Datentabelle unter dem Diagramm nach, um zu sehen, wie viele Bestellungen du gestern hattest. Vergleiche diese Zahl mit der Zahl in Magento, und du solltest sehen, dass sie genau übereinstimmen. Wenn das nicht der Fall ist, liegt das Problem höchstwahrscheinlich daran, dass die Zeitzone deines Klaviyo-Kontos nicht mit der Zeitzone in Magento übereinstimmt. So überprüfst du deine Zeitzoneneinstellung:

1. Klicke unten links auf den Namen deiner Organisation.
2. Klicke auf Einstellungen.
3. Wähle Organisation.

Möglicherweise stellst du fest, dass der Umsatz -Wert auf deinem Klaviyo-Dashboard nicht immer mit dem Umsatzwert übereinstimmt, den du in Magento siehst; das liegt daran, dass Klaviyo stornierte und erstattete Bestellungen nicht von unserer Umsatzberechnung abzieht.

Eigenschaften für synchronisierte Magento-Bestellungen

Unten findest du Beispiel-JSON-Payloads für die Metriken „Placed Order“, „Ordered Product“ und „Fulfilled Order“, die den Eigenschaften entsprechen, die wir für Bestellungen speichern, die über die Magento-SOAP-API synchronisiert werden.

Das ist nützlich, um die richtigen Eigenschaften für Bestellungen zu senden, die mit Magento-Bestelldaten kombiniert werden.

Bestellung aufgegeben

// 
// 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
}

Produkt bestellt

// 
// 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
}

Bestellung erfüllt

// 
// 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
}