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 de la 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. La primera importación lee el historial disponible en el origen. Las ejecuciones posteriores se reanudan desde el progreso guardado mediante la marca de tiempo de detección de cambios, por lo que Klaviyo no vuelve 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) a partir de una métrica de API existente que selecciones o del valor de una columna de nombre de métrica designada en cada fila.
   • La marca de tiempo del evento, los identificadores de perfil y el ID único y 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. Los nombres de columna con 3 guiones bajos (p. ej., parent___child1, parent___child2) se pueden usar 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 API personalizadas en segmentación, flujos y análisis.

Puedes programar importaciones recurrentes (p. ej., cada hora) o elegir Manual para ejecutar importaciones cuando sea necesario.

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.
• Prepara las credenciales de la cuenta de servicio y los esquemas necesarios para el almacén. Consulta las guías de conexión en Información sobre la importación de almacén de datos en Klaviyo.
• 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

Las siguientes columnas son obligatorias para la importación de eventos del almacén de datos:

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:

• Los nombres de las columnas se convierten en nombres de propiedades de nivel superior, a menos que contengan 3 guiones bajos (___), que crean propiedades secundarias anidadas como se describe más arriba.
• 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:

• In-Store Purchase eventos con totales de pedidos, ubicación de la tienda y tipo de forma de pago
• Appointment Completed eventos con miembro del personal, tipo de servicio y 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:

• Support Ticket Created y Support Ticket Resolved
• Order Returned 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:

• High Churn Risk eventos generados a partir de un modelo en tu almacén de datos
• Lifecycle Milestone Reached eventos cuando un cliente cambia de etapa en 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 tu almacén ya está conectado, ve al paso 2. De lo contrario:

1. En Klaviyo, ve a Advanced Klaviyo Data Platform > Data Management > Syncing (KDP avanzado > Gestión de datos > Sincronización).
2. Haz clic en Crear sincronización si ya tienes sincronizaciones configuradas. Selecciona Importar datos desde el almacén de datos y, a continuación, selecciona el conector del almacén.
3. Completa los pasos de preparación del almacén de datos en la guía de conexión correspondiente, enlazada desde Entender la importación de almacén de datos en Klaviyo.
4. Haz clic en Conectar con y, a continuación, en el nombre de tu almacén. Introduce los datos de conexión necesarios y, a continuación, haz clic en Siguiente.
5. Haz clic en Probar. Después de que la conexión se realice correctamente y Klaviyo pueda acceder al menos a 1 tabla o vista, haz clic en Siguiente.

Puedes crear varias conexiones de importación de almacén de datos y añadir tablas o vistas de origen a cada conexión.

Antes de crear la sincronización, decide qué eventos históricos incluir. Puedes hacer una de estas dos cosas:

• 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 histórica dedicada y, más adelante, cambia a una vista respaldada por captura de datos modificados para las actualizaciones continuas. Mantén las mismas columnas mapeadas y asigna a las filas nuevas marcas de tiempo de detección de cambios posteriores al progreso guardado de la sincronización.

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

Para crear una conexión nueva, continúa con la configuración que abriste arriba. Para una conexión existente, primero:

1. En Advanced Klaviyo Data Platform > Data Management > Syncing, selecciona la conexión al almacén.
2. Haz clic en Añadir origen.

En la configuración de sincronización:

1. Introduce un nombre para la sincronización y, opcionalmente, una descripción.
2. En Origen de datos, selecciona la tabla o vista que contenga los eventos que quieres importar.
3. En Tipos de objetos de datos, selecciona Eventos.

3) Elige la cadencia de sincronización

1. En Cadencia, elige cómo ejecutar la sincronización:
   • Programar ejecución: elige el intervalo en Cada y configura la Fecha de inicio, la Hora de inicio y la Zona horaria. El intervalo predeterminado es 1 hora.
   • Manual: guarda la sincronización sin un programa recurrente y ejecútala cuando sea necesario.
2. Haz clic en Siguiente para asignar campos.

4) Mapea los campos obligatorios

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

Completa estas asignaciones:

1. En Detección de cambios, selecciona la columna de marca de tiempo de detección de cambios en Detección de filas nuevas. Usa una columna de origen diferente de la marca de tiempo del evento.
2. En Tipo de evento, elige 1 de estas opciones:
   • Mismo tipo de evento: selecciona una métrica de API existente para todas las filas.
   • Tipo de evento específico para cada fila: selecciona la columna que contiene el nombre de la métrica de cada fila. Usa esta opción si la métrica que necesitas no está en la lista de métricas de API existente.
3. En Marcas de tiempo de eventos, selecciona la columna que registra cuándo se produjo el evento.
4. En propiedades de perfil, haz clic en Añadir asignación y asigna al menos 1 identificador de perfil (p. ej., email, número de teléfono, ID externo o ID de Klaviyo).

También puedes asignar campos recomendados:

• ID único
• Valor

Para conservar los metadatos de moneda (p. ej., USD), deja su columna sin asignar para que se convierta en una propiedad del evento. No hay ninguna asignación específica de Value currency.

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.

5) Guarda y comprueba la sincronización

1. Revisa la configuración y, a continuación, haz clic en Listo para guardar la sincronización de importación de eventos.
2. En la página de conexión del almacén, haz clic en el nombre de la sincronización. Si la configuración te devolvió a la vista general de Syncing, selecciona primero la conexión del almacén.
3. Si elegiste Manual, haz clic en Ejecutar sincronización para iniciar la importación. Las importaciones programadas se ejecutan según la cadencia que seleccionaste.
4. Consulta Historial de ejecuciones para ver el progreso y Registros para ver los errores.

Cómo se comportan los eventos importados en Klaviyo

Una vez importado:

• Cada fila aparece como un evento de una métrica API personalizada en Klaviyo.
• El nombre de métrica que asignaste (o configuraste como una constante) determina el nombre del tipo de evento que ves en el producto (por ejemplo, Placed Order).
• 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:

• Usa la importación de eventos para los datos de eventos. Para actualizar las propiedades de perfil, usa la importación de perfiles 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 eventos puede evitar que importes de forma segura el histórico de eventos después de la primera sincronización.
• Para las cargas históricas, utiliza la hora a la que se cargó cada fila en el almacén de datos como su marca de tiempo de detección de cambios. Un trabajo que crea una tabla histórica puede almacenar la marca de tiempo de ese trabajo en las filas para mantener el intervalo acotado. No recalcules esta marca de tiempo cada vez que se consulta una vista y sigue las directrices de volumen de filas que se indican a continuación.
• Usa un ID único estable por evento siempre que sea posible para mejorar la deduplicación y facilitar la depuración. Reimportar el mismo ID para el mismo perfil y la misma métrica se considera un duplicado; no actualiza las propiedades del evento.
• Puedes mantener varios tipos de evento (métricas) en la misma tabla. Las columnas no asignadas se incluyen como propiedades del evento, así que usa vistas separadas si necesitas conjuntos de propiedades diferentes para distintas métricas.
• 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.
• Mantén las marcas de tiempo históricas de detección de cambios en un intervalo reducido. Durante el relleno inicial, Klaviyo lee los datos en ventanas de 1 hora a partir de la marca de tiempo de detección de cambios más antigua. Un único registro de 2023 cuando todos los demás son recientes puede ralentizar ese relleno, ya que Klaviyo debe avanzar a través de las ventanas intermedias. Las ejecuciones posteriores se reanudan a partir del progreso guardado en lugar de volver a empezar desde el registro más antiguo.
• No superes aproximadamente 100 000 filas en una sola ventana de marca de tiempo de detección de cambios de 1 hora. Si demasiadas filas comparten el mismo periodo de 1 hora, es posible que la consulta de sincronización agote el tiempo de espera.

Mejora el rendimiento de las consultas de Snowflake

Configuración de clave de agrupación recomendada de Snowflake

En el caso de tablas grandes de Snowflake, una clave de agrupación en la marca de tiempo de detección de cambios puede ayudar a las consultas a omitir micro-particiones innecesarias. Prueba consultas representativas antes de añadir una clave y sopesa cualquier ahorro en consultas frente a los créditos de Snowflake usados para mantener la agrupación:

ALTER TABLE your_schema.your_table CLUSTER BY (your_change_timestamp_column);