Comprender la sincronización del almacén de datos en Klaviyo
Objetivos del artículo
Aprende a sincronizar datos de Klaviyo con tu almacén de datos, y a importar datos del almacén a Klaviyo mediante SFTP. Puedes sincronizar tu perfil del cliente y los datos de tus eventos, lo que te permite almacenar, comercializar y analizar información clave sobre tu cliente fuera de Klaviyo.
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.
Antes de empezar
Tendrás que asegurarte de que el almacén de datos con el que te conectas está configurado como destino. Para asegurarte de que lo has configurado correctamente:
- Asegúrese de que el usuario que se proporciona a Klaviyo tiene los permisos adecuados.
- Asegúrate de establecer las tablas con los nombres adecuados, que se muestran a continuación, en función de tu almacén.
Además, asegúrate de que la lista de (entes, sitios, etc.) permitidos Klaviyo's outbound almacén de datos traffic IP addresses. Esto garantizará que las peticiones de Klaviyo no sean bloqueadas por tu capa de seguridad. Estas direcciones están representadas por los siguientes rangos CIDR:
184.72.183.187/3252.206.71.52/323.227.146.32/3244.198.39.11/3235.172.58.121/323.228.37.244/3254.88.219.8/323.214.211.176/32
Conectar con un almacén de datos
Para añadir una conexión de almacén de datos a Klaviyo, navega hasta Gestión avanzada de la plataforma de datos Klaviyo > > Sincronización.
Para añadir un almacén de datos, seleccione un almacén de datos compatible en el modal Seleccione un conector.
Sólo puedes tener 1 destino de almacén de datos por cuenta.
También puede seleccionar su almacén de datos en el mercado de aplicaciones de Klaviyo, en Integrations (Integraciones) > Explore apps (Explorar aplicaciones) y busque su plataforma.
Al conectar un almacén, puedes importar datos de tu almacén de datos a Klaviyo, o establecer un almacén como destino de sincronización saliente.
Importar datos a través de SFTP
Si desea importar datos de su almacén de datos a Klaviyo, puede hacerlo a través de SFTP.
Para importar tus datos en Klaviyo, selecciona importar datos cuando conectes por primera vez un almacén de destino, o haz clic en el botón importar de la página de sincronización de datos si ya tienes una conexión establecida.
El proceso para importar los datos del almacén a Klaviyo es el siguiente:
- Exporta los datos que desees de tu almacén de datos.
- Genera clave SSH en tu máquina local.
- Configura el cliente SFTP e importa.
Esto se demuestra con Snowflake, pero el proceso de importación es similar independientemente de las integraciones de tu almacén.
Exporta tu base de datos
En primer lugar, tendrás que exportar los datos de tu almacén. Accede a tu almacén y exporta los datos que quieras importar a Klaviyo a un archivo CSV.
Dé formato a los datos exportados según el formato CSV y las limitaciones de tamaño.
Genera claves SSH en tu equipo local
Una vez que tengas los datos deseados exportados desde tu almacén, genera una nueva clave SSH en tu máquina local y añádela a Klaviyo seleccionando el botón Añadir clave SSH.
Cuando añada su clave, asegúrese de que empieza por 1 de los siguientes:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-ssh
Configurar el cliente SFTP e importar
Una vez que tu clave SSH se haya añadido correctamente a Klaviyo, tendrás que configurar tu cliente SFTP e importar los datos.
- Abra su cliente SFTP y configure una nueva conexión con las credenciales presentadas en Klaviyo Verá las credenciales presentadas después de añadir correctamente su clave SSH
- Una vez autenticado, asegúrese de que su base de datos sigue las directrices recomendadas antes de importar
- Cargue su archivo de base de datos a través de su cliente SFTP y revise
También verás una vista de lista de tus importaciones recientes con la siguiente información:
-
Estado
Completado o incompleto. -
Filas procesadas
Porcentaje del total de filas procesadas hasta el momento. -
importar fecha
Fecha de importación. -
Importado por
Usuario que importó los datos.
Exporta datos a tu almacén
Para configurar tu almacén de datos como destino, necesitarás el siguiente conjunto de información y credenciales para cada almacén de datos.
Amazon Redshift
Para configurar Amazon Redshift como destino, ejecuta el siguiente script para crear las tablas klaviyo_event y klaviyo_profile.
Una vez configurado como destino, conecta tu almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: El nombre de tu base de datos en Redshift (se recomienda utilizar el mismo nombre que tu base de datos en Redshift)
- URL del host: El punto de conexión del servidor de Amazon Redshift (llamado URL de conexión en Redshift)
- Base de datos: El nombre para identificar tu fuente de datos
- Puerto: El número de puerto utilizado por Redshift
- Esquema: El esquema de tu base de datos
- Nombre de usuario: El nombre de usuario utilizado para iniciar sesión en Redshift
-
Contraseña de la base de datos: La contraseña utilizada para iniciar sesión en Redshift
Amazon S3
Para configurar Amazon S3 como destino, establece los nombres de las tablas como klaviyo_profile y klaviyo_event.
Una vez configurado como destino, conecta tu almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: El nombre legible por máquina de la base de datos de Amazon S3.
- Cubo: El nombre de tu cubo.
- Ubicación del cubo: El nombre de la región que se eligió al crear el cubo de almacenamiento.
- ID de la clave de acceso: Tu ID de la clave de acceso de AWS.
-
Clave de acceso secreta: Tu clave de acceso secreta de AWS.
Google BigQuery
Para configurar Google BigQuery como destino, ejecuta el siguiente script para configurar las tablas klaviyo_profile y klaviyo_event . Tu cuenta de Google BigQuery debe tener un perfil de pago para que el proceso de conexión se realice correctamente.
Ten en cuenta que en este script debes sustituir el marcador de posición "SERVICE cuenta correo electrónico" por tu servicio BigQuery cuenta correo electrónico.
Una vez configurado como destino, conecta tu almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: Un nombre que te ayude a identificar este destino
- ID del proyecto: Se conoce como ID del proyecto y lo puedes encontrar en tu consola de interfaz de programación de aplicaciones (API).
- Conjunto de datos: También llamado esquema. Este es el mismo nombre que utilizaste en el script que deberías haber ejecutado para la configuración.
-
Clave de la cuenta de servicio: Pega todo el contenido del archivo JSON que descargaste al crear tu cuenta de servicio en BigQuery.
Análisis de Microsoft Azure Synapse
Para configurar Microsoft Azure como destino, ejecuta el siguiente script para crear las tablas klaviyo_profile y klaviyo_event .
- Nombre: Se recomienda utilizar el mismo nombre que tu base de datos en Azure.
- Espacio de trabajo: El nombre del espacio de trabajo de Azure Synapse.
- Nombre de la base de datos: Identifica tu base de datos del Grupo SQL Dedicado.
- Nombre de usuario: Tu nombre de usuario para acceder a la base de datos de tu Grupo SQL Dedicado.
- Contraseña de la basede datos:Tu contraseña de acceso a la base de datos de tu Grupo SQL Dedicado.
- Nombre de cuenta: Tu cuenta de almacenamiento de Windows Azure, o prefijo DNS que hayas creado.
- Firma de acceso: Tu cadena de firma de acceso compartido (SAS) que prueba el acceso al contenedor de Almacenamiento de Blobs.
-
Nombre del contenedor: El nombre del contenedor Azure Blob para el área de almacenamiento temporal para la transferencia de datos.
Snowflake
Para configurar Snowflake como destino, sigue estos pasos:
1. Genera una clave privada ejecutando el siguiente comando en tu terminal:
openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out rsa_key.p8 -nocrypt
2. Genera una clave pública que haga referencia a la clave privada ejecutando el siguiente comando en tu terminal:
openssl rsa -in clave_rsa.p8 -pubout -out clave_rsa.pub
3. Ejecuta el siguiente script para configurar las tablas KLAVIYO_PROFILE, KLAVIYO_EVENT y KLAVIYO_METRIC. Debes tener privilegios de securityadmin y sysadmin para poder completar la configuración que se indica a continuación. Para revisar qué rol(es) tienes, ejecuta SHOW GRANTS TO USER <your_username> y asegúrate de que tienes ambos roles en la lista. acude a un administrador del sistema si necesitas que ajusten tu función.
Una vez configurado como destino, conecta tu almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: Se recomienda utilizar el mismo nombre que tu base de datos en Snowflake.
-
Nombre de usuario: Nombre de usuario para conectarte a tu base de datos. Debe ser el mismo que nombre_usuario en el script de configuración.
-
Clave privada: La clave privada Snowflake generada.
- Almacén: Tu almacén en Copo de Nieve.
- cuenta: Tu cuenta en Copo de Nieve.
- Base de datos: El nombre de tu base de datos. Debe ser el mismo que nombre_base_de_datos en el script de configuración.
-
Esquema: El esquema de tu base de datos. Debe ser el mismo que nombre_esquema en el script de configuración.
Tras introducir tus credenciales para el almacén de datos con el que vas a sincronizar, elige los datos que quieres sincronizar desde Klaviyo.
Objetos de datosObjetos de datos
En la sección de objetos de datos puedes elegir sincronizar todos los datos del perfil, sólo datos de eventos específicos, o ambos tipos de datos marcando la(s) casilla(s) correspondiente(s) junto a cada opción.
Klaviyo utiliza una estructura JSON anidada cuando envía datos a su almacén de datos. El perfil y los eventos se envían como una única tabla, lo que te permite consultar 1 tabla en lugar de un gran número de posibles nombres de tabla en tu almacén de datos.
Sincronizar todos los datos de Klaviyo puede hacerte incurrir en cargos adicionales de tu almacén de datos.
Integraciones para excluir
En el campo integraciones a excluir, puedes seleccionar las integraciones concretas que quieras excluir en la sincronización del almacén de datos. Esto es útil si quieres evitar que se sincronicen también los datos de una integración concreta que ya tengas conectada a Klaviyo.
Excluir datos de integraciones específicas es sólo para datos de eventos, y no excluye datos del perfil.
Sincronización selectiva
En el campo Sincronización selectiva , selecciona los eventos concretos que quieres sincronizar con tu almacén de datos desde Klaviyo. Por defecto, se incluyen todos los eventos. Cuando configures eventos específicos para que se sincronicen con este campo, sólo se sincronizarán los eventos seleccionados.
Este campo sólo aparecerá si seleccionas el objeto de datos Eventos .
Selecciona la frecuencia de sincronización de datos
El valor establecido para el campo Cadencia de sincronización periódica en la sección llamada Selecciona la frecuencia con la que se sincronizarán tus datos define la frecuencia con la que se producirá una sincronización desde Klaviyo a tu almacén de datos.
La cadencia de sincronización periódica está establecida por defecto en cada hora y no se puede cambiar.
Selecciona cuántos datos históricos quieres sincronizar
En la sección Selecciona cuántos datos históricos quieres sincronizar , puedes definir cuántos datos históricos quieres sincronizar desde Klaviyo a tu almacén de datos durante la conexión inicial. Puedes elegir:
- 30 días
- 90 días
- 1 año
- Todos los tiempos
Puedes incurrir en costes adicionales de tu almacén de datos si sincronizas una gran cantidad de datos a la vez.
Revisión de Sync
Una vez que hayas conectado tus integraciones, si la configuración se ha realizado correctamente, verás una pantalla final en la que se indica que la conexión está Activada, junto con:
- Detalles de la sincronización que ha configurado
- Qué datos se comparten (perfiles, eventos o ambos)
- Cualquier integración excluida
Si tu sincronización no se conectó correctamente, verás el estado No se pudo conectar, junto con opciones para reintentar la conexión o editar la información de tus credenciales.
Una vez que hayas conectado correctamente tu almacén de datos, volverás a la página principal de la lista Sincronización de datos. Aquí verás tus:
- Destino del almacén
- El estado Activado
- Cualquier error potencial que pueda haber ocurrido con su sincronización en las últimas 24 horas
- La última sincronización que se produjo junto con una marca de tiempo de este evento
Dado que sólo podrá conectar 1 destino, sólo verá reflejado 1 destino en esta vista de lista.
panel de sincronización de datospanel de sincronización de datos
Cuando la conexión se haya establecido correctamente, haz clic en tus integraciones en la página de la lista de sincronización de datos. Desde aquí accederás al panel de sincronización de datos que proporciona información histórica y actual sobre las sincronizaciones de datos que se han ejecutado.
Aquí verás la información de sincronización dividida en 2 pestañas:
- Históricas
- Periódicas
Histórico
La pestaña Histórico tiene registros que muestran el estado de tus sincronizaciones de datos históricos. Las sincronizaciones históricas se refieren a la sincronización de tus datos existentes desde Klaviyo a tu almacén de datos cuando estableces una conexión.
Verás la siguiente información para cada sincronización:
-
Nombre
Los datos se incluyen en la sincronización. -
Estado
Estado y progreso potencial de la sincronización con un porcentaje estimado o errores potenciales señalados. Estos estados podrían incluir:
-
Finalizado
Tus datos han terminado de sincronizarse para esta sincronización puntual. No se volverá a sincronizar automáticamente. -
Programado
Cuando la próxima sincronización está programada para ejecutarse automáticamente. -
En curso
Los datos se están sincronizando activamente con tu almacén de datos con un porcentaje estimado de finalización. -
Error en
Se ha producido un error, pero Klaviyo seguirá intentando restablecer la conexión. Dependiendo de las integraciones, este calendario puede variar ligeramente. -
Fallido
La sincronización falló completamente incluso después de intentar restablecer la conexión. Esto significa que tendrás que revisar los ajustes de configuración o incluso la configuración del almacén de datos. -
Pausado
Has pausado la sincronización manualmente. -
desactivar/inhabilitar
La sincronización se desactivó/inhabilitó porque la propia integraciones se desactivó/inhabilitó o eliminó.
-
Finalizado
-
Comenzó el
Hora de inicio de la sincronización. -
Finalizó en
Hora de finalización de la sincronización.
Periódicas
La pestaña Periódico tiene registros que muestran el estado de tus sincronizaciones periódicas. A medida que el cliente siga interactuando con tu marca y se creen nuevos datos, se enviarán rutinariamente a tu almacén de datos. Al configurar una conexión de almacén de datos, las sincronizaciones periódicas se producirán cada hora.
Verás la siguiente información para cada sincronización:
-
Nombre
Los datos se incluyen en la sincronización. -
Estado
Estado y progreso potencial de la sincronización con un porcentaje estimado o errores potenciales señalados. Estos estados podrían incluir:
-
Finalizado
Tus datos han terminado de sincronizarse para esta sincronización puntual. No se volverá a sincronizar automáticamente. -
Programado
Cuando la próxima sincronización está programada para ejecutarse automáticamente. -
En curso
Los datos se están sincronizando activamente con tu almacén de datos con un porcentaje estimado de finalización. -
Error en
Se ha producido un error, pero Klaviyo seguirá intentando restablecer la conexión. Dependiendo de las integraciones, este calendario puede variar ligeramente. -
Fallido
La sincronización falló completamente incluso después de intentar restablecer la conexión. Esto significa que tendrás que revisar los ajustes de configuración o incluso la configuración del almacén de datos. -
Pausado
Has pausado la sincronización manualmente. -
desactivar/inhabilitar
La sincronización se desactivó/inhabilitó porque la propia integraciones se desactivó/inhabilitó o eliminó.
-
Finalizado
-
frescura de los datos
La frescura de los datos se refiere a lo actualizados que están tus datos. Por ejemplo, si una sincronización tiene una frescura de 2 minutos, esto significa que cualquier dato nuevo creado en Klaviyo en los últimos 2 minutos aún no está en tu almacén de datos. - Botones para Pausar, Reanudar y volver a activar sincronizaciones individuales.
Eliminar conexiones del almacén de datos
Para eliminar una conexión de almacén de datos de su cuenta de Klaviyo, seleccione la pestaña Integraciones.
Abra el menú junto a la integración de su almacén de datos y seleccione Eliminar integración para eliminar la conexión.
Ver registros de errores
Si tienes problemas con la sincronización de datos entre Klaviyo y tu almacén de datos, consultar los registros de errores asociados puede proporcionarte información adicional sobre la causa del problema.
Para ver los errores, haz clic en el destino de tu almacén en la página Sincronización. Tanto en la pestaña de Sincronización Histórica como en la de Sincronización Periódica verás una lista de las exportaciones y su estado, junto con un indicador que muestra si hay algún error con actividad.
Para ver más detalles sobre un error concreto, haz clic en la exportación que experimenta el fallo.
Aquí verás una cronología de las sincronizaciones salientes, junto con un mensaje de error o de éxito según el estado de la sincronización.
Al hacer clic en un error concreto, se abrirá un cajón con la siguiente información:
-
Resumen
Una breve descripción del error devuelto por el almacén de datos -
Código
El código del error -
Mensaje externo
El mensaje de error real devuelto por el almacén de datos -
Fecha
La fecha y hora del error
Recursos adicionales
Comprender cómo se intercambia la información entre Klaviyo y las apps
Comprender los tipos de información intercambiada entre Klaviyo y las apps