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:

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

1. En Klaviyo, ve a Advanced → Syncing (Sincronización avanzada) en la barra lateral izquierda.
2. Haz clic en Crear sincronización.
3. Selecciona Importar o exportar datos a tu almacén de datos.
4. Elige BigQuery como almacén de datos.
5. Haz clic en Conectarse a BigQuery.

Cuando se te pida, proporciona los siguientes detalles de configuración de la conexión:

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.