Einführung in Klaviyo-Datenü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 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 aktualisieren, werden bei der ersten Datenübertragung nach dieser Aktualisierung 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 konfigurieren, um bei jeder Datenübertragung alle Daten aus Ihren Klaviyo-Datasets zu übertragen.

Alternativ können Sie eine inkrementelle Datenübertragung (Vorschau) konfigurieren, um nur Daten zu übertragen, 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 Zieltabellen eingefügt. Bei dieser Option werden übertragene Daten einfach angehängt, ohne nach vorhandenen Einträgen zu suchen. Daher kann es in der Zieltabelle 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 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 aus einer oder mehreren Spalten in der Tabelle bestehen, 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