Cómo importar manualmente datos históricos de eventos

Qué aprenderás

Aprenda a importar manualmente datos históricos de eventos a Klaviyo. Aunque recomendamos utilizar las integraciones construidas por Klaviyo con plataformas como Shopify, Magento y BigCommerce, y nuestra API para integraciones personalizadas, también es posible añadir estos datos manualmente. Un ejemplo común de esto es la adición de datos históricos de compra de una plataforma de comercio electrónico anterior para la que Klaviyo no tiene una integración pre-construida.

Tenga en cuenta que existe un límite de 50 MB para las cargas de CSV. 

Formatee sus datos

El primer paso consiste en formatear correctamente sus 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 su archivo CSV debe representar una acción o actividad que alguien haya realizado. Por ejemplo, "Compró el producto" o "Se inscribió en un seminario web." Si tiene varias acciones de las que realizar un seguimiento, deberá cargarlas como archivos CSV independientes. La dirección de correo electrónico debe ir en primer lugar cuando cargue su CSV.

Aquí tiene algunos CSV de eventos de ejemplo a los que puede remitirse cuando formatee sus datos.

Campos obligatorios

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

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

  Si dos o más eventos de su archivo CSV tienen la misma marca de tiempo, debe incluir un $event_id único, o sólo se importará uno de los eventos y se omitirá el resto. Consulte la sección sobre $event_id más abajo.

• Persona//Email o Persona//ID: Lo más probable es que utilice un correo electrónico para identificar a sus clientes. Algunos clientes también utilizarán un identificador único. Si lo desea, puede utilizar ambos.

Campos opcionales

Hay dos campos especiales de los que debe tomar nota.

• $event_id: Se trata de un identificador único para el evento. En la práctica, debería enviar un $event_id si dispone de un identificador único para cada evento, por ejemplo un ID de pedido. También debe establecer el $event_id si espera que ciertos eventos se produzcan en el mismo momento. Esto puede ocurrir cuando alguien realiza una acción que usted dividirá en varios eventos. Por ejemplo, si alguien compra varios artículos y usted desea registrar un evento por cada artículo comprado.
  
  En los dos conjuntos de datos de muestra que aparecen a continuación hay un evento de pedido realizado, junto con 3 eventos de producto pedido (uno por cada producto del pedido realizado). Todos estos eventos tienen la misma marca de tiempo, pero todos serán importados 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: Utilice este campo si el evento que está importando incluye un valor. Por ejemplo, si está importando datos de eventos de pedidos realizados, cada pedido tendrá un valor. No es necesario que anteponga a sus valores un $ u otro símbolo de moneda.

Si tiene datos adicionales sobre la persona que hizo algo, deben ir en una columna cuya etiqueta empiece por Persona// y a continuación el tipo de datos que tiene esa columna. Por ejemplo, si tuviera la empresa u organización a la que pertenece cada persona, querría 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 puede utilizar para ayudarle 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/cargo: cargo

Si dispone de datos adicionales sobre cada acción, puede incluirlos en columnas adicionales con las etiquetas que desee. Por ejemplo, si alguien compra algo y usted quiere incluir qué artículo compró, podría incluir esos datos en una columna denominada Artículo comprado. A continuación encontrará algunos ejemplos.

• Artículo comprado
• Categoría
• Producto
• Ubicación

Si no tiene datos para una columna concreta, déjela en blanco y la ignoraremos. Por ejemplo, si no conoce la organización de alguien, puede dejar en blanco la columna Persona/Organización y omitiremos el seguimiento de esa propiedad para esa fila de sus datos.

Una vez que haya terminado de formatear sus datos, guárdelos en un archivo CSV.

Cargar un archivo CSV de datos

Una vez que sus datos estén formateados correctamente, diríjase a Klaviyo y haga clic en el nombre de su cuenta en la parte inferior izquierda, después seleccione Integraciones > Gestionar fuentes > Importar vía CSV.

Se le pedirá que cargue su archivo CSV y, a continuación, haga clic en Siguiente.

A continuación, tendrá la oportunidad de dar nombre al evento. Si está intentando asignar los datos importados a una métrica de evento que ya existe en su cuenta, asegúrese de escribir el nombre del evento exactamente como ya aparece.

Una vez que haya dado nombre a su evento, podrá previsualizar sus datos a continuación. Cuando esté listo para importar sus datos, pulse Siguiente. Su archivo comenzará a procesarse y podrá salir de la página. 

Nota para tienda de comercio electrónico cargando datos de compra

Si está cargando datos de compra, querrá cargar 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 un evento para el Pedido Realizado, y luego eventos separados para cada uno de los Productos Pedidos. Este es el aspecto típico que deberían tener las cabeceras de esos archivos:

Pedido realizado

Producto pedido

No utilizamos el $ para anteponer los valores de los pedidos. Utilice sólo números para indicar el precio o el valor de un pedido. El uso de la cabecera $value rellenará los datos correctamente en su cuenta de Klaviyo.

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

Para los eventos de producto pedido, $event_id debe ser un identificador único para cada combinación de pedido y producto pedido. Una forma sencilla 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 las resoluciones que puede 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 dependiendo del tamaño de su lista -- recomendamos encarecidamente comenzar la importación de cualquier lista al menos 24 horas antes de necesitarla para una campaña determinada para asegurar que el proceso de importación no retrase su envío.

Mi importación sigue fallando

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

• ¿Es su archivo un archivo .csv? Su archivo debe estar en .csv formato. Si intenta cargar un archivo Excel o un archivo .txt archivo, la importación fallará.
• ¿Ha formateado correctamente la columna Timestamp? Debe formatear la fecha y la hora como AAAA-MM-DD HH:MM:SS. Por ejemplo, las 13:30 del 14 de noviembre serían: 2012-11-14 13:30:00. Como segunda comprobación, abra el archivo CSV en un editor de texto para asegurarse de que no se eliminan los ceros finales de las marcas de tiempo al guardar o exportar los archivos CSV. Si está trabajando con datos en una hoja de cálculo, asegúrese 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 para cada fila? Debe tener una columna con la etiqueta Persona//Email o Persona//ID. Si alguna de estas columnas tiene una fila vacía, esto puede hacer que su importación falle.
• ¿Su columna Persona/Correo electrónico contiene direcciones de correo electrónico no válidas? Si tiene valores dentro de Persona//Email que no tienen un formato válido de dirección de correo electrónico, esto puede hacer que su importación falle.
• ¿Están todas sus columnas etiquetadas correctamente? ¿Hay espacios en blanco? Asegúrese de que todos los encabezados de sus columnas coinciden con lo indicado en esta guía. También querrá asegurarse de que no hay espacios en los nombres de las columnas.

Recursos adicionales

• Formatos de fecha y hora aceptables para las propiedades de perfiles y eventos
• Cómo formatear fechas para archivos CSV
• Migrar a Klaviyo