Resolución de problemas de importación de listas

Qué aprenderás

Aprende a solucionar los errores que se producen al subir un CSV de contactos a una lista nueva o existente en Klaviyo. ¿Vas a subir reseñas? Para saber más, lee nuestro artículo sobre cómo importar reseñas.

Antes de empezar

¿Quieres asegurarte de que tu archivo se importará? Consulta la lista de requisitos que se muestra a continuación antes de importar tu lista.

• Archivo CSV (no en ningún otro formato)
• El tamaño del archivo es de 50 MB o menos
• La primera fila son encabezados
• Cada fila tiene asociada una dirección de email o un número de teléfono.
• No hay direcciones de email ni números de teléfono duplicados.

Nuestro equipo de soporte no puede importar archivos CSV a Klaviyo en tu nombre. Si necesitas ayuda con una importación, consulta la sección de resolución de problemas a continuación para obtener consejos sobre cómo solucionar correctamente los problemas de importación de listas.

Tabla de contenidos

• Retraso en la importación
• Solución de problemas de importación
• Todas las columnas importadas como un único campo
• Mensajes de error de formato no válido
• Formato incorrecto de fecha o marca de tiempo
• Mensajes de error de identificador único duplicado o ausente
• Falta un valor en un campo obligatorio
• Problemas de formato del número de teléfono

Retraso en la importación

Si importas un archivo grande con una cantidad significativa de datos, el proceso de importación puede tardar varias horas en completarse. Lamentablemente, no hay forma de acelerar este proceso una vez que ha comenzado. Sin embargo, una forma de acelerar de forma proactiva el proceso de importación es eliminar todos los emails duplicados de tu CSV antes de importar. Te recomendamos encarecidamente planificar la importación de una nueva lista al menos un día antes de cuando tengas pensado enviar un email a los contactos de la lista.

Después de que comience una importación, al principio verás una barra de estado. Si haces clic fuera, podrás seguir el progreso de la importación viendo cómo aumenta el recuento de la lista con el tiempo. Te enviaremos un email en cuanto finalice la importación de una lista.

Solución de problemas de importación

Si tu lista no se sube, busca los siguientes errores comunes en tu archivo CSV que pueden estar causando este obstáculo:

Todas las columnas importadas como un único campo

Si usas una versión de Excel que no utiliza el inglés como idioma predeterminado, es posible que tu software use puntos y comas, y no comas, como separador en tu archivo. Si es así, es posible que tu archivo se vea así al importarlo:

Para solucionarlo, ve a la configuración de Formato de número o Separador de listas (o números) de tu ordenador. Esta configuración probablemente se encuentre en los ajustes de Idioma y región y puede estar en la sección Ajustes avanzados. Sustituye el punto y coma por una coma y guarda. Ahora, cuando exportes archivos como CSV, usarán el formato de coma. Ten en cuenta que la ubicación exacta de esta configuración puede variar según el sistema operativo.

Además, asegúrate de que tu CSV se ajusta a los requisitos de formato de Klaviyo. Si aún no lo has hecho, consulta nuestra documentación sobre dar formato a tus datos. Por ejemplo, uno de los campos obligatorios es el de las direcciones de email.

Solución de errores de los mensajes de error de formato no válido

Cuando importas una lista en Klaviyo, la página de asignación de campos te permite asociar cualquier propiedad con su tipo de datos correspondiente en Klaviyo. Por ejemplo, Email siempre tiene un tipo de datos de Texto; mientras que, si subes una propiedad personalizada para Cumpleaños, querrás establecer el tipo de datos en Fecha.

Revisa a continuación los tipos de datos, los formatos aceptables y los ejemplos.

• Texto
  Cualquier texto, o cualquier combinación de texto y números. Si no tienes claro en qué formato están tus datos, elige esta opción.
  • Ejemplos:
    email@example.com
    Hola, mundo
    5,00 $
• Numérico
  Todos los números. No incluyas símbolos de moneda en los campos numéricos.
  • Ejemplos:
    2
    5,0031
    130,0
• Booleano
  Valores verdadero o falso.
  • Ejemplos:
    verdadero
    falso
• Fecha
  Consulta nuestra guía sobre formatos de fecha y hora aceptables para las propiedades de perfiles y eventos para obtener información sobre los formatos de fecha aceptados.
  • Ejemplo:
    2014-09-01 13:34:08
• Lista
  Los datos deben tener el formato de una matriz JSON.
  • Ejemplos:
    ["apples","bananas","oranges"]
    ["apples"]
• Consentimiento
  El consentimiento tiene el formato del canal (email, SMS, etc.) y el tipo de consentimiento (si hay varios tipos disponibles en Klaviyo). La única opción para email es Consentimiento de marketing por email; para SMS, sería Consentimiento de marketing por SMS o Consentimiento transaccional por SMS; etc. El valor de este campo debe ser "suscribirse," "nunca suscrito," o "darse de baja." 

Para obtener más información sobre lo que implican los diferentes tipos de datos y cuál seleccionar al importar tu lista, consulta nuestra guía sobre cómo entender los tipos de datos.

Para obtener más información sobre los mensajes de error «Formato de [tipo de datos] no válido» (p. ej., «Formato de lista no válido»), consulta nuestra guía de solución de problemas para mensajes de error de formato no válido.

Formato incorrecto de fecha o marca de tiempo

Puede que estés usando el formato incorrecto para fechas o marcas de tiempo. Si has incluido alguno de los dos y no estás seguro de los formatos aceptados por Klaviyo, consulta nuestra guía sobre formatos de fecha y marca de tiempo aceptables para propiedades de perfil y evento.

Solucionar problemas con los mensajes de error de identificador único duplicado o faltante

Duplicar identificadores

Los registros omitidos por "ID único duplicado" significan que una dirección de email o un número de teléfono se repitió en tu archivo. En estos casos, Klaviyo procesará los datos de la primera fila que contenga el identificador repetido y proporcionará todos los registros no procesados en un archivo descargable.

Haz clic en Descargar registros omitidos para ver los contactos omitidos debido a identificadores duplicados y volver a subir estos registros omitidos si es necesario.

Faltan identificadores únicos

Los registros omitidos debido a «Falta ID único» significan que las filas omitidas no contenían una dirección de email, un número de teléfono u otro identificador único aceptado.

Haz clic en Descargar registros omitidos para ver los contactos omitidos debido a identificadores faltantes, añade una dirección de email o un número de teléfono para cada uno y vuelve a cargar el nuevo archivo.

Falta un valor en un campo obligatorio

Comprueba que todos los campos obligatorios tengan valores asociados. Por ejemplo, si a uno de los contactos de la lista le falta una dirección de email en la columna de email, verás un error al subirlo. Comprueba que cada contacto que quieras subir tenga un valor en todos los campos obligatorios. Si están vacíos, complétalos antes de volver a intentar subirlos.

Dirección de email no válida o caracteres no reconocidos

Si recibes este mensaje de error, comprueba si las direcciones de email de tu archivo tienen caracteres no válidos. Los caracteres no válidos incluyen ( ) , : ; [ / ], así como espacios.

Transferencia de perfiles entre cuentas

Al transferir perfiles de una cuenta a otra, hay algunas propiedades que no se pueden cargar en otra cuenta.

Por ejemplo, perfil creado el no se puede transferir porque está configurado en la fecha en la que se crea un perfil en la cuenta. Otro conjunto de ejemplos son First Active y Last Active, ya que se configuran automáticamente en función de la actividad del perfil en la cuenta.

Problemas de formato del número de teléfono

Los números de teléfono deben incluir un código de país o una columna aparte que indique su país, y deben seguir un formato de número de teléfono aceptado. Aprende a dar el formato correcto y subir números de teléfono.

Recursos adicionales