Cómo gestionar traducciones de forma masiva con CSV

Administra las traducciones fuera de Klaviyo exportando y editando un archivo CSV, y luego impórtalo de nuevo para actualizar las traducciones en lote 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 (correo electrónico de campaña, correo electrónico de flujo, SMS, mensaje de WhatsApp, etc.).
2. Haz clic en Traducir para abrir el editor de traducción.
3. En el editor de traducción, abre el menú de acciones y haz clic en Exportar CSV.

4. En el modal de exportación, tienes la opción de seleccionar entre un CSV de Smartling o un CSV
   

Exportación de CSV de Smartling

1. El navegador descarga un archivo CSV que incluye:

1. Las siguientes directivas predeterminadas de Smartling:
2. # smartling.first_row_header=TRUE
   # smartling.paths=2
   # smartling.source_key_paths=1
   # smartling.translations_in_columns=TRUE
3. block_id – el identificador único de cada cadena traducible en este mensaje.
4. Código de idioma de origen (p. ej., en): el texto original de origen para esa cadena.

Puedes usar este archivo tal como está 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 resultante e impórtalo de nuevo con el botón Importar.

Exportar un CS simple

1. El navegador descarga un archivo CSV que incluye:

1. block_id – el identificador único de cada cadena traducible en este mensaje.
2. source – el texto de origen original de esa cadena.
3. Columnas de idioma: una columna por idioma, con el nombre de su código de idioma (por ejemplo, en, fr, es-MX).

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, agregues ni elimines valores en la columna block_id. Si una fila tiene un block_id no válido o faltante, esa fila se ignora durante la importación y sus traducciones no se actualizan.

Lo que puedes cambiar de forma segura

En el CSV:

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

Lo que no debes cambiar

Evita lo siguiente:

• No edites ni elimines valores de block_id.
• No agregues filas. Cada fila debe seguir asignándose a 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 luego exporta un CSV nuevo.
• No cambies el nombre de las columnas obligatorias (block_id, source y las columnas de idioma).
• No cambies el formato del archivo:
  • Mantén el archivo como un archivo .csv de formato .csv.
  • Guárdalo con la codificación UTF‐8.

Cómo manejar las celdas vacías

Si borras el contenido de una celda de traducción en el CSV y la dejas vacía:

• 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 quieres evitar cambiar una traducción, deja su valor actual en el CSV o elimina por completo esa columna de idioma antes de importar.

Cuando termines de editar, guarda el archivo como un .csv con codificación UTF‐8.

Importar el CSV

Después de actualizar y guardar el CSV:

1. Regresa al editor de traducción para el mismo mensaje.
2. Haz clic en Importar CSV.
3. En el modal de importación, haz lo siguiente:

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

5. Klaviyo ejecuta una "prueba en seco" de validación y muestra:

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

7. Revisa cuidadosamente el resumen y las advertencias.
8. Si todo se ve correcto, haz clic en Importar para aplicar los cambios.

Durante la validación, Klaviyo también revisa lo siguiente:

• Límites de tamaño de archivo y de filas (por ejemplo, los archivos de más de 10 MB se rechazarán).
• Columnas obligatorias (como block_id, source y al menos una columna de idioma).
• Códigos de idioma que el canal no reconoce o no admite.
• Valores de traducción vacíos y otros posibles problemas.

Si la validación falla, verás un mensaje de error y podrás seleccionar un archivo nuevo sin hacer cambios en tus traducciones.

Entiende los resultados de la importación

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

Recuento de resumen

El resumen puede incluir recuentos como:

• Actualizado: la cantidad de filas en las que cambiará al menos un valor de traducción.
• Sin cambios – filas que están presentes en el archivo CSV, pero donde todos los valores coinciden con los que ya están almacenados.
• Ignorado/omitido: filas que no se importarán (por ejemplo, porque el block_id no existe en este mensaje o falta información obligatoria).

Mejores prácticas

Para mantener los datos de traducción precisos y fáciles de administrar:

1. Empieza con la exportación más reciente. Evita reutilizar CSV antiguos, especialmente después de cambiar el contenido o los idiomas del mensaje.
2. Guarda una copia de respaldo de cada exportación. Guarda una copia del CSV antes de hacer cambios para que puedas volver atrás si es necesario.
3. Coordina con los traductores. 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 el archivo es muy grande, considera dividir el trabajo en varios mensajes o ejecutar varias importaciones más pequeñas.
5. Usa códigos de idioma compatibles. Al agregar nuevas columnas de idioma, usa códigos BCP-47 compatibles del artículo Traducción inteligente para evitar idiomas “no procesables”.

Resuelve las advertencias de validación y los errores de importación

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

Recursos adicionales