Configurazione e connessione dell'ambiente

Panoramica: segui questi passaggi per preparare BigQuery per Klaviyo. Puoi creare gli schemi richiesti (in un set di dati/progetto), impostare un account di servizio e una chiave dedicati, assegnare i privilegi minimi richiesti, verificare la configurazione e connettere BigQuery a Klaviyo.

Per i dettagli sul funzionamento delle importazioni del magazzino dati in Klaviyo, tra cui la struttura dello schema, le tabelle obbligatorie e le mappature dei campi, consulta Come funzionano le Importazioni del magazzino dati in Klaviyo.

1) Crea Gli Schemi/Set Di Dati Richiesti

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

CREA LO SCHEMA `KLAVIYO_IMPORT_FROM_DWH`; CREA LO SCHEMA `KLAVIYO_TMP`;

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

2) Crea l'account e la chiave 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 agli account IAM e Amministratore → Service 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. Mantieni sicuro questo file chiave: ne avrai bisogno quando configuri la connessione in Klaviyo.

3) Assegna Le Autorizzazioni Richieste

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

-- Esempi di comandi nella CLI GCP (sostituisci i segnaposto): 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" progetti gcloud add-iam-policy-binding YOUR_PROJECT_ID \ --member="serviceAccount:KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com" \ --role="roles/bigquery.dataViewer" \ --condition=Nessuno \ --dataset="KLAVIYO_IMPORT_FROM_DWH"

4) Verifica La Tua Configurazione (Facoltativo)

4.1 Verifica l'esistenza dei set di dati

SELEZIONA schema_name DA `YOUR_PROJECT_ID.INFORMATION_SCHEMA.SCHEMATA` DOVE schema_name IN ('KLAVIYO_IMPORT_FROM_DWH','KLAVIYO_TMP');

4.2 Conferma l'accesso all'account di servizio

Utilizza la chiave dell'account di servizio per effettuare l'autenticazione con BigQuery CLI o API ed eseguire una semplice query:

bq --project_id=YOUR_PROJECT_ID \ --dataset_id=KLAVIYO_IMPORT_FROM_DWH \ query --use_legacy_sql=false \ 'SELEZIONA CONTEGGIO(*) DA `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.some_table` LIMIT 1'

4.3 Controlla le autorizzazioni su ogni set di dati

SELEZIONA * DA `YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES` DOVE GRANTEE = 'KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com';

4.4 Facoltativo: convalida delle operazioni di creazione/lettura

-- Crea test in KLAVIYO_TMP CREA TABELLA `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;

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

5) Connetti Klaviyo a BigQuery

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

1. In Klaviyo, vai su Advanced → Syncing (Sincronizzazione avanzata) nella barra laterale sinistra.
2. Fai clic 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, fornire i seguenti dettagli di configurazione della connessione:

Dopo la connessione: Klaviyo convalida la connessione, testa l'accesso ai tuoi set di dati e poi ti consente di configurare le sincronizzazioni, sia per l'importazione dei dati in Klaviyo che per l'esportazione dei dati di Klaviyo in BigQuery.

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