Klaviyo-Daten in BigQuery laden

Wenn Sie wiederkehrende Datenübertragungen von Klaviyo zu BigQuery planen möchten, erstellen Sie eine Übertragungskonfiguration, in der Sie angeben, welche Datenobjekte übertragen werden sollen und wie oft die Datenübertragung geplant werden soll. Sie können eine Übertragungskonfiguration entweder über die Google Cloud Console oder das bq Befehlszeilentool erstellen. Nachdem Sie die Übertragungskonfiguration eingerichtet haben, überträgt der BigQuery Data Transfer Service die neuesten Daten nach dem angegebenen Zeitplan in eine BigQuery-Tabelle.

Weitere Informationen zur Funktionsweise einer Klaviyo-Übertragung finden Sie unter Einführung in Klaviyo-Übertragungen.

Hinweis

In den folgenden Abschnitten werden die Voraussetzungen beschrieben, die Sie erfüllen müssen, bevor Sie eine Klaviyo-Datenübertragung erstellen.

Voraussetzungen für Klaviyo

Sie benötigen einen schreibgeschützten privaten API-Schlüssel, damit der Klaviyo-Connector Daten zu BigQuery übertragen kann. Weitere Informationen finden Sie unter Privaten Schlüssel erstellen.

Voraussetzungen für BigQuery

Erforderliche BigQuery-Rollen

Bitten Sie Ihren Administrator, Ihnen die BigQuery-Administrator (roles/bigquery.admin) IAM-Rolle für Ihr Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Erstellen einer Datenübertragung mit dem BigQuery Data Transfer Service benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen einer Datenübertragung mit dem BigQuery Data Transfer Service erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen , um die notwendigen Berechtigungen anzuzeigen, die erforderlich sind:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um eine Datenübertragung mit dem BigQuery Data Transfer Service zu erstellen:

  • Berechtigungen für BigQuery Data Transfer Service:
    • bigquery.transfers.update
    • bigquery.transfers.get
  • BigQuery-Berechtigungen:
    • bigquery.datasets.get
    • bigquery.datasets.getIamPolicy
    • bigquery.datasets.update
    • bigquery.datasets.setIamPolicy
    • bigquery.jobs.create

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen finden Sie unter Zugriff auf bigquery.admin gewähren.

Wenn Sie Benachrichtigungen zur Übertragungsausführung für Pub/Sub einrichten möchten, benötigen Sie die IAM-Berechtigung pubsub.topics.setIamPolicy. Pub/Sub-Berechtigungen sind nicht erforderlich, wenn Sie nur E‑Mail-Benachrichtigungen einrichten. Weitere Informationen finden Sie unter Ausführungsbenachrichtigungen im BigQuery Data Transfer Service.

Klaviyo-Datenübertragung einrichten

Fügen Sie BigQuery Klaviyo-Daten hinzu, indem Sie eine Übertragungskonfiguration mit einer der folgenden Optionen einrichten:

Console

  1. Rufen Sie in der Google Cloud Console die Seite „Datenübertragungen“ auf.

    Zu „Datenübertragungen“

  2. Klicken Sie auf Übertragung erstellen.

  3. Wählen Sie im Abschnitt Quelltyp als Quelle die Option Klaviyo – Vorschau aus.

  4. Führen Sie im Abschnitt Details zur Datenquelle folgende Schritte aus:

    • Geben Sie unter Privater API-Schlüssel Ihren privaten API-Schlüssel ein. Weitere Informationen finden Sie unter Voraussetzungen für Klaviyo.
    • Optional: Geben Sie unter Startdatum ein Startdatum an, ab dem neue Datensätze in die Datenübertragung aufgenommen werden sollen. Nur Datensätze, die an oder nach diesem Datum erstellt wurden, werden in die Datenübertragung aufgenommen. Der Standardwert ist drei Monate vor dem Datum der Übertragungsausführung.
    • Klicken Sie unter Zu übertragende Klaviyo-Objekte auf Durchsuchen , um alle Objekte auszuwählen, die an das BigQuery Ziel-Dataset übertragen werden sollen. Sie können in diesem Feld auch manuell Objekte eingeben, die in die Datenübertragung aufgenommen werden sollen.

  5. Wählen Sie im Abschnitt Zieleinstellungen als Dataset das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

  6. Geben Sie im Abschnitt Konfigurationsname für Übertragung als Anzeigename einen Namen für die Datenübertragung ein.

  7. Im Abschnitt Zeitplanoptionen:

    • Wählen Sie in der Liste Wiederholungshäufigkeit aus, wie oft diese Datenübertragung ausgeführt werden soll. Wenn Sie eine benutzerdefinierte Wiederholungshäufigkeit angeben möchten, wählen Sie Benutzerdefiniert aus. Wenn Sie On demand auswählen, wird diese Datenübertragung ausgeführt, wenn Sie die Übertragung manuell auslösen.
    • Wählen Sie gegebenenfalls Jetzt starten oder Zu festgelegter Zeit starten aus und geben Sie ein Startdatum und eine Laufzeit an.

  8. Optional: Gehen Sie im Abschnitt Benachrichtigungsoptionen so vor:

    • Klicken Sie zum Aktivieren von E‑Mail-Benachrichtigungen auf den Ein/Aus-Button E‑Mail-Benachrichtigung. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E‑Mail-Benachrichtigung, falls ein Übertragungsvorgang fehlschlägt.
    • Klicken Sie auf den Ein/Aus-Button Pub/Sub-Benachrichtigungen, um Pub/Sub-Benachrichtigungen über die Ausführung von Übertragungen für diese Übertragung zu aktivieren. Sie können Ihr Thema auswählen oder auf Thema erstellen klicken, um eines zu erstellen.

  9. Klicken Sie auf Speichern.

bq

Geben Sie den bq mk Befehl ein und geben Sie das Flag für die Übertragungserstellung --transfer_config an:

bq mk
    --transfer_config
    --project_id=PROJECT_ID
    --data_source=DATA_SOURCE
    --display_name=NAME
    --target_dataset=DATASET
    --params='PARAMETERS'

Ersetzen Sie Folgendes:

  • PROJECT_ID (optional): Ihre Google Cloud Projekt-ID. Wenn --project_id nicht angegeben wird, um ein bestimmtes Projekt anzugeben, wird das Standardprojekt verwendet.
  • DATA_SOURCE. Die Datenquelle – klaviyo.
  • NAME: Der Anzeigename für die Datenübertragungskonfiguration. Der Übertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung identifizieren können, wenn Sie sie später ändern müssen.
  • DATASET: Das Ziel-Dataset für die Übertragungskonfiguration.

  • PARAMETERS: die Parameter für die erstellte Übertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Im Folgenden finden Sie die Parameter für eine Klaviyo-Datenübertragung:

    • assets: Der Pfad zu den Klaviyo-Objekten, die in BigQuery übertragen werden sollen.
    • connector.authentication.privateApiKey: Der private API-Schlüssel für das Klaviyo-Konto.
    • connector.startDate: (Optional) Ein Startdatum für neue Datensätze, die in die Datenübertragung aufgenommen werden sollen, im Format YYYY-MM-DD. Nur Datensätze, die an oder nach diesem Datum erstellt wurden, werden in die Datenübertragung aufgenommen. Der Standardwert ist drei Monate vor dem Datum der Übertragungsausführung.

Mit dem folgenden Befehl wird eine Klaviyo-Datenübertragung im Standardprojekt erstellt.

    bq mk
        --transfer_config
        --target_dataset=mydataset
        --data_source=klaviyo
        --display_name='My Transfer'
        --params= ' {
            "assets": [ "Events" , "Flows"] ,
            "connector.authentication.privateApiKey" : "pk_123456789123",
            "connector.startDate": "2025-10-20"
            }'
Wenn Sie die Übertragungskonfiguration speichern, löst der Klaviyo-Connector automatisch eine Übertragungsausführung gemäß Ihrer Zeitplanoption aus. Bei jeder Übertragungsausführung überträgt der Klaviyo-Connector alle verfügbaren Daten von Klaviyo nach BigQuery.

Wenn Sie eine Datenübertragung außerhalb des regulären Zeitplans manuell ausführen möchten, können Sie einen Backfill-Vorgang starten.

Eine Liste der Daten, die in einer Klaviyo-Datenübertragung enthalten sind, finden Sie in der Referenz zum Klaviyo-Datenmodell.

Fehler bei der Übertragungseinrichtung beheben

Wenn Sie Probleme beim Einrichten Ihrer Datenübertragung haben, finden Sie weitere Informationen unter Probleme mit Klaviyo-Übertragungen.

Nächste Schritte

  • Eine Übersicht über den BigQuery Data Transfer Service finden Sie unter Was ist der BigQuery Data Transfer Service?.
  • Informationen zum Verwenden von Übertragungen, einschließlich des Abrufs von Informationen zu einer Übertragungskonfiguration, des Auflistens von Übertragungskonfigurationen und des Aufrufs des Ausführungsverlaufs der Übertragung finden Sie unter Übertragungen verwalten.