Omgeving instellen en verbinden

Overzicht: Volg deze stappen om BigQuery voor te bereiden op Klaviyo. Je maakt de vereiste schema's (in een dataset/project), stelt een speciale service account en sleutel in, wijst de minimaal vereiste rechten toe, controleert de configuratie en verbindt BigQuery met Klaviyo.

Voor meer informatie over hoe importeren uit datawarehouse werkt in Klaviyo- inclusief schema-structuur, vereiste tabellen en veld-toewijzingen - zie Hoe importeren uit datawarehouse werkt in Klaviyo.

1) Vereiste schema's / datasets maken

Maak in BigQuery twee datasets aan in het project dat je gaat gebruiken voor Klaviyo.

MAAK SCHEMA `KLAVIYO_IMPORT_FROM_DWH` AAN;
MAAK SCHEMA `KLAVIYO_TMP` AAN;

• KLAVIYO_IMPORT_FROM_DWH: Tabellen en weergaven die in deze dataset zijn gemaakt, zijn beschikbaar voor Klaviyo om te lezen/schrijven.
• KLAVIYO_TMP: Tijdelijke of staging gegevens gebruikt tijdens synchronisatie operaties.

2) Maak het Klaviyo Service-account en de sleutel aan

Maak een Google-service account (bijv. KLAVIYO_DATA_TRANSFER_USER) die Klaviyo uitsluitend voor deze integratie zal gebruiken. Download een JSON sleutel voor dit account en sla deze veilig op.

• Ga naar IAM & Beheerder → Service account in de GCP Console.
• Maak een nieuw serviceaccount aan (of selecteer een bestaand account speciaal voor Klaviyo).
• Maak op het tabblad Sleutels een nieuwe sleutel van het type JSON. Bewaar dit sleutelbestand goed - u hebt het nodig bij het configureren van de verbinding in Klaviyo.

3) Vereiste machtigingen toewijzen

Ken aan de service account de volgende rollen toe, afgestemd op de twee datasets die je hebt gemaakt:

-- Voorbeeldcommando's in GCP CLI (placeholders vervangen):
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) Je instellingen controleren (optioneel)

4.1 Bevestig dat de datasets bestaan

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

4.2 Toegang tot service account bevestigen

Gebruik de service account sleutel om je te authenticeren met de BigQuery CLI of API en voer een eenvoudige query uit:

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

4.3 Controleer de rechten op elke dataset

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 Optioneel: Valideer aanmaak/leesbewerkingen

-- Test aanmaken 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;

Tip: Voer deze controles uit met dezelfde service account en sleutel die je gaat verstrekken aan Klaviyo. Bewaar een kopie van de resultaten voor controle.

5) Klaviyo verbinden met BigQuery

Zodra je BigQuery omgeving is geconfigureerd, voltooi je de verbinding in Klaviyo.

1. Navigeer in Klaviyo naar Geavanceerd → Synchroniseren in de linker zijbalk.
2. Klik op Synchronisatie maken.
3. Selecteer Gegevens importeren of exporteren naar je datawarehouse.
4. Kies BigQuery als je datawarehouse.
5. Klik op Verbinden met BigQuery.

Geef de volgende verbindingsconfiguratiegegevens op wanneer daarom wordt gevraagd:

Nadat u verbinding hebt gemaakt: Klaviyo zal de verbinding valideren, de toegang tot je datasets testen en je vervolgens toestaan om syncs te configureren - voor zowel het importeren van gegevens in Klaviyo als het exporteren van Klaviyo gegevens naar BigQuery.

Volgende stap: Na een succesvolle verbinding, maak je je eerste import of export sync in Klaviyo en begin je met het verplaatsen van gegevens van of naar BigQuery.