Wie man historische Ereignisdaten manuell importiert

Das wirst du lernen

Lerne, wie du historische Ereignisdaten manuell in Klaviyo importieren kannst. Wir empfehlen die Verwendung von Klaviyo-Integrationen mit Plattformen wie Shopify, Magento und BigCommerce sowie unsere API für benutzerdefinierte Integrationen, aber es ist auch möglich, diese Daten manuell hinzuzufügen. Ein häufiges Beispiel hierfür ist das Hinzufügen historischer Kaufdaten von einer früheren E-Commerce-Plattform, für die Klaviyo keine vorgefertigte Integration hat.

Bitte beachte, dass CSV-Uploads maximal 50 MB groß sein dürfen. 

Formatiere deine Daten

Der erste Schritt besteht darin, deine Daten in einer CSV-Datei richtig zu formatieren. Im Folgenden findest du ein Beispiel für die Daten einer platzierten Bestellung und eine Beschreibung der Felder. Jede Zeile in deiner CSV-Datei sollte eine Aktion oder Aktivität darstellen, die jemand durchgeführt hat. Zum Beispiel: "Gekauftes Produkt" oder "Anmeldung zum Webinar." Wenn du mehrere Aktionen zu verfolgen hast, solltest du sie als separate CSV-Dateien hochladen. Die E-Mail-Adresse muss an erster Stelle stehen, wenn du deine CSV-Datei hochlädst.

Hier sind einige Beispiel-Ereignis-CSVs, die du beim Formatieren deiner Daten verwenden kannst.

Erforderliche Felder

Die beiden erforderlichen Felder sind ein Zeitstempel, der angibt, wann das Ereignis eingetreten ist, und eine Kundeneigenschaft (eine E-Mail oder eine eindeutige ID), die angibt, wer die Aktion durchgeführt hat.

• Zeitstempel: Ein Zeitstempel, der den Tag und die Uhrzeit des Ereignisses angibt. Das Format ist JJJJ-MM+-TT HH:MM+:SS. Zum Beispiel wäre 13:30 Uhr am 14. November 2012: 2012-11-14 13:30:00.

  Wenn zwei oder mehr Ereignisse in deiner CSV-Datei den gleichen Zeitstempel haben, musst du eine eindeutige $event_id angeben, sonst wird nur eines der Ereignisse importiert und der Rest wird übersprungen. Siehe den Abschnitt über $event_id weiter unten.

• Person//E-Mail oder Person//ID: Höchstwahrscheinlich wirst du eine E-Mail verwenden, um deinen Kunden zu identifizieren. Manche Kunden verwenden auch eine eindeutige ID. Du kannst beides verwenden, wenn du möchtest.

Optionale Felder

Es gibt zwei besondere Felder, die du beachten solltest.

• $event_id: Dies ist ein eindeutiger Bezeichner für das Ereignis. In der Praxis solltest du eine $event_id senden, wenn du einen eindeutigen Bezeichner für jedes Ereignis hast, zum Beispiel eine Bestell-ID. Du solltest auch die $event_id setzen, wenn du erwartest, dass bestimmte Ereignisse zum gleichen Zeitpunkt auftreten. Das kann passieren, wenn jemand eine Aktion ausführt, die du dann in mehrere Ereignisse aufteilst. Wenn jemand zum Beispiel mehrere Artikel kauft und du für jeden gekauften Artikel ein Ereignis aufzeichnen möchtest.
  
  In den beiden Beispiel-Datensätzen unten gibt es ein Ereignis für eine Bestellung und 3 Ereignisse für bestellte Produkte (eines für jedes Produkt in der Bestellung). Alle diese Ereignisse haben denselben Zeitstempel, aber sie werden alle importiert, weil sie jeweils eine eindeutige $event_id haben. Wenn die $event_ids identisch sind oder wenn sie fehlen, wird nur eines der Ereignisse importiert und die anderen werden übersprungen.
  
• $Wert: Verwende dieses Feld, wenn das Ereignis, das du importierst, einen Wert enthält. Wenn du z.B. die Daten des Ereignisses "Erteilte Bestellung" importierst, hat jede Bestellung einen Wert. Du musst deinen Werten kein $ oder ein anderes Währungssymbol voranstellen.

Wenn du zusätzliche Daten über die Person hast, die etwas getan hat, sollten diese in einer Spalte stehen, deren Beschriftung mit Person// und dann mit der Art der Daten in dieser Spalte beginnt. Wenn du zum Beispiel das Unternehmen oder die Organisation hast, zu der jede Person gehört, würdest du die Spalte Person/Organisation beschriften wollen. Das spezielle Präfix lässt uns wissen, dass die Daten in dieser Spalte mit jeder Person und nicht mit der Aktivität verknüpft werden. Im Folgenden findest du spezielle Spalten, mit denen du Personen identifizieren kannst:

• Person//Vorname: Vorname
• Person//Nachname: Nachname
• Person//Telefon: Rufnummer
• Person//Organisation: Organisation
• Person//Titel: Berufsbezeichnung

Wenn du zusätzliche Daten zu jeder Aktion hast, kannst du sie in zusätzliche Spalten mit beliebigen Beschriftungen aufnehmen. Wenn jemand zum Beispiel etwas kauft und du wissen willst, welchen Artikel er gekauft hat, kannst du diese Daten in eine Spalte mit der Bezeichnung Gekaufter Artikel aufnehmen. Im Folgenden findest du einige Beispiele.

• Gekaufter Artikel
• Artikel Kategorie
• Produkt
• Standort

Wenn du keine Daten für eine bestimmte Spalte hast, lass sie einfach leer und wir ignorieren sie. Wenn du z. B. die Organisation einer Person nicht kennst, kannst du die Spalte für Person/Organisation leer lassen und wir werden diese Eigenschaft für diese Zeile in deinen Daten nicht erfassen.

Wenn du mit der Formatierung deiner Daten fertig bist, speichere sie in einer CSV-Datei.

Lade eine CSV-Datei mit Daten hoch

Nachdem du deine Daten richtig formatiert hast, gehst du auf Klaviyo und klickst unten links auf deinen Kontonamen. Dann wählst du Integrationen > Quellen verwalten > Importieren via CSV.

Du wirst aufgefordert, deine CSV-Datei hochzuladen, und klickst dann auf Weiter.

Als nächstes hast du die Möglichkeit, das Ereignis zu benennen. Wenn du versuchst, die importierten Daten einem Ereignis zuzuordnen, das bereits in deinem Konto vorhanden ist, musst du den Ereignisnamen genau so eingeben, wie er bereits erscheint.

Sobald du deine Veranstaltung benannt hast, kannst du deine Daten unten in der Vorschau anzeigen. Wenn du bereit bist, deine Daten zu importieren, klicke auf Weiter. Deine Datei wird nun bearbeitet und du kannst die Seite verlassen. 

Hinweis für E-Commerce-Shop zum Laden von Kaufdaten

Wenn du Einkaufsdaten hochlädst, solltest du zwei Dateien hochladen - eine für die gesamte Bestellung und eine zweite, die die Daten der einzelnen Artikel enthält.  Ein Kunde kann zum Beispiel eine Bestellung für mehrere Produkte aufgeben. In diesem Fall gäbe es ein Ereignis für die aufgegebene Bestellung und dann separate Ereignisse für jedes der bestellten Produkte. So sollten die Kopfzeilen dieser Dateien normalerweise aussehen:

Bestellung aufgegeben

Bestelltes Produkt

Wir verwenden das $ nicht als Präfix für Bestellwert. Verwende nur Zahlen, um den Preis oder Wert einer Bestellung anzugeben. Wenn du den $value-Header verwendest, werden die Daten in deinem Klaviyo-Konto korrekt ausgefüllt.

Der Grund, warum du zwei Metriken einfügst, ist, dass es so einfacher ist, später E-Mails sowohl für eine Gesamtbestellung als auch für bestimmte Kategorien / Artikel auszulösen.

Bei Ereignissen zu bestellten Produkten muss $event_id ein eindeutiger Bezeichner für jede Kombination aus Bestellung und bestelltem Produkt sein. Eine einfache Möglichkeit, einen eindeutigen Bezeichner zu erstellen, ist die Kombination von Bestell-ID und Produkt-ID wie im obigen Beispiel.

Fehlerbehebung importieren

Im Folgenden findest du einige häufige Probleme und Lösungen, die du beim manuellen Import von historischen Ereignisdaten finden kannst.

Mein Importieren dauert sehr lange

Das Importieren kann je nach Größe deiner Liste zwischen 5 Minuten und 24 Stunden dauern. Wir empfehlen dir, mit dem Importieren einer Liste mindestens 24 Stunden vor dem Zeitpunkt zu beginnen, an dem du sie für eine bestimmte Kampagne benötigst, um sicherzustellen, dass der Importvorgang deinen Versand nicht aufhält.

Mein Importieren schlägt immer wieder fehl

Wenn dein Importieren fehlschlägt, liegt das wahrscheinlich an einem der folgenden Gründe:

• Ist deine Datei eine .csv-Datei? Deine Datei muss im .csv-Format sein Format. Wenn du versuchst, eine Excel-Datei oder eine .txt-Datei hochzuladen Datei, wird das Importieren fehlschlagen.
• Hast du die Spalte Zeitstempel richtig formatiert? Du solltest das Datum und die Uhrzeit als JJJJ-MM+-TT HH:MM+:SS formatieren. Zum Beispiel wäre 13:30 Uhr am 14. November: 2012-11-14 13:30:00. Als zweite Überprüfung öffnest du deine CSV-Datei in einem Texteditor, um sicherzustellen, dass beim Speichern oder Exportieren deiner CSV-Dateien keine nachgestellten 0s aus den Zeitstempeln entfernt werden. Wenn du mit Daten in einer Tabellenkalkulation arbeitest, stelle sicher, dass die Zeitstempel-Zellen auf das richtige Zeitstempel-Format eingestellt sind.
  
• Sind alle erforderlichen Spalten in jeder Zeile mit Daten gefüllt? Du musst eine Spalte mit der Bezeichnung Person//E-Mail oder Person//ID haben .Wenn eine dieser Spalten eine leere Zeile enthält, kann dies dazu führen, dass dein Importieren fehlschlägt.
• Enthält deine Person//E-Mail-Spalte ungültige E-Mail-Adressen? Wenn du Werte innerhalb der Person//E-Mail hast, die kein gültiges E-Mail-Adressformat haben, kann das dazu führen, dass dein Importieren fehlschlägt.
• Sind alle deine Spalten richtig beschriftet? Gibt es Leerzeichen? Achte darauf, dass alle deine Spaltenüberschriften mit den Angaben in diesem Leitfaden übereinstimmen. Du solltest auch darauf achten, dass die Spaltennamen keine Leerzeichen enthalten.

Zusätzliche Ressourcen

• Zulässige Datums- und Zeitstempelformate für Profil- und Ereigniseigenschaften
• Wie man Daten für CSV-Dateien formatiert
• Zu Klaviyo migrieren