Einführung in Klaviyo-Datenübertragungen

Mit dem BigQuery Data Transfer Service für Klaviyo-Connector können Sie Daten aus Klaviyo in BigQuery laden. Mit dem BigQuery Data Transfer Service können Sie wiederkehrende Übertragungsjobs planen, mit denen Ihre neuesten Daten aus Klaviyo in BigQuery übertragen 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 beim Einrichten einer Klaviyo-Übertragung in der Übertragungskonfiguration die Schreibeinstellung Vollständig oder Inkrementell auswählen. Inkrementelle Übertragungen werden in der Vorschau unterstützt.

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

Alternativ können Sie eine inkrementelle Datenübertragung (Vorschau) so konfigurieren, dass nur Daten übertragen werden, die seit der letzten Datenübertragung geändert wurden, anstatt das gesamte Dataset bei jeder Datenübertragung zu laden. Wenn Sie für Ihre Datenübertragung Inkrementell auswählen, müssen Sie entweder den Schreibmodus Anhängen oder Upsert angeben, um zu definieren, wie Daten bei 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 einfach angehängt, ohne nach vorhandenen Datensätzen zu suchen. Daher kann dieser Modus potenziell zu Datenduplizierung in der Zieltabelle führen.

Wenn Sie den Modus „Anhängen“ auswählen, müssen Sie eine Watermark-Spalte auswählen. Eine Watermark-Spalte ist erforderlich, damit der Klaviyo-Connector Änderungen in der Quelltabelle nachverfolgen kann.

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.

Schreibmodus „Upsert“

Im Schreibmodus „Upsert“ 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 die Zieltabelle 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 Modus „Upsert“ auswählen, müssen Sie eine Watermark-Spalte und einen Primärschlüssel auswählen:

  • Eine Watermark-Spalte ist erforderlich, damit der Klaviyo-Connector Änderungen in der Quelltabelle nachverfolgen kann.
    • Wählen Sie eine Watermark-Spalte aus, die jedes Mal aktualisiert wird, wenn eine Zeile geändert wird. Wir empfehlen Spalten wie UPDATED_AT oder LAST_MODIFIED.

  • Der Primärschlüssel kann eine oder mehrere Spalten in der Tabelle sein, die erforderlich sind, damit der Klaviyo-Connector ermitteln kann, ob eine Zeile eingefügt oder aktualisiert werden muss.

    Wählen Sie Spalten aus, die Nicht-Null-Werte enthalten, die in allen Zeilen der Tabelle eindeutig sind. Wir empfehlen Spalten mit vom System generierten IDs, eindeutigen Referenzcodes (z. B. automatisch inkrementierende IDs) oder unveränderlichen zeitbasierten Sequenz-IDs.

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

Datentypzuordnung

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

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

Preise

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

Nächste Schritte