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

Hola: 14 minutos de lectura
|
Actualizado 25 nov 2024, 8:13 EST
Qué aprenderás

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. 

Klaviyo CDP no está incluido en la aplicación de marketing estándar de Klaviyo, y se requiere una suscripción CDP para acceder a la funcionalidad asociada. Vaya a nuestra guía de facturación para saber más sobre cómo añadir esta funcionalidad a su plan o empiece si es un cliente nuevo.

Vídeo sobre la sincronización del almacén de datos en Klaviyo plataforma de datos de clientes" aria-hidden=
Antes de empezar

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/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
Conectarse a un almacén de datos 

Conectarse a un almacén de datos 

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

  1. Para añadir un almacén de datos, pulse el botón Nueva conexión
  2. 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.jpg

importar datos a través de SFTP

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:

  1. Exporte los datos deseados desde su almacén de datos.
  2. Genere clave SSH en su máquina local.
  3. 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

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

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

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.

  1. 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.
  2. Una vez autentificado, asegúrese de que su base de datos sigue las directrices recomendadas antes de proceder a la importación.
  3. Cargue su archivo de base de datos a través de su cliente SFTP y revíselo.

configurar.jpg

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.

Panel.jpg

Exporte datos a su almacén  

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
    Credenciales de Redshift para conectarse
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.
    Credenciales de Amazon S3 para conectarse
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. 
    Credenciales de BigQuery para conectarse
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 .

 

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 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.
    Credenciales Azure
Snowflake

Para configurar Snowflake como destino, ejecute el siguiente script para configurar las tablas KLAVIYO_PROFILE y KLAVIYO_EVENT . Debe tener privilegios securityadminy sysadminpara poder completar la configuración que se indica a continuación. Para revisar qué rol(es) tiene, ejecute SHOW GRANTS TO USER <your_username> y asegúrese de que tiene ambos roles en la lista. Póngase en contacto con un administrador del sistema si necesita que se ajuste su 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 conectarse a su base de datos.
  • Contraseña: Contraseña para conectarse a su base de datos.
  • Almacén:  Su almacén en Copo de Nieve.
  • Cuenta: Su cuenta en Snowflake.
  • Base de datos: El nombre de su base de datos. 
  • Esquema: El esquema de su base de datos. Credenciales de Snowflake para conectarse

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 datos 

Objetos 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.

Objetos de datos de perfiles y eventos

Sincronizar todos los datos de Klaviyo puede ocasionarle gastos adicionales de su almacén de datos. 

Integraciones a excluir

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.

Integraciones para excluir el campo

Sincronización selectiva

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 

Campo de sincronización selectiva

Seleccione la frecuencia con la que se sincronizarán sus datos

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.

Campo de cadencia de sincronización periódica

Seleccione cuántos datos históricos desea sincronizar 

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 

Seleccione cuántos datos desea sincronizar con su almacén de datos

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

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.

Conexión exitosa modal

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.

Tarjeta.jpg

Dado que sólo podrá conectar un destino, sólo verá reflejado un destino en esta vista de lista.

Panel de sincronización de datos

Panel 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.

Interfaz de sincronización tras conectar el almacén

Aquí verá la información de sincronización dividida en 2 pestañas:

  • Histórico
  • Periódico
Histórico 

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.
  • Comenzó el
    Hora de inicio de la sincronización.
  • Finalizó en
    Hora de finalización de la sincronización.
Periódico

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.
  • 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 

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.  

cuenta_meny.jpg

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.

integraciones_pagina.jpg

Ver registros de errores 

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.

Lista de exportaciones al almacén con información sobre la salud y recuento de errores

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. 

Cronología de las sincronizaciones salientes con el estado de salud

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. 

Cajón con información sobre el error de sincronización

Recursos adicionales 

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

¿Te ha resultado útil este artículo?
Utiliza este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar con el servicio de asistencia.

Descubre más de Klaviyo

Comunidad
Conecta con compañeros, socios y expertos de Klaviyo para inspirarte, compartir ideas y resolver todas tus dudas.
Formación en directo
Únete a una sesión en directo con expertos de Klaviyo para conocer las prácticas recomendadas, cómo configurar funciones clave y mucho más.
Asistencia

Accede al servicio de asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia por chat/virtual
La disponibilidad varía según la ubicación y el tipo de plan