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 usar integraciones creadas por Klaviyo con plataformas como Shopify, Magento y BigCommerce, y nuestra interfaz de programación de aplicaciones (API) para integraciones personalizadas, también es posible agregar estos datos manualmente. Un ejemplo común de esto es agregar datos históricos de compras desde una plataforma de ecommerce anterior para la que Klaviyo no tiene una integración predefinida.

Ten en cuenta que hay un límite de 50 MB para las cargas de CSV.

Dar formato a tus datos

El primer paso es dar el formato correcto a los 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 a continuación. Cada fila del archivo CSV debe representar una acción o actividad que alguien realizó, como "Producto comprado" o "Registro para un webinar". Si tienes varias acciones para hacer seguimiento, debes cargarlas como archivos CSV separados. La dirección de correo electrónico debe ir primero al cargar el archivo CSV.

Estos son algunos CSV de eventos de ejemplo que puedes usar como referencia al dar formato a los datos.

Campos obligatorios

Los 2 campos obligatorios son una marca de tiempo para identificar cuándo ocurrió el evento y una propiedad del 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 evento. El formato es AAAA-MM-DD HH:MM:SS. Por ejemplo, 1:30 p.m. del 14 de noviembre de 2012 sería: 2012-11-14 13:30:00.

• Persona//Correo electrónico o Persona//ID: Lo más probable es que uses un correo electrónico para identificar a tus clientes. Algunos clientes también usarán un ID único. Puedes usar ambos si quieres.

Campos opcionales

Hay 2 campos especiales que debes tener en cuenta.

• $event_id: este es un identificador único para el evento. En la práctica, deberías enviar un $event_id si tienes un identificador único para cada evento (p. ej., un ID de pedido). También deberías configurar el $event_id si esperas que ciertos eventos ocurran en el mismo momento. Esto puede ocurrir cuando alguien realiza una acción que dividirás en varios eventos. Por ejemplo, si alguien compra varios artículos, es posible que quieras registrar 1 evento por cada artículo comprado.
  
  En los 2 conjuntos de datos de muestra a continuación, hay 1 evento de pedido realizado, junto con 3 eventos de producto pedido (1 para cada producto del pedido realizado). Todos estos eventos tienen la misma marca de tiempo, pero se importarán todos porque cada uno tiene un $event_id único. Si los $event_ids fueran idénticos o si no estuvieran presentes, entonces solo se importaría uno de los eventos y los demás se omitirían.
  

• $value: Usa este campo si el evento que estás importando incluye un valor. Por ejemplo, si importas datos de eventos de Pedido realizado, cada pedido tendrá un valor. No necesitas anteponer a los valores un $ u otro símbolo de moneda.

Si se tiene datos adicionales sobre la persona que hizo algo, deben ir en una columna cuya etiqueta comience con Person// y luego el tipo de datos que contiene esa columna. Por ejemplo, si se tuviera la empresa u organización a la que pertenece cada persona, convendría etiquetar esa columna como Person//Organization. El prefijo especial permite saber que se debe asociar la información de esa columna con cada persona, en lugar de con la actividad. Las siguientes son columnas especiales que se pueden usar para ayudarte a identificar a las personas:

• Persona//Nombre: nombre
• Persona//Apellido: apellido
• Persona//Teléfono: número de teléfono
• Person//Organization: organización
• Persona//Cargo: puesto de trabajo

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ó, puedes incluir esos datos en una columna con la etiqueta Artículo comprado. A continuación, se muestran algunos ejemplos.

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

Si no tienes datos para una columna en particular, 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 en tus datos.

Cuando termines de dar formato a los datos, guárdalos en un archivo CSV.

Cargar un archivo CSV de datos

Después de que los datos tengan el formato correcto, ve 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 luego hagas clic en Siguiente.
4. Tendrás la oportunidad de asignarle un nombre al evento. Si intentas asignar los datos importados a una métrica de evento que ya existe en la cuenta, asegúrate de escribir el nombre del evento exactamente como ya aparece.

5. Una vez que hayas nombrado el evento, puedes previsualizar los datos abajo.
6. Cuando estés listo para importar los datos, haz clic en Siguiente. El archivo comenzará a procesarse y puedes salir de la página.

Nota para tiendas de ecommerce que cargan datos de compras

Si vas a cargar datos de compras, tendrás que cargar dos archivos: uno para el pedido general y otro que incluya los datos de cada artículo.  Por ejemplo, un cliente podría hacer un pedido de varios productos. En este caso, habría 1 evento de pedido realizado y luego eventos separados para cada uno de los productos pedidos. Así es como suelen verse los encabezados de esos archivos:

Pedido realizado

Producto Pedido

No usamos el $ para anteponer los valores de los pedidos. Usa solo números para indicar el precio o valor de un pedido. Usar el encabezado $value completará los datos correctamente en tu cuenta de Klaviyo.

El motivo para incluir dos métricas es que facilita activar después correos electrónicos tanto a partir de un pedido general como de categorías o artículos específicos.

Para los eventos de Ordered Product, $event_id debe ser un identificador único para cada combinación del pedido y el producto pedido. Una forma sencilla de crear un identificador único es combinar el ID del pedido y el ID del producto, como en el ejemplo anterior.

Solución de problemas de importación

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

Mi importación está tardando mucho

Las importaciones pueden tardar entre 5 minutos y 24 horas, según el tamaño de la lista. Recomendamos ampliamente comenzar la importación de cualquier lista al menos 24 horas antes de necesitarla para una campaña determinada, para asegurarte de que el proceso de importación no retrase el envío.

Mi importación sigue fallando

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

• ¿Tu archivo es un archivo .csv? El archivo debe estar en formato .csv formato. Si intentas cargar un archivo de Excel o un archivo .txt, la importación fallará.
• ¿Formateaste correctamente la columna Timestamp? Debes formatear la fecha y la hora como YYYY-MM-DD HH:MM:SS. Por ejemplo, la 1:30 p.m. del 14 de noviembre sería: 2012-11-14 13:30:00. Como segunda verificación, abre el CSV en un editor de texto para asegurarte de que no se eliminen los 0 finales de tus timestamps al guardar o exportar los archivos CSV. Si trabajas con datos en una hoja de cálculo, asegúrate de que las celdas de Timestamp estén configuradas con el formato de timestamp correcto.
  

• ¿Todas las columnas obligatorias tienen datos llenados en cada fila? Debes tener una columna con la etiqueta Person//Email o Person//ID. Si cualquiera de estas columnas tiene una fila vacía, esto puede hacer que la importación falle.
• ¿Tu columna Person//Email contiene direcciones de correo electrónico no válidas? Si tienes valores en Person//Email que no tienen un formato de dirección de correo electrónico válido, esto puede hacer que tu importación falle.
• ¿Todas las columnas están etiquetadas correctamente? ¿Hay espacios? Asegúrate de que todos los encabezados de columna coincidan con lo que se describe en esta guía. También asegúrate de que no haya espacios en los nombres de las columnas.

Recursos adicionales