Comprende la sincronización del almacén de datos en Klaviyo

Objetivos del artículo

Aprende a sincronizar datos de Klaviyo con el almacén de datos e importar datos del almacén de datos a Klaviyo mediante SFTP. Puedes sincronizar los datos de perfiles de clientes y eventos, lo que te permite almacenar y analizar información clave sobre los clientes fuera de Klaviyo.

This content requires Functional cookies to be enabled.

Update Cookie Settings

Antes de empezar

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

• Asegúrate de que el usuario proporcionado a Klaviyo tenga los permisos correctos.
• 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 agregar las direcciones IP de tráfico saliente del almacén de datos de Klaviyo a la lista de (entes, sitios, etc.) permitidos. Esto garantizará que la capa de seguridad no bloquee las solicitudes de Klaviyo. Estas direcciones se representan mediante los siguientes rangos de 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

Conectar con un almacén de datos

1. Ve a Data management > Syncing. 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 luego haz clic en Conectar a [warehouse name] en su página de configuración.

Como alternativa, puedes seleccionar tu almacén de datos desde el marketplace de apps de Klaviyo. Para hacerlo, ve a Integraciones > Explorar apps 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.

Importar datos a través de SFTP

Si quieres importar datos desde tu almacén de datos a Klaviyo, puedes hacerlo mediante SFTP. Para una conexión directa al almacén de datos, consulta Información sobre Importación desde almacén de datos en Klaviyo.

Ve a integraciones, abre Administrar datos > Transferencia de datos por SFTP y luego 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 deseados desde el almacén de datos.
2. Genera claves SSH en tu equipo local.
3. Configurar el cliente SFTP e importar.

Exporta la base de datos

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

Genera claves SSH en tu 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 Agregar clave SSH. Ingresa 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 e importar

Después de agregar la clave pública a Klaviyo, configura el cliente SFTP y sube el archivo CSV.

1. Crea una conexión en el cliente SFTP usando el servidor, el puerto y el nombre de usuario que aparecen 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 pautas de formato recomendadas enlazadas arriba.
3. Carga el archivo CSV a través del cliente SFTP.

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

• Estado
  En cola, en proceso, completado, fallido o cancelado. Una importación completada aún puede contener errores.
• Filas procesadas
  Porcentaje del archivo procesado hasta el momento. Expande una importación para revisar los recuentos de filas procesadas y omitidas.
• Fecha de importación
  Fecha de importación.
• Importado por
  Usuario que importó los datos.

Exportar datos al almacén 

Para configurar el almacén de datos como un destino, vas a necesitar el siguiente conjunto de información y credenciales para cada almacén de datos.

Amazon Redshift

Para configurar Amazon Redshift como un destino, ejecuta el siguiente script para crear las tablas klaviyo_event, klaviyo_profile y klaviyo_metric.

Pide al administrador de bases de datos que adapte este ejemplo antes de ejecutarlo: reemplaza los marcadores de posición, corrige el */ que no coincide cerca del inicio y ejecuta las instrucciones GRANT específicas de cada tabla después de crear las tablas.

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

• Nombre: Un nombre para identificar esta conexión. Puedes 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 de la base de datos de Redshift a la que se conectará Klaviyo
• Puerto: El número de puerto que usa Redshift
• Esquema: el esquema de la base de datos
• Nombre de usuario: El nombre de usuario que se usa 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 listos 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 de datos con Klaviyo con el siguiente conjunto de credenciales:

• Nombre: Un nombre para identificar esta conexión.
• Bucket: el nombre del bucket.
• Ubicación del bucket: El nombre de la región que se eligió cuando se creó el bucket de almacenamiento.
• ID de la clave de acceso: El ID de tu clave de acceso de AWS.
• Clave de acceso secreta: Tu clave de acceso secreta a AWS.
  

Google BigQuery

Para configurar Google BigQuery como destino, ejecuta el siguiente script para configurar las tablas klaviyo_profile, klaviyo_event y klaviyo_metric. La 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 reemplazar el marcador de posición "SERVICE ACCOUNT EMAIL" por el correo electrónico de tu cuenta de servicio de BigQuery.

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

• Nombre: Un nombre que te ayude a identificar este destino.
• ID del proyecto: Esto se conoce como el ID del proyecto y se puede encontrar en la consola de interfaz de programación de aplicaciones (API).
• Conjunto de datos: También conocido como “esquema”. Es el mismo nombre que usaste en el script que debiste haber ejecutado para la configuración.
• Clave de la cuenta de servicio: Pega todo el contenido del archivo JSON que descargaste al crear la cuenta de servicio en BigQuery.
  

Microsoft Azure Synapse Analytics

Para configurar Microsoft Azure como un destino, ejecuta el siguiente script para crear las tablas klaviyo_profile, klaviyo_event y klaviyo_metric. Pídele al administrador de la base de datos que adapte el ejemplo antes de ejecutarlo: comienza con declaraciones DROP TABLE, incluida una declaración DROP TABLE klaviyo_profile duplicada. Quita las declaraciones DROP TABLE al crear tablas nuevas o si necesitas conservar los datos existentes.

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

• Nombre: Se recomienda usar el mismo nombre que el de tu base de datos en Azure.
• Espacio de trabajo: El nombre del espacio de trabajo de Azure Synapse.
• Nombre de la base de datos: Esto identifica tu base de datos del grupo de SQL dedicado.
• Nombre de usuario: Nombre de usuario de inicio de sesión para la base de datos del grupo de SQL dedicado.
• Contraseña de la base de datos: La contraseña para iniciar sesión en la base de datos del grupo de SQL dedicado.
• Nombre de la cuenta: Tu cuenta de almacenamiento de Windows Azure o el prefijo DNS que creaste.
• Firma de acceso: Cadena de firma de acceso compartido (SAS) que comprueba 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 un 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 comando siguiente 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 que puedas completar la configuración indicada abajo. A fin de revisar qué roles tienes, ejecuta SHOW GRANTS TO USER <your_username> y cerciórate de que tienes ambos roles en la lista. Ponte en contacto con un administrador de sistema si necesitas que ajusten tu rol. Antes de ejecutar el script, reemplaza los 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 reemplaza cualquier tabla existente con esos nombres. Usa una base de datos nueva o pídele a tu administrador que adapte esas instrucciones si necesitas conservar los datos existentes.

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

• Nombre: Se recomienda usar el mismo nombre que el de la base de datos de Snowflake.
• Nombre de usuario: Nombre de usuario para conectarte a la base de datos. Debe 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 la base de datos. Esto debe 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 de Almacén de blobs, úsala para configurar el almacenamiento de la exportación. Para los destinos de almacén de datos, este almacenamiento prepara los datos antes de cargarlos en el almacén de datos. Para Amazon S3, es el destino de exportación.

1. Para usar una tienda guardada, selecciona Usar una configuración de blob si aparece y luego elige una tienda de blobs compatible. Si dejas Usar una configuración de blob sin seleccionar, continúa con los detalles de conexión que se indican arriba. Si Klaviyo requiere una tienda de blobs, selecciona una antes de continuar.
2. Para agregar una tienda, elige Crear en la lista desplegable Almacén de blobs. Selecciona un proveedor si se te solicita, ingresa los detalles de conexión y luego haz clic en Crear.
3. Si aparece un campo de nombre de configuración de almacenamiento, ingresa 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 archivos exportados, si aparecen esos controles.

Después de ingresar los detalles 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 de perfil, solo datos de eventos específicos o ambos tipos de datos al marcar las casillas correspondientes junto a cada opción.

Integraciones para excluir

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

Sincronización selectiva

En el campo Sincronización selectiva , 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 de sincronización de datos

En Selecciona la frecuencia de sincronización de tus datos, elige un intervalo en Cada: 1, 2, 4, 6, 12 o 24 horas. Configura la Fecha de inicio, la Hora de inicio y la Zona horaria para la programación.

Selecciona la cantidad de datos históricos para sincronizar

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

• 30 días
• 90 días
• 1 año
• Cualquier momento

Sincronizar reseñas

Haz clic en Siguiente para abrir Revisión. Revisa los detalles de 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 tu programación.

Si Klaviyo muestra No se puede conectar, haz clic en Editar credenciales para corregir los detalles de la conexión. Luego, 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: importar o exportar
• Fecha de creación

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

Panel de sincronización de datos

Una vez que tengas una conexión exitosa, haz clic en tus integraciones desde la página de lista de Sincronización de datos. Desde aquí, se te llevará 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óricas

La pestaña Histórico tiene registros que muestran el estado de las sincronizaciones de datos históricos. Las sincronizaciones históricas se refieren a la sincronización de los datos existentes de Klaviyo en el 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 única. 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 de finalización estimado.
  • Con errores
    Se produjo un error, pero Klaviyo seguirá intentando restablecer una conexión. Según la integraciones, este tiempo puede variar ligeramente.
  • Error
    La sincronización falló 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. Después de resolver el problema, haz clic en Volver a habilitar para la sincronización.
  • En pausa
    Pausaste la sincronización manualmente.
  • Cancelado
    La sincronización se canceló 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ódicas

La pestaña Periodic 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 al almacén de datos según el programa que seleccionaste. Después de que finaliza cada ejecución, Klaviyo programa la siguiente ejecución.

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á esperando su próxima ejecución programada.
  • Sincronizando
    Los datos se están sincronizando activamente con el almacén de datos.
  • Con errores
    Se produjo un error, pero Klaviyo seguirá intentando restablecer una conexión. Según la integraciones, este tiempo puede variar ligeramente.
  • Error
    La sincronización falló por completo incluso después de intentar volver a establecer una conexión. Esto significa que tendrás que revisar la 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.
  • Cancelado
    La sincronización se canceló y ya no está programada.
• Actualidad de los datos
  La actualidad de los datos se refiere a qué tan actualizados están los datos. Por ejemplo, una actualidad de 2 minutos indica que la sincronización procesó datos hasta hace aproximadamente 2 minutos. Es posible que los datos más recientes aún estén esperando para sincronizarse.
• Botones para Pausar, Reanudar y volver a habilitar sincronizaciones individuales.

Eliminar conexiones del 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 estás teniendo problemas con la sincronización de datos entre Klaviyo y tu almacén de datos, ver los registros de errores asociados puede proporcionar información adicional sobre la causa del problema.

Para ver errores, haz clic en tu destino del almacén de datos en la página Sincronización. En las pestañas de sincronización Histórica y Periódica verás una lista de las exportaciones y su estado, junto con un indicador que muestra si hay errores con actividad.

Para ver más detalles sobre un error específico, haz clic en la exportación que está teniendo el error.

Aquí verás una línea de tiempo de las sincronizaciones salientes, junto con un mensaje de error o éxito basado en el estado de la sincronización.

Al hacer clic en un error específico, se abrirá un panel lateral con la siguiente información:

• Descripción
  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 que devuelve el almacén de datos
• Fecha
  La fecha y hora del error

Recursos adicionales