Qué aprenderás
Aprenda a sincronizar los datos de Klaviyo con su almacén de datos y a importar los datos del almacén a Klaviyo a través de SFTP. Puede sincronizar su perfilado de clientes y los datos de sus eventos, lo que le permitirá negociar y analizar información clave sobre sus clientes fuera de Klaviyo.
La Plataforma de Datos Avanzada Klaviyo y Klaviyo Marketing Analytics no están incluidas en la aplicación de marketing estándar de Klaviyo, y se requiere una suscripción para acceder a la funcionalidad asociada. Dirígete a nuestra guía de facturación para saber cómo adquirir este plan.
Antes de empezar
Deberá asegurarse de que el almacén de datos con el que se conecta está configurado como destino. Para asegurarse de que lo ha configurado correctamente:
- Asegúrese de que el usuario que se proporciona a Klaviyo tiene los permisos adecuados
- Asegúrese de establecer las tablas con los nombres adecuados, que se muestran a continuación, en función de su almacén.
Además, asegúrese de incluir en la lista las direcciones IP del tráfico saliente del almacén de datos de Klaviyo. Esto asegurará que las peticiones de Klaviyo no sean bloqueadas por su 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
Conectarse a 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, pulse el botón Nueva conexión .
- En el modal Seleccione un destino , seleccione un almacén de datos compatible para conectar con Klaviyo.
Sólo puede tener 1 destino de almacén de datos por cuenta.
Alternativamente, puede seleccionar su almacén de datos del directorio de integración de Klaviyo yendo a Cuenta > Integración.
Al conectar un almacén, puede importar datos de su 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 sus datos en Klaviyo, seleccione importar datos cuando conecte por primera vez un almacén de destino, o haga clic en el botón importar de la página Sincronización de datos si ya tiene una conexión establecida.
El proceso para importar los datos del almacén a Klaviyo es el siguiente:
- Exporte los datos deseados desde su almacén de datos.
- Genere clave SSH en su máquina local.
- Configure el cliente SFTP e impórtelo.
Esto se demuestra con Snowflake, pero el proceso de importación es similar independientemente de la integración de su almacén.
Exporte su base de datos
En primer lugar, tendrá que exportar los datos de su almacén. Acceda a su almacén y exporte los datos que desea importar a Klaviyo a un archivo CSV.
Dé formato a los datos exportados según el formato CSV y las limitaciones de tamaño.
Generar clave SSH en su máquina local
Una vez que haya exportado los datos deseados de su almacén, genere una nueva clave SSH en su máquina local y añádala a Klaviyo seleccionando el botón Añadir clave SSH.
Cuando añada su clave, asegúrese de que empieza por uno de los siguientes:
- Ssh-ras
- Ecdsa-sha2
- Ssh-ed
- Sk-ecdsa
- sk-ssh
Configurar cliente SFTP e importar
Una vez que su clave SSH se haya añadido correctamente a Klaviyo, tendrá que configurar su 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 tras añadir correctamente su clave SSH.
- Una vez autentificado, asegúrese de que su base de datos sigue las directrices recomendadas antes de proceder a la importación.
- Cargue su archivo de base de datos a través de su cliente SFTP y revíselo.
También verá una lista de sus 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.
Exporte datos a su almacén
Para configurar su almacén de datos como destino, necesitará el siguiente conjunto de información y credenciales para cada almacén de datos.
Amazon Redshift
Para configurar Amazon Redshift como destino, ejecute el siguiente script para crear las tablas klaviyo_event y klaviyo_profile.
Una vez configurado como destino, conecte su almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: El nombre de su base de datos en Redshift (se recomienda utilizar el mismo nombre que su base de datos en Redshift)
- URL del host: El punto final del servidor de Amazon Redshift (denominado URL de conexión en Redshift).
- Base de datos: El nombre para identificar su fuente de datos
- Puerto: El número de puerto utilizado por Redshift
- Esquema: El esquema de su 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, establezca los nombres de las tablas como klaviyo_profile y klaviyo_event.
Una vez configurado como destino, conecte su almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: El nombre legible por máquina para la base de datos de Amazon S3.
- Cubo: El nombre de su 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: Su ID de la clave de acceso de AWS.
-
Clave de acceso secreta: Su clave de acceso secreta de AWS.
Google BigQuery
Para configurar Google BigQuery como destino, ejecute el siguiente script para configurar las tablas klaviyo_profile y klaviyo_event . Su cuenta de Google BigQuery debe tener un perfil de pago para que el proceso de conexión se realice correctamente.
Tenga en cuenta que en este script debe sustituir el marcador de posición "SERVICE ACCOUNT EMAIL" por el correo electrónico de su cuenta de servicio BigQuery.
Una vez configurado como destino, conecte su almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: Un nombre que le ayude a identificar este destino
- ID del proyecto: Se conoce como ID del proyecto y se puede encontrar en su consola API.
- Conjunto de datos: También conocido como esquema. Este es el mismo nombre que utilizó en el script que debería haber ejecutado para la configuración.
-
Clave de la cuenta de servicio: Pegue todo el contenido del archivo JSON que descargó al crear su cuenta de servicio en BigQuery.
Análisis de sinapsis de Microsoft Azure
Para configurar Microsoft Azure como destino, ejecute el siguiente script para crear las tablas klaviyo_profile y klaviyo_event .
- Nombre: Se recomienda utilizar el mismo nombre que su base de datos en Azure.
- Espacio de trabajo: El nombre del espacio de trabajo de Azure Synapse.
- Nombre de la base de datos: Identifica su base de datos SQL Pool dedicada.
- Nombre de usuario: Su nombre de usuario para acceder a su base de datos SQL Pool dedicada.
- Contraseña de la basede datos:Su contraseña de inicio de sesión para su base de datos SQL Pool dedicada.
- Nombre de la cuenta: Su cuenta de almacenamiento de Windows Azure o el prefijo DNS que haya creado.
- Firma de acceso: Su cadena de firma de acceso compartido (SAS) que prueba el acceso al contenedor Blob Storage.
-
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 perfil, KLAVIYO_EVENT y métrica. 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, conecte su almacén con Klaviyo utilizando el siguiente conjunto de credenciales:
- Nombre: Se recomienda utilizar el mismo nombre que su 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: Su almacén en Copo de Nieve.
- Cuenta: Su cuenta en Snowflake.
- 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 sus credenciales para el almacén de datos con el que va a sincronizar, elija los datos que desea sincronizar desde Klaviyo.
Objetos de datosObjetos de datos
En la sección Objetos de datos puede elegir sincronizar todos los datos del perfil, sólo los 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. Los perfiles y los eventos se envían cada uno como una única tabla, lo que le permite consultar una tabla en lugar de un gran número de posibles nombres de tablas en su almacén de datos.
Sincronizar todos los datos de Klaviyo puede ocasionarle gastos adicionales de su almacén de datos.
Integraciones a excluir
En el campo Integraciones a excluir, puede seleccionar la(s) integración(es) específica(s) que desea excluir en la sincronización del almacén de datos. Esto es útil si desea eliminar los datos de una integración específica que ya haya conectado a Klaviyo para que no se sincronicen también.
La exclusión de datos de integración específicos sólo se aplica a los datos de eventos y no excluye los datos de perfil.
Sincronización selectiva
En el campo Sincronización selectiva , seleccione los eventos específicos que desea sincronizar con su almacén de datos desde Klaviyo. Por defecto, se incluyen todos los eventos. Cuando configure eventos específicos para que se sincronicen con este campo, sólo se sincronizarán los eventos seleccionados.
Este campo sólo aparecerá si selecciona el objeto de datos Eventos .
Seleccione la frecuencia con la que se sincronizarán sus datos
El valor establecido para el campo Cadencia de sincronización periódica en la sección denominada Seleccione la frecuencia con la que se sincronizarán sus datos define la frecuencia con la que se producirá una sincronización desde Klaviyo a su almacén de datos.
La cadencia de sincronización periódica está fijada por defecto en cada hora y no puede modificarse.
Seleccione cuántos datos históricos desea sincronizar
En la sección Seleccione cuántos datos históricos desea sincronizar , puede definir cuántos datos históricos desea sincronizar desde Klaviyo a su almacén de datos durante la conexión inicial. Puede elegir:
- 30 días
- 90 días
- 1 año
- Todos los tiempos
Puede incurrir en costes adicionales de su almacén de datos si sincroniza una gran cantidad de datos a la vez.
Revisión de Sync
Una vez que haya conectado su integración, si la configuración se ha realizado correctamente, verá 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 su sincronización no se conectó correctamente, verá en su lugar un estado No se pudo conectar, junto con opciones para reintentar su conexión o para editar la información de sus credenciales.
Una vez que haya conectado correctamente su almacén de datos, volverá a la página principal de la lista de sincronización de datos. Aquí verá su:
- Destino del almacén
- El estado Activado
- Cualquier error potencial que pueda haberse producido 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 un destino, sólo verá reflejado un destino en esta vista de lista.
Panel de sincronización de datosPanel de sincronización de datos
Una vez que la conexión se haya realizado correctamente, haga clic en su integración en la página de la lista de sincronización de datos. Desde aquí accederá al panel de sincronización de datos, que le proporcionará información histórica y actual sobre las sincronizaciones de datos que se han ejecutado.
Aquí verá la información de sincronización dividida en 2 pestañas:
- Histórico
- Periódico
Histórico
La pestaña Histórico tiene registros que muestran el estado de sus sincronizaciones de datos históricos. Las sincronizaciones históricas se refieren a la sincronización de sus datos existentes desde Klaviyo a su almacén de datos cuando establece una conexión.
Verá 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
Sus 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 su 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 la integración, este calendario puede variar ligeramente. -
Fallido
La sincronización falló por completo incluso después de intentar restablecer la conexión. Esto significa que tendrá que revisar los ajustes de configuración o incluso la configuración del almacén de datos. -
Pausado
Ha pausado la sincronización manualmente. -
Desactivado
La sincronización se ha desactivado porque la propia integración se ha desactivado o eliminado.
-
Finalizado
-
Comenzó el
Hora de inicio de la sincronización. -
Finalizó en
Hora de finalización de la sincronización.
Periódico
La pestaña Periódico tiene registros que muestran el estado de sus sincronizaciones periódicas. A medida que los clientes sigan interactuando con su marca y se creen nuevos datos, éstos se enviarán rutinariamente a su almacén de datos. Al configurar una conexión de almacén de datos, las sincronizaciones periódicas se producirán cada hora.
Verá 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
Sus 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 su 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 la integración, este calendario puede variar ligeramente. -
Fallido
La sincronización falló por completo incluso después de intentar restablecer la conexión. Esto significa que tendrá que revisar los ajustes de configuración o incluso la configuración del almacén de datos. -
Pausado
Ha pausado la sincronización manualmente. -
Desactivado
La sincronización se ha desactivado porque la propia integración se ha desactivado o eliminado.
-
Finalizado
-
Actualidad de los datos
La frescura de los datos se refiere a lo actualizados que están sus 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 su almacén de datos. - Botones para pausar, reanudar y volver a activar sincronizaciones individuales.
Eliminación de las conexiones del almacén de datos
Para eliminar una conexión de almacén de datos de su cuenta Klaviyo, navegue a la página Integraciones en Klaviyo desde el menú de la cuenta en la esquina inferior izquierda.
En la página Integraciones, abra el menú situado 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 está experimentando problemas con la sincronización de datos entre Klaviyo y su almacén de datos, la visualización de los registros de errores asociados puede proporcionar información adicional sobre la causa del problema.
Para ver los errores, pulse en el destino de su 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á una lista de las exportaciones y su estado, junto con un indicador que muestra si hay algún error activo.
Para ver más detalles sobre un error concreto, haga clic en la exportación que experimenta el fallo.
Aquí verá una cronología de las sincronizaciones salientes, junto con un mensaje de error o de éxito en función del 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 la hora del error.
Recursos adicionales
Comprender cómo se intercambia la información entre Klaviyo y las aplicaciones
Comprender los tipos de información intercambiada entre Klaviyo y las aplicaciones