Importación de eventos de almacén de datos en Klaviyo

Qué aprenderás

Aprende a usar la importación de eventos de almacén de datos para sincronizar datos de eventos de tu almacén con Klaviyo. De esta forma, podrás impulsar segmentos, flujos y elaboración de informes con un comportamiento que se origina fuera de las integraciones nativas de Klaviyo (por ejemplo, sistemas de puntos de venta, plataformas de asistencia o aplicaciones personalizadas).

Qué es la importación de eventos de almacén de datos

La importación de eventos de almacén de datos permite a Klaviyo conectarse directamente a tu almacén de datos y configurar sincronizaciones de importación desde tablas de almacén o vistas que contengan datos de eventos.

Cada fila de la tabla de origen se trata como un único evento en Klaviyo:

• Las marcas de tiempo, el nombre métrica y los identificadores de la fila definen lo que ocurrió, cuándo y para quién.
• Las columnas adicionales se convierten en propiedades de eventos que puedes usar en segmentación, flujos y análisis.

La importación de eventos se basa en la misma Importación de almacén de datos que la importación de perfiles, pero se dirige al proceso de ingesta de eventos de Klaviyo en lugar de a los perfiles.

Cómo funciona la importación de eventos de almacén de datos

Después de conectar Klaviyo a tu almacén y configurar una sincronización de eventos:

1. Klaviyo consulta tu almacén para la tabla o vista configurada.
2. En cada ejecución, Klaviyo solo lee las filas cuya marca de tiempo de detección de cambios sea más reciente que la última sincronización correcta. Esto permite importaciones incrementales sin reprocesar toda la tabla.
3. A continuación, cada fila se procesa de la siguiente manera:
   • Klaviyo determina el nombre métrica (tipo de evento) en función de las opciones seleccionadas durante la configuración de la sincronización: ya sea un único nombre métrica seleccionado o dinámicamente en función del valor de una columna de nombre métrica designado en la tabla de origen.
   • La marca de tiempo del evento, los identificadores de perfil y el ID único, el valor y la moneda de valor opcionales se establecen en función de las asignaciones de campos configuradas durante la configuración de la sincronización.
   • Todas las columnas restantes se ingieren como propiedades de evento, utilizando los nombres de columna como nombres de propiedad. Nombres de columnas con tres guiones bajos (por ejemplo, padre__child1, parent___hijo2) se puede usar para crear una propiedad de evento (principal) con propiedades secundarias.
4. Klaviyo carga los eventos resultantes en tu cuenta, donde se comportan como otras métricas de API personalizadas en segmentación, flujos y análisis.

Las importaciones se ejecutan con una frecuencia periódica (por ejemplo, cada hora), por lo que las filas nuevas o actualizadas de tu almacén se traducen regularmente en eventos en Klaviyo.

Antes de empezar

Asegúrate de que se cumplan los siguientes requisitos antes de crear una sincronización de importación de eventos:

• Tu cuenta tiene acceso a Advanced Klaviyo Data Platform y a la Importación de almacén de datos.
• Has creado y validado una conexión de almacén de datos en Klaviyo. Consulta los artículos del centro de asistencia de tu almacén de datos para obtener más información sobre la cuenta de servicio y los esquemas requeridos.
• Tu tabla o vista de origen contiene las columnas obligatorias que aparecen a continuación.
• Tienes privilegios suficientes en tu almacén para exponer las tablas/vistas necesarias al usuario del servicio de Klaviyo.

Estructura de la tabla de origen de los eventos

Para asegurarte de que los datos de tus eventos se puedan importar correctamente, la tabla o vista de origen debe cumplir los campos y la estructura obligatorios de Klaviyo.

Campos obligatorios

En la importación de eventos de almacén de datos V1, se requieren las siguientes columnas:

Campos opcionales

Estos campos se recomiendan cuando corresponda, pero no son estrictamente necesarios:

Propiedades del evento

Todas las demás columnas de tu tabla se tratan como propiedades de evento:

• Las columnas se importan como propiedades aplanadas, con el nombre de columna utilizado directamente como nombre de propiedad en Klaviyo.
• No necesitas asignar explícitamente todas las propiedades; las columnas no asignadas se incluirán como propiedades de evento.
• El JSON anidado se puede almacenar dentro de un valor de propiedad individual si es necesario (por ejemplo, un objeto JSON de líneas de pedido), pero el nombre de la propiedad en sí proviene de una columna de nivel superior.

Klaviyo realiza el análisis del tipo más eficaz para las propiedades de eventos y no proporciona una lógica de transformación por campo como parte de la configuración de la importación de eventos.

Casos de uso comunes

Los clientes suelen utilizar la importación de eventos de almacén de datos para lo siguiente:

1) Importación de eventos de punto de venta o sin conexión

Trae eventos en tienda o fuera de línea (por ejemplo, compras en puntos de venta, devoluciones o citas) desde tu almacén para que se comporten como otros eventos y métricas de Klaviyo.

Ejemplos:

• Eventos de compra en tienda con totales de pedidos, ubicación de la tienda y tipo de licitación
• Nombramiento Eventos completados con el miembro del personal, el tipo de servicio y la duración

2) Interacciones de atención al cliente y asistencia

Sincroniza eventos de asistencia y servicio como la creación de tickets, la resolución o las devoluciones para enriquecer los plazos de tus clientes y potenciar los mensajes en función del historial de servicio.

Ejemplos:

• Ticket de asistencia creado y Ticket de asistencia resuelto
• Pedido Devuelto con códigos de motivo e importes de reembolso

3) Eventos modelados o derivados

Convierte los comportamientos basados en almacenes en eventos que sean más fáciles de usar en Klaviyo.

Ejemplos:

• Eventos de Alto Riesgo de Abandono generados a partir de un modelo en tu almacén
• Hito del ciclo de vida Se alcanzan eventos cuando un cliente pasa a etapas de un modelo de ciclo de vida personalizado

Configura una sincronización de importación de eventos de almacén de datos

1) Conecta tu almacén de datos

Si aún no has conectado tu almacén:

1. En Klaviyo, ve a Advanced Klaviyo Data Platform > Data Management > Syncing (KDP avanzado > Gestión de datos > Sincronización).
2. Haz clic en Añadir almacén de datos y selecciona el conector de almacén.
3. Completa los pasos de conexión para tu plataforma siguiendo la guía de conexión correspondiente vinculada desde el artículo de resumen de la Importación de almacén de datos.

Klaviyo admite una conexión de almacén de datos activa por cuenta.

2) Crea una nueva sincronización de importación de eventos

Una vez que conectes tu almacén:

1. En Advanced Klaviyo Data Platform > Data Management > Syncing, selecciona la conexión al almacén.
2. Elige Importar datos (si configuras las importaciones por primera vez) o haz clic en Crear sincronización / Añadir sincronización para una conexión existente.
3. Cuando se te pida el tipo de datos, selecciona Eventos (en lugar de Perfiles).
4. Elige la tabla o vista en tu almacén que contenga los eventos que quieras importar.

3) Asigna los campos obligatorios

A continuación, asignarás columnas de tu tabla de almacén a los campos de eventos obligatorios de Klaviyo.

La configuración de importación de eventos requiere que proporciones asignaciones para:

• Marca de tiempo del evento
• Nombre Métrica (una constante que selecciones en la configuración o una columna que contenga el nombre métrica por fila)
• Identificador del perfil (al menos uno)
• Marca de tiempo de detección de cambios

También puedes asignar campos recomendados:

• ID único
• Valor
• Valor de moneda

Las columnas restantes que no asignes explícitamente a estos campos principales se convertirán automáticamente en propiedades de evento.

La interfaz de usuario de configuración evita que asignes varias columnas al mismo campo de nivel superior y valida que todos los campos obligatorios estén presentes antes de permitirte guardar.

4) Elige la cadencia de sincronización y el alcance histórico

Cuando guardes tu importación de eventos:

• Klaviyo programa sincronizaciones periódicas para que se ejecuten con una frecuencia regular (normalmente cada hora).
• En cada ejecución, solo se procesan las filas cuya marca de tiempo de detección de cambios sea más reciente que la última ejecución correcta, lo que garantiza que las importaciones sean incrementales.

Para el relleno histórico, puedes:

• Apunta la importación de tu evento a una tabla o vista que ya incluya todos los eventos históricos relevantes, o
• Empieza con una tabla de histórico dedicada y, más tarde, cambia a una vista respaldada por la captura de datos para obtener actualizaciones continuas.

Cómo se comportan los eventos importados en Klaviyo

Una vez importado:

• Cada fila aparece como un evento de un API personalizado métrica en Klaviyo.
• El nombre métrica que asignaste (o configuraste como una constante) determina el nombre del tipo de evento que ves en el producto (por ejemplo, Pedido Realizado).
• Todos los identificadores de perfil se resuelven en perfiles existentes siempre que sea posible; de lo contrario, Klaviyo crea nuevos perfiles utilizando los campos de identificador proporcionados, de forma similar a otras rutas de ingesta de eventos.

Puedes usar estos eventos para lo siguiente:

• Crea segmentos en función de lo que alguien haya hecho y filtra las propiedades de los eventos.
• Activa y filtra flujos.
• Analiza el comportamiento en métricas y elaboración de informes junto con eventos de otras fuentes.

Limitaciones y prácticas recomendadas

Ten en cuenta lo siguiente al importar eventos de almacén de datos:

• La versión 1 de la importación de eventos se centra solo en los datos de eventos. Las actualizaciones de propiedades de perfil derivadas de eventos pueden añadirse en una iteración posterior. Por ahora, las propiedades de perfil deben actualizarse a través de la importación de perfiles u otras rutas admitidas.
• La marca de tiempo de detección de cambios debe ser diferente de la marca de tiempo del evento. Usar la misma columna para ambos eventos puede evitar que importes de forma segura el histórico de eventos después de la primera sincronización.
• Para obtener la velocidad óptima, configura el campo de detección de cambios en la marca de tiempo del momento en el que se crea la nueva tabla. Los registros se agrupan en ciclos de sincronización utilizando este valor, por lo que el tiempo para importar registros históricos puede reducirse si todos los registros históricos tienen marcas de tiempo de detección de cambios en un rango estrecho (por ejemplo, la marca de tiempo de un trabajo que crea la nueva tabla).
• Utiliza un ID único estable por evento siempre que sea posible para mejorar la deduplicación y facilitar la depuración posterior.
• Si tu tabla contiene varios tipos de eventos (métricas) con diferentes conjuntos de columnas, generalmente está bien mantenerlas juntas: las columnas que son NULL para filas particulares simplemente se ignoran para esos eventos en Klaviyo.
• En el caso de los objetos anidados complejos (por ejemplo, las matrices de líneas de pedido), te recomendamos que aplanes en varias columnas siempre que sea posible, sobre todo en el caso de las propiedades que quieras usar en la segmentación o los flujos.

»