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 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. Email debe ir en primer lugar cuando subas tu CSV.

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

Campos obligatorios

Los 2 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 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: 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

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

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Selecciona Gestionar fuentes > importar vía CSV.
3. Se te pedirá que subas 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 comercio electrónico cargando datos de compra

Si estás subiendo datos de compra, querrás subir dos archivos: uno para el pedido global, y un segundo que incluya 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 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

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 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 la referencia de las propiedades de perfil y evento
• Formato de fechas para archivos CSV de referencia
• Migrar a Klaviyo