Einführung in Klaviyo-Übertragungen

Mit dem BigQuery Data Transfer Service für den 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.

Beschränkungen

Für inkrementelle Klaviyo-Übertragungen gelten die folgenden Beschränkungen:

  • Sie können nur TIMESTAMP-Spalten als Watermark-Spalten auswählen.
  • Die inkrementelle Aufnahme wird nur für Assets mit gültigen Watermark-Spalten unterstützt.
  • Die Werte in einer Watermark-Spalte müssen monoton ansteigen.
  • Bei inkrementellen Übertragungen können Löschvorgänge in der Quelltabelle nicht synchronisiert werden.
  • Eine einzelne Übertragungskonfiguration kann nur entweder die inkrementelle oder die vollständige Aufnahme unterstützen.
  • Nach der ersten inkrementellen Aufnahme können Sie Objekte in der Liste asset nicht mehr aktualisieren.
  • Nach der ersten inkrementellen Aufnahme können Sie den Schreibmodus in einer Übertragungskonfiguration nicht mehr ändern.
  • Nach der ersten inkrementellen Aufnahme können Sie die Watermark-Spalte oder den Primärschlüssel nicht mehr ändern.
  • Die BigQuery-Zieltabellen werden mit dem angegebenen Primärschlüssel geclustert und unterliegen den Beschränkungen für geclusterte Tabellen.
  • Wenn Sie eine vorhandene Übertragungskonfiguration zum ersten Mal in den inkrementellen Aufnahmemodus ändern, werden bei der ersten Datenübertragung nach dieser Änderung alle verfügbaren Daten aus Ihrer Datenquelle übertragen. Bei allen nachfolgenden inkrementellen Datenübertragungen werden nur die neuen und aktualisierten Zeilen aus Ihrer Datenquelle übertragen.

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 geben an, 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](https://cloud.google.com/products#product-launch-stages)) konfigurieren, bei der nur Daten übertragen werden, die seit der letzten Datenübertragung geändert wurden. So muss nicht bei jeder Datenübertragung das gesamte Dataset geladen werden. 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 Zieltabellen eingefügt. Bei dieser Option werden übertragene Daten einfach angehängt, ohne nach vorhandenen Einträgen zu suchen. Daher kann es in der Zieltabellen zu Datenduplizierungen kommen.

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 Eintrags 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 Zieltabellen eingefügt. Dazu wird nach einem Primärschlüssel gesucht. Sie können einen Primärschlüssel angeben, damit der Klaviyo-Connector ermitteln kann, welche Änderungen erforderlich sind, um die Zieltabellen auf dem neuesten Stand zu halten. Wenn der angegebene Primärschlüssel während einer Datenübertragung in der BigQuery-Zieltabellen 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 aus einer oder mehreren Spalten in der Tabelle bestehen. Er ist erforderlich, 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 die 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

Die Übertragung von Klaviyo-Daten in BigQuery ist kostenlos, solange sich diese Funktion in der Vorschaubefindet.

Nächste Schritte