Grundlegendes zur Data-Warehouse-Synchronisierung in Klaviyo

Übersicht

Erfahre, wie du Daten von Klaviyo mit deinem Data Warehouse synchronisieren und Data-Warehouse-Daten via SFTP in Klaviyo importieren kannst. Du kannst deine Profildaten und Ereignisdaten deiner Kund*innen synchronisieren. So kannst du wichtige Informationen über deine Kund*innen außerhalb von Klaviyo speichern und analysieren.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Bevor du anfängst

Bevor du Daten aus Klaviyo exportierst, konfiguriere dein Data Warehouse als Ziel:

• Stelle sicher, dass die Klaviyo bereitgestellte Nutzer*in die richtigen Berechtigungen hat.
• Erstelle für Ziele, die Tabellen verwenden, die Tabellen mit den Namen, die in den Einrichtungshinweisen unten angegeben sind.

Stelle außerdem sicher, dass du die IP-Adressen für den ausgehenden Data-Warehouse-Traffic von Klaviyo auf die Whitelist setzt. So wird sichergestellt, dass Klaviyos Anfragen nicht von deiner Sicherheitsebene blockiert werden. Diese Adressen werden durch die folgenden CIDR-Bereiche dargestellt:

• 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

Mit einem Data Warehouse verbinden

1. Gehe zu Datenverwaltung > Synchronisierung. Wenn du bereits eine Verbindung hast, klicke auf Synchronisierung erstellen.
2. Wähle Daten in dein Data Warehouse exportieren aus.
3. Wähle dein Lager aus und klicke dann auf der Einrichtungsseite auf Mit [warehouse name] verbinden.

Alternativ kannst du dein Data Warehouse über Klaviyos App-Marketplace auswählen, indem du zu Integrationen > Apps erkunden gehst und nach deiner Plattform suchst.

Die Option Daten aus deinem Data Warehouse importieren richtet einen direkten Warehouse-Import ein. Um CSV-Dateien per SFTP hochzuladen, folge dem nächsten Abschnitt.

Daten über SFTP importieren

Wenn du Daten aus deinem Data Warehouse in Klaviyo importieren möchtest, kannst du dies über SFTP tun. Informationen zu einer direkten Warehouse-Verbindung findest du unter Den Data-Warehouse-Import in Klaviyo verstehen.

Navigiere zu Integrationen, öffne Daten verwalten > SFTP-Datenübertragung und wähle dann den Tab SFTP-Einrichtung aus.

Der Prozess zum Importieren von Data-Warehouse-Daten in Klaviyo ist wie folgt:

1. Exportiere deine gewünschten Daten aus deinem Data Warehouse.
2. SSH-Schlüssel auf deinem lokalen Rechner generieren.
3. SFTP-Client konfigurieren und importieren.

Datenbank exportieren

Zunächst musst du deine Daten aus deinem Data Warehouse exportieren. Melde dich bei deinem Data Warehouse an und exportiere die Daten, die du in Klaviyo importieren möchtest, in eine CSV-Datei.

SSH-Schlüssel auf deinem lokalen Rechner generieren

Generiere ein neues SSH-Schlüsselpaar auf deinem lokalen Rechner. Bewahre den privaten Schlüssel für deinen SFTP-Client auf.

1. Klicke unter SFTP-Einrichtung auf SSH-Schlüssel hinzufügen. Gib einen Schlüsseltitel ein und füge deinen öffentlichen Schlüssel in SSH-Schlüssel ein.
2. Klicke auf Schlüssel hinzufügen.

SFTP-Client konfigurieren und importieren

Nachdem du deinen öffentlichen Schlüssel zu Klaviyo hinzugefügt hast, konfiguriere deinen SFTP-Client und lade deine CSV-Datei hoch.

1. Erstelle in deinem SFTP-Client eine Verbindung mit dem Server, Port und Benutzernamen, die unter SFTP Credentials in SFTP setup angezeigt werden. Authentifiziere dich mit dem passenden privaten Schlüssel.
2. Bevor du etwas hochlädst, stelle sicher, dass deine CSV-Datei den oben verlinkten empfohlenen Formatierungsrichtlinien entspricht.
3. Lade die CSV-Datei über deinen SFTP-Client hoch.

Um den Import zu überprüfen, öffne den Tab Datenimport in SFTP-Datenübertragung. Aktuelle Importe zeigt:

• Status
  In der Warteschlange, Wird verarbeitet, Abgeschlossen, Fehlgeschlagen oder Abgebrochen. Ein abgeschlossener Import kann weiterhin Fehler enthalten.
• Verarbeitete Zeilen
  Prozentsatz der Datei, der bisher verarbeitet wurde. Erweitere einen Import, um die Anzahl der verarbeiteten und übersprungenen Zeilen zu überprüfen.
• Importdatum
  Datum des Imports.
• Importiert von
  Nutzer*in, die*der Daten importiert hat.

Daten in dein Data Warehouse exportieren 

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, klaviyo_profile und klaviyo_metric zu erstellen.

Lass dieses Beispiel vor der Ausführung von deine*r Datenbankadministrator*in anpassen: Ersetze die Platzhalter, korrigiere das nicht zugeordnete */ nahe dem Anfang und führe die tabellenspezifischen GRANT-Anweisungen aus, nachdem du die Tabellen erstellt hast.

Sobald du es als Ziel konfiguriert hast, verbinde dein Warehouse mithilfe des folgenden Satzes von Anmeldedaten mit Klaviyo:

• Name: Ein Name, mit dem du diese Verbindung identifizieren kannst. Du kannst denselben Namen wie bei deiner Datenbank in Redshift verwenden.
• Host-URL: Der Endpunkt des Amazon-Redshift-Servers (in Redshift als Connection URL bezeichnet)
• Datenbank: Der Name der Redshift-Datenbank, mit der Klaviyo eine Verbindung herstellt
• Port: Die von Redshift verwendete Portnummer
• Schema: Dein Datenbankschema
• Benutzername: Der Benutzername, der für die Anmeldung bei Redshift verwendet wird
• Datenbankpasswort: Das Passwort, das zum Anmelden bei Redshift verwendet wird
  

Amazon S3

Um Amazon S3 als Ziel zu konfigurieren, halte deinen Bucket-Namen, deine Bucket-Region und deine AWS-Zugriffsdaten bereit.

Sobald du es als Ziel konfiguriert hast, verbinde dein Warehouse mithilfe des folgenden Satzes von Anmeldedaten mit Klaviyo:

• Name: Ein Name, um diese Verbindung zu identifizieren.
• Bucket: Der Name deines Buckets.
• Bucket-Standort: Der Name der Region, die beim Erstellen des Storage-Buckets gewählt wurde.
• Zugriffsschlüssel-ID: Deine AWS-Zugriffsschlüssel-ID.
• Geheimer Zugriffsschlüssel: Dein geheimer AWS-Zugriffsschlüssel.
  

Google BigQuery

Um Google BigQuery als Ziel zu konfigurieren, führe das folgende Skript aus, um die Tabellen klaviyo_profile, klaviyo_event und klaviyo_metric einzurichten. Dein Google BigQuery-Konto muss über ein Zahlungsprofil verfügen, damit der Verbindungsprozess erfolgreich ist.

Beachte, dass du in diesem Script den Platzhalter „SERVICE ACCOUNT EMAIL“ durch die E-Mail-Adresse deines BigQuery-Service-Kontos ersetzen musst.

Sobald du es als Ziel konfiguriert hast, verbinde dein Warehouse mithilfe des folgenden Satzes von Anmeldedaten mit Klaviyo:

• Name: Ein Name, mit dem du dieses Ziel identifizieren kannst
• Projekt-ID: Diese wird als Projekt-ID bezeichnet und kann in deiner API-Konsole gefunden werden.
• Datensatz: Auch bekannt als Schema. Dies ist derselbe Name, den du in dem Script verwendet hast, das du zum Einrichten ausführen solltest.
• Servicekontoschlü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 klaviyo_profile, klaviyo_event und klaviyo_metric zu erstellen. Lass deine*n Datenbankadministrator*in das Beispiel anpassen, bevor du es ausführst: Es beginnt mit DROP TABLE-Anweisungen, einschließlich eines doppelten DROP TABLE klaviyo_profile. Entferne die DROP TABLE-Anweisungen, wenn du neue Tabellen erstellst oder wenn du vorhandene Daten beibehalten musst.

Sobald du es als Ziel konfiguriert hast, verbinde dein Warehouse mithilfe des folgenden Satzes von Anmeldedaten mit Klaviyo:

• Name: Am besten wählst du denselben Namen wie bei deiner Datenbank in Azure.
• Workspace: Der Name des Azure-Synapse-Workspaces.
• Datenbankname: Dies identifiziert deine dedizierte SQL-Pool-Datenbank.
• Benutzername: Dein Anmelde-Benutzername für deine Dedicated SQL Pool-Datenbank.
• Datenbankpasswort: Dein Anmeldepasswort für deine dedizierte SQL-Pool-Datenbank.
• Kontoname: Dein Windows Azure-Speicherkonto oder das DNS-Präfix, das du erstellt hast.
• Zugriffssignatur: Deine Shared Access Signature (SAS)-Zeichenfolge, 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.
  

Snowflake

Um Snowflake als Ziel zu konfigurieren, führe die folgenden Schritte aus:

1. Generiere einen privaten Schlüssel, indem du den folgenden Befehl in deinem Terminal ausführst:

textCopy

openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt

2. Generiere einen öffentlichen Schlüssel, der auf den privaten Schlüssel verweist, indem du den folgenden Befehl in deinem Terminal ausführst:

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub

3. Führe das folgende Skript aus, um die Tabellen KLAVIYO_PROFILE, KLAVIYO_EVENT und KLAVIYO_METRIC einzurichten. Du musst über die Berechtigungen securityadmin und sysadmin verfügen, um die folgende Einrichtung abzuschließen. Um zu überprüfen, welche Rolle(n) du hast, führe SHOW GRANTS TO USER <your_username> aus und stelle sicher, dass beide Rollen aufgeführt sind. Wende dich an eine*n Systemadministrator*in, wenn du deine Rolle anpassen lassen musst. Bevor du das Skript ausführst, ersetze die SET_-Platzhalter durch deine Werte und GENERATE_PUBLIC_KEY durch den öffentlichen Schlüssel, den du generiert hast. Das Skript verwendet CREATE OR REPLACE TABLE, wodurch alle vorhandenen Tabellen mit diesen Namen ersetzt werden. Verwende eine neue Datenbank oder lass diese Anweisungen von deine*r Administrator*in anpassen, wenn du vorhandene Daten beibehalten musst.

Sobald du es als Ziel konfiguriert hast, verbinde dein Warehouse mithilfe des folgenden Satzes von Anmeldedaten mit Klaviyo:

• Name: Am besten wählst du denselben Namen wie bei deiner Datenbank in Snowflake.
• Benutzername: Benutzername, um eine Verbindung zu deiner Datenbank herzustellen. Dieser sollte identisch mit user_name im Einrichtungsskript sein.
  
• Privater Schlüssel: Der generierte Snowflake-Private-Key.
  
• Warehouse:  Dein Warehouse in Snowflake.
• Konto: Dein Konto in Snowflake.
• Datenbank: Der Name deiner Datenbank. Dieser sollte mit database_name im Setup-Skript identisch sein.
• Schema: Dein Datenbankschema. Dies sollte mit schema_name im Einrichtungs-Script übereinstimmen.
  

Databricks

Um Databricks als Ziel zu konfigurieren, einschließlich des Einrichtungsskripts, der erforderlichen Berechtigungen und der Anmeldeinformationen für die Verbindung, folge den Schritten in So exportierst du Klaviyo-Daten nach Databricks.

Wenn dein Verbindungsformular einen Abschnitt Blob store anzeigt, verwende ihn, um den Speicher für deinen Export zu konfigurieren. Bei Warehouse-Zielen stellt dieser Speicher die Daten bereit, bevor sie in das Warehouse geladen werden. Bei Amazon S3 ist er das Exportziel.

1. Um einen gespeicherten Store zu verwenden, wähle Eine Blob-Konfiguration verwenden aus, falls angezeigt, und wähle dann einen kompatiblen Blob-Store aus. Wenn du Eine Blob-Konfiguration verwenden nicht auswählst, fahre mit den oben aufgeführten Verbindungsdetails fort. Wenn Klaviyo einen Blob-Store erfordert, wähle einen aus, bevor du fortfährst.
2. Um einen Store hinzuzufügen, wähle im Dropdown-Menü Blob Store die Option Erstellen aus. Wähle eine*n Anbieter*in aus, falls du dazu aufgefordert wirst, gib die Verbindungsdetails ein und klicke dann auf Erstellen.
3. Wenn ein Feld für den Namen der Speicherkonfiguration angezeigt wird, gib den Namen der Speicherkonfiguration ein, die du in deinem Warehouse erstellt hast.
4. Wähle für ein Amazon S3-Ziel ein Dateiformat aus und ob du exportierte Dateien komprimieren möchtest, falls diese Optionen angezeigt werden.

Nachdem du deine Verbindungsdetails eingegeben hast, klicke auf Weiter. Wähle dann die Daten und den Zeitplan für deinen Export aus.

Datenobjekte

Im Abschnitt Datenobjekte kannst du auswählen, ob du alle Profildaten, nur bestimmte Ereignisdaten oder beide Datentypen synchronisieren möchtest, indem du das/die entsprechende(n) Kontrollkästchen neben jeder Option aktivierst.

Auszuschließende Integrationen

Im Feld Auszuschließende Integrationen kannst du die Integrationen auswählen, die du von der Synchronisierung mit dem Data Warehouse ausschließen möchtest. Das ist hilfreich, wenn du die Daten einer bestimmten Integration, die du möglicherweise bereits mit Klaviyo verbunden hast, auch von der Synchronisierung ausschließen möchtest.

Selektive Synchronisierung

Im Feld Selective sync wählst du die spezifischen Ereignisse aus, die du aus Klaviyo mit deinem Data Warehouse synchronisieren möchtest. Standardmäßig sind alle Ereignisse enthalten. Wenn du in diesem Feld bestimmte Ereignisse für die Synchronisierung festlegst, werden nur die ausgewählten Ereignisse synchronisiert.

Wähle aus, wie oft deine Daten synchronisiert werden sollen

Wähle in Auswählen, wie oft deine Daten synchronisiert werden unter Alle ein Intervall aus: 1, 2, 4, 6, 12 oder 24 Stunden. Lege für den Zeitplan Startdatum, Startzeit und Zeitzone fest.

Wähle aus, wie viele historische Daten du synchronisieren möchtest

Im Abschnitt Wähle aus, wie viele historische Daten du synchronisieren möchtest kannst du festlegen, wie viele historische Daten du bei der ersten Verbindung von Klaviyo mit deinem Data Warehouse synchronisieren möchtest. Du kannst auswählen:

• 30 Tage
• 90 Tage
• 1 Jahr
• Alle Zeiträume

Sync-Überprüfung

Klicke auf Weiter, um Überprüfen zu öffnen. Überprüfe die Verbindungsdetails und die Exporteinstellungen, einschließlich:

• Details zur Synchronisierung, die du eingerichtet hast
• Welche Daten werden geteilt (Profile, Events oder beides)
• Ausgeschlossene Integrationen

Klicke auf Verbinden, um die Verbindung zu speichern und die Synchronisierungen gemäß deinem Zeitplan zu starten.

Wenn Klaviyo Verbindung nicht möglich anzeigt, klicke auf Anmeldedaten bearbeiten, um die Verbindungsdetails zu korrigieren, kehre dann zu Überprüfen zurück und klicke erneut auf Verbinden.

Nachdem die Verbindung gespeichert wurde, bringt Klaviyo dich zurück zu Datensynchronisierung. Die Tabelle „Verbindungen“ zeigt:

• Warehouse
• Typ: Import oder Export
• Erstellt am

Exportziele und Direktimport-Verbindungen werden in derselben Tabelle angezeigt. Aktiviere Typ, um sie zu unterscheiden.

Dashboard für die Datensynchronisierung

Sobald eine erfolgreiche Verbindung hergestellt wurde, klicke in der Liste Datensynchronisierung auf deine Integration. Von hier aus gelangst du zum Dashboard für die Datensynchronisierung, das historische und aktuelle Informationen zu den ausgeführten Datensynchronisierungen bereitstellt.

Hier siehst du die Synchronisierungsinformationen, aufgeteilt in 2 Tabs:

• Historisch
• Regelmäßig

Historisch

Der Tab Historisch enthält Protokolle, die den Status deiner Synchronisierungen historischer Daten anzeigen. Historische Synchronisierungen beziehen sich auf die Synchronisierung deiner vorhandenen Daten von Klaviyo zu deinem Data Warehouse, wenn du eine Verbindung herstellst.

Für jede Synchronisierung werden die folgenden Informationen angezeigt:

• Name
  Die Daten, die in die Synchronisierung einbezogen werden.
• Status
  Status und möglicher Fortschritt der Synchronisierung mit einem geschätzten Prozentsatz oder ggf. vermerkten Fehlern. Diese Status könnten Folgendes umfassen:
  
  
  • Abgeschlossen
    Deine Daten wurden für diese einmalige Synchronisierung fertig synchronisiert. Es erfolgt keine automatische erneute Synchronisierung.
  • Geplant
    Wann die nächste Synchronisierung geplant ist, um automatisch zu laufen.
  • Synchronisierung
    Daten werden aktiv mit einem geschätzten prozentualen Abschlussgrad mit deinem Data Warehouse synchronisiert.
  • Fehler aufgetreten
    Ein Fehler ist aufgetreten, aber Klaviyo versucht weiterhin, die Verbindung erneut herzustellen. Je nach Integrationen kann dieses Timing leicht abweichen.
  • Fehlgeschlagen
    Die Synchronisierung ist vollständig fehlgeschlagen, selbst nachdem du versucht hast, die Verbindung wiederherzustellen. Das bedeutet, dass du deine Konfigurationseinstellungen oder sogar die Data-Warehouse-Einrichtung überprüfen musst. Nachdem du das Problem behoben hast, klicke für die Synchronisierung auf Erneut aktivieren.
  • Pausiert
    Du hast die Synchronisierung manuell pausiert.
  • Abgebrochen
    Die Synchronisierung wurde abgebrochen und ist nicht mehr geplant.
• Gestartet am
  Startzeit der Synchronisierung.
• Beendet am
  Endzeit der Synchronisierung.

Regelmäßig

Der Tab Periodisch zeigt den Status der laufenden Synchronisierungen an. Während Kund*innen weiterhin mit deiner Marke interagieren und neue Daten erstellt werden, werden sie nach dem von dir ausgewählten Zeitplan an dein Data Warehouse gesendet. Nachdem jeder Durchlauf abgeschlossen ist, plant Klaviyo den nächsten Durchlauf.

Für jede Synchronisierung werden die folgenden Informationen angezeigt:

• Name
  Die Daten, die in die Synchronisierung einbezogen werden.
• Status
  Der aktuelle Status des Syncs und alle Fehler. Diese Status können Folgendes umfassen:
  • Geplant
    Die Synchronisierung wartet auf ihren nächsten geplanten Lauf.
  • Synchronisierung
    Daten werden aktiv mit deinem Data Warehouse synchronisiert.
  • Fehler aufgetreten
    Ein Fehler ist aufgetreten, aber Klaviyo versucht weiterhin, die Verbindung erneut herzustellen. Je nach Integrationen kann dieses Timing leicht abweichen.
  • Fehlgeschlagen
    Die Synchronisierung ist auch nach dem Versuch, die Verbindung wiederherzustellen, vollständig fehlgeschlagen. Das bedeutet, dass du deine Konfigurationseinstellungen oder sogar dein Data-Warehouse-Setup überprüfen musst. Nachdem du das Problem behoben hast, klicke für die Synchronisierung auf Erneut aktivieren.
  • Pausiert
    Du hast die Synchronisierung manuell pausiert.
  • Abgebrochen
    Die Synchronisierung wurde abgebrochen und ist nicht mehr geplant.
• Datenaktualität
  Datenaktualität bezieht sich darauf, wie aktuell deine Daten sind. Eine Aktualität von 2 Minuten bedeutet zum Beispiel, dass die Synchronisierung Daten bis vor ungefähr 2 Minuten verarbeitet hat. Neuere Daten warten möglicherweise noch auf die Synchronisierung.
• Buttons zum Anhalten, Fortsetzen und erneuten Aktivieren einzelner Syncs.

Data-Warehouse-Verbindungen entfernen

1. Navigiere zu Integrationen.
2. Öffne das Menü neben deiner Data Warehouse-Integrationen und wähle Integration entfernen aus. Klicke im Bestätigungsdialog erneut auf Integration entfernen.

Fehlerprotokolle anzeigen

Wenn du Probleme bei der Datensynchronisierung zwischen Klaviyo und deinem Data Warehouse hast, kann das Anzeigen der zugehörigen Fehlerprotokolle zusätzliche Informationen zur Ursache des Problems liefern.

Um Fehler anzuzeigen, klicke auf der Seite Syncing in dein Warehouse-Ziel. Auf den Synchronisierungs-Tabs Historisch und Periodisch siehst du eine Liste der Exporte und ihren Status sowie einen Indikator, der anzeigt, ob es aktive Fehler gibt.

Um weitere Details zu einem bestimmten Fehler anzuzeigen, klicke in den Export, bei dem der Fehler auftritt.

Hier siehst du eine Zeitleiste der ausgehenden Synchronisierungen sowie je nach Status der Synchronisierung eine Fehlermeldung oder Erfolgsmeldung.

Wenn du auf einen bestimmten Fehler klickst, wird ein Drawer mit den folgenden Informationen geöffnet:

• Beschreibung
  Eine kurze Beschreibung des vom Data Warehouse zurückgegebenen Fehlers
• Code
  Der Fehlercode für den Fehler
• Externe Nachricht
  Die tatsächliche Fehlermeldung, die vom Data Warehouse zurückgegeben wird.
• Datum
  Datum und Uhrzeit des Fehlers

Weitere Ressourcen