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 contiene un encabezado único y no vacío para cada columna
• Cada fila tiene un identificador único válido, como una dirección de correo electrónico, un número de teléfono o un ID externo
• 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.

Í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. Lamentablemente, no hay forma de acelerar este proceso una vez que ha comenzado. Sin embargo, una forma de acelerar el proceso de importación de manera preventiva es eliminar todos los correos electrónicos duplicados del CSV antes de importar. Te recomendamos ampliamente planificar la importación de una nueva lista al menos con 1 día de anticipación a cuando planeas enviar un correo electrónico 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, abre la lista y selecciona la pestaña Importaciones para revisar su progreso y los resultados. Te enviaremos un correo electrónico en cuanto finalice una importación de lista.

Solución de problemas de importación

Si tu archivo no se carga o se omiten algunas filas, revisa los errores comunes 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 Errors en el CSV descargado para identificar y corregir las filas afectadas. Elimina las columnas Errors y Warnings del archivo corregido para que no se importen como propiedades del perfil.
4. Haz clic en Cargar nuevo archivo y carga el CSV corregido. Asigna sus 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 con la guía de solución de problemas a continuación y corrígelo antes de volver a subirlo.

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 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 tus datos. Cada fila necesita un identificador único válido; no se requiere una dirección de correo electrónico cuando se proporciona otro identificador aceptado.

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 de propiedades de consentimiento 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
• Número
  Todos los números. No incluyas símbolos de moneda en campos numéricos.
  • Ejemplos:
    2
    5.0031
    130.0
• Booleano
  Valores verdaderos o falsos.
  • Ejemplos:
    verdadero
    falso
• 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
• 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 de su canal y tipo de consentimiento, como Consentimiento de marketing por correo electrónico, Consentimiento de marketing por SMS o Consentimiento transaccional por SMS. Estas propiedades usan el tipo de datos Texto. Ingresa "suscribirse", "nunca suscribirse" o "cancelar la suscripción" 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 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.

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

Solución de problemas de mensajes de error de identificador único duplicado o faltante

Identificadores duplicados

Los errores de identificador duplicado significan que varias filas usan el mismo identificador de perfil, como una dirección de correo electrónico 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 detalles 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 que se omitieron debido a identificadores duplicados. Revisa los detalles que quieres conservar antes de volver a cargar, 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 correo electrónico, 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 omitieron debido a identificadores faltantes. Agrega 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 subirlo.

Falta un valor en un campo obligatorio

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

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.

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