Configurazione dell'ambiente e connessione

Panoramica: segui questi passaggi per preparare BigQuery per Klaviyo. Creerai gli schemi richiesti (in un set di dati/progetto), configurerai un account di servizio e una chiave dedicati, assegnerai i privilegi minimi richiesti, verificherai la configurazione e collegherai BigQuery a Klaviyo.

Per informazioni su come funziona l'importazione del magazzino dati in Klaviyo, inclusi la struttura dello schema, le tabelle richieste e le mappature dei campi, vedi Come funzionano le importazioni del magazzino dati in Klaviyo.

1) Crea schemi/dataset richiesti

In BigQuery, crea due set di dati nel progetto che userai per Klaviyo.

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

• KLAVIYO_IMPORT_FROM_DWH: le tabelle e le visualizzazioni create in questo set di dati saranno disponibili per la lettura/scrittura da parte di Klaviyo.
• KLAVIYO_TMP: dati temporanei o di staging usati durante le operazioni di sincronizzazione.

2) Crea l’account e la chiave del Klaviyo Service

Crea un account di servizio Google (ad es. KLAVIYO_DATA_TRANSFER_USER) che Klaviyo utilizzerà esclusivamente per questa integrazione. Scarica una chiave JSON per questo account e conservala in modo sicuro.

• Vai a IAM e Amministratore → Account di servizio nella Console GCP.
• Crea un nuovo account di servizio (o selezionane uno esistente dedicato a Klaviyo).
• Nella scheda Chiavi, crea una nuova chiave di tipo JSON. Conserva questo file della chiave in un luogo sicuro: ti servirà quando configuri la connessione in Klaviyo.

3) Assegna le autorizzazioni richieste

Concedi all'account di servizio i seguenti ruoli, con ambito limitato ai due set di dati che hai creato:

-- 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) Verifica la configurazione (facoltativo)

4.1 Conferma che i set di dati esistono

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

4.2 Conferma l'accesso all'account di servizio

Usa la chiave dell’account di servizio per autenticarti con la CLI o l’API di BigQuery ed eseguire una query semplice:

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 Controlla le autorizzazioni su ogni set di dati

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 Facoltativo: convalidare le operazioni di creazione/lettura

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

Suggerimento: esegui questi controlli utilizzando lo stesso account di servizio e la stessa chiave che fornirai a Klaviyo. Conserva una copia dei risultati per gli audit.

5) Collega Klaviyo a BigQuery

Una volta configurato l'ambiente BigQuery, completa la connessione in Klaviyo.

1. In Klaviyo, vai su Avanzate → Sincronizzazione nella barra laterale sinistra.
2. Clicca su Crea sincronizzazione.
3. Seleziona Importa o esporta i dati nel tuo magazzino dati.
4. Scegli BigQuery come magazzino dati.
5. Fai clic su Connetti a BigQuery.

Quando richiesto, fornisci i seguenti dettagli di configurazione della connessione:

Dopo la connessione: Klaviyo convaliderà la connessione, testerà l'accesso ai tuoi set di dati e poi ti consentirà di configurare le sincronizzazioni, sia per importare dati in Klaviyo sia per esportare i dati di Klaviyo in BigQuery.

Passaggio successivo: dopo aver effettuato la connessione correttamente, crea la tua prima sincronizzazione di importazione o esportazione in Klaviyo e inizia a spostare i dati da o verso BigQuery.