La sincronización del almacén de datos en Klaviyo

Qué aprenderás

Descubre cómo sincronizar datos de Klaviyo con tu almacén de datos e importar datos del almacén a Klaviyo mediante SFTP. Puedes sincronizar los datos del perfil del cliente y los datos de eventos, lo que te permite almacenar y analizar información clave sobre tus clientes fuera de Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Antes de empezar

Antes de exportar datos desde Klaviyo, configura el almacén de datos como destino:

• Asegúrate de que el usuario que se proporciona a Klaviyo tenga los permisos adecuados.
• Para los destinos que usan tablas, crea las tablas con los nombres que se muestran en las instrucciones de configuración a continuación.

Además, asegúrate de añadir a la lista de permitidos las direcciones IP de tráfico saliente del almacén de datos de Klaviyo. Esto garantizará que tu capa de seguridad no bloquee las solicitudes de Klaviyo. Estas direcciones se representan mediante los siguientes rangos CIDR:

• 184.72.183.187/32
• 52.206.71.52/32
• 3.227.146.32/32
• 44.198.39.11/32
• 35.172.58.121/32
• 3.228.37.244/32
• 54.88.219.8/32
• 3.214.211.176/32

Conéctate a un almacén de datos

1. Ve a Gestión de datos > Sincronización. Si ya tienes una conexión, haz clic en Crear sincronización.
2. Selecciona Exportar datos a tu almacén de datos.
3. Selecciona tu almacén y, a continuación, haz clic en Conectar con [warehouse name] en su página de configuración.

Como alternativa, puedes seleccionar tu almacén de datos desde el marketplace de aplicaciones de Klaviyo; para ello, ve a Integraciones > Explorar aplicaciones y busca tu plataforma.

La opción Importar datos desde el almacén de datos configura una importación directa del almacén. Para cargar archivos CSV mediante SFTP, sigue la siguiente sección.

Importa datos vía SFTP.

Si quieres importar datos desde tu almacén de datos a Klaviyo, puedes hacerlo mediante SFTP. Para una conexión directa con el almacén de datos, consulta Comprender la importación de almacén de datos en Klaviyo.

Ve a Integraciones, abre Administrar datos > Transferencia de datos SFTP y, a continuación, selecciona la pestaña Configuración de SFTP.

El proceso para importar datos del almacén en Klaviyo es el siguiente:

1. Exporta los datos que quieras desde tu almacén de datos.
2. Generar clave SSH en el equipo local.
3. Configurar el cliente SFTP e importar.

Exportar tu base de datos

Primero, tendrás que exportar tus datos desde tu almacén de datos. Inicia sesión en tu almacén y exporta los datos que quieras importar a Klaviyo a un archivo CSV.

Generar claves SSH en el equipo local

Genera un nuevo par de claves SSH en el equipo local. Conserva la clave privada para el cliente SFTP.

1. En Configuración de SFTP, haz clic en Añadir clave SSH. Introduce un Título de la clave y pega la clave pública en clave SSH.
2. Haz clic en Añadir clave.

Configurar el cliente SFTP y llevar a cabo la importación

Después de añadir tu clave pública a Klaviyo, configura tu cliente SFTP y sube tu archivo CSV.

1. Crea una conexión en el cliente SFTP con el servidor, el puerto y el nombre de usuario que se muestran en Credenciales de SFTP en Configuración de SFTP. Autentícate con la clave privada correspondiente.
2. Antes de subirlo, asegúrate de que el archivo CSV siga las directrices de formato recomendadas enlazadas arriba.
3. Carga el archivo CSV a través del cliente SFTP.

Para comprobar la importación, abre la pestaña Importación de datos en Transferencia de datos por SFTP. Importaciones recientes muestra:

• Estado
  En cola, en procesamiento, completado, fallido o cancelado. Una importación completada puede seguir conteniendo errores.
• Filas procesadas
  Porcentaje del archivo procesado hasta el momento. Expande una importación para comprobar el recuento de filas procesadas y omitidas.
• Fecha de importación
  Fecha de importación.
• Importado por
  Usuario que importó los datos.

Exportar datos a tu almacén 

Para configurar el 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, klaviyo_profile y klaviyo_metric.

Pide a tu administrador/a de bases de datos que adapte este ejemplo antes de ejecutarlo: reemplaza los marcadores de posición, corrige el */ sin emparejar cerca del principio y ejecuta las instrucciones GRANT específicas de la tabla después de crear las tablas.

Una vez configurado como destino, conecta tu almacén con Klaviyo usando el siguiente conjunto de credenciales:

• Nombre: Un nombre para identificar esta conexión. Puedes usar el mismo nombre que el de la 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 de la base de datos de Redshift a la que se conectará Klaviyo
• Puerto: el número de puerto que utiliza 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 que se usa para iniciar sesión en Redshift
  

Amazon S3

Para configurar Amazon S3 como destino, ten a mano el nombre del bucket, la región del bucket y las credenciales de acceso de AWS.

Una vez configurado como destino, conecta tu almacén con Klaviyo usando el siguiente conjunto de credenciales:

• Nombre: Un nombre para identificar esta conexión.
• Cubo: El nombre de tu cubo.
• Ubicación del bucket: El nombre de región que se eligió al crear el bucket de almacenamiento.
• ID de clave de acceso: Tu ID de 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, klaviyo_event y klaviyo_metric. Tu cuenta de Google BigQuery debe tener un perfil de pago para que el proceso de conexión se complete correctamente.

Ten en cuenta que, en este script, debes sustituir el marcador de posición "SERVICE ACCOUNT EMAIL" por el email de tu cuenta de servicio de BigQuery.

Una vez configurado como destino, conecta tu almacén con Klaviyo usando el siguiente conjunto de credenciales:

• Nombre: Elige un nombre que te ayude a identificar este destino
• ID de proyecto: Se conoce como el ID de proyecto y puedes encontrarlo en tu consola de API.
• Conjunto de datos: También conocido como «esquema». Es el mismo nombre que utilizaste en el script que deberías haber ejecutado para la configuración.
• Clave de cuenta de servicio: Pega todo el contenido del archivo JSON que descargaste al crear tu cuenta de servicio en BigQuery.
  

Microsoft Azure Synapse Analytics

Para configurar Microsoft Azure como destino, ejecuta el siguiente script para crear las tablas klaviyo_profile, klaviyo_event y klaviyo_metric. Pide al administrador de la base de datos que adapte el ejemplo antes de ejecutarlo: empieza con instrucciones DROP TABLE, incluida una instrucción DROP TABLE klaviyo_profile duplicada. Elimina las instrucciones DROP TABLE al crear tablas nuevas o si necesitas conservar los datos existentes.

Una vez configurado como destino, conecta tu almacén con Klaviyo usando el siguiente conjunto de credenciales:

• Nombre: Se recomienda usar el mismo nombre que el de tu base de datos de 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 de SQL dedicado.
• Nombre de usuario: Tu nombre de usuario de inicio de sesión para tu base de datos del grupo de SQL dedicado.
• Contraseña de base de datos: Tu contraseña de inicio de sesión para tu base de datos del grupo de SQL dedicado.
• Nombre de la cuenta: Tu cuenta de almacenamiento de Windows Azure o el prefijo DNS que has creado.
• Firma de acceso: Tu cadena de firma de acceso compartido (SAS) que demuestra el acceso al contenedor de Blob Storage.
• Nombre del contenedor: el nombre del contenedor de 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:

textCopy

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:

textCopy

openssl rsa -in rsa_key.p8 -pubout -out rsa_key.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 completar la configuración a continuación. Para revisar qué rol(es) tienes, ejecuta SHOW GRANTS TO USER <your_username> y asegúrate de que se enumeren ambos roles. Ponte en contacto con un administrador del sistema si necesitas que se ajuste el rol. Antes de ejecutar el script, sustituye sus marcadores de posición SET_ por tus valores y GENERATE_PUBLIC_KEY por la clave pública que generaste. El script usa CREATE OR REPLACE TABLE, que sustituye cualquier tabla existente con esos nombres. Usa una base de datos nueva o pide a tu administrador que adapte esas instrucciones si necesitas conservar los datos existentes.

Una vez configurado como destino, conecta tu almacén con Klaviyo usando el siguiente conjunto de credenciales:

• Nombre: Te recomendamos que uses el mismo nombre que el de tu base de datos de Snowflake.
• Nombre de usuario: El nombre de usuario que se utilizará para conectarse a tu base de datos. Debería ser el mismo que user_name en el script de configuración.
  
• Clave privada: la clave privada de Snowflake generada.
  
• Almacén:  tu almacén en Snowflake.
• Cuenta: Tu cuenta en Snowflake.
• Base de datos: El nombre de tu base de datos. Esto debería ser lo mismo que database_name en el script de configuración.
• Esquema: el esquema de tu base de datos. Esto debería ser lo mismo que schema_name en el script de configuración.
  

Databricks

Para configurar Databricks como destino, incluido el script de configuración, los permisos necesarios y las credenciales de conexión, sigue los pasos de Cómo exportar datos de Klaviyo a Databricks.

Si el formulario de conexión muestra una sección Blob store, úsala para configurar el almacenamiento para la exportación. En el caso de los destinos de almacén de datos, este almacenamiento prepara los datos antes de cargarlos en el almacén de datos. En el caso de Amazon S3, es el destino de exportación.

1. Para usar un almacén guardado, selecciona Usar una configuración de blobs si se muestra y, después, elige un almacén de blobs compatible. Si dejas Usar una configuración de blobs sin seleccionar, continúa con la información de conexión indicada anteriormente. Si Klaviyo requiere un almacén de blobs, selecciona uno antes de continuar.
2. Para añadir una tienda, selecciona Crear en el menú desplegable Blob store. Selecciona un proveedor si se te solicita, introduce los detalles de conexión y haz clic en Crear.
3. Si aparece un campo Nombre de configuración de almacenamiento, introduce el nombre de la configuración de almacenamiento que creaste en el almacén de datos.
4. Para un destino de Amazon S3, elige un Formato de archivo y si quieres comprimir los archivos exportados si aparecen esos controles.

Después de introducir los datos de conexión, haz clic en Siguiente. Luego, elige los datos y la programación de la exportación.

Objetos de datos

En la sección Objetos de datos puedes elegir sincronizar todos los datos del perfil, solo datos de evento específicos o ambos tipos de datos marcando la(s) casilla(s) correspondiente(s) junto a cada opción.

Integraciones a excluir

En el campo Integraciones que se van a excluir, puedes seleccionar las integraciones específicas que quieres excluir en la sincronización del almacén de datos. Esto resulta útil si quieres evitar que se sincronicen también los datos de una integración específica que ya hayas conectado a Klaviyo.

Sincronización selectiva

En el campo Selective sync , seleccionas los eventos específicos que quieres sincronizar con tu almacén de datos desde Klaviyo. De forma predeterminada, se incluyen todos los eventos. Cuando configuras eventos específicos para sincronizarlos con este campo, solo se sincronizarán los eventos seleccionados.

Selecciona la frecuencia con la que se sincronizarán tus datos

En Select how often your data will sync, selecciona un intervalo en Every: 1, 2, 4, 6, 12 o 24 horas. Configura Start Date, Start Time y Timezone para la programación.

Selecciona qué cantidad de datos históricos quieres sincronizar

En la sección Selecciona cuántos histórico de datos quieres sincronizar , puedes definir cuántos histórico de datos te gustaría sincronizar desde Klaviyo con tu almacén de datos durante la conexión inicial. Puedes elegir:

• 30 días
• 90 días
• 1 año
• Desde siempre

Revisión de la sincronización

Haz clic en Siguiente para abrir Revisar. Comprueba los detalles de la conexión y la configuración de exportación, incluidos:

• Detalles de la sincronización que configuraste
• ¿Qué datos se comparten (perfiles, eventos o ambos)?
• Cualquier integración excluida

Haz clic en Conectar para guardar la conexión e iniciar las sincronizaciones según el calendario.

Si Klaviyo muestra No se puede conectar, haz clic en Editar credenciales para corregir los detalles de la conexión y, a continuación, vuelve a Revisar y haz clic en Conectar de nuevo.

Después de guardar la conexión, Klaviyo te devuelve a Sincronización de datos. La tabla de conexiones muestra:

• Almacén
• Tipo: import o export
• Fecha de creación

Los destinos de exportación y las conexiones de importación directa aparecen en la misma tabla. Comprueba Tipo para distinguirlos.

Panel de sincronización de datos

Una vez que tengas una conexión correcta, haz clic en tus integraciones en la página de la lista Sincronización de datos. A partir de 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órico
• Periódico

Histórico

La pestaña Histórico tiene registros que muestran el estado de tus sincronizaciones de histórico de datos. Las sincronizaciones históricas hacen referencia a la sincronización de tus datos existentes de Klaviyo con tu almacén de datos cuando estableces una conexión.

Verás la siguiente información para cada sincronización:

• Nombre
  Los datos que se incluyen en la sincronización.
• Estado
  Estado y posible progreso de la sincronización con un porcentaje estimado o posibles errores indicados. Estos estados podrían incluir:
  
  
  • Completado
    Tus datos terminaron de sincronizarse para esta sincronización puntual. No se volverá a sincronizar automáticamente.
  • Programado
    Cuando está programada la próxima sincronización para ejecutarse automáticamente.
  • Sincronizando
    Los datos se están sincronizando activamente con el almacén de datos con un porcentaje estimado de finalización.
  • Con errores
    Se ha producido un error, pero Klaviyo seguirá intentando restablecer una conexión. En función de las integraciones, este tiempo puede variar ligeramente.
  • Error
    La sincronización ha fallado por completo incluso después de intentar restablecer una conexión. Esto significa que tendrás que revisar tus ajustes de configuración o incluso la configuración del almacén de datos. Después de resolver el problema, haz clic en Volver a habilitar para la sincronización.
  • En pausa
    Has puesto la sincronización en pausa manualmente.
  • Cancelada
    La sincronización se ha cancelado y ya no está programada.
• Iniciado el
  Hora de inicio de la sincronización.
• Finalizó el
  Hora de finalización de la sincronización.

Periódico

La pestaña Periódica muestra el estado de las sincronizaciones en curso. A medida que los clientes siguen interactuando con tu marca y se crean nuevos datos, se envían a tu almacén de datos según la programación que seleccionaste. Cuando termina cada ejecución, Klaviyo programa la siguiente.

Verás la siguiente información para cada sincronización:

• Nombre
  Los datos que se incluyen en la sincronización.
• Estado
  El estado actual de la sincronización y cualquier error. Estos estados podrían incluir:
  • Programado
    La sincronización está a la espera de la próxima ejecución programada.
  • Sincronización
    Los datos se están sincronizando activamente con el almacén de datos.
  • Con errores
    Se ha producido un error, pero Klaviyo seguirá intentando restablecer una conexión. En función de las integraciones, este tiempo puede variar ligeramente.
  • Error
    La sincronización ha fallado por completo incluso después de intentar restablecer una conexión. Esto significa que tendrás que revisar los ajustes de configuración o incluso la configuración del almacén de datos. Después de resolver el problema, haz clic en Volver a habilitar para la sincronización.
  • En pausa
    Has pausado la sincronización manualmente.
  • Cancelada
    La sincronización se ha cancelado y ya no está programada.
• Actualización de los datos
  La actualización de los datos se refiere a lo recientes que son los datos. Por ejemplo, una actualización de 2 minutos indica que la sincronización ha procesado datos hasta hace aproximadamente 2 minutos. Es posible que los datos más recientes sigan esperando para sincronizarse.
• Botones para pausar, reanudar y volver a habilitar sincronizaciones individuales.

Eliminar conexiones de almacén de datos

1. Ve a Integraciones.
2. Abre el menú junto a la integración del almacén de datos y selecciona Eliminar integración. En el cuadro de diálogo de confirmación, haz clic en Eliminar integración de nuevo.

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 proporcionar 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 Sincronizando. Tanto en las pestañas de sincronización Histórico como Periódico verás una lista de las exportaciones y su estado, junto con un indicador que muestra si hay errores activos.

Para ver más detalles sobre un error concreto, haz clic en la exportación que está experimentando el fallo.

Aquí verás 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 específico, se abrirá un panel con la siguiente información:

• Descripción
  Una breve descripción del error que devuelve el almacén de datos
• Código
  El código de error 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