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

Du musst sicherstellen, dass das Data Warehouse, mit dem du eine Verbindung herstellst, als Ziel konfiguriert ist. So stellst du sicher, dass du das korrekt eingerichtet hast:

• Stelle sicher, dass die Klaviyo bereitgestellte Nutzer*in die richtigen Berechtigungen hat.
• Stell sicher, dass du Tabellen mit den passenden Namen einrichtest, die unten basierend auf deinem Warehouse angezeigt werden.

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

Um Klaviyo eine Data-Warehouse-Verbindung hinzuzufügen, navigiere zu Advanced Klaviyo Data Platform > Datenmanagement > Synchronisierung.

Um ein Data Warehouse hinzuzufügen, wähle im Modal „Connector auswählen“ ein unterstütztes Data Warehouse aus.

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

Beim Verbinden eines Data Warehouse kannst du entweder Daten aus deinem Data Warehouse in Klaviyo importieren oder ein Data Warehouse als Ziel für ausgehende Synchronisierung festlegen.

Daten über SFTP importieren

Wenn Daten aus deinem Data Warehouse in Klaviyo importiert werden sollen, geht das über SFTP.

Um deine Daten in Klaviyo zu importieren, wähle beim erstmaligen Verbinden eines Warehouse-Ziels Daten importieren aus oder klicke auf der Seite Datensynchronisierung auf die Schaltfläche Importieren, wenn bereits eine Verbindung besteht.

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

Sobald du die gewünschten Daten aus deinem Warehouse exportiert hast, generiere auf deinem lokalen Computer einen neuen SSH-Schlüssel und füge ihn zu Klaviyo hinzu, indem du die Schaltfläche SSH-Schlüssel hinzufügen auswählst.

SFTP-Client konfigurieren und importieren

Nachdem dein SSH-Schlüssel erfolgreich zu Klaviyo hinzugefügt wurde, musst du deinen SFTP-Client konfigurieren und die Daten importieren.

1. Öffne deinen SFTP-Client und konfiguriere eine neue Verbindung mit den in Klaviyo bereitgestellten Anmeldedaten. Du siehst die Anmeldedaten, nachdem du deinen SSH-Schlüssel erfolgreich hinzugefügt hast.
2. Sorge nach der Authentifizierung dafür, dass deine Datenbank vor dem Import den empfohlenen Richtlinien entspricht.
3. Lade deine Datenbankdatei über deinen SFTP-Client hoch und überprüfe sie.

Außerdem siehst du eine Listenansicht deiner letzten Importe mit folgenden Informationen:

• Status
  Abgeschlossen oder nicht abgeschlossen.
• Verarbeitete Zeilen
  Prozentsatz der bisher insgesamt verarbeiteten Zeilen.
• 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, brauchst du die folgenden Informationen und Zugangsdaten 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 klaviyo_profile zu erstellen.

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

• Name: Der Name deiner Datenbank in Redshift (es ist empfehlenswert, denselben Namen wie bei deiner Datenbank in Redshift zu verwenden)
• Host-URL: Der Endpunkt des Amazon-Redshift-Servers (in Redshift als Connection URL bezeichnet)
• Datenbank: Der Name zur Identifizierung deiner Datenquelle
• 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, lege die Tabellennamen auf klaviyo_profile und klaviyo_event fest.

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

• Name: Der maschinenlesbare Name für die Amazon S3-Datenbank.
• 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 und klaviyo_event einzurichten. Dein Google BigQuery-Konto muss ein Zahlungsprofil haben, 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 und klaviyo_event zu erstellen.

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:

text Copy

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:

text Copy

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 festzulegen. Du musst über die Berechtigungen securityadmin und sysadmin verfügen, um das Setup unten 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.

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.
  

Nachdem du deine Anmeldedaten für das Data Warehouse eingegeben hast, mit dem du synchronisierst, wähle die Daten aus Klaviyo aus, die du synchronisieren möchtest.

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

Der Wert, der für das Feld Cadence der periodischen Synchronisierung im Abschnitt Auswählen, wie oft deine Daten synchronisiert werden festgelegt ist, bestimmt, wie häufig eine Synchronisierung von Klaviyo zu deinem Data Warehouse erfolgt.

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

Sobald du deine Integrationen verbunden hast, siehst du, wenn die Einrichtung erfolgreich war, einen letzten Bildschirm, der darauf hinweist, dass die Verbindung Aktiviert ist, sowie:

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

Wenn deine Synchronisierung nicht erfolgreich verbunden wurde, siehst du stattdessen den Status Verbindung nicht möglich sowie Optionen, um deine Verbindung erneut zu versuchen oder die Informationen in deinen Anmeldedaten zu bearbeiten.

Nachdem du dein Data Warehouse erfolgreich verbunden hast, wirst du zurück zur Hauptlistenseite Daten synchronisieren gebracht. Hier siehst du Folgendes:

• Warehouse- Ziel
• Der Status Aktiviert
• Mögliche Fehler, die in den letzten 24 Stunden bei deiner Synchronisierung aufgetreten sind
• Die letzte Synchronisierung zusammen mit einem Zeitstempel dieses Ereignisses

Da du nur 1 Ziel verbinden kannst, wird in dieser Listenansicht auch nur 1 Ziel angezeigt.

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 werden in die Synchronisierung einbezogen.
• 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.
  • In Bearbeitung
    Daten werden aktiv mit deinem Data Warehouse synchronisiert, mit einem geschätzten Prozentsatz des Abschlusses.
  • 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 die Einrichtung des Data Warehouse überprüfen musst.
  • Pausiert
    Du hast die Synchronisierung manuell pausiert.
  • Deaktiviert
    Die Synchronisierung wurde deaktiviert, weil die Integrationen selbst deaktiviert oder entfernt wurde.
• Gestartet am
  Startzeit der Synchronisierung.
• Beendet am
  Endzeit der Synchronisierung.

Regelmäßig

Der Tab Periodic enthält Protokolle, die den Status deiner periodischen Synchronisierungen anzeigen. Während Kund*innen weiter mit deiner Marke interagieren und neue Daten erstellt werden, werden diese routinemäßig an dein Data Warehouse gesendet. Beim Einrichten einer Data-Warehouse-Verbindung erfolgen periodische Synchronisierungen stündlich.

Für jede Synchronisierung werden die folgenden Informationen angezeigt:

• Name
  Die Daten werden in die Synchronisierung einbezogen.
• 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.
  • In Bearbeitung
    Daten werden aktiv mit deinem Data Warehouse synchronisiert, mit einem geschätzten Prozentsatz des Abschlusses.
  • 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 die Data-Warehouse-Einrichtung überprüfen musst.
  • Pausiert
    Du hast die Synchronisierung manuell pausiert.
  • Deaktiviert
    Die Synchronisierung wurde deaktiviert, weil die Integration selbst deaktiviert oder entfernt wurde.
• Datenaktualität
  Datenaktualität bezieht sich darauf, wie aktuell deine Daten sind. Wenn ein Sync beispielsweise eine Aktualität von 2 Minuten hat, bedeutet das, dass alle neuen Daten, die in Klaviyo in den letzten 2 Minuten erstellt wurden, noch nicht in deinem Data Warehouse sind.
• Buttons zum Anhalten, Fortsetzen und erneuten Aktivieren einzelner Syncs.

Data-Warehouse-Verbindungen entfernen

Um eine Data-Warehouse-Verbindung aus deinem Klaviyo-Konto zu löschen, wähle die Registerkarte Integrationen aus.

Öffne das Menü neben deiner Data-Warehouse-Integration und wähle Integration entfernen aus, um die Verbindung zu 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:

• Zusammenfassung
  Eine kurze Beschreibung des Fehlers, der vom Data Warehouse zurückgegeben wird
• 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