Grundlegendes zum Data-Warehouse-Import in Klaviyo

Einleitung

Der Data-Warehouse-Import ermöglicht es Klaviyo, sich direkt mit deinem Snowflake-, BigQuery-, Redshift- oder Databricks-Data Warehouse zu verbinden und Importsynchronisierungen für Tabellen (oder Views) mit Profil- und Ereignisdaten zu konfigurieren.

Wie funktioniert der Data-Warehouse-Import in Klaviyo?

Nachdem du eine Verbindung zu deinem Warehouse hergestellt hast, kannst du einen Datensatz (z. B. eine Tabelle oder eine Ansicht) auswählen, um ihn zu synchronisieren.

Deine Tabelle oder Ansicht muss eine Zeitstempelspalte enthalten, die erfasst, wann jede Zeile hinzugefügt oder aktualisiert wurde, z. B. updated_at oder modified_at. Wähle diese Spalte unter Änderungserkennung aus, wenn du die Synchronisierung konfigurierst. Aktualisiere seinen Wert jedes Mal, wenn sich eine Zeile ändert, und verschiebe ihn nicht rückwärts auf einen früheren Zeitpunkt.

Füge für eine Profilsynchronisierung mindestens 1 Profilkennung hinzu, zum Beispiel eine E-Mail-Adresse, Telefonnummer oder externe ID. Ordne deine Datenspalten den Profileigenschaften zu, die du aktualisieren möchtest, einschließlich benutzerdefinierter Eigenschaften.

Ordne für eine Ereignissynchronisierung einen Ereigniszeitstempel und mindestens 1 Profil-Identifikator zu. Wähle einen einzelnen Ereignistyp für die Synchronisierung aus oder ordne eine Spalte zu, die für jede Zeile einen Ereignistyp enthält. Verwende eine separate Spalte für die Änderungserkennung, damit historische Ereignisdaten nicht bestimmen, wann Zeilen für den Import erfasst werden.

Geplante Synchronisierungen importieren vorhandene Daten und importieren weiterhin neue oder aktualisierte Zeilen in dem von dir gewählten Intervall (z. B. stündlich oder täglich). Dabei verwenden sie den Zeitstempel der Änderungserkennung, um Änderungen zu identifizieren. Profil-Synchronisierungen erstellen oder aktualisieren Profile; Ereignis-Synchronisierungen fügen Ereignisse hinzu.

Du kannst auch eine manuelle Synchronisierung auswählen, die ausgeführt wird, wenn du Synchronisierung ausführen auswählst.

Wenn du keinen vollständig zusammengeführten Datensatz mit allen Feldern hast, die du synchronisieren möchtest, kannst du mehrere Synchronisierungen mit unterschiedlichen Feldzuordnungen erstellen (z. B. Kontaktinformationen, Treueguthaben und benutzerdefinierte Segmente).

Wenn du mehrere Profil-Synchronisierungen verwendest, nutze konsistente Kennungen in deinen Tabellen, damit Zeilen demselben Profil zugeordnet werden können. Jede Profileigenschaft, die keine Kennung ist, kann nur aus 1 Quelle zugeordnet werden; Kennungen können über mehrere Quellen hinweg wiederverwendet werden.

Einwilligungen für E-Mail und Textnachrichten verwenden dieselben gültigen Werte und Formate wie Datei- oder SFTP-Uploads. Anleitungen zu Einwilligungsfeldern und Formatierung findest du unter So importierst du Abonnent*innen in eine Liste.

Häufige Anwendungsfälle

Profilverwaltung

• Erstelle neue Profile in Klaviyo, die aus Systemen stammen, die nicht direkt in Klaviyo integriert sind (z. B. POS-, Reservierungs- oder Auftragsverwaltungssysteme).
• Aktualisiere Profilinfos in Klaviyo aus Offline-Quellen, die im Warehouse verfügbar sind.

Ergänzung von Profilinformationen

• Synchronisiere Guthaben aus dem Treueprogramm mit einer benutzerdefinierten Eigenschaft „Loyalty_Balance“.
• Synchronisiere Scores oder Kategorien aus benutzerdefinierten Modellen, die im Warehouse ausgeführt werden (z. B. Intent-Scores für maßgeschneiderte Lifecycle-Ereignisse, Affinitätskategorien, Abwanderungsrisiko oder LTV-Metriken).
• Synchronisiere demografische oder verhaltensbezogene Anreicherungsdaten von Drittanbietern mit benutzerdefinierten Profileigenschaften.
• Synchronisiere Support- oder Service-Touchpoints in benutzerdefinierte Profilfelder, um darzustellen, ob Kund*innen offene Serviceanfragen haben, wie viele Tage seit dem letzten Servicebesuch vergangen sind oder welche die aktuellste Kategorie der Support-Interaktion ist.

Individuelle Segmentierung

• Führe eine komplexe Segmentierung im Warehouse durch und synchronisiere die Segmentnamen mit benutzerdefinierten Profileigenschaften, um sie als Kriterien in Segmenten oder Flows zu verwenden.
• Segmentierung im Data Warehouse auf Basis sensibler, vertraulicher oder regulierter Daten durchführen und Segmentgruppenzuweisungen oder Profil-Flags mit bereinigten Namen (z. B. Gruppe A, Gruppe B) als benutzerdefinierte Profileigenschaften synchronisieren.

Anleitung zur Einrichtung

Herstellen einer Verbindung

Diese Artikel bieten Schritt-für-Schritt-Anleitungen zum Einrichten des Data-Warehouse-Imports.

Klaviyo und Snowflake verbinden

Klaviyo und BigQuery verbinden

Klaviyo und Redshift verbinden

Klaviyo und Databricks verbinden

Erstelle eine Profilimport-Synchronisierung

Nachdem du dein Lager vorbereitet und die Verbindung validiert hast, erstelle in Klaviyo eine Profilimport-Synchronisierung:

1. Gehe zu Erweitert > Datenmanagement > Synchronisierung und wähle dann deine Warehouse-Verbindung aus.
2. Klicke auf Quelle hinzufügen. Gib im Feld Name einen eindeutigen Sync-Namen ein und wähle unter Datenquelle deine Tabelle oder Ansicht aus.
3. Wähle Profile unter Datenobjekttypen aus.
4. Wähle unter Kadenz die Option Geplante Ausführung aus und lege Intervall, Startdatum, Startzeit und Zeitzone fest. Wähle Manuell, wenn du jeden Durchlauf selbst starten möchtest.
5. Klicke auf Weiter. Wähle unter Änderungserkennung in Erkennung neuer Zeilen deine Zeitstempelspalte aus. Ordne mindestens 1 Profilkennung und die anderen Profileigenschaften zu, die du importieren möchtest.
6. Klicke auf Fertig, um die Synchronisierung zu speichern.

Wenn du Manuell gewählt hast, öffne die gespeicherte Synchronisierung und wähle Synchronisierung ausführen aus, um den Import zu starten.

Ereignisdaten importieren

Weitere Informationen zu ereignisspezifischen Feldern und Einrichtungsanweisungen findest du unter Data-Warehouse-Ereignisimport in Klaviyo verstehen.

Fehlerbehebung bei Synchronisierungen

Wenn eine Synchronisierung nicht die Daten importiert, die du erwartest, prüfe vor dem Testen deiner Profildaten per CSV-Upload den Status und die Fehlerdetails.

1. Gehe zu Advanced > Data management > Syncing, wähle deine Warehouse-Verbindung aus und klicke dann auf den Sync-Namen.
2. Überprüfe auf dem Tab Ausführungen die Zählwerte für Erfasst und Fehlgeschlagen. Ein Status Abgeschlossen kann trotzdem fehlgeschlagene Zeilen enthalten.
3. Öffne bei einem abgeschlossenen Durchlauf mit fehlgeschlagenen Zeilen das Menü des Durchlaufs und wähle Fehlerdatei herunterladen aus, wenn die Option verfügbar ist.
4. Öffne den Tab Protokolle und prüfe periodische oder historische Protokolle, um Details zur betroffenen Synchronisierung zu erhalten.

Profildaten mit einem CSV-Import validieren

Ein CSV-Import kann dabei helfen, Formatierungsprobleme bei Profildaten zu erkennen, insbesondere bei Einwilligungswerten und Zeitstempeln. Er testet nicht deine Warehouse-Verbindung oder die Konfiguration der Änderungserkennung der Synchronisierung. Das vollständige Upload-Verfahren findest du unter So importierst du Abonnent*innen in eine Liste.

Verwende eine separate Testliste ohne listengetriggerte Flows. Der Import erstellt oder aktualisiert weiterhin Profile in deinem Konto und wendet alle Einwilligungswerte an, die du aus der Datei zuordnest.

1. Exportiere deine Profil-Tabelle oder -Ansicht in eine CSV-Datei.
2. Gehe in Klaviyo auf Zielgruppe > Listen und Segmente.
3. Wähle eine separate Testliste aus oder erstelle eine neue Liste zum Testen.
4. Wähle im Menü Liste verwalten oben rechts Kontakte importieren aus.
5. Lade die CSV-Datei aus Schritt 1 hoch.
6. Ordne die Spalten, die du testen möchtest, denselben Klaviyo-Profileigenschaften und Datentypen zu, die von deiner Warehouse-Synchronisierung verwendet werden.
7. Wenn du nach dem Zuordnen Weiter siehst, klicke darauf und wähle dann im Bildschirm zur Einwilligungsbestätigung Nein aus, um zu vermeiden, dass du eine Massen-Einwilligung hinzufügst. Einwilligungswerte, die aus der Datei zugeordnet wurden, gelten weiterhin.
8. Klicke auf Importieren. Wenn die Verarbeitung abgeschlossen ist, überprüfe die Importdetails und wähle Fehlerdatei herunterladen, falls verfügbar, um übersprungene Zeilen und ihre Fehler zu sehen.

Korrigiere alle Fehler in deinen Warehouse-Daten und setze die Änderungs-Erkennungszeitstempel der betroffenen Zeilen nach vorn, um widerzuspiegeln, wann du sie korrigiert hast, damit eine spätere inkrementelle Synchronisierung sie importieren kann.