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 contiene un encabezado único y no vacío para cada columna
• Cada fila tiene un identificador único válido, como una dirección de email, un número de teléfono o un ID externo
• 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. Por desgracia, no hay manera de acelerar este proceso una vez que ha comenzado. Sin embargo, una forma de agilizar el proceso de importación de forma preventiva es eliminar todos los emails duplicados del CSV antes de importarlo. Te recomendamos encarecidamente planificar la importación de una lista nueva con al menos 1 día de antelación con respecto al momento en que tengas previsto enviar un email a los contactos de la lista.

Tras iniciar una importación, al principio verás una barra de estado. Si haces clic fuera, abre la lista y selecciona la pestaña Importaciones para comprobar su progreso y sus resultados. Te enviaremos un email en cuanto se complete la importación de una lista.

Solución de problemas de importación

Si el archivo no se sube o se omiten algunas filas, revisa los errores comunes que se indican a continuación. Para encontrar y corregir filas omitidas después de que finalice una importación:

1. Abre la lista y selecciona la pestaña Importaciones.
2. Para una importación marcada como Completada con errores, haz clic en Descargar archivo de errores si el botón está disponible.
3. Usa la columna Errores del CSV descargado para identificar y corregir las filas afectadas. Elimina las columnas Errores y Advertencias del archivo corregido para que no se importen como propiedades de perfil.
4. Haz clic en Cargar nuevo archivo y carga tu CSV corregido. Asigna las columnas, revisa la configuración de consentimiento y haz clic en Importar para iniciar la importación.

Si Descargar archivo de errores no está disponible, revisa el CSV original según las indicaciones de resolución de problemas que aparecen a continuación y corrígelo antes de volver a subirlo.

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, comprueba que el archivo CSV se ajusta a los requisitos de formato de Klaviyo. Si aún no lo has hecho, consulta nuestra documentación sobre cómo dar formato a tus datos. Cada fila necesita un identificador único válido; no se requiere una dirección de email cuando se proporciona otro identificador aceptado.

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 los tipos de datos, los formatos de propiedades de consentimiento y los ejemplos que aparecen a continuación.

• 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 $
• Número
  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"]
• Propiedades de consentimiento
  Asigna cada columna de consentimiento a la propiedad correspondiente a su canal y tipo de consentimiento, como Consentimiento de marketing por email, Consentimiento de marketing por SMS o Consentimiento transaccional por SMS. Estas propiedades usan el tipo de datos Texto. Introduce "suscribirse", "Nunca se suscribió" o "darse de baja" como valor.

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.

Si aparece un error de marca de tiempo de consentimiento no válida, comprueba que la marca de tiempo refleje cuándo se otorgó el consentimiento y que sea el 1 de enero de 1990 o posterior. Comprueba también la zona horaria: una marca de tiempo sin desfase se interpreta como UTC, lo que puede hacer que una hora local parezca estar en el futuro.

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

Duplicar identificadores

Los errores de identificador duplicado significan que varias filas usan el mismo identificador de perfil, como una dirección de email o un número de teléfono. Klaviyo puede omitir las filas duplicadas y no debes confiar en que se importe la primera fila del archivo. Consolida los datos de cada contacto en 1 fila antes de volver a importar.

Haz clic en Descargar archivo de errores, si está disponible, para revisar las filas omitidas debido a identificadores duplicados. Comprueba los detalles que quieres conservar antes de volver a subirlos, ya que los valores importados pueden actualizar un perfil existente.

Faltan identificadores únicos

Un error de identificador único faltante significa que una fila omitida no contenía una dirección de email, un número de teléfono u otro identificador único aceptado.

Haz clic en Descargar archivo de errores, si está disponible, para revisar las filas que se han omitido debido a identificadores que faltan. Añade un identificador válido para cada contacto y asegúrate de que su columna esté asignada a la propiedad de Klaviyo correspondiente antes de volver a cargarlo.

Falta un valor en un campo obligatorio

Comprueba los campos obligatorios para la información que estás importando. Por ejemplo, una fila con consentimiento para email necesita una dirección de email, y una fila con consentimiento para SMS necesita un número de teléfono. Rellena el valor que falta o elimina la información de consentimiento que no se aplique a ese contacto antes de volver a subirlo.

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