Cómo importar manualmente datos históricos de eventos

Objetivos del artículo

Aprende a importar manualmente datos históricos de eventos a Klaviyo. Aunque recomendamos utilizar integraciones construidas por Klaviyocon plataformas como Shopify, Magento, y BigCommerce, y nuestra interfaz de programación de aplicaciones (API) para integraciones personalizadas, también es posible añadir estos datos manualmente. Un ejemplo común de esto es añadir datos históricos de compras de una plataforma ecommerce anterior para la que Klaviyo no tiene integraciones preconstruidas.

Ten en cuenta que hay un límite de 50 MB para subir archivos CSV. 

Formatea tus datos

El primer paso es formatear correctamente tus datos en un archivo CSV. A continuación se muestra un ejemplo de datos de Pedido realizado, junto con una descripción de los campos que aparecen más abajo. Cada fila de tu archivo CSV debe representar una acción o actividad que alguien haya realizado, como "Compró un producto" o "Se inscribió en un seminario web." Si tienes varias acciones que seguir, debes subirlas como archivos CSV separados. La dirección de correo electrónico debe ir en primer lugar cuando cargues tu CSV.

Aquí tienes algunos CSV de eventos de ejemplo a los que puedes referirte cuando formatees tus datos.

Campos obligatorios

Los 2 campos obligatorios son una marca de tiempo para identificar cuándo se produjo el evento, y una propiedad de cliente (un correo electrónico o un ID único) para identificar quién realizó la acción.

• Marca de tiempo: Una marca de tiempo que muestra el día y la hora del suceso. El formato es AAAA-mercado de mediana empresa (MM+)-DD HH:mercado de mediana empresa (MM+):SS. Por ejemplo, las 13:30 del 14 de noviembre de 2012 serían 2012-11-14 13:30:00.

  Si dos o más eventos de tu archivo CSV tienen la misma fecha y hora, debes incluir un $event_id único, o sólo se importará uno de los eventos y se omitirá el resto. Consulta la sección sobre $event_id más abajo.

• Person//correo electrónico o Person//ID: Lo más probable es que utilices un correo electrónico para identificar a tu cliente. Algunos clientes también utilizarán un identificador único. Si quieres, puedes utilizar ambos.

Campos opcionales

Hay 2 campos especiales que debes tener en cuenta.

• $id_evento: Es un identificador único para el evento. En la práctica, debes enviar un $event_id si tienes un identificador único para cada evento (por ejemplo, un ID de pedido). También debes establecer el $event_id si esperas que ciertos eventos ocurran en el mismo momento. Esto puede ocurrir cuando alguien realiza una acción que tú dividirás en varios eventos. Por ejemplo, si alguien compra varios artículos, puede que quieras registrar 1 evento por cada artículo comprado.
  
  En los 2 conjuntos de datos de ejemplo que aparecen a continuación hay 1 evento de pedido realizado, junto con 3 eventos de producto pedido (1 por cada producto del pedido realizado). Todos estos eventos tienen la misma marca de tiempo, pero todos se importarán porque cada uno tiene un $event_id único. Si los $event_ids fueran idénticos, o si estuvieran ausentes, sólo se importaría uno de los eventos y se omitirían los demás.
  
• $valor: Utiliza este campo si el evento que estás importando incluye un valor. Por ejemplo, si estás importando datos de eventos Pedido realizado, cada pedido tendrá un valor. No es necesario que antepongas a tus valores un $ u otro símbolo de moneda.

Si tienes datos adicionales sobre la persona que hizo algo, deben ir en una columna cuya etiqueta empiece por Persona// y luego el tipo de datos que tiene esa columna. Por ejemplo, si tuvieras la empresa u organización a la que pertenece cada persona, querrías etiquetar esa columna Persona/Organización. El prefijo especial nos permite saber que debemos asociar los datos de esa columna a cada persona y no a la actividad. Las siguientes son columnas especiales que puedes utilizar para ayudarte a identificar a las personas:

• Persona/ Nombre: nombre
• Persona/Apellido: apellido
• Persona//Teléfono: número de teléfono
• Persona/Organización: organización
• Persona/Title: cargo

Si tienes datos adicionales sobre cada acción, puedes incluirlos en columnas adicionales con las etiquetas que quieras. Por ejemplo, si alguien compra algo y quieres incluir qué artículo compró, podrías incluir esos datos en una columna llamada Artículo comprado. Aquí tienes algunos ejemplos.

• Artículo comprado
• Categoría del artículo
• Producto
• La ubicación

Si no tienes datos para una columna concreta, déjala en blanco y la ignoraremos. Por ejemplo, si no conoces la organización de alguien, puedes dejar en blanco la columna Persona/Organización y omitiremos el seguimiento de esa propiedad para esa fila de tus datos.

Cuando hayas terminado de formatear tus datos, guárdalos en un archivo CSV.

Cargar un archivo CSV de datos

Después de formatear correctamente tus datos, dirígete a Klaviyo. 

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Selecciona Administrar datos > Importar con CSV.
3. Se te pedirá que cargues tu archivo CSV y, a continuación, haz clic en Siguiente.
4. Tendrás la oportunidad de dar nombre al evento. Si intentas asignar los datos importados a una métrica de evento que ya existe en tu cuenta, asegúrate de escribir el nombre del evento exactamente como aparece.
5. Una vez que hayas nombrado tu evento, puedes previsualizar tus datos a continuación.
6. Cuando estés listo para importar tus datos, haz clic en Siguiente. Tu archivo comenzará a procesarse y podrás salir de la página. 

Nota para tienda de ecommerce cargar datos de compra

Si vas a subir datos de compra, querrás subir dos archivos: uno para el pedido global, y un segundo que incluya los datos artículo por artículo.  Por ejemplo, un cliente puede hacer un pedido de varios productos. En este caso habría 1 evento para el Pedido Realizado, y luego eventos separados para cada uno de los Productos Pedidos. Así es como deberían ser normalmente las cabeceras de esos archivos:

Pedido realizado

Producto pedido

No utilizamos el $ para prefijar el valor del pedido. Utiliza sólo números para indicar el precio o el valor de un pedido. Si utilizas el encabezado $valor, los datos se rellenarán correctamente en tu cuenta de Klaviyo.

La razón de incluir dos métricas es que facilita la activación posterior del correo electrónico tanto a partir de un pedido global como de categorías / artículos específicos.

Para los eventos de Producto pedido, $event_id tiene que ser un identificador único para cada combinación de pedido y producto pedido. Una forma fácil de crear un identificador único es combinar el ID de Pedido y el ID de Producto, como en el ejemplo anterior.

importar solución de problemas

A continuación se indican algunos problemas comunes y resoluciones que puedes encontrar al importar manualmente datos históricos de sucesos.

Mi importación está tardando mucho

importar puede tardar entre 5 minutos y 24 horas, dependiendo del tamaño de tu lista. Te recomendamos encarecidamente que empieces a importar cualquier lista al menos 24 horas antes de necesitarla para una campaña determinada, para asegurarte de que el proceso de importación no retrasa tu envío.

Mi importación sigue fallando

Si tu importación falla, es probable que se deba a una de las siguientes razones:

• ¿Tu archivo es un archivo .csv? Tu archivo debe estar en .csv formato. Si intentas subir un archivo Excel o un archivo .txt archivo, la importación fallará.
• ¿Has formateado correctamente la columna Marca de tiempo? Debes formatear la fecha y la hora como AAAA-mercado de mediana empresa (MM+)-DD HH:mercado de mediana empresa (MM+):SS. Por ejemplo, las 13:30 del 14 de noviembre serían 2012-11-14 13:30:00. Como segunda comprobación, abre el CSV en un editor de texto para asegurarte de que no se eliminan los 0 finales de las marcas de tiempo al guardar o exportar los archivos CSV. Si trabajas con datos en una hoja de cálculo, asegúrate de que las celdas de Marca de tiempo están configuradas con el formato de marca de tiempo correcto.
  
• ¿Todas las columnas obligatorias tienen datos rellenados en cada fila? Debes tener una columna con la etiqueta Persona//correo electrónico o Persona//ID. Si alguna de estas columnas tiene una fila vacía, tu importación puede fallar.
• ¿Tu columna Persona//correo electrónico contiene direcciones de correo electrónico no válidas? Si tienes valores dentro de Persona//correo electrónico que no tienen un formato de dirección de correo electrónico válido, esto puede hacer que tu importación falle.
• ¿Todas tus columnas están etiquetadas correctamente? ¿Hay espacios en blanco? Asegúrate de que todos los encabezados de tus columnas coinciden con lo indicado en esta guía. También deberás asegurarte de que no hay espacios en los nombres de las columnas.

Recursos adicionales

• Formatos de fecha y hora aceptables para la referencia de las propiedades de perfil y evento
• Formato de fechas para referencia de archivos CSV
• Migrar a Klaviyo