Einrichtung und Verbindung der Umgebung

Übersicht: So bereitest du BigQuery für Klaviyo vor Du erstellst die erforderlichen Schemata (in einem Dataset/Projekt), richtest ein dediziertes Dienstkonto und einen Schlüssel ein, weist die mindestens erforderlichen Berechtigungen zu, verifizierst die Konfiguration und verbindest BigQuery mit Klaviyo.

Weitere Informationen zur Funktionsweise von Data-Warehouse-Import in Klaviyo, einschließlich Schemastruktur, erforderlichen Tabellen und Feldzuordnungen, findest du unter Funktionsweise von Data-Warehouse-Import in Klaviyo.

1) Erforderliche Schemas/Datensätze erstellen

Erstelle in BigQuery zwei Datensätze in dem Projekt, das du für Klaviyo verwenden wirst.

CREATE SCHEMA `KLAVIYO_IMPORT_FROM_DWH`; CREATE SCHEMA `KLAVIYO_TMP`;

• KLAVIYO_IMPORT_FROM_DWH: Die in diesem Dataset erstellten Tabellen und Sichten stehen Klaviyo zum Lesen/Schreiben zur Verfügung.
• KLAVIYO_TMP: Temporäre oder Stagingdaten, die bei Synchronisierungsvorgängen verwendet werden.

2) Klaviyo Service-Konto und Schlüssel erstellen

Erstelle ein Google-Dienstkonto (z. B. KLAVIYO_DATA_TRANSFER_USER), die Klaviyo exklusiv für diese Integration verwenden wird. Lade einen JSON-Schlüssel für dieses Konto herunter und speichere ihn sicher.

• Gehe zu IAM und Administrator → Dienstkonten in der GCP-Konsole.
• Erstelle ein neues Dienstkonto (oder wähle ein bestehendes speziell für Klaviyo).
• Erstelle auf der Registerkarte Schlüssel einen neuen Schlüssel vom Typ JSON. Bewahre diese Schlüsseldatei auf – du brauchst sie, wenn du die Verbindung in Klaviyo konfigurierst.

3) Erforderliche Berechtigungen zuweisen

Gewähre dem Dienstkonto die folgenden Rollen, die sich auf die beiden von dir erstellten Datensätze beziehen:

-- Beispielbefehle in GCP CLI (Platzhalter ersetzen): gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \ --member=„serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com“ \ --role=„roles/bigquery.dataEditor“ \ --condition=None \ --dataset=„KLAVIYO_TMP“ gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \ --member=„serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com“ \ --role=„roles/bigquery.dataViewer“ \ --condition=Keine \ --dataset=„KLAVIYO_IMPORT_FROM_DWH“

4) Deine Einrichtung verifizieren (optional)

4.1 Bestätige, dass die Datensätze vorhanden sind

WÄHLE schema_name FROM `YOUR_PROJECT_ID.INFORMATION_SCHEMA.SCHEMATA` WHERE schema_name IN ('KLAVIYO_IMPORT_FROM_DWH','KLAVIYO_TMP');

4.2 Bestätige den Zugriff auf dein Dienstkonto

Mit dem Dienstkontoschlüssel kannst du dich bei der BigQuery-CLI oder -API authentifizieren und eine einfache Abfrage durchführen:

bq --project_id=DEIN_PROJEKT_ID \ --dataset_id=KLAVIYO_IMPORT_FROM_DWH \ query --use_legacy_sql=false \ 'SELECT COUNT(*) FROM `DEIN_PROJEKT_ID.KLAVIYO_IMPORT_FROM_DWH.some_table` LIMIT 1'

4.3 Berechtigungen für jeden Datensatz überprüfen

WÄHLE * AUS „YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES“, WOBEI grantee = „KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com“;

4.4 Optional: Erstellen/Lesen-Vorgänge validieren

-- Testen der Erstellung in KLAVIYO_TMP CREATE TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions` (id INT64); DROP TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions`;

-- Testauswahl in KLAVIYO_IMPORT_FROM_DWH SELECT * FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_existing_table` LIMIT 1;

Tipp: Führe diese Prüfungen mit demselben Dienstkonto und demselben Schlüssel durch, den du Klaviyo zur Verfügung stellst. Bewahre eine Kopie der Ergebnisse für die Prüfung auf.

5) Klaviyo mit BigQuery verbinden

Sobald deine BigQuery-Umgebung konfiguriert ist, schließe die Verbindung in Klaviyo ab.

1. Navigiere in Klaviyo in der linken Seitenleiste zu Advanced → Syncing (Erweitert Synchronisierung).
2. Klicke auf Synchronisierung erstellen.
3. Wähle Importieren oder Exportieren von Daten in dein Data Warehouse aus.
4. Wähle BigQuery als Data Warehouse.
5. Klicke auf Mit BigQuery verbinden.

Wenn du dazu aufgefordert wirst, gib die folgenden Details zur Verbindungskonfiguration an:

Nach der Verbindung: Klaviyo validiert die Verbindung, testet den Zugriff auf deine Datensätze und ermöglicht dir die Konfiguration von Synchronisierungen – sowohl für den Import von Daten in Klaviyo als auch für den Export von Klaviyo-Daten in BigQuery.

Nächster Schritt: Nachdem du die Verbindung hergestellt hast, erstellst du deine erste Import- oder Exportsynchronisierung in Klaviyo und beginnst damit, Daten in oder aus BigQuery zu verschieben.