Miljökonfiguration och anslutning

Översikt: Följ dessa steg för att förbereda BigQuery för Klaviyo. Du skapar obligatoriska scheman (i en dataset/projekt), konfigurerar ett dedikerat tjänstekonto och en nyckel, tilldelar de minsta privilegier som krävs, verifierar konfigurationen och ansluter BigQuery till Klaviyo.

Mer information om hur import av datalager fungerar i Klaviyo – inklusive schemastruktur, obligatoriska tabeller och fältmappningar – finns i Så fungerar import av datalager i Klaviyo.

1) Skapa obligatoriska scheman/dataset

I BigQuery skapar du två datamängder i projektet som du ska använda för Klaviyo.

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

• KLAVIYO_IMPORT_FROM_DWH: tabeller och vyer som skapas i den här datauppsättningen kommer att vara tillgängliga för Klaviyo att läsa/skriva.
• KLAVIYO_TMP: Tillfälliga data eller stagingdata som används under synkroniseringsåtgärder.

2) Skapa Klaviyo Service-kontot och nyckeln

Skapa ett Google-tjänstkonto (t.ex. KLAVIYO_DATA_TRANSFER_USER) som Klaviyo kommer att använda exklusivt för den här integreringen. Ladda ner en JSON-nyckel för det här kontot och lagra den säkert.

• Gå till IAM & Administratör → Tjänstekonton i GCP Console.
• Skapa ett nytt tjänstekonto (eller välj ett befintligt som är dedikerat till Klaviyo).
• På fliken Nycklar skapar du en ny nyckel av typen JSON. Förvara den här nyckelfilen säkert – du behöver den när du konfigurerar anslutningen i Klaviyo.

3) Tilldela obligatoriska behörigheter

Ge tjänstkontot följande roller, begränsade till de två datauppsättningar som du skapade:

-- 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) Verifiera din konfiguration (valfritt)

4.1 Bekräfta att dataset finns

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

4.2 Bekräfta åtkomst för tjänstekonto

Använd nyckeln för tjänstekontot för att autentisera med BigQuery CLI eller API och köra en enkel fråga:

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 Kontrollera behörigheter för varje datauppsättning

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 Valfritt: validera create/read-åtgärder

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

Tips: Kör de här kontrollerna med samma tjänstekonto och nyckel som du ska ge till Klaviyo. Spara en kopia av resultaten för granskning.

5) Anslut Klaviyo till BigQuery

När din BigQuery-miljö är konfigurerad slutför du anslutningen i Klaviyo.

1. I Klaviyo går du till Avancerat → Synkronisering i det vänstra sidofältet.
2. Klicka på Skapa synkronisering.
3. Välj Importera eller exportera data till ditt datalager.
4. Välj BigQuery som ditt datalager.
5. Klicka på Anslut till BigQuery.

När du uppmanas att göra det anger du följande anslutningskonfigurationsuppgifter:

När du har anslutit: Klaviyo validerar anslutningen, testar åtkomst till dina dataset och låter dig sedan konfigurera synkroniseringar – både för att importera data till Klaviyo och exportera Klaviyo-data till BigQuery.

Nästa steg: När anslutningen har lyckats skapar du din första import- eller exportsynk i Klaviyo och börjar flytta data till eller från BigQuery.