La Plataforma de Datos Avanzada Klaviyo no está incluida en la aplicación de marketing estándar de Klaviyo, y se requiere una suscripción para acceder a la funcionalidad asociada. Visita nuestra guía de facturación para saber cómo contratar este plan.
Configuración y conexión del entorno
Resumen: sigue estos pasos para preparar BigQuery para Klaviyo. Crearás los esquemas necesarios (en un conjunto de datos o proyecto), configurarás una cuenta de servicio y una clave dedicadas, asignarás los privilegios mínimos necesarios, verificarás la configuración y conectarás BigQuery a Klaviyo.
Para obtener más información sobre cómo funciona la Importación de almacén de datos en Klaviyo, incluida la estructura del esquema, las tablas obligatorias y las asignaciones de campos, consulta Cómo funcionan las Importaciones de almacén de datos en Klaviyo.
1) Crear Esquemas Y Conjuntos De Datos Obligatorios
En BigQuery, crea dos conjuntos de datos en el proyecto que utilizarás para Klaviyo.
CREAR ESQUEMA «KLAVIYO_IMPORT_FROM_DWH»; CREAR ESQUEMA «KLAVIYO_TMP»;
-
KLAVIYO_IMPORT_FROM_DWH: las tablas y vistas creadas en este conjunto de datos estarán disponibles para que Klaviyo las lea o escriba. -
KLAVIYO_TMP: datos temporales o de almacenamiento provisional utilizados durante las operaciones de sincronización.
2) Crea la cuenta y la clave de Klaviyo Service
Crea una cuenta de servicio de Google (por ejemplo KLAVIYO_DATA_TRANSFER_USER) que Klaviyo utilizará exclusivamente para esta integración. Descarga una clave JSON para esta cuenta y guárdala de forma segura.
- Dirígete a IAM y Administrador → Cuentas de servicio en la consola de GCP.
- Crea una cuenta de servicio (o selecciona una existente dedicada a Klaviyo).
- En la pestaña Claves, crea una nueva clave de tipo JSON. Mantén este archivo clave a salvo: lo necesitarás al configurar la conexión en Klaviyo.
3) Asigna los permisos requeridos
Concede a la cuenta de servicio los siguientes roles, con el alcance de los dos conjuntos de datos que has creado:
| Conjunto de datos | Roles mínimos requeridos | Descripción |
|---|---|---|
KLAVIYO_TMP |
Editor de datos de BigQuery + Usuario de trabajo de BigQuery
|
Permite a Klaviyo crear y gestionar tablas temporales, trabajos, etc. |
KLAVIYO_IMPORT_FROM_DWH |
Visor de datos de BigQuery + usuario de trabajo de BigQuery
|
Permite a Klaviyo leer desde tus tablas. |
-- Ejemplos de comandos en GCP CLI (reemplazar marcadores de posición): gcloud proyecta 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 proyecta 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 tu configuración (opcional)
4.1 Confirma que los conjuntos de datos existan
SELECCIONA schema_name EN «TU_PROYECTO_ID.INFORMACIÓN_ESQUEMA.ESQUEMA» DONDE schema_name EN ('KLAVIYO_IMPORT_FROM_DWH','KLAVIYO_TMP');
4.2 Confirma el acceso a la cuenta de servicio
Usa la clave de la cuenta de servicio para autenticarte con la CLI o API de BigQuery y haz una consulta sencilla:
bq --project_id=YOUR_PROJECT_ID \ --dataset_id=KLAVIYO_IMPORT_FROM_DWH \ query --use_legacy_sql=false \ 'SELECCIONAR RECUENTO(*) DE `TU_PROYECTO_ID.KLAVIYO_IMPORT_FROM_DWH.some_table` LÍMITE 1'
4.3 Comprueba los permisos de cada conjunto de datos
SELECCIONA * DE «YOUR_PROJECT_ID.KLAVIYO_IMPORT_FROM_DWH.INFORMATION_SCHEMA.OBJECT_PRIVILEGES» DONDE «grantee» = »KLAVIYO_DATA_TRANSFER_USER@YOUR_PROJECT_ID.iam.gserviceaccount.com»;
4.4 Opcional: valida las operaciones de creación/lectura
-- Prueba create en KLAVIYO_TMP CREAR TABLA «TU_PROYECTO_ID.KLAVIYO_TMP.test_permissions» (id INT64); SUELTA LA TABLA «YOUR_PROJECT_ID.KLAVIYO_TMP.test_permissions»; -- Prueba de selección en KLAVIYO_IMPORT_FROM_DWH SELECCIONAR * DE «TU_PROYECTO_ID.KLAVIYO_IMPORT_FROM_DWH.some_existing_table» LÍMITE 1;
Consejo: ejecuta estas comprobaciones con la misma cuenta de servicio y clave que proporcionarás a Klaviyo. Guarda una copia de los resultados para la auditoría.
5) Conecta Klaviyo con BigQuery
Una vez que hayas configurado tu entorno de BigQuery, completa la conexión en Klaviyo.
- En Klaviyo, ve a Advanced → Syncing (Sincronización avanzada) en la barra lateral izquierda.
- Haz clic en Crear sincronización.
- Selecciona Importar o exportar datos a tu almacén de datos.
- Elige BigQuery como almacén de datos.
- Haz clic en Conectarse a BigQuery.
Cuando se te pida, proporciona los siguientes detalles de configuración de la conexión:
| Campo | Descripción | Dónde encontrarlo |
|---|---|---|
| ID del proyecto | Tu ID de proyecto de Google Cloud. | Se encuentra en la consola de GCP, en la parte superior de la página del proyecto. |
| Conjunto de datos | El conjunto de datos (esquema) que contiene tus tablas de Klaviyo (por ejemplo, KLAVIYO_IMPORT_FROM_DWH). |
Usa el conjunto de datos que creaste en el paso 1. Selecciona ese conjunto de datos al configurar la conexión. |
| Clave de cuenta de servicio (JSON) | El archivo de clave JSON que descargaste para la cuenta de servicio. | Sube o pega el contenido del archivo de clave JSON que creaste en el paso 2. |
Después de conectarte: Klaviyo validará la conexión, probará el acceso a tus conjuntos de datos y te permitirá configurar sincronizaciones, tanto para importar datos a Klaviyo como para exportar los datos de Klaviyo a BigQuery.
Siguiente paso: después de conectarte correctamente, crea tu primera sincronización de importación o exportación en Klaviyo y empieza a mover datos hacia o desde BigQuery.