Debes tener una cuenta de pago en Klaviyo y tener habilitadas las traducciones inteligentes para poder utilizar estas funciones.
Esta función tiene actualmente una disponibilidad limitada. ¡Mantente al tanto!
Gestiona las traducciones fuera de Klaviyo exportando y editando un archivo CSV, y luego importándolo de nuevo para actualizar las traducciones de forma masiva o colaborar con otras personas.
Exporta un CSV con tus traducciones.
Sigue estos pasos para exportar las traducciones actuales de un solo mensaje:
- Abre el mensaje que deseas actualizar (correo electrónico de campaña, correo electrónico de flujo, SMS, mensaje de WhatsApp, etc.).
- Haz clic en Traducir para abrir el editor de traducción.
- En el editor de traducción, abre el menú de acciones y haz clic en Exportar CSV.
-
Tu navegador descarga un archivo CSV que incluye:
- block_id: identificador único de cada cadena traducible de este mensaje.
- fuente: el texto original de esa cadena.
- Columnas de idioma: una columna por idioma, nombrada con 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.
Actualizar el CSV
Cuando edites el CSV, solo tienes que trabajar en las columnas de idiomas.
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 falta, esa fila se ignora durante la importación y sus traducciones no se actualizan.
Lo que puedes cambiar con seguridad
En el CSV:
- Actualiza las traducciones existentes editando la columna del idioma correspondiente.
- Agrega las traducciones que falten rellenando las celdas vacías de la columna del idioma correspondiente.
- No modifiques los valores de un idioma si no deseas actualizarlo.
- Añade una o más columnas de idioma nuevas:
- Utiliza un código de idioma BCP-47 válido (por ejemplo, fr-CA, de, ca).
- Al importarlos, estos idiomas se añaden al editor de traducción de este mensaje, siempre que sean compatibles.
Lo que no debes cambiar
Evita lo siguiente:
- No edites ni elimines los valores de block_id.
- No agregues filas. Cada fila debe seguir correspondiendo a una cadena traducible existente en el mensaje.
-
No cambies los valores de origen en el CSV:
- Para cambiar el contenido original, edita el mensaje directamente en el editor de Klaviyo y, a continuación, exporta un nuevo archivo CSV.
- No cambies el nombre de las columnas obligatorias (block_id, source y las columnas de idioma).
-
No cambies el formato del archivo:
- Guarda el archivo como .csv. archivo.
- Guarda en codificación UTF-8.
Manejo de celdas vacías
Si borras 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 eficazmente una traducción.
Si deseas 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 archivo .csv codificado en UTF-8.
Importar el CSV
Después de actualizar y guardar tu CSV:
- Vuelve al editor de traducción para el mismo mensaje.
- Haz clic en Importar CSV.
-
En el modal de importación, haz lo siguiente:
- Haz clic en Seleccionar archivo y elige tu CSV, o
- Arrastra y suelta tu CSV en el área de carga.
-
Klaviyo realiza una «prueba de validación» y muestra:
- Un resumen de cuántas filas se actualizarán, permanecerán sin cambios o se ignorarán.
- Cualquier advertencia o error que hayas detectado.
- Revisa detenidamente el resumen y las advertencias.
- Si todo parece correcto, haz clic en Importar para aplicar los cambios.
Durante la validación, Klaviyo también comprueba lo siguiente:
- Límites de tamaño de archivo y de filas (por ejemplo, los archivos de más de 10 MB serán rechazados).
- Columnas obligatorias (como block_id, source y al menos una columna de idioma).
- Códigos de idioma que no son reconocidos o no son compatibles con el canal.
- Valores de traducción vacíos y otros posibles problemas.
Si la validación falla, aparecerá un mensaje de error y podrás seleccionar un nuevo archivo sin realizar ningún cambio en tus traducciones.
Comprender los resultados de la importación
Después de la validación, el resumen de importación muestra lo que sucederá si continúas.
Recuentos resumidos
El resumen puede incluir recuentos como:
- Actualizado: el número de filas en las que cambiará al menos un valor de traducción.
- Sin cambios: filas que están presentes en el CSV, pero en las que todos los valores coinciden con los que ya están almacenados.
- Ignoradas/omitidas: filas que no se importarán (por ejemplo, porque el block_id no existe en este mensaje o faltan datos necesarios).
Los recuentos se calculan por fila, no por idioma. Por ejemplo, si un CSV tiene dos filas y dos columnas de idioma:
- Si se actualiza una fila en un idioma, el recuento de actualizaciones es 1.
- Si se actualiza una fila en ambos idiomas, el recuento de actualizaciones seguirá siendo 1.
- Si las dos filas se actualizan en uno o en todos los idiomas, el recuento de actualizaciones es 2.
Mejores prácticas
Para mantener tus datos de traducción precisos y fáciles de gestionar:
- Comienza por la última exportación. Evita reutilizar archivos CSV antiguos, especialmente después de cambiar el contenido o los idiomas del mensaje.
- Guarda una copia de seguridad de cada exportación. Guarda una copia del CSV antes de realizar cambios para que puedas revertirlos si es necesario.
- Coordinarse con los traductores. Explica qué columnas pueden editar (solo las columnas de idioma) y cuáles no deben modificar (block_id, source).
- Trabaja en lotes más pequeños si es necesario. Si tu archivo es muy grande, considera dividir el trabajo en varios mensajes o realizar varias importaciones más pequeñas.
- Utiliza códigos de idioma compatibles. Al agregar nuevas columnas de idioma, utiliza los códigos BCP-47 compatibles que se indican en el artículo Traducciones inteligentes 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 siguientes para comprender qué significan y cómo solucionarlos.
Qué significa: Faltan o se han renombrado una o varias columnas obligatorias (block_id o source).
Qué hacer: Asegúrate de que el CSV incluya las columnas block_id y source. Si has copiado datos en una nueva hoja, confirma que la fila de encabezado coincida con la exportación original.
Qué significa: Tu CSV tiene valores de traducción vacíos, y las cadenas vacías se tratarán como valores.
Qué hacer: Si continúas, esas celdas vacías sobrescribirán cualquier traducción existente para esa clave e idioma. Si deseas dejar esas traducciones sin cambios, restaura los valores anteriores o elimina esa columna de idioma y vuelve a importar el archivo.
Qué significa: Algunos valores de block_id en tu CSV no existen para esta plantilla (por ejemplo, si los valores de block_id se editaron manualmente).
Qué hacer: esas filas se ignoran y las traducciones de esas claves no cambian. Para resolver esto, elimina esas filas del CSV o exporta un archivo nuevo si es necesario.
Qué significa: Dos o más filas de tu CSV tienen los mismos valores de block_id (por ejemplo, si las filas se duplicaron por error).
Qué hacer: Se utilizan los valores de la primera fila y se ignoran las filas duplicadas restantes. Para resolver esto, elimina las filas duplicadas del CSV o exporta un archivo nuevo si es necesario.
Qué significa: Dos o más columnas de tu CSV tienen el mismo código de idioma o se resuelven en el mismo idioma (por ejemplo, si una columna de idioma se duplicó por error).
Qué hacer: Se utilizan los valores de la última columna duplicada y se ignoran las columnas duplicadas restantes. Para resolver esto, elimina las columnas duplicadas del CSV o exporta un archivo nuevo si es necesario.
Qué significa: El encabezado de una columna de tu CSV utiliza un código de idioma que no es compatible ni reconocido.
Qué hacer: Para agregar un nuevo idioma, utiliza uno de los códigos BCP-47 compatibles que se indican en la documentación de Smart Translations. Las columnas con códigos no compatibles se ignoran.
Qué significa: Tu CSV incluye columnas de idioma que actualmente no forman parte de esta plantilla.
Qué hacer:
- Si deseas agregar esos idiomas, revisa la lista y haz clic en Importar para agregarlos al editor de traducción.
- Si no deseas agregarlas, elimina esas columnas y vuelve a importar el archivo.
Significado: El CSV incluye las columnas block_id y source, pero no se ha detectado ningún otro encabezado de columna.
Qué hacer: Agrega al menos una columna de idioma compatible y vuelve a intentarlo.
Significado: El CSV incluye las columnas block_id y source, pero no contiene columnas de idioma válidas.
Qué hacer: Agrega al menos una columna de idioma compatible y vuelve a intentarlo.
Si solo ves advertencias y comprendes su impacto, puedes continuar con la importación. Si observas un error, debes corregir el CSV y volver a subirlo antes de continuar. Si sigues viendo errores, exporta un CSV nuevo desde el editor de traducción, realiza cambios mínimos e intenta otra importación para aislar el problema.
Si sigues viendo errores después de revisar estos elementos, exporta un CSV nuevo desde el editor de traducción, realiza cambios mínimos e intenta otra importación para aislar qué cambio está causando el problema.