Konfiguracja środowiska i nawiązanie połączenia

Przegląd: Wykonaj te kroki, aby przygotować BigQuery do Klaviyo. Utworzysz wymagane schematy (w zbiorze danych/projekcie), skonfigurujesz dedykowane konto usługi i klucz, przypiszesz minimalne wymagane uprawnienia, zweryfikujesz konfigurację i połączysz BigQuery z Klaviyo.

Aby uzyskać szczegółowe informacje o tym, jak działa import z hurtowni danych w Klaviyo — w tym o strukturze schematu, wymaganych tabelach i mapowaniach pól — zobacz Jak działają importy z hurtowni danych w Klaviyo.

1) Utwórz wymagane schematy / zestawy danych

W BigQuery utwórz dwa zbiory danych w projekcie, którego użyjesz w Klaviyo.

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

• KLAVIYO_IMPORT_FROM_DWH: Tabele i widoki utworzone w tym zestawie danych będą dostępne dla Klaviyo do odczytu/zapisu.
• KLAVIYO_TMP: Tymczasowe lub testowe dane używane podczas operacji synchronizacji.

2) Utwórz konto usługi Klaviyo Service i klucz

Utwórz konto usługi Google (np. KLAVIYO_DATA_TRANSFER_USER) którego Klaviyo będzie używać wyłącznie na potrzeby tej integracji. Pobierz klucz JSON dla tego konta i przechowuj go w bezpiecznym miejscu.

• Przejdź do IAM i administrator → Konta usługi w konsoli GCP.
• Utwórz nowe konto usługi (lub wybierz istniejące, przeznaczone dla Klaviyo).
• Na karcie Keys utwórz nowy klucz typu JSON. Przechowuj ten plik klucza w bezpiecznym miejscu — będzie potrzebny podczas konfigurowania połączenia w Klaviyo.

3) Przypisz wymagane uprawnienia

Przyznaj kontu usługi następujące role, z zakresem ograniczonym do dwóch utworzonych zbiorów danych:

-- Example commands in GCP CLI (replace placeholders):
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=None \
  --dataset="KLAVIYO_IMPORT_FROM_DWH"

4) Zweryfikuj konfigurację (opcjonalnie)

4.1 Potwierdź, że zestawy danych istnieją

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

4.2 Potwierdź dostęp do konta usługi

Użyj klucza konta usługi do uwierzytelnienia w BigQuery CLI lub API i uruchom prostą kwerendę:

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

4.3 Sprawdź uprawnienia w każdym zestawie danych

SELECT * 
FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES`
WHERE grantee = 'KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com';

4.4 Opcjonalnie: zweryfikuj operacje tworzenia/odczytu

-- Test create in KLAVIYO_TMP
CREATE TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions` (id INT64);
DROP TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions`;

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

Wskazówka: Uruchom te kontrole, używając tego samego konta usługi i klucza, które przekażesz do Klaviyo. Zachowaj kopię wyników do celów audytu.

5) Połącz Klaviyo z BigQuery

Gdy środowisko BigQuery będzie skonfigurowane, dokończ łączenie w Klaviyo.

1. W Klaviyo przejdź do Zaawansowane → Synchronizacja na lewym pasku bocznym.
2. Kliknij Utwórz synchronizację.
3. Wybierz Importuj lub eksportuj dane do hurtowni danych.
4. Wybierz BigQuery jako hurtownię danych.
5. Kliknij Połącz z BigQuery.

Gdy pojawi się monit, podaj następujące szczegóły konfiguracji połączenia:

Po połączeniu: Klaviyo zweryfikuje połączenie, przetestuje dostęp do Twoich zestawów danych, a następnie umożliwi skonfigurowanie synchronizacji — zarówno importowania danych do Klaviyo, jak i eksportowania danych z Klaviyo do BigQuery.

Następny krok: Po pomyślnym połączeniu utwórz pierwszą synchronizację importu lub eksportu w Klaviyo i zacznij przenosić dane do BigQuery lub z BigQuery.