Einführung in Klaviyo-Datenübertragungen

Sie können Daten aus Klaviyo mit dem BigQuery Data Transfer Service für den Klaviyo-Connector in BigQuery laden. Mit dem BigQuery Data Transfer Service können Sie wiederkehrende Übertragungsjobs planen, mit denen Ihre neuesten Daten von Klaviyo zu BigQuery hinzugefügt werden.

Informationen zum Planen einer Klaviyo-Übertragung finden Sie unter Klaviyo-Daten in BigQuery laden.

Optionen für die Datenaufnahme

In diesen Abschnitten werden die Optionen für die Datenaufnahme zum Einrichten einer Klaviyo-Datenübertragung beschrieben.

Vollständige oder inkrementelle Übertragungen

Sie können angeben, wie Daten in BigQuery geladen werden, indem Sie in der Übertragungskonfiguration die Schreibeinstellung Vollständig oder Inkrementell auswählen, wenn Sie eine Klaviyo-Übertragung einrichten. Inkrementelle Übertragungen werden in der Vorabversion unterstützt.

Sie können eine vollständige Datenübertragung konfigurieren, um bei jeder Datenübertragung alle Daten aus Ihren Klaviyo-Datasets zu übertragen.

Alternativ können Sie eine inkrementelle Datenübertragung (Vorabversion) konfigurieren, um nur Daten zu übertragen, die sich seit der letzten Datenübertragung geändert haben, anstatt bei jeder Datenübertragung das gesamte Dataset zu laden. Wenn Sie für die Datenübertragung Inkrementell auswählen, müssen Sie entweder den Schreibmodus Anhängen oder Upsert angeben, um festzulegen, wie Daten während einer inkrementellen Datenübertragung in BigQuery geschrieben werden. In den folgenden Abschnitten werden die verfügbaren Schreibmodi beschrieben.

Schreibmodus „Anhängen“

Im Schreibmodus „Anhängen“ werden nur neue Zeilen in die Zieltabelle eingefügt. Bei dieser Option werden übertragene Daten strikt angehängt, ohne dass nach vorhandenen Datensätzen gesucht wird. Daher kann dieser Modus zu Datenduplikaten in der Zieltabelle führen.

Wenn Sie den Anfügemodus auswählen, müssen Sie eine Watermark-Spalte auswählen. Für den Klaviyo-Connector ist eine Wasserzeichenspalte erforderlich, um Änderungen in der Quelltabelle zu verfolgen.

Für Klaviyo-Übertragungen empfehlen wir, eine Spalte auszuwählen, die nur beim Erstellen des Datensatzes aktualisiert wird und sich bei nachfolgenden Aktualisierungen nicht ändert, z. B. die Spalte CREATED_AT.

Upsert-Schreibmodus

Im Upsert-Schreibmodus wird entweder eine Zeile aktualisiert oder eine neue Zeile in die Zieltabelle eingefügt, indem nach einem Primärschlüssel gesucht wird. Sie können einen Primärschlüssel angeben, damit der Klaviyo-Connector ermitteln kann, welche Änderungen erforderlich sind, um Ihre Zieltabelle mit Ihrer Quelltabelle auf dem neuesten Stand zu halten. Wenn der angegebene Primärschlüssel während einer Datenübertragung in der BigQuery-Zieltabelle vorhanden ist, aktualisiert der Klaviyo-Connector diese Zeile mit neuen Daten aus der Quelltabelle. Wenn während einer Datenübertragung kein Primärschlüssel vorhanden ist, fügt der Klaviyo-Connector eine neue Zeile ein.

Wenn Sie den Upsert-Modus auswählen, müssen Sie eine Watermark-Spalte und einen Primärschlüssel auswählen:

  • Für den Klaviyo-Connector ist eine Wasserzeichenspalte erforderlich, um Änderungen in der Quelltabelle zu verfolgen.
    • Wählen Sie eine Wasserzeichenspalte aus, die jedes Mal aktualisiert wird, wenn eine Zeile geändert wird. Wir empfehlen Spalten, die der Spalte UPDATED_AT oder LAST_MODIFIED ähneln.

  • Der Primärschlüssel kann eine oder mehrere Spalten in Ihrer Tabelle sein, die der Klaviyo-Connector benötigt, um zu bestimmen, ob eine Zeile eingefügt oder aktualisiert werden muss.

    Wählen Sie Spalten aus, die Werte ungleich Null enthalten, die in allen Zeilen der Tabelle eindeutig sind. Wir empfehlen Spalten, die systemgenerierte Kennungen, eindeutige Referenzcodes (z. B. automatisch inkrementierende IDs) oder unveränderliche zeitbasierte Sequenz-IDs enthalten.

    Um potenziellen Datenverlust oder Datenbeschädigung zu vermeiden, müssen die von Ihnen ausgewählten Primärschlüsselspalten eindeutige Werte enthalten. Wenn Sie Zweifel an der Eindeutigkeit der ausgewählten Primärschlüsselspalte haben, empfehlen wir, stattdessen den Schreibmodus „Anhängen“ zu verwenden.

Datentypzuordnung

In der folgenden Tabelle werden Klaviyo-Datentypen den entsprechenden BigQuery-Datentypen zugeordnet:

Klaviyo-Datentyp BigQuery-Datentyp
String STRING
Text STRING
Integer INTEGER
Float FLOAT
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY
JSON JSON
Record RECORD

Preise

Während sich dieses Feature in der Vorschau befindet, fallen keine Kosten für die Übertragung von Klaviyo-Daten in BigQuery an.

Nächste Schritte