Hinweis: Data-Warehouse-Import ist Teil von Advanced KDP und nicht in der standardmäßigen Marketing-Anwendung von Klaviyo enthalten. Für den Zugriff auf diese Funktionalität ist ein Abonnement erforderlich.

Grundlegendes zum Data-Warehouse-Ereignisimport in Klaviyo

Übersicht

Lerne, wie du den Data-Warehouse-Ereignisimport nutzt, um Ereignisdaten aus deinem Warehouse mit Klaviyo zu synchronisieren. So kannst du Segmente, Flows und Berichte mit Verhaltensweisen außerhalb der nativen Integrationen von Klaviyo (z. B. POS-Systeme, Supportplattformen oder benutzerdefinierte Anwendungen) unterstützen.

Was ist der Data-Warehouse-Ereignisimport?

Mit dem Data-Warehouse-Ereignisimport kann Klaviyo eine direkte Verbindung zu deinem Data Warehouse herstellen und Importsynchronisierungen aus Warehouse-Tabellen oder -Sichten konfigurieren, die Ereignisdaten enthalten.

Jede Zeile in deiner Quelltabelle wird in Klaviyo wie ein einziges Ereignis behandelt:

Die Zeitstempel, der Name der Metrik und die Kennungen der Zeile definieren,was passiert ist, wann und für wen.
Zusätzliche Spalten werden zu Ereigniseigenschaften, die du in Segmentierung, Flows und Auswertungen verwenden kannst.

Der Ereignisimport basiert auf derselben Profilinfrastruktur wie der Profilimport, zielt aber auf die Ereignisaufnahmepipeline von Klaviyo statt auf Data-Warehouse-Importe ab.

Wie funktioniert der Data-Warehouse-Ereignisimport?

Nachdem du Klaviyo mit deinem Warehouse verbunden und eine Ereignissynchronisierung konfiguriert hast:

Klaviyo fragt dein Warehouse nach der konfigurierten Tabelle oder Ansicht ab.
Bei jedem Durchlauf liest Klaviyo nur Zeilen, deren Zeitstempel der Änderungserkennung neuer ist als die letzte erfolgreiche Synchronisierung. Dies ermöglicht inkrementelle Importe, ohne die gesamte Tabelle erneut zu verarbeiten.
Jede Zeile wird dann wie folgt verarbeitet:
- Klaviyo bestimmt den Metriknamen (Ereignistyp) anhand der bei der Synchronisierungseinrichtung ausgewählten Optionen: entweder eine einzelne ausgewählte Metrik oder dynamisch basierend auf dem Wert einer Spalte mit dem angegebenen Metriknamen in der Quelltabelle.
- Ereigniszeitstempel, Profilkennungen und optionale eindeutige ID, Wert und Wertwährung werden auf der Grundlage von Feldzuordnungen festgelegt, die während der Synchronisierungseinrichtung konfiguriert wurden.
- Alle verbleibenden Spalten werden als Ereigniseigenschaften aufgenommen, wobei die Spaltennamen als Eigenschaftsnamen verwendet werden. Spaltennamen mit drei Unterstrichen (z. B. übergeordnet___child1, parent___untergeordnet2) kann verwendet werden, um eine Ereigniseigenschaft (übergeordnet) mit untergeordneten Eigenschaften zu erstellen.
Klaviyo lädt die daraus resultierenden Ereignisse in dein Konto und verhält sich dort wie bei anderen benutzerdefinierten API-Metriken in Segmentierung, Flows und Auswertungen.

Importe werden in regelmäßigen Abständen (z. B. stündlich) ausgeführt, sodass neue oder aktualisierte Zeilen in deinem Warehouse regelmäßig in Events in Klaviyo umgewandelt werden.

Bevor du anfängst

Stelle sicher, dass die folgenden Anforderungen erfüllt sind, bevor du eine Ereignis-Import-Synchronisierung erstellst:

Dein Konto hat Zugriff auf Advanced KDP und Data-Warehouse-Import.
Du hast eine Data-Warehouse-Verbindung in Klaviyo erstellt und validiert. Weitere Informationen zum erforderlichen Dienstkonto und den erforderlichen Schemata findest du in den Artikeln zum Support Center für dein Data Warehouse.
Deine Quelltabelle oder -ansicht enthält die erforderlichen Spalten unten.
Du hast ausreichende Berechtigungen in deinem Warehouse, um die erforderlichen Tabellen/Views dem Klaviyo-Dienstbenutzer zur Verfügung zu stellen.

Quelltabellenstruktur für Ereignisse

Um sicherzustellen, dass deine Ereignisdaten korrekt importiert werden können, muss deine Quelltabelle oder -ansicht die erforderlichen Felder und die Struktur von Klaviyo erfüllen.

Pflichtfelder

Die folgenden Spalten sind in V1 des Data-Warehouse-Ereignisimports erforderlich:

Spalte	Erforderlich?	Typ	Beschreibung
Ereigniszeitstempel	Erforderlich	Zeitstempel/datetime	Wann das Ereignis aufgetreten ist.
Metrikname	Erforderlich, wenn bei der Einrichtung der Synchronisierungskonfiguration keine einzelne Metrik ausgewählt wird.	String/Text	Der Name des Ereignisses oder der Metrik (z. B. `Bestellung aufgegeben`, `Support-Ticket geöffnet`).
Profilkennung	Erforderlich (mindestens 1)	String/Text	Eine der folgenden Optionen ist verfügbar: E-Mail, Telefonnummer, externe ID oder Klaviyo ID. Du kannst mehrere in die Zeile aufnehmen, musst aber mindestens eine zuordnen.
Zeitstempel der Änderungserkennung	Erforderlich	Zeitstempel	Stabiler Zeitstempel zum Erkennen neuer oder aktualisierter Zeilen seit der letzten Ausführung. Muss sich vom Ereigniszeitstempel unterscheiden, damit du historische Ereignisse sicher importieren kannst. Dies sollte widerspiegeln, wann die Zeile zum Dataset hinzugefügt wurde, und muss stabil sein, damit die Synchronisierung korrekt funktioniert.

Optionale Felder

Diese Felder werden ggf. empfohlen, sind aber nicht unbedingt erforderlich:

Spalte	Erforderlich?	Typ	Beschreibung
Eindeutige ID	Empfohlen	String/Zahl	Eindeutiger Bezeichner des Ereignisses (für die Deduplizierung verwendet).
Eintrag	Empfohlen	Zahl	Numerischer Wert für das Ereignis (z. B. Bestellsumme, verwendete Punkte). Ordnet dem übergeordneten `Wertfeld` im Ereignismodell von Klaviyo zu.
Wert: Währung	Empfohlen	String/Text	Währungscode, der mit dem `Wert` verknüpft ist (z. B. `USD`). Ordnet dem Feld „ `value_currency`“ der obersten Ebene zu.

Ereigniseigenschaften

Alle anderen Spalten in deiner Tabelle werden als Ereigniseigenschaften behandelt:

Spalten werden als verflachte Eigenschaften importiert, wobei der Spaltenname direkt als Name der Eigenschaft in Klaviyo verwendet wird.
Du musst nicht jede Eigenschaft explizit zuordnen. Nicht zugeordnete Spalten werden als Ereigniseigenschaften einbezogen.
Verschachteltes JSON kann bei Bedarf innerhalb eines einzelnen Eigenschaftswerts gespeichert werden (z. B. ein JSON-Objekt von Zeilenelementen), aber der Eigenschaftsname selbst stammt aus einer Spalte der obersten Ebene.

Klaviyo führt Best-Effort-Typanalysen für Ereigniseigenschaften durch und stellt keine feldspezifische Transformationslogik als Teil der Einrichtung des Ereignisimports bereit.

Häufige Anwendungsfälle

Kunden verwenden den Data-Warehouse-Ereignisimport in der Regel für:

1) Offline- oder POS-Ereignisse importieren

Binde In-Store- oder Offline-Events (z. B. POS-Käufe, Retouren oder Termine) aus deinem Warehouse ein, damit sie sich wie andere Klaviyo-Events und -Metriken verhalten.

Beispiele:

Ereignisse für Käufe im Ladengeschäft mit Gesamtbestellwert, Ladenstandort und Zahlungsmitteltyp
Termine abgeschlossen – Ereignisse mit Mitarbeiter, Servicetyp und Dauer

2) Service- und Support-Interaktionen

Synchronisiere Support- und Service-Ereignisse wie Ticketerstellung, Lösung oder Retouren, um deine Kundenzeitpläne zu erweitern und Nachrichten basierend auf der Service-Historie zu versenden.

Beispiele:

Support-Ticket erstellt und Support-Ticket gelöst
Bestellung mit Ursachencodes und Rückerstattungsbeträgen zurückgegeben

3) Modellierte oder abgeleitete Ereignisse

Wandle lagerortmodelliertes Verhalten in Ereignisse um, die in Klaviyo einfacher zu verwenden sind.

Beispiele:

Ereignisse mit hohem Abwanderung-Risiko, die von einem Modell in deinem Warehouse generiert werden
Lifecycle-Meilenstein erreicht – Ereignisse, wenn ein Kunde Phasen in einem benutzerdefinierten Lifecycle-Modell verschiebt

Richte eine Synchronisierung für den Data-Warehouse-Ereignis-Import ein.

1) Verbinde dein Data Warehouse

Wenn du dein Warehouse noch nicht verbunden hast:

Gehe in Klaviyo zu Advanced KDP > Datenverwaltung > Synchronisierung.
Klicke auf Data Warehouse hinzufügen und wähle deinen Warehouse-Konnektor aus.
Führe die Verbindungsschritte für deine Plattform entsprechend der jeweiligen Verbindungsanleitung durch, die im Artikel zur Data-Warehouse-Import-Übersicht verlinkt ist.

Klaviyo unterstützt eine aktive Data-Warehouse-Verbindung pro Konto.

2) Neue Synchronisierung für Ereignisimport erstellen

Sobald dein Warehouse verbunden ist:

Wähle unter Advanced KDP > Datenverwaltung > Synchronisierung deine Warehouse-Verbindung aus.
Wähle Daten importieren (wenn du zum ersten Mal Importe konfigurierst) oder klicke auf Synchronisierung erstellen / Synchronisierung hinzufügen für eine bestehende Verbindung.
Wenn du zur Eingabe des Datentyps aufgefordert wirst, wähle Ereignisse (anstelle von Profilen).
Wähle die Tabelle oder Ansicht in deinem Warehouse, die die Ereignisse enthält, die du importieren möchtest.

3) Pflichtfelder zuordnen

Als Nächstes ordnest du die Spalten aus deiner Warehouse-Tabelle den erforderlichen Ereignisfeldern von Klaviyo zu.

Für die Konfiguration des Ereignishimports musst du Zuordnungen bereitstellen für:

Ereigniszeitstempel
Metrikname (entweder eine Konstante, die du in der Konfiguration auswählst, oder eine Spalte, die den Metriknamen pro Zeile enthält)
Profilkennung (mindestens eine)
Zeitstempel der Änderungserkennung

Du kannst auch empfohlene Felder zuordnen:

Eindeutige ID
Eintrag
Wert: Währung

Alle verbleibenden Spalten, die du diesen Kernfeldern nicht explizit zuordnest, werden automatisch zu Ereigniseigenschaften.

Die Konfigurations-UI verhindert, dass du mehrere Spalten demselben Feld auf oberster Ebene zuordnen kannst, und überprüft, ob alle erforderlichen Felder vorhanden sind, bevor du speichern kannst.

4) Wähle die Synchronisierungsfrequenz und den historischen Umfang aus.

Wenn du deinen Ereignis-Import speicherst:

Klaviyo plant wiederkehrende Synchronisierungen so, dass sie in regelmäßigen Abständen (in der Regel stündlich) ausgeführt werden.
Bei jedem Durchlauf werden nur Zeilen verarbeitet, deren Zeitstempel der Änderungserkennung neuer ist als der letzte erfolgreiche Durchlauf. So wird sichergestellt, dass die Importe inkrementell erfolgen.

Für historische Nachfüllungen kannst du entweder:

Richte deinen Ereignisimport auf eine Tabelle oder Ansicht, die bereits alle relevanten historischen Ereignisse enthält, oder
Beginne mit einer dedizierten historischen Tabelle und wechsle später zu einer Ansicht mit Änderungsdatenerfassung, um fortlaufende Updates zu erhalten.

So verhalten sich importierte Ereignisse in Klaviyo

Einmal importiert:

Jede Zeile wird als Ereignis einer benutzerdefinierten API-Metrik in Klaviyo angezeigt.
Der Metrikname, den du zugeordnet (oder als Konstante konfiguriert) hast, bestimmt den Namen des Ereignistyps, den du im Produkt siehst (z. B. Bestellung aufgegeben).
Alle Profilkennungen werden nach Möglichkeit in bestehende Profile aufgelöst. Andernfalls erstellt Klaviyo neue Profile anhand der angegebenen Kennungsfelder, ähnlich wie bei anderen Ereignisaufnahmepfaden.

Mit diesen Ereignissen kannst du:

Erstelle Segmente basierend auf dem, was jemand getan hat, und filtere nach Ereigniseigenschaften.
Flows auslösen und filtern
Analysiere das Verhalten in Metriken und Reporting zusammen mit Ereignissen aus anderen Quellen.

Einschränkungen und Best Practices

Beachte beim Importieren von Data-Warehouse-Ereignissen Folgendes:

Der Fokus von V1 des Ereignisimports liegt nur auf Ereignisdaten. Von Ereignissen abgeleitete Aktualisierungen von Profileigenschaften können in einer späteren Iteration hinzugefügt werden. Im Moment sollten Profileigenschaften über Profilimport oder andere unterstützte Pfade aktualisiert werden.
Der Zeitstempel der Änderungserkennung muss sich vom Ereigniszeitstempel unterscheiden. Wenn du für beide die gleiche Spalte verwendest, kannst du verhindern, dass historische Ereignisse nach deiner ersten Synchronisierung sicher importiert werden.
Um eine optimale Geschwindigkeit zu erzielen, setze das Feld zur Änderungserkennung auf den Zeitstempel der Erstellung der neuen Tabelle. Datensätze werden in Synchronisierungszyklen mit diesem Wert gebündelt, sodass die Zeit zum Importieren historischer Datensätze verkürzt werden kann, wenn alle historischen Datensätze einen Änderungserkennungs-Zeitstempel in einem engen Bereich haben (z. B. den Zeitstempel eines Auftrags, der die neue Tabelle erstellt).
Wenn möglich, verwendest du eine stabile eindeutige ID pro Ereignis, um die Deduplizierung zu verbessern und das Downstream-Debuggen zu vereinfachen.
Wenn deine Tabelle mehrere Ereignistypen (Metriken) mit unterschiedlichen Spaltensätzen enthält, ist es im Allgemeinen in Ordnung, sie zusammenzuhalten: Spalten, die für bestimmte Zeilen NULL sind, werden für diese Ereignisse in Klaviyo einfach ignoriert.
Für komplexe verschachtelte Objekte (z. B. Zeilenelementarrays) empfehlen wir, sie nach Möglichkeit in mehrere Spalten zu reduzieren, insbesondere für Eigenschaften, die du voraussichtlich in Segmentierung oder Flows verwenden wirst.

„