Cómo importar términos del glosario en masa con un archivo CSV
Debes tener una cuenta de Klaviyo de pago y Traducción inteligente habilitada para usar esta función.
Importar un glosario existente
La función Traducción inteligente de Klaviyo usa un glosario para controlar cómo se traducen términos específicos: nombres de marca, nombres de productos, eslóganes o términos técnicos que necesitan una traducción coherente en cada campaña.
Si ya mantienes un glosario en otro sistema de traducción (DeepL, Lokalise, Phrase o una hoja de cálculo interna), puedes importarlo directamente a Klaviyo como CSV, en lugar de recrear cada entrada manualmente.
Cuándo usar la importación de CSV
La importación de CSV es útil cuando quieres:
- Importa un glosario existente en Klaviyo desde un TMS (sistema de gestión de traducciones), como DeepL, Lokalise, Phrase o memoQ.
- Agrega un gran lote de términos a la vez (decenas o cientos), en lugar de escribir cada uno en la IU.
- Migra un glosario que se mantiene en una hoja de cálculo compartida a una fuente única de información en Klaviyo.
Para solo unos cuantos términos, agregarlos manualmente, uno por uno, en el panel de glosario suele ser más rápido.
La importación es unidireccional. Subes los términos a Klaviyo, pero por el momento no hay exportación de CSV. Conserva una copia del archivo de origen si necesitas un respaldo.
Prepara el archivo CSV
Formato de archivo
- Codificación: UTF-8
- Tipo de archivo: .csv
- Delimitador: coma (,)
- Fila de encabezado: obligatoria (ver abajo)
Archivo de muestra
Término de origen | Término de destino | configuración regional de origen | configuración regional de destino |
|---|---|---|---|
hola | hola | ES | FR |
hola | hallo | ES | de |
tschüß | adiós | de | ES |
Columnas obligatorias
Cada fila debe incluir cuatro columnas:
source term— el término en el idioma de origentarget term— cómo se debe traducir el términosource locale— la etiqueta de configuración regional BCP-47 del idioma de origentarget locale— la etiqueta de configuración regional BCP-47 del idioma de destino
Los cuatro encabezados deben estar presentes en la primera fila del archivo. El orden de las columnas no importa.
Códigos de configuración regional (BCP-47)
Los códigos de configuración regional siguen el estándar BCP-47. La forma más común es un código de idioma de dos letras, opcionalmente seguido de una región:
en— Inglésen-US— Inglés (Estados Unidos)en-GB— Inglés (Reino Unido)fr— Francésfr-CA— Francés (Canadá)de— Alemánja— Japonéspt-BR— Portugués (Brasil)
Usa la etiqueta más específica que coincida con la configuración regional que hayas configurado en Klaviyo.
Varios pares de idiomas en un archivo
Un solo CSV puede incluir entradas para muchos pares de idiomas. Cada fila se trata de forma independiente, así que puedes mezclar pares libremente:
Término de origen | Término de destino | configuración regional de origen | configuración regional de destino |
|---|---|---|---|
hola | hola | ES | FR |
hola | hola | ES | es |
hola | hallo | ES | de |
hola | buenos días | FR | es |
Esto es útil si mantienes un solo glosario maestro que permite la traducción en varias configuraciones regionales.
Los términos del glosario son simétricos
Cada entrada del glosario define una equivalencia bidireccional entre términos. Si importas:
Término de origen | Término de destino | configuración regional de origen | configuración regional de destino |
|---|---|---|---|
hola | hola | ES | FR |
Klaviyo hará lo siguiente:
- Traduce
hellocomobonjoural traducir de inglés a francés. - Traduce
bonjourcomohelloal traducir de francés a inglés.
Esto significa que no puedes definir asignaciones asimétricas como:
Término de origen | Término de destino | configuración regional de origen | configuración regional de destino |
|---|---|---|---|
hola | hola | ES | FR |
hola | hola | FR | ES |
Ambas filas asignan bonjour a un término en inglés diferente, lo que genera un conflicto. Solo se permite una asignación por combinación de configuración regional-par de términos. El importador omitirá la fila en conflicto y reportará un error (consulta Solucionar errores de importación).
Si necesitas traducciones diferentes al inglés para bonjour según el contexto, los términos del glosario no son la herramienta adecuada: están pensados para términos que se traducen igual siempre.
Modos de importación
Cuando importes, elige uno de dos modos:
- Agregar — Se conservan las entradas existentes del glosario. Se agregan nuevas entradas desde el CSV. Se omiten las filas que entren en conflicto con las entradas existentes.
- Reemplazar todo: se elimina todo el glosario actual y se reemplaza con el contenido del CSV.
Reemplazar todo elimina todo el glosario actual.
Usa Reemplazar todo solo cuando tengas la seguridad de que el CSV es la nueva fuente de información confiable. No hay opción de deshacer.
Importa el archivo
1. Ve a cuenta → Configuración → Traducciones → Glosario.
2. Haz clic en Importar CSV.
3. En el cuadro de diálogo, elige Añadir o Reemplazar todo.
4. Haz clic en el área del archivo y selecciona el archivo .csv (o arrástralo al área).
5. Haz clic en Siguiente. Klaviyo valida el archivo, pero no guarda nada todavía. Verás una pantalla de vista previa.
6. Revisa la vista previa:
- Total de filas — cuántas filas había en el archivo.
- Entradas válidas — cuántas se importarán.
- Filas omitidas — cuántas se descartaron debido a problemas de validación.
7. Si aparece alguna advertencia, puedes continuar o regresar y corregir el archivo primero.
8. Haz clic en Importar para guardar los cambios.
Si hay algún problema con el archivo, verás una pantalla de Error en la importación en lugar de la vista previa.
Solucionar problemas de errores de importación
Cuando la importación falla, Klaviyo muestra uno o más mensajes de error que explican qué salió mal. Algunos errores se aplican a todo el archivo; otros señalan una fila específica.
Errores a nivel de archivo
Esto detiene la importación por completo. Corrígelos y vuelve a intentarlo.
"El archivo cargado está vacío."
Qué significa: el archivo no contiene contenido.
Qué hacer: Asegúrate de que el archivo no sea de 0 bytes y tenga al menos una fila más el encabezado.
"Faltan encabezados obligatorios."
Lo que significa: La fila de encabezado no incluye las cuatro columnas obligatorias.
Qué hacer: Comprueba que la primera fila contiene source term, target term, source locale y target locale. El orden de los encabezados no importa; la ortografía sí.
"No hay entradas válidas en el glosario."
Qué significa: Después de la validación, no se pudo importar ninguna fila.
Qué hacer: Abre el archivo y verifica que las filas de datos coincidan con el formato esperado.
"Error de codificación."
Qué significa: El archivo no está codificado en UTF-8
Qué hacer: Vuelve a guardar el archivo desde tu herramienta de hoja de cálculo con codificación UTF-8. En Excel, usa Guardar como → CSV UTF-8.
"Un término supera la longitud máxima."
Qué significa: uno o más términos son demasiado largos.
Qué hacer: Los términos del glosario deben ser frases cortas. Acorta o haz una división de las entradas muy largas.
Errores a nivel de fila
Estos marcan una fila específica. El resto del archivo aún se puede importar —se omite la fila incorrecta.
"Fila N: número inesperado de columnas"
Qué significa: la fila tiene muy pocos o demasiados valores separados por comas.
Qué hacer: Revisa la fila en tu CSV —las comas adicionales dentro de un término deben ir entre comillas ("hello, world").
"Fila N: valor del término vacío"
Qué significa: la celda del término de origen o de destino está en blanco.
Qué hacer: Completa el término faltante o elimina la fila.
"Fila N: código de configuración regional vacío"
Lo que significa: La celda de configuración regional de origen o destino está en blanco.
Qué hacer: Completa la configuración regional que falta (p. ej., en, fr-CA).
"Fila N: código de configuración regional no reconocido"
Qué significa: La cadena de configuración regional no es una etiqueta BCP-47 válida.
Qué hacer: Usa un código de configuración regional estándar como en, fr, de, pt-BR. Consulta códigos de configuración regional.
"Fila N: se detectó una columna de configuración regional duplicada"
Qué significa: La misma configuración regional aparece más de una vez en un solo contexto de entrada.
Qué hacer: Cada fila necesita configuraciones regionales de origen y destino distintas; no puedes traducir en → en.
"Fila N: traducción en conflicto para el mismo término y configuración regional"
Qué significa: La fila intenta asignar el mismo término de origen a un destino diferente que otra fila en el archivo.
Qué hacer: Decide cuál traducción es correcta y elimina el duplicado.
"Fila N: el término entra en conflicto con una entrada existente"
Qué significa: La fila intenta definir una traducción que contradice un término que ya está en tu glosario (solo en el modo Agregar).
Qué hacer: actualiza la entrada existente en la IU o usa el modo Reemplazar todo si el archivo nuevo es correcto.
"Fila N: se eliminó un carácter inicial de fórmula por motivos de seguridad"
Qué significa: Un término comenzó con =, +, - o @, lo que las apps de hojas de cálculo interpretarían como una fórmula.
Qué hacer: Esta es una advertencia, no un error. El término se importa con el carácter inicial eliminado. Si necesitas el carácter, encierra el término entre comillas.
Error de validación genérico
Si ves “Se produjo un error de validación. Comprueba el archivo e inténtalo de nuevo.”, el importador tuvo un problema que no pudo categorizar. Verifica que el archivo coincida con el formato esperado y contacta a soporte si el error persiste.