Comprender la importación de eventos del almacén de datos en Klaviyo

Objetivos del artículo

Aprende a utilizar la importación de eventos de almacén de datos para sincronizar los datos de eventos de tu almacén con Klaviyo, de modo que puedas potenciar los segmentos, los flujos y la elaboración de informes con comportamientos que se originan fuera de las integraciones nativas de Klaviyo(por ejemplo, sistemas POS, plataformas de soporte o aplicaciones personalizadas).

¿Qué es la importación de eventos al almacén de datos?

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

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

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

La importación de eventos se basa en la misma infraestructura de Importación desde almacén de datos que la importación de perfiles, pero se dirige al canal de ingestión de eventos de Klaviyoen lugar de a los perfiles.

¿Cómo funciona la importación de eventos del 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 en busca de la tabla o vista configurada.
2. En cada ejecución, Klaviyo solo lee las filas cuya marca de tiempo de detección de cambios es más reciente que la última sincronización correcta. Esto permite importaciones incrementales sin necesidad de volver a procesar toda la tabla.
3. A continuación, cada fila se procesa de la siguiente manera:
   • Klaviyo determina el nombre de la métrica (tipo de evento) en función de las opciones seleccionadas durante la configuración de la sincronización: una única métrica elegida o de forma dinámica en función del valor de una columna de nombre de métrica designada en la tabla de origen.
   • La marca de tiempo del evento, los identificadores de perfil y el ID único opcional, el valor y la moneda del valor se establecen en función de las asignaciones de campos configuradas durante la configuración de la sincronización.
   • Todas las columnas restantes se ingestan como propiedades del evento, utilizando los nombres de las columnas como nombres de las propiedades. Los nombres de columna con tres guiones bajos (por ejemplo, parent___child1, parent___child2) se pueden utilizar para crear una propiedad de evento (parent) con propiedades secundarias.
4. Klaviyo Carga los eventos resultantes en tu cuenta, donde se comportan como otras métricas de interfaz de programación de aplicaciones (API) personalizadas en segmentación, flujo y análisis.

Las importaciones se ejecutan con una cadencia recurrente (por ejemplo, cada hora), por lo que las filas nuevas o actualizadas en 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 la Plataforma de datos avanzada de Klaviyo y a la Importación desde el 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 soporte técnico de tu almacén de datos para obtener más información sobre la cuenta de servicio y los esquemas necesarios.
• Tu tabla o vista de origen contiene las columnas necesarias que se indican a continuación.
• Tienes suficientes privilegios en tu almacén para exponer las tablas/vistas necesarias al usuario del servicio de Klaviyo.

Estructura de la tabla de origen para eventos

Para garantizar que los datos de tu evento se puedan importar correctamente, tu tabla o vista de origen debe cumplir con los campos y la estructura requeridos por Klaviyo.

Campos obligatorios

Las siguientes columnas son necesarias en la versión 1 de la importación de eventos del almacén de datos:

Campos opcionales

Estos campos son recomendables cuando sean aplicables, pero no son estrictamente necesarios:

Propiedades del evento

El resto de columnas de tu tabla se tratan como propiedades del evento:

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

Klaviyo realiza un análisis sintáctico del tipo «mejor esfuerzo» para las propiedades de los eventos y no proporciona una lógica de transformación por campo como parte de la configuración de importación de eventos.

Casos de uso comunes

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

1) Importación de eventos offline o POS

Incluye los eventos en tienda o fuera de línea (por ejemplo, compras en el punto de venta, devoluciones o citas) de 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 pago.
• Eventos de citas completadas con el miembro del personal, el tipo de servicio y la duración.

2) Interacciones de servicio y soporte

Sincroniza eventos de soporte y servicio, como la creación de tickets, la resolución o las devoluciones, para enriquecer las líneas de tiempo de tus clientes y potenciar los mensajes basados en el historial de servicio.

Ejemplos:

• Ticket de soporte creado y ticket de soporte resuelto
• Pedido devuelto con códigos de motivo y montos de reembolso

3) Eventos modelados o derivados

Convierte los comportamientos modelados en el almacén 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
• Eventos de hitos del ciclo de vida alcanzados cuando un cliente pasa de una etapa a otra en un modelo de ciclo de vida personalizado.

Configurar la sincronización de importación de eventos del 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» (Avanzado) Klaviyo Data Platform (Plataforma de datos Klaviyo) > Gestión de datos > Sincronización.
2. Haz clic en Agregar almacén de datos y selecciona tu conector de almacén.
3. Completa los pasos de conexión para tu plataforma siguiendo la guía de conexión correspondiente, cuyo enlace se encuentra en el artículo general Importación desde almacén de datos.

Klaviyo Admite una conexión activa por cuenta.

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

Una vez que tu almacén esté conectado:

1. En la plataforma de datos avanzada de Klaviyo, en « > » (Gestión de datos), en « > » (Sincronización), selecciona la conexión de tu almacén.
2. Selecciona Importar datos (si estás configurando 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 solicite el tipo de datos, selecciona Eventos (en lugar de perfil).
4. Elige la tabla o vista de tu almacén que contenga los eventos que deseas importar.

3) Campos obligatorios del mapa

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

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

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

También puedes asignar campos recomendados:

• ID único
• Valor
• Moneda de valor

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 impide asignar varias columnas al mismo campo de nivel superior y comprueba que todos los campos obligatorios estén presentes antes de permitirte guardar los cambios.

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

Cuando guardes la importación de tu evento:

• Klaviyo programa sincronizaciones periódicas para que se ejecuten a intervalos regulares (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:

• Dirige la importación de eventos a una tabla o vista que ya incluya todos los eventos históricos relevantes, o
• Comienza con una tabla histórica dedicada y luego cambia a una vista respaldada por la captura de datos modificados para las actualizaciones continuas.

Cómo se comportan los eventos importados en Klaviyo

Una vez importado:

• Cada fila aparece como un evento de una interfaz de programación de aplicaciones (API) personalizada en Klaviyo.
• El nombre de la métrica que asignaste (o configuraste como 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 un perfil existente siempre que sea posible; de lo contrario, Klaviyo crea un nuevo perfil utilizando los campos de identificador proporcionados, de forma similar a otras rutas de ingestión de eventos.

Puedes utilizar estos eventos para:

• Crea segmentos basados en lo que alguien ha hecho y filtra por las propiedades del evento.
• activar y filtrar flujo.
• Analizar el comportamiento en métricas y elaboración de informes junto con eventos de otras fuentes.

Limitaciones y mejores prácticas

Ten en cuenta lo siguiente al utilizar la importación de eventos del almacén de datos:

• La versión 1 de la importación de eventos se centra únicamente en los datos de los eventos. Las actualizaciones de las propiedades del perfil derivadas de eventos pueden añadirse en una iteración posterior; por ahora, las propiedades del perfil deben actualizarse mediante la importación del perfil u otras rutas compatibles.
• 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 puede impedirte importar de forma segura los eventos históricos después de la primera sincronización.
• Para obtener una velocidad óptima, configura el campo de detección de cambios con la marca de tiempo en la que se crea la nueva tabla. Los registros se agrupan en ciclos de sincronización utilizando este valor, por lo que el tiempo de importación de los registros históricos se puede reducir 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 identificador ú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, por lo general, no hay problema en mantenerlos juntos: las columnas que son NULL para filas concretas simplemente se ignoran para esos eventos en Klaviyo.
• En el caso de objetos anidados complejos (por ejemplo, matrices de elementos de línea), recomendamos aplanarlos en varias columnas cuando sea posible, especialmente para las propiedades que esperas utilizar en segmentación o flujo.

```