La piattaforma dati avanzata Klaviyo non è inclusa nell'applicazione di marketing standard di Klaviyoe per accedere alle funzionalità associate è necessario un abbonamento. Visita la nostra guida alla fatturazione per scoprire come acquistare questo piano.
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:
| Set di dati | Ruoli minimi obbligatori | Descrizione |
|---|---|---|
KLAVIYO_TMP |
Editor di dati BigQuery + utente del processo BigQuery
|
Consente a Klaviyo di creare e gestire tabelle, processi temporanei e così via. |
IMPORTAZIONE DA KLAVIYO DWH |
Visualizzatore dati BigQuery + Utente processo BigQuery
|
Consente a Klaviyo di leggere dalle tue tabelle. |
-- 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.
- In Klaviyo, vai su Advanced → Syncing (Sincronizzazione avanzata) nella barra laterale sinistra.
- Fai clic su Crea sincronizzazione.
- Seleziona Importa o esporta i dati nel tuo magazzino dati.
- Scegli BigQuery come magazzino dati.
- Fai clic su Connetti a BigQuery.
Quando richiesto, fornire i seguenti dettagli di configurazione della connessione:
| Campo | Descrizione | Dove trovarlo |
|---|---|---|
| ID del progetto | Il tuo ID del progetto Google Cloud. | Si trova nella console GCP nella parte superiore della pagina del progetto. |
| Set di dati | Il set di dati (schema) contenente le tue tabelle Klaviyo (ad esempio, KLAVIYO_IMPORT_FROM_DWH). |
Utilizza il set di dati che hai creato nel passaggio 1. Seleziona quel set di dati durante la configurazione della connessione. |
| Chiave dell'account di servizio (JSON) | Il file di chiave JSON che hai scaricato per l'account di servizio. | Carica o incolla il contenuto del file di chiave JSON che hai creato nel Passaggio 2. |
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.