Installation och anslutning av miljö

Översikt: Följ dessa steg för att förbereda BigQuery för Klaviyo. Du skapar nödvändiga scheman (i ett dataset/projekt), konfigurerar ett konto och en nyckel för en dedikerad tjänst, tilldelar minimikraven på behörigheter, verifierar konfigurationen och ansluter BigQuery till Klaviyo.

För detaljer om hur import av datalager fungerar i Klaviyo- inklusive schemastruktur, obligatoriska tabeller och fältmappningar - se Hur import av datalager fungerar Klaviyo i.

1) Skapa nödvändiga scheman / dataset

I BigQuery skapar du två dataset i det projekt som du kommer att använda för Klaviyo.

SKAPA SCHEMA `KLAVIYO_IMPORT_FROM_DWH`;
SKAPA SCHEMA `KLAVIYO_TMP`;

• KLAVIYO_IMPORT_FROM_DWH: Tabeller och vyer som skapas i denna datauppsättning kommer att vara tillgängliga för Klaviyo att läsa/skriva.
• KLAVIYO_TMP: Tillfälliga data som används under synkroniseringsoperationer.

2) Skapa Klaviyo Service Konto och nyckel

Skapa en Google-tjänst Konto (t.ex. KLAVIYO_DATA_TRANSFER_USER) som Klaviyo kommer att använda exklusivt för denna integrerare. Ladda ner en JSON-nyckel för det här kontot och förvara den på ett säkert sätt.

• Gå till IAM & Administratör → Service Konto i GCP Console.
• Skapa en ny tjänst Konto (eller välj en befintlig tjänst som är avsedd för Klaviyo).
• På fliken Keys 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 nödvändiga behörigheter

Ge tjänsten Konto följande roller, som är begränsade till de två dataset som du skapade:

-- Exempel på kommandon i GCP CLI (ersätt platshållare):
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 installation (valfritt)

4.1 Bekräfta att dataseten 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 tjänsten Konto åtkomst

Använd tjänstens Konto-nyckel för att autentisera dig med BigQuery CLI eller API och kör 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örigheterna för varje 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 Valfritt: Validera skapande/läsning

-- Test skapa i KLAVIYO_TMP
CREATE TABLE `DITT_PROJEKT_ID.KLAVIYO_TMP.test_permissions` (id INT64);
DROP TABLE `YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions`;

-- Testa select i KLAVIYO_IMPORT_FROM_DWH
SELECT * FROM `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_existing_table` LIMIT 1;

Tips och råd: Kör dessa kontroller med samma servicekonto och nyckel som du kommer att tillhandahålla till Klaviyo. Spara en kopia av resultaten för revision.

5) Anslut Klaviyo till BigQuery

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

1. I Klaviyo navigerar 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 information om anslutningskonfigurationen:

Efter att du har anslutit: Klaviyo validerar anslutningen, testar åtkomst till dina dataset och låter dig sedan konfigurera synkroniseringar - för både import av data till Klaviyo och export av Klaviyo-data till BigQuery.

Nästa steg: När du har anslutit framgångsrikt kan du skapa din första import- eller exportsynkronisering i Klaviyo och börja flytta data till eller från BigQuery.