Du wirst lernen
Erfahre, wie du Daten von Klaviyo mit deinem Data Warehouse synchronisierst und Warehouse-Daten über SFTP auf Klaviyo importierst. Du kannst dein Kunden-Profiling und deine Ereignisdaten synchronisieren, so dass du wichtige Informationen über deine Kunden auch außerhalb von Klaviyo laden und analysieren kannst.
Klaviyo Die Kundendatenplattform ist nicht in der Standard-Marketinganwendung von Klaviyoenthalten. Um auf die damit verbundenen Funktionen zugreifen zu können, ist ein Abonnement der Kundendatenplattform erforderlich. In unserem Leitfaden zur Abrechnung erfährst du mehr darüber, wie du diese Funktion zu deinem Abonnement hinzufügen kannst, oder du kannst gleich loslegen, wenn du ein neuer Kunde bist.
Bevor du beginnst
Du musst sicherstellen, dass das Data Warehouse, mit dem du dich verbinden willst, als Ziel konfiguriert ist. Um sicherzugehen, dass du die Einstellungen richtig vorgenommen hast:
- Vergewissere dich, dass der Benutzer, der Klaviyo zur Verfügung gestellt wird, die richtigen Berechtigungen hat
- Vergewissere dich, dass du die Tabellen je nach Lager mit den entsprechenden Namen versiehst (siehe unten).
Stelle außerdem sicher, dass du die IP-Adressen des ausgehenden Data Warehouse-Verkehrs auf die Whitelist Klaviyo setzt. So wird sichergestellt, dass die Anfragen von Klaviyo nicht von deiner Sicherheitsschicht blockiert werden. Diese Adressen werden durch die folgenden CIDR-Bereiche repräsentiert:
184.72.183.187/32
52.206.71.52/32
3.227.146.32/32
44.198.39.11/32
35.172.58.121/32
3.228.37.244/32
54.88.219.8/32
3.214.211.176/32
Verbindung zu einem Data Warehouse
Um eine Data Warehouse-Verbindung zu Klaviyo hinzuzufügen, navigiere zu Datenmanagement > Synchronisierung.
- Um ein Data Warehouse hinzuzufügen, klicke auf die Schaltfläche Neue Verbindung .
- Im Modal " Ziel auswählen" wählst du ein unterstütztes Data Warehouse aus, um es mit Klaviyo zu verbinden.
Du kannst nur 1 Data Warehouse-Ziel pro Konto haben.
Alternativ kannst du dein Data Warehouse auch aus dem Klaviyo-Integrationsverzeichnis auswählen, indem du auf Konto > Integration gehst.
Wenn du ein Warehouse anbindest, kannst du entweder Daten aus deinem Data Warehouse in Klaviyo importieren oder ein Warehouse als Ziel für eine ausgehende Synchronisierung festlegen.
Daten über SFTP importierenDaten über SFTP importieren
Wenn du Daten aus deinem Data Warehouse in Klaviyo importieren möchtest, kannst du dies über SFTP tun.
Um deine Daten in zu importieren,Klaviyo wähle beim ersten Verbinden eines Lagerziels die Option Daten importieren oder klicke auf der Seite Datenabgleich auf die Schaltfläche Importieren , wenn du bereits eine Verbindung hergestellt hast.
Der Prozess zum Importieren von Lagerdaten in Klaviyo läuft folgendermaßen ab:
- Exportiere die gewünschten Daten aus deinem Data Warehouse.
- Erstelle SSH-Schlüssel auf deinem lokalen Rechner.
- SFTP-Client konfigurieren und importieren.
Dies wird mit Snowflake demonstriert, aber der Importprozess ist unabhängig von deiner Warehouse-Integration ähnlich.
Exportiere deine Datenbank
Zuerst musst du deine Daten aus deinem Lager exportieren. Logge dich in dein Lagerhaus ein und exportiere die Daten, die du in Klaviyo importieren möchtest, in eine CSV-Datei.
Formatiere deine exportierten Daten entsprechend dem CSV-Format und den Größenbeschränkungen.
Erstelle SSH-Schlüssel auf deinem lokalen Rechner
Sobald du die gewünschten Daten aus deinem Lager exportiert hast, generierst du einen neuen SSH-Schlüssel auf deinem lokalen Rechner und fügst ihn zu Klaviyo hinzu, indem du auf die Schaltfläche SSH-Schlüssel hinzufügen klickst.
Wenn du deinen Schlüssel hinzufügst, achte darauf, dass er mit einem der folgenden Zeichen beginnt:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-ssh
SFTP-Client konfigurieren und importieren
Sobald dein SSH-Schlüssel erfolgreich zu Klaviyo hinzugefügt wurde, musst du deinen SFTP-Client konfigurieren und die Daten importieren.
- Öffne deinen SFTP-Client und konfiguriere eine neue Verbindung mit den in Klaviyo angegebenen Anmeldeinformationen. Nach dem erfolgreichen Hinzufügen deines SSH-Schlüssels werden dir die Anmeldedaten angezeigt.
- Sobald du authentifiziert bist, stelle sicher, dass deine Datenbank den empfohlenen Richtlinien entspricht, bevor du sie importierst.
- Lade deine Datenbankdatei über deinen SFTP-Client hoch und überprüfe sie.
Du siehst auch eine Listenansicht deiner letzten Importe mit den folgenden Informationen:
-
Status
Abgeschlossen oder unvollständig. -
Verarbeitete Zeilen
Prozentsatz aller bisher verarbeiteten Zeilen. -
Datum importieren
Datum des Importierens. -
Importiert von
Benutzer, der die Daten importiert hat.
Exportiere Daten in dein Lagerhaus
Um dein Data Warehouse als Ziel zu konfigurieren, benötigst du die folgenden Informationen und Anmeldedaten für jedes Data Warehouse.
Amazon Redshift
Um Amazon Redshift als Ziel zu konfigurieren, führe das folgende Skript aus, um die Tabellen klaviyo_event und Profil zu erstellen.
Sobald du dein Lager als Ziel konfiguriert hast, verbindest du dein Lager mit Klaviyo, indem du die folgenden Anmeldedaten verwendest:
- Name: Der Name deiner Datenbank in Redshift (es wird empfohlen, denselben Namen zu verwenden wie deine Datenbank in Redshift)
- Host-URL: Der Endpunkt des Amazon Redshift-Servers (in Redshift Verbindungs-URL genannt)
- Datenbank: Der Name, der deine Datenquelle identifiziert
- Port: Die von Redshift verwendete Portnummer
- Schema: Dein Datenbankschema
- Benutzername: Der Benutzername, mit dem du dich bei Redshift anmeldest
-
Datenbankpasswort: Das Passwort, das für die Anmeldung bei Redshift verwendet wird
Amazon S3
Um Amazon S3 als Ziel zu konfigurieren, setze die Tabellennamen auf Profil und klaviyo_event.
Sobald du dein Lager als Ziel konfiguriert hast, verbindest du dein Lager mit Klaviyo, indem du die folgenden Anmeldedaten verwendest:
- Name: Der maschinenlesbare Name für die Amazon S3-Datenbank.
- Eimer: Der Name deines Eimers.
- Standort des Buckets: Der Name der Region, die bei der Erstellung des Speicherbereichs ausgewählt wurde.
- Zugangsschlüssel-ID: Deine AWS-Zugangsschlüssel-ID.
-
Geheimer Zugangsschlüssel: Dein geheimer AWS-Zugangsschlüssel.
Google BigQuery
Um Google BigQuery als Ziel zu konfigurieren, führe das folgende Skript aus, um die Tabellen Profil und klaviyo_event zu setzen. Dein Google BigQuery-Konto muss ein Zahlungsprofil haben, damit der Verbindungsprozess erfolgreich ist.
Beachte, dass du in diesem Skript den Platzhalter "SERVICE ACCOUNT E-Mail" durch deine BigQuery Service Account E-Mail ersetzen musst.
Sobald du dein Lager als Ziel konfiguriert hast, verbindest du dein Lager mit Klaviyo, indem du die folgenden Anmeldedaten verwendest:
- Name: Ein Name, der dir hilft, das Ziel zu identifizieren
- Projekt-ID: Diese wird als Projekt-ID bezeichnet und kann in deiner API-Konsole gefunden werden.
- Dataset: Auch bekannt als Schema. Dies ist derselbe Name, den du in dem Skript verwendet hast, das du für die Einrichtung hättest ausführen müssen.
-
Servicekonto-Schlüssel: Füge den gesamten Inhalt der JSON-Datei ein, die du beim Erstellen deines Servicekontos in BigQuery heruntergeladen hast.
Microsoft Azure Synapse Analytics
Um Microsoft Azure als Ziel zu konfigurieren, führe das folgende Skript aus, um die Tabellen Profil und klaviyo_event zu erstellen.
- Name: Es wird empfohlen, denselben Namen zu verwenden wie deine Datenbank in Azure.
- Arbeitsbereich: Der Name des Azure Synapse-Arbeitsbereichs.
- Datenbankname: Dies identifiziert deine Dedicated SQL Pool Datenbank.
- Benutzername: Dein Login-Benutzername für deine Dedicated SQL Pool-Datenbank.
- Datenbankpasswort:Dein Anmeldepasswort für deine Dedicated SQL Pool-Datenbank.
- Kontoname: Dein Windows Azure-Speicherkonto oder das von dir erstellte DNS-Präfix.
- Zugriffssignatur: Deine gemeinsame Zugriffssignatur (SAS), die den Zugriff auf den Blob Storage Container nachweist.
-
Containername: Der Name des Azure Blob-Containers für den temporären Staging-Bereich für die Datenübertragung.
Schneeflocke
Um Snowflake als Ziel zu konfigurieren, führe das folgende Skript aus, um die Tabellen Profil und KLAVIYO_EVENT zu setzen. Du musst über securityadmin- und sysadmin-Berechtigungenverfügen, um die folgenden Einstellungen vornehmen zu können. Um zu überprüfen, welche Rolle(n) du hast, führe SHOW GRANTS TO USER <your_username> aus und stelle sicher, dass beide Rollen aufgelistet sind. Wende dich an einen Systemadministrator, wenn du deine Rolle anpassen lassen willst.
Sobald du dein Lager als Ziel konfiguriert hast, verbindest du dein Lager mit Klaviyo, indem du die folgenden Anmeldedaten verwendest:
- Name: Es wird empfohlen, denselben Namen zu verwenden wie deine Datenbank in Snowflake.
-
Benutzername: Benutzername für die Verbindung zu deiner Datenbank.
-
Passwort: Passwort für die Verbindung zu deiner Datenbank.
- Lagerhaus: Dein Lagerhaus in Snowflake.
- Konto: Dein Konto in Snowflake.
- Datenbank: Der Name deiner Datenbank.
- Schema: Dein Datenbankschema.
Nachdem du deine Anmeldedaten für das Data Warehouse, mit dem du synchronisieren möchtest, eingegeben hast, wählst du die Daten aus, die du mit Klaviyo synchronisieren möchtest.
DatenobjekteDatenobjekte
Im Abschnitt Datenobjekte kannst du wählen, ob du alle Profildaten, nur bestimmte Ereignisdaten oder beide Arten von Daten synchronisieren möchtest, indem du das/die entsprechende(n) Kästchen neben jeder Option markierst.
Klaviyo verwendet eine verschachtelte JSON-Struktur, wenn es Daten an dein Data Warehouse sendet. Profil und Ereignisse werden jeweils als eine einzige Tabelle gesendet, so dass du eine Tabelle abfragen kannst, anstatt eine große Anzahl von möglichen Tabellennamen in deinem Data Warehouse.
Wenn du alle Daten von Klaviyo synchronisierst, können dir zusätzliche Kosten für dein Data Warehouse entstehen.
Auszuschließende Integrationen
Im Feld Auszuschließende Integrationen kannst du die Integration(en) auswählen, die du bei der Data Warehouse-Synchronisierung ausschließen möchtest. Dies ist hilfreich, wenn du die Daten einer bestimmten Integration, die du bereits mit Klaviyo verbunden hast, nicht synchronisieren möchtest.
Der Ausschluss bestimmter Integrationsdaten gilt nur für Ereignisdaten und schließt keine Profildaten aus.
Selektive Synchronisation
Im Feld " Selektive Synchronisierung" wählst du die spezifischen Ereignisse aus, die du mit deinem Data Warehouse von Klaviyo synchronisieren möchtest. Standardmäßig werden alle Ereignisse einbezogen. Wenn du bestimmte Ereignisse für die Synchronisierung mit diesem Feld festlegst, werden nur die ausgewählten Ereignisse synchronisiert.
Dieses Feld wird nur angezeigt, wenn du das Datenobjekt Ereignisse auswählst.
Wähle aus, wie oft deine Daten synchronisiert werden sollen
Der Wert für das Feld Periodic sync cadence im Abschnitt Select how often your data will sync legt fest, wie oft eine Synchronisierung zwischen Klaviyo und deinem Data Warehouse stattfinden soll.
Die periodische Synchronisierung ist standardmäßig auf stündlich eingestellt und kann nicht geändert werden.
Wähle aus, wie viele historische Daten du synchronisieren möchtest
Im Abschnitt Wählen Sie aus, wie viele historische Daten Sie synchronisieren möchten , können Sie festlegen, wie viele historische Daten Sie während der ersten Verbindung von Klaviyo mit Ihrem Data Warehouse synchronisieren möchten. Du kannst wählen:
- 30 Tage
- 90 Tage
- 1 Jahr
- Alle Zeit
Wenn du eine große Menge an Daten auf einmal synchronisierst, können dir zusätzliche Kosten für dein Data Warehouse entstehen.
Sync-Überprüfung
Wenn du deine Integration verbunden hast und die Einrichtung erfolgreich war, siehst du einen Abschlussbildschirm, der anzeigt, dass die Verbindung aktiviert ist:
- Details zu der von dir eingerichteten Synchronisierung.
- Welche Daten werden geteilt (Profil, Ereignisse oder beides).
- Alle ausgeschlossenen Integrationen.
Wenn deine Synchronisierung nicht erfolgreich war, siehst du stattdessen den Status "Verbindung nicht möglich" und die Möglichkeit, die Verbindung erneut zu versuchen oder die Informationen in deinen Anmeldedaten zu bearbeiten.
Wenn du dein Data Warehouse erfolgreich verbunden hast, gelangst du zurück zur Hauptseite der Datenabgleichsliste. Hier siehst du deine:
- Ziel Lagerhaus
- Der Status Aktiviert
- Alle möglichen Fehler, die in den letzten 24 Stunden bei deiner Synchronisierung aufgetreten sind.
- Die letzte Synchronisierung, die zusammen mit einem Zeitstempel dieses Ereignisses aufgetreten ist.
Da du immer nur ein Ziel verbinden kannst, siehst du auch nur ein Ziel in dieser Listenansicht.
Dashboard für die DatensynchronisierungDashboard für die Datensynchronisierung
Sobald die Verbindung erfolgreich hergestellt wurde, klickst du auf der Seite " Datenabgleichsliste " auf deine Integration. Von hier aus gelangst du zum Dashboard für den Datenabgleich, das dir historische und aktuelle Informationen über die durchgeführten Datenabgleiche liefert.
Hier siehst du die Synchronisierungsinformationen, die in 2 Registerkarten aufgeteilt sind:
- Historisch
- Regelmäßig
Historisch
Auf der Registerkarte Historisch findest du Protokolle, die den Status deiner historischen Datensynchronisationen anzeigen. Historische Synchronisierungen beziehen sich auf die Synchronisierung deiner bestehenden Daten von Klaviyo mit deinem Data Warehouse, wenn du eine Verbindung herstellst.
Du siehst die folgenden Informationen für jede Synchronisierung:
-
Name
Die Daten werden in die Synchronisierung einbezogen. -
Status
Status und möglicher Fortschritt der Synchronisierung mit einem geschätzten Prozentsatz oder möglichen Fehlern. Diese Status können sein:
-
Abgeschlossen
Die Synchronisierung deiner Daten für diese einmalige Synchronisierung wurde abgeschlossen. Es wird nicht automatisch wieder synchronisiert. -
Geplant
Wann die nächste Synchronisierung automatisch durchgeführt werden soll. -
In Bearbeitung
Die Daten werden aktiv mit deinem Data Warehouse synchronisiert, mit einem geschätzten Prozentsatz der Fertigstellung. -
Fehlerhaft
Es ist ein Fehler aufgetreten, aber Klaviyo wird weiterhin versuchen, die Verbindung wiederherzustellen. Je nach Integration kann dieser Zeitpunkt leicht abweichen. -
Fehlgeschlagen
Die Synchronisierung ist komplett fehlgeschlagen, auch nachdem du versucht hast, die Verbindung wiederherzustellen. Das bedeutet, dass du deine Konfigurationseinstellungen oder sogar die Einrichtung des Data Warehouse überprüfen musst. -
Pausiert
Du hast die Synchronisierung manuell pausiert. -
Deaktiviert
Die Synchronisierung wurde deaktiviert, weil die Integration selbst deaktiviert oder entfernt wurde.
-
Abgeschlossen
-
Gestartet am
Startzeitpunkt der Synchronisation. -
Beendet auf
Endzeit der Synchronisation.
Regelmäßig
Auf der Registerkarte Regelmäßig findest du Protokolle, die den Status deiner regelmäßigen Synchronisierungen anzeigen. Wenn die Kunden weiterhin mit deiner Marke interagieren und neue Daten erstellt werden, werden diese routinemäßig an dein Data Warehouse gesendet. Wenn du eine Data Warehouse-Verbindung einrichtest, werden regelmäßige Synchronisierungen jede Stunde durchgeführt.
Du siehst die folgenden Informationen für jede Synchronisierung:
-
Name
Die Daten werden in die Synchronisierung einbezogen. -
Status
Status und möglicher Fortschritt der Synchronisierung mit einem geschätzten Prozentsatz oder möglichen Fehlern. Diese Status können sein:
-
Abgeschlossen
Die Synchronisierung deiner Daten für diese einmalige Synchronisierung wurde abgeschlossen. Es wird nicht automatisch wieder synchronisiert. -
Geplant
Wann die nächste Synchronisierung automatisch durchgeführt werden soll. -
In Bearbeitung
Die Daten werden aktiv mit deinem Data Warehouse synchronisiert, mit einem geschätzten Prozentsatz der Fertigstellung. -
Fehlerhaft
Es ist ein Fehler aufgetreten, aber Klaviyo wird weiterhin versuchen, die Verbindung wiederherzustellen. Je nach Integration kann dieser Zeitpunkt leicht abweichen. -
Fehlgeschlagen
Die Synchronisierung ist komplett fehlgeschlagen, auch nachdem du versucht hast, die Verbindung wiederherzustellen. Das bedeutet, dass du deine Konfigurationseinstellungen oder sogar die Einrichtung des Data Warehouse überprüfen musst. -
Pausiert
Du hast die Synchronisierung manuell pausiert. -
Deaktiviert
Die Synchronisierung wurde deaktiviert, weil die Integration selbst deaktiviert oder entfernt wurde.
-
Abgeschlossen
-
Datenfrische
Die Datenfrische bezieht sich darauf, wie aktuell deine Daten sind. Wenn eine Synchronisierung zum Beispiel einen Freshness-Wert von 2 Minuten hat, bedeutet das, dass alle neuen Daten, die in den letzten 2 Minuten in Klaviyo erstellt wurden, noch nicht in deinem Data Warehouse sind. - Schaltflächen zum Anhalten, Fortsetzen und erneuten Aktivieren einzelner Synchronisierungen.
Entfernen von Data Warehouse-Verbindungen
Um eine Data Warehouse-Verbindung aus deinem Klaviyo-Konto zu löschen, navigierst du in Klaviyo über das Kontomenü unten links zur Seite Integrationen .
Öffne auf der Seite Integrationen das Menü neben deiner Data Warehouse-Integration und wähle Integration entfernen, um die Verbindung zu entfernen.
Fehlerprotokolle anzeigenFehlerprotokolle anzeigen
Wenn Sie Probleme mit der Datensynchronisierung zwischen Klaviyo und Ihrem Data Warehouse haben, kann die Anzeige der zugehörigen Fehlerprotokolle zusätzliche Informationen über die Ursache des Problems liefern.
Um Fehler anzuzeigen, klicken Sie auf der Seite Synchronisierung auf Ihr Lagerziel. Sowohl auf der Registerkarte Historische als auch auf der Registerkarte Periodische Synchronisierung sehen Sie eine Liste der Exporte und deren Status sowie einen Indikator, der anzeigt, ob es aktive Fehler gibt.
Um weitere Details zu einem bestimmten Fehler anzuzeigen, klicken Sie auf den Export, bei dem der Fehler aufgetreten ist.
Hier sehen Sie eine Zeitleiste der ausgehenden Synchronisierungen, zusammen mit einer Fehler- oder Erfolgsmeldung je nach Status der Synchronisierung.
Wenn Sie auf einen bestimmten Fehler klicken, wird eine Schublade mit den folgenden Informationen geöffnet:
-
Zusammenfassung
Eine kurze Beschreibung des vom Data Warehouse zurückgegebenen Fehlers. -
Code
Der Fehlercode für den Fehler. -
Externe Meldung
Die eigentliche Fehlermeldung, die vom Data Warehouse zurückgegeben wird. -
Datum
Das Datum und die Uhrzeit des Fehlers.
Zusätzliche Ressourcen
Verstehen, wie Informationen zwischen Klaviyo und Apps ausgetauscht werden
Verstehen der Arten von Informationen, die zwischen Klaviyo und Apps ausgetauscht werden