Cómo gestionar traducciones de forma masiva con un CSV

Administra las traducciones fuera de Klaviyo exportando y editando un archivo CSV y, después, importándolo para actualizar traducciones de forma masiva o colaborar con otras personas.

Exportar un CSV de tus traducciones

Sigue estos pasos para exportar las traducciones actuales de un solo mensaje:

1. Abre el mensaje que quieras actualizar (email de campaña, email de flujo, SMS, mensaje de WhatsApp, etc.).
2. Haz clic en el icono o botón Traducir del mensaje, o en el botón que muestra el número de traducciones, para abrir el editor de traducciones. Si el mensaje aún no se ha traducido, completa primero la configuración del idioma.
3. En el editor de traducción, abre el menú de acciones de 3 puntos y haz clic en Exportar.

4. En Seleccionar el formato de exportación, elige CSV. Mantén Compatible con Smartling seleccionado si vas a enviar el archivo a Smartling o desmárcalo para editar un CSV estándar en una hoja de cálculo.

5. En Idiomas que exportar, elige Seleccionar todo para incluir todos los idiomas de traducción existentes, o Selección personalizada para elegir idiomas concretos. Para exportar solo el texto de origen para una persona traductora, elige la opción Solo idioma de origen. El idioma de origen se incluye en todas las exportaciones.
6. Haz clic en Exportar para descargar el CSV.

CSV de Smartling

Un CSV compatible con Smartling incluye:

Directivas de Smartling en la parte superior del archivo, incluidos:

# smartling.first_row_header=VERDADERO
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=VERDADERO

• block_id: el identificador único para cada cadena traducible de este mensaje.
• Código de idioma de origen (p. ej., en): el texto original de origen de esa cadena.
• Columnas de idioma para los idiomas de traducción que seleccionaste, si corresponde.

Puedes usar este archivo tal cual para importar tus cadenas a Smartling. Smartling analiza automáticamente el CSV, extrae las cadenas y te permite activar trabajos de traducción.

Cuando termine el trabajo, descarga el CSV traducido. Antes de importarlo en Klaviyo, elimina las filas de directivas iniciales # smartling. para que la primera fila contenga los encabezados de columna. Conserva la columna block_id, la columna del idioma de origen y al menos 1 columna de idioma de traducción compatible. Luego, sigue estos pasos: importa el siguiente CSV.

Standard CSV

Un CSV estándar incluye:

• block_id: el identificador único para cada cadena traducible de este mensaje.
• source: el texto original de esa cadena.
• Columnas de idioma: 1 columna por idioma de traducción que hayas seleccionado, con el nombre de su código de idioma (por ejemplo, en, fr, es-MX). Una exportación solo de origen no tiene columnas de idioma de traducción.

Ahora puedes abrir este archivo en Excel, Google Sheets u otro editor de hojas de cálculo.

Actualiza el CSV

Cuando edites el CSV, solo necesitas trabajar en las columnas de idioma.

No edites, añadas ni elimines ningún valor en la columna block_id. Si una fila tiene un block_id no válido o que falta, esa fila se ignora durante la importación y sus traducciones no se actualizan.

Lo que puedes cambiar con traquilidad

En el CSV:

• Actualiza las traducciones existentes editando la columna del idioma correspondiente.
• Añade las traducciones que falten rellenando las celdas vacías de una columna de idioma.
• Deja los valores de un idioma sin cambios si no quieres actualizar ese idioma.
• Añade una o más columnas de idioma nuevas:
  • Usa un código de idioma BCP‐47 válido (por ejemplo, fr-CA, de, ca).
  • Al importar, los idiomas compatibles con nuevos valores de traducción se añaden al editor de traducciones de este mensaje.

Lo que no debes cambiar

Evita lo siguiente:

• No edites ni elimines los valores de block_id.
• No añadas filas. Cada fila debe seguir correspondiéndose con una cadena traducible existente en el mensaje.
• No cambies los valores de origen en el CSV:
  • Para cambiar el contenido de origen, edita el mensaje directamente en el editor de Klaviyo y, a continuación, exporta un nuevo CSV.
• Mantén los encabezados de columna block_id y source sin cambios. En un CSV de Smartling, mantén el encabezado de columna del idioma de origen en lugar de source. Mantén cada columna del idioma de traducción etiquetada con el código de idioma compatible.
• No cambies el formato del archivo:
  • Conserva el archivo como un archivo .csv .
  • Guarda con la codificación UTF‐8.

Mantén las etiquetas de plantilla y las etiquetas de plantilla, como {{ first_name }} y {% if ... %}, sin cambios en cada traducción. Si estos marcadores de posición difieren del mensaje de origen, la validación bloquea la importación.

Gestión de celdas vacías

Si vacías una celda de traducción en el CSV y la dejas sin nada:

• La importación trata esa cadena vacía como un valor.
• La traducción existente para esa celda se sobrescribe con un valor vacío. Esto puede eliminar una traducción de forma efectiva.

Si al borrar una celda también se eliminan los marcadores de posición presentes en el origen, la validación bloquea la importación. Restaura los marcadores de posición o elimina esa columna de idioma antes de importar.

Si quieres evitar cambiar una traducción, deja su valor existente en el CSV o elimina por completo esa columna de idioma antes de importar.

Cuando termines de editar, guarda el archivo como un archivo .csv codificado en UTF‐8.

Importar el CSV

Después de haber actualizado y guardado el CSV:

1. Vuelve al editor de traducciones del mismo mensaje.
2. Abre el menú de acciones de 3 puntos y haz clic en Importar CSV.
3. En el modal de importación, puedes:

• Haz clic en Seleccionar archivo y elige tu CSV, o
• Arrastra y suelta tu archivo CSV en el área de carga.

4. Haz clic en Siguiente para validar el archivo y previsualizar los cambios.

Klaviyo ejecuta una «simulación de validación» y muestra:

• Un resumen de cuántas filas se actualizarán, mantendrán o ignorarán.
• Cualquier advertencia o error que haya detectado.

1. Revisa el resumen y las advertencias detenidamente.
2. Si todo parece correcto, haz clic en Importar para aplicar los cambios.

Cuando la importación se realiza correctamente, se cierra la ventana modal y se actualizan las traducciones en el editor de traducciones. Revisa las traducciones importadas.

Durante la validación, Klaviyo también comprueba:

• Tipo de archivo y codificación: usa un CSV codificado en UTF-8.
• Columnas de CSV: conserva block_id, la columna de origen (o la columna en el idioma de origen para Smartling) y al menos 1 columna de idioma de traducción compatible.
• Códigos de idioma que no se reconocen o que no son compatibles con el canal.
• Valores de traducción vacíos y otros posibles problemas.
• Etiquetas de plantilla que difieren del mensaje de origen.

Si se produce un error de validación, aparece un mensaje de error. Haz clic en Seleccionar archivo nuevo después de corregir el CSV para volver a intentarlo; la validación no cambia las traducciones.

Entender los resultados de importación

Tras la validación, el resumen de importación muestra lo que ocurrirá si continúas.

Recuentos de resumen

El resumen puede incluir recuentos como:

• Actualizado: el número de filas en las que cambiará al menos 1 valor de traducción.
• Omitidas (sin cambios): filas del CSV en las que todos los valores de traducción incluidos coinciden con lo que ya está almacenado.
• Ignoradas: filas que no se importarán, como filas duplicadas después de la primera aparición o filas cuyo block_id no existe en este mensaje.

Prácticas recomendadas

Para mantener tus datos de traducción precisos y fáciles de gestionar:

1. Empezar desde la exportación más reciente. Evita reutilizar CSV antiguos, especialmente después de cambiar contenido o idiomas en el mensaje.
2. Guarda una copia de seguridad de cada exportación. Guarda una copia del CSV antes de hacer cambios para poder revertirlos si es necesario.
3. Coordina con el equipo de traducción. Explica qué columnas pueden editar (solo las columnas de idioma) y qué columnas no deben cambiar (block_id, source).
4. Trabaja en lotes más pequeños si es necesario. Si tu archivo es muy grande, considera dividir el trabajo entre varios mensajes o ejecutar varias importaciones más pequeñas.
5. Usa códigos de idioma admitidos. Al añadir nuevas columnas de idioma, utiliza los códigos BCP-47 admitidos del artículo Traducciones inteligentes para evitar idiomas «no procesables».

Resolver advertencias de validación y errores de importación

Si ves advertencias o errores durante la validación de la importación, revisa las secciones de abajo para entender qué significan y cómo solucionarlos.

Recursos adicionales