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

Tendrás que asegurarte de que el almacén de datos con el que te estás conectando esté configurado como un destino. Para asegurarte de que lo has configurado correctamente:

• Asegúrate de que el usuario que se proporciona a Klaviyo tenga los permisos adecuados.
• Asegúrate de configurar las tablas con los nombres adecuados, que se muestran a continuación, en función de tu almacén de datos.

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

Para añadir una conexión de almacén de datos a Klaviyo, ve a Advanced KDP > Gestión de datos > Sincronización.

Para añadir un almacén de datos, selecciona un almacén de datos compatible en el modal Seleccionar un conector.

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.

Al conectar un almacén de datos, puedes importar datos desde tu almacén de datos a Klaviyo o establecer un almacén de datos como destino de sincronización saliente.

Importa datos vía SFTP.

Si quieres importar datos de tu almacén de datos a Klaviyo, puedes hacerlo a través de SFTP.

Para importar tus datos a Klaviyo, selecciona Importar datos al conectar por primera vez un destino de almacén, o haz clic en el botón Importar en la página Sincronización de datos si ya tienes una conexión establecida.

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

Una vez que hayas exportado los datos que quieres 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.

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

Una vez que tu clave SSH se haya añadido correctamente a Klaviyo, tendrás que configurar tu cliente SFTP e importar los datos.

1. Abre tu cliente SFTP y configura una nueva conexión con las credenciales que se muestran en Klaviyo. Verás las credenciales después de añadir correctamente tu clave SSH
2. Una vez realizada la autenticación, asegúrate de que tu base de datos siga las directrices recomendadas antes de importar
3. Sube el archivo de tu base de datos a través de tu cliente SFTP y revísalo

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.
• Fecha de importación
  Fecha de importación.
• Importado por
  Usuario que importó los datos.

Exportar 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 usando el siguiente conjunto de credenciales:

• Nombre: El nombre de tu base de datos en Redshift (se recomienda usar el mismo nombre que el de 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 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, establece los nombres de las tablas en klaviyo_profile y klaviyo_event.

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

• Nombre: el nombre legible por máquina para la base de datos de Amazon S3.
• 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 y klaviyo_event . Tu cuenta de Google BigQuery debe tener un perfil de pagos 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: 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 y klaviyo_event .

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 la 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:

text Copy

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:

text Copy

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 los privilegios de securityadmin y sysadmin para completar la configuración siguiente. Para revisar qué rol(es) tienes, ejecuta SHOW GRANTS TO USER <your_username> y asegúrate de que aparezcan ambos roles. Ponte en contacto con un administrador del sistema si necesitas ajustar tu rol.

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.
  

Después de introducir tus credenciales del almacén de datos con el que estás sincronizando, elige los datos que quieras sincronizar desde Klaviyo.

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

El valor configurado para el campo Periodic sync cadence en la sección llamada Select how often your data will sync define la frecuencia con la que se producirá una sincronización desde Klaviyo a tu almacén de datos.

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

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á Enabled, junto con:

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

Si la sincronización no se conectó correctamente, verás en su lugar el estado No se puede conectar, junto con opciones para volver a intentar la conexión o editar la información de las 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 lo siguiente:

• Destinodel almacén
• El estado Habilitado
• Cualquier error potencial que pueda haber ocurrido con tu sincronización en las últimas 24 horas
• La última sincronización que se produjo, junto con una marca de tiempo de este evento

Como solo podrás conectar 1 destino, solo verás 1 destino reflejado en esta vista de lista.

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 se están incluyendo 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.
  • En curso
    Los datos se están sincronizando activamente con tu 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 la configuración o incluso la configuración del almacén de datos.
  • En pausa
    Has puesto la sincronización en pausa manualmente.
  • Deshabilitado
    La sincronización se deshabilitó porque la integración en sí se deshabilitó o se eliminó.
• 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ódico tiene registros que muestran el estado de tus sincronizaciones periódicas. A medida que los clientes siguen interactuando con tu marca y se crean nuevos datos, se enviarán de forma rutinaria a tu almacén de datos. Al configurar una conexión de almacén de datos, las sincronizaciones periódicas se realizarán cada hora.

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

• Nombre
  Los datos se están incluyendo 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.
  • En curso
    Los datos se están sincronizando activamente con tu 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.
  • Fallido
    La sincronización falló por completo incluso después de intentar volver a establecer 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.
  • En pausa
    Has pausado la sincronización manualmente.
  • Desactivada
    La sincronización se desactivó porque la integración en sí se desactivó o se eliminó.
• Actualización de datos
  La actualización de datos se refiere a lo actualizados que están tus datos. Por ejemplo, si una sincronización tiene una actualización de 2 minutos, 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 habilitar sincronizaciones individuales.

Eliminar conexiones de almacén de datos

Para eliminar una conexión de almacén de datos de tu cuenta de Klaviyo, selecciona la pestaña Integraciones.

Abre el menú junto a las integraciones con tu almacén de datos y selecciona 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 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:

• Resumen
  Una breve descripción del error devuelto por 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