Qué aprenderás

Descubre cómo 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 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 compra de una plataforma de comercio electrónico anterior para la que Klaviyo no tiene una integración prediseñada.

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

Dales formato a tus datos

El primer paso es dar el formato correcto a los datos en un archivo CSV. Usa la primera fila para los encabezados de columna. Cada fila restante debe representar una acción o actividad que alguien realizó, como «Compró un producto» o «Se registró en un seminario web». Si tienes varios tipos de acciones para hacer seguimiento, cárgalas como archivos CSV independientes. Las columnas pueden aparecer en cualquier orden.

Aquí tienes algunos CSV de eventos de ejemplo que puedes consultar al dar formato a tus 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 email 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. Usa el formato 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.

Si hay 2 o más eventos para la misma persona y métrica con la misma marca de tiempo, incluye un $event_id diferente para cada evento o solo se importará 1 y el resto se omitirá. Consulta la sección sobre $event_id a continuación.

  • Person//Email or Person//ID: lo más probable es que uses un email 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: Es un identificador único del 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 se produzcan varios eventos para la misma persona y métrica al mismo tiempo. Esto puede ocurrir cuando alguien realiza una acción que 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 muestra que aparecen a continuación hay 1 evento Placed Order, junto con 3 eventos Ordered Product (1 por 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 3 eventos Ordered Product tuvieran valores de $event_id idénticos, o no tuvieran valores de $event_id, solo se importaría 1 evento Ordered Product. El evento Placed Order pertenece a una métrica diferente y se importaría por separado.
mceclip0.png
mceclip0.png
mceclip1.png
mceclip1.png
  • $value: usa este campo si el evento que estás importando incluye un valor. Por ejemplo, si estás importando datos del evento Placed Order, cada pedido tendrá un valor. Usa solo números, sin un $ ni ningún otro símbolo de moneda.

Si tienes datos adicionales sobre la persona que ha hecho algo, deben ir en una columna cuya etiqueta empiece por Person// 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, te interesaría etiquetar esa columna como Person//Organization. El prefijo especial nos permite saber que hay que asociar los datos de esa columna con cada persona en lugar de con la actividad. A continuación se indican columnas especiales que puedes usar para ayudarte a identificar a las personas:

  • Persona//Nombre: nombre
  • Persona//Apellidos: apellidos
  • Persona//Teléfono: número de teléfono
  • Person//Organization: organización
  • Persona//Puesto: 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ó, podrías 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
  • Ubicación

Si no tienes datos para una columna opcional 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 de Person//Organization y omitiremos el seguimiento de esa propiedad para esa fila en tus datos.

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

Subir un archivo CSV de datos

Para importar datos, el rol de usuario debe tener permiso para gestionar integraciones.

  1. En Klaviyo, selecciona la pestaña Integraciones.
  2. Selecciona Gestionar datos > Importar a través de CSV.
  3. Se te pedirá que subas el archivo CSV y, a continuación, hagas clic en Siguiente.
  4. Introduce un nombre en Nombre del evento o la acción. Para añadir eventos a una métrica de una importación de CSV anterior, introduce su nombre exactamente. Que el nombre de una métrica coincida con el de otra integración no añade datos a esa métrica por sí solo.
  5. Selecciona la zona horaria que coincida con las marcas de tiempo del archivo. Si las marcas de tiempo están en UTC, selecciona UTC.
  1. Revisa los nombres de las columnas y la primera fila de valores en Previsualiza tus datos.
  2. Cuando estés listo para importar tus datos, haz clic en Siguiente. Tu archivo empezará a procesarse y podrás salir de la página.
  3. Cuando finalice el procesamiento, comprueba el número de filas cargadas. Haz clic en Listo para volver a integraciones.

Nota para tienda de comercio electrónico que cargan datos de compra

Si vas a cargar datos de compra, tendrás que cargar 2 archivos: 1 para el pedido en general y un segundo que incluya los datos por 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. Normalmente, los encabezados de esos archivos deberían tener este aspecto:

Pedido Realizado

Persona//Email

Persona//Nombre

Persona//Apellidos

Marca de tiempo

$event_id

$value

Cantidad

Artículos

John@gmail.com

John

Sánchez

2014-03-10 08:55:01

12425

49,00

2

["Matar a un ruiseñor", "Pictionary"]

Producto Pedido

Persona//Email

Persona//Nombre

Persona//Apellidos

Marca de tiempo

$event_id

$value

Cantidad

Artículo

John@gmail.com

John

Sánchez

2014-03-10 08:55:01

12425_TKM

24,00

1

Matar a un ruiseñor

John@gmail.com

John

Sánchez

2014-03-10 08:55:01

12425_P

25,00

1

Pictionary

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

La razón para incluir 2 métricas es que facilita activar más adelante emails 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 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 encontrarás algunos problemas comunes y sus soluciones que puedes ver al importar manualmente datos históricos de eventos.

Mi importación está tardando mucho

Las importaciones pueden tardar entre 5 minutos y 24 horas, en función del tamaño del archivo. Recomendamos iniciar la importación al menos 24 horas antes de necesitar los datos para una campaña, para que el proceso de importación no retrase el envío.

La importación falla o se omiten filas

Si el archivo no se carga o no se importan algunas filas, comprueba lo siguiente:

  • ¿Tu archivo es un archivo .csv? Tu archivo debe estar en formato .csv formato. Si intentas subir un archivo de Excel o un archivo .txt archivo, la importación fallará.
  • ¿Has dado el formato correcto a la columna Timestamp? Usa el formato de fecha y hora YYYY-MM-DD HH:MM:SS. Por ejemplo, las 1:30 p. m. del 14 de noviembre de 2012 serían: 2012-11-14 13:30:00. Como segunda comprobación, abre el CSV en un editor de texto para asegurarte de que los 0 finales de las marcas de tiempo no se eliminen al guardar o exportar los archivos CSV. Si trabajas con datos en una hoja de cálculo, asegúrate de que las celdas Timestamp estén configuradas con el formato de marca de tiempo correcto.
  • ¿Todas las columnas obligatorias tienen datos completados en cada fila? Incluye una columna de Timestamp y al menos 1 de Person//Email o Person//ID. Cada fila necesita una marca de tiempo y un identificador de cliente. Si incluyes Person//Email, cada fila debe tener una dirección de email válida, aunque Person//ID también esté presente.
  • ¿La columna Person//Email tiene direcciones de email no válidas? Si los valores de la columna Person//Email no tienen un formato de dirección de email válido, se omitirán esas filas.
  • ¿Todas las columnas están etiquetadas correctamente? Haz coincidir Timestamp y el encabezado de identificador de cliente elegido (Person//Email o Person//ID) exactamente, incluidas las mayúsculas. Elimina los espacios adicionales antes o después de estos encabezados. Se permiten los espacios dentro de los nombres de propiedades, como en Person//First Name o Item Purchased.

Recursos adicionales

¿Te ha resultado útil este artículo?
Utiliza este formulario solo para enviar comentarios sobre el artículo. Más información sobre cómo contactar con el servicio de asistencia.

Descubre más sobre Klaviyo

Klaviyo Community
Conecta con compañeros, socios y expertos de Klaviyo para encontrar ideas, compartir información y resolver todas tus dudas.
Socios
Contrata a un experto certificado por Klaviyo para ayudarte con una tarea específica o para la gestión continua de marketing.
Asistencia

Accede al servicio de asistencia a través de tu cuenta.

Asistencia por correo electrónico (prueba gratuita y cuentas de pago) Disponible 24/7

Asistencia por chat/virtual
La disponibilidad varía según la ubicación y el tipo de plan