Resolución de problemas de importaciones de listas
Objetivos del artículo
Aprende a solucionar errores que se producen al subir un archivo CSV de contactos a una lista nueva o existente en Klaviyo. ¿Vas a subir reseñas? Consulta nuestro artículo sobre cómo importar reseñas.
Antes de empezar
¿Quieres asegurarte de que el archivo se importará? Revisa la lista de requisitos que aparece abajo antes de importar la 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 una dirección de correo electrónico o un número de teléfono asociado
- No hay direcciones de correo electrónico ni números de teléfono duplicados
Nuestro equipo de servicio de asistencia no puede importar archivos CSV a Klaviyo en tu nombre. Si necesitas ayuda con una importación, consulta la sección de solución de problemas a continuación para obtener consejos sobre cómo resolver correctamente problemas de importación de listas.
¿Tienes problemas para subir una lista de perfiles con consentimiento de SMS? Consulta la guía de Klaviyo para subir una lista de contactos de SMS.
Índice
- Retraso de importación
- Solución de problemas de importación
- Todas las columnas se importaron como un solo 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 faltante
- Falta un valor en un campo obligatorio
- Problemas de formato del número de teléfono
Retraso de importación
Si importas un archivo grande con una cantidad importante de datos, el proceso de importación puede tardar varias horas en completarse. Desafortunadamente, no hay forma de acelerar este proceso una vez que ha comenzado. Sin embargo, una forma de agilizar el proceso de importación de manera preventiva es eliminar todos los correos electrónicos duplicados del CSV antes de importar. Recomendamos ampliamente planear importar una nueva lista al menos con un día de anticipación a cuando piensas enviar correos electrónicos a los contactos de la lista.
Después de que comience una importación, al principio verás una barra de estado. Si sales de la página, todavía podrás dar seguimiento al progreso de la importación viendo cómo el conteo de la lista aumenta con el tiempo. Te enviaremos un correo electrónico en cuanto finalice la importación de una lista.
Solución de problemas de importación
Si no se carga la lista, busca los siguientes errores comunes en el archivo CSV que podrían estar causando este bloqueo:
Todas las columnas se importaron como un solo campo
Si usas una versión de Excel que no usa inglés como idioma predeterminado, es posible que tu software use punto y coma y no comas como separador en tu archivo. Si este es el caso, tu archivo puede verse así al importarlo:
Para solucionarlo, ve a la configuración de Formato de número o Separador de lista (o de números) de tu computadora. Es probable que esta configuración esté en Idioma y región, y puede estar dentro de la sección Configuración avanzada. Reemplaza el punto y coma por una coma y guarda. Ahora, cuando exportes archivos como CSV, usarán el formato con coma. Ten en cuenta que la ubicación exacta de esta configuración puede variar entre sistemas operativos.
Además, revisa para asegurarte de que el CSV cumpla con los requisitos de formato de Klaviyo. Si aún no lo has hecho, consulta nuestra documentación sobre dar formato a los datos. Por ejemplo, uno de los campos obligatorios es el de las direcciones de correo electrónico.
Solución de mensajes de error de formato no válido
Cuando importas una lista a Klaviyo, la página de asignación de campos te permite hacer coincidir cualquier propiedad con su tipo de datos correspondiente en Klaviyo. Por ejemplo, Email siempre tiene un tipo de datos Texto; en cambio, si cargas una propiedad personalizada para Cumpleaños, te conviene configurar el tipo de datos como Fecha.
Revisa los tipos de datos, los formatos aceptables y los ejemplos a continuación.
- Texto
Cualquier texto o combinación de texto y números. Si no estás seguro en qué formato están los datos, elige esta opción.- Ejemplos:
email@example.com
Hola, mundo
$5.00
- Ejemplos:
- Numérico
Todos los números. No incluyas símbolos de moneda en los campos numéricos.- Ejemplos:
2
5.0031
130.0
- Ejemplos:
- Booleano
Valores verdaderos o falsos.- Ejemplos:
verdadero
falso
- Ejemplos:
- Fecha
Consulta nuestra guía sobre formatos de fecha y marcas de tiempo admisibles para las propiedades de perfiles y eventos para conocer los formatos de fecha aceptados.- Ejemplo:
2014-09-01 13:34:08
- Ejemplo:
- Lista
Los datos deben tener el formato de una matriz JSON.- Ejemplos:
["apples","bananas","oranges"]
["apples"]
- Ejemplos:
- Consentimiento
El consentimiento tiene el formato del canal (correo electrónico, SMS, etc.) y el tipo de consentimiento (si hay varios tipos disponibles en Klaviyo). La única opción para correo electrónico es Consentimiento de marketing por correo electrónico; para SMS, sería Consentimiento de marketing por SMS o Consentimiento transaccional por SMS; etc. El valor de este campo debe ser "suscribirse", "Nunca se suscribió" o "cancelar la suscripción".
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 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 de mensajes de error de formato no válido.
Formato incorrecto de fecha o marca de tiempo
Es posible que estés usando un formato incorrecto para fechas u marcas de tiempo. Si incluiste alguno de estos 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 de evento.
Solución de problemas de mensajes de error de identificador único duplicado o faltante
Identificadores duplicados
Los registros omitidos debido a "Duplicate Unique ID" significan que una dirección de correo electrónico 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 vuelve a subir estos registros omitidos si es necesario.
Faltan identificadores únicos
Los registros omitidos debido a “Falta un ID único” significan que las filas omitidas no contenían una dirección de correo electrónico, 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, agrega una dirección de correo electrónico o un número de teléfono para cada uno y vuelve a cargar el nuevo archivo.
Falta un valor en un campo obligatorio
Verifica 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 correo electrónico en la columna de correo electrónico, verás un error al cargarlo. Revisa para asegurarte de que cada contacto que quieras cargar tenga un valor en todos los campos obligatorios. Si están vacíos, complétalos antes de tu próximo intento de carga.
Dirección de correo electrónico no válida o caracteres no reconocidos
Si recibes este mensaje de error, revisa las direcciones de correo electrónico del archivo para detectar caracteres no válidos. Los caracteres no válidos incluyen ( ) , : ; [ / ], así como espacios.
A fin de mantener la seguridad de tus datos, el equipo de asistencia de Klaviyo no puede abrir tus archivos CSV. Si necesitas ayuda adicional para solucionar un problema de importación de listas, ponte en contacto con el equipo de asistencia con una descripción detallada del problema y capturas de pantalla del error que hayas encontrado.
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 con la fecha en la que se crea un perfil en la cuenta. Otro conjunto de ejemplos son Primero con actividad y Último con actividad, ya que se establecen automáticamente según 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 separada que indique el país, y deben seguir un formato de número de teléfono aceptado. Aprende a dar el formato correcto y cargar números de teléfono.
Recursos adicionales
- Cómo importar suscriptores a una lista
Aprende a añadir suscriptores a una lista en Klaviyo. Cargar contactos es clave cuando das los primeros pasos con Klaviyo, sobre todo si estás migrando desde otro proveedor de servicios o incorporando información de un tercero.
- Referencia de formatos de fecha y marca de tiempo aceptables para las propiedades de perfil y evento
Descubre qué formatos de fecha y hora reconoce Klaviyo en los datos de eventos y perfiles enviados a través de nuestras interfaz de programación de aplicaciones (API) o en una carga de CSV. Ten en cuenta que esto no aplica a una marca de tiempo de evento enviada a través de la interfaz de programación de aplicaciones (API) de seguimiento, que debe ser tiempo Unix en segundos.