Como gerenciar traduções em massa com CSV
Você precisa ter uma conta paga do Klaviyo e as Traduções Inteligentes ativadas para usar este recurso.
Gerencie traduções fora do Klaviyo exportando e editando um arquivo CSV e depois importe-o novamente para atualizar traduções em massa ou colaborar com outras pessoas.
Exporte um CSV das suas traduções
Siga estas etapas para exportar as traduções atuais de uma única mensagem:
- Abra a mensagem que você quer atualizar (e-mail de campanha, e-mail de fluxo, SMS, mensagem do WhatsApp etc.).
- Clique em Traduzir para abrir o editor de tradução.
- No editor de tradução, abra o menu de ações e clique em Exportar CSV.
- No modal de exportação, você pode escolher entre um Smarting CSV ou um CSV
Exportar Smartling CSV
- Seu navegador baixa um arquivo CSV que inclui:
- As seguintes diretivas padrão do Smartling:
- # smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE - block_id – o identificador exclusivo de cada string traduzível nesta mensagem.
- Código do idioma de origem (por exemplo, en) – o texto original de origem para essa string.
Você pode usar este arquivo como está para importar suas strings para o Smartling. O Smartling analisa automaticamente o CSV, extrai as strings e permite que você acione trabalhos de tradução.
Depois que o trabalho terminar, baixe o CSV resultante e importe-o novamente usando o botão importar.
Exportar um CS simples
- Seu navegador baixa um arquivo CSV que inclui:
- block_id – o identificador exclusivo de cada string traduzível nesta mensagem.
- source – o texto de origem original dessa string.
- Colunas de idioma – uma coluna por idioma, nomeada com o respectivo código de idioma (por exemplo, en, fr, es-MX).
Agora você pode abrir este arquivo no Excel, no Google Sheets ou em outro editor de planilhas.
Atualize o CSV
Ao editar o CSV, você só precisa trabalhar nas colunas de idioma.
Não edite, adicione nem exclua nenhum valor na coluna block_id. Se uma linha tiver um block_id inválido ou ausente, essa linha será ignorada durante a importação e as traduções dela não serão atualizadas.
O que você pode alterar com segurança
No CSV:
- Atualize as traduções existentes editando a coluna do idioma apropriado.
- Adicione traduções ausentes preenchendo as células vazias de uma coluna de idioma.
- Deixe os valores de um idioma inalterados se você não quiser atualizar esse idioma.
- Adicione uma ou mais novas colunas de idioma:
- Use um código de idioma BCP-47 válido (por exemplo, fr-CA, de, ca).
- Na importação, esses idiomas são adicionados ao editor de tradução desta mensagem se forem compatíveis.
O que você não deve alterar
Evite o seguinte:
- Não edite nem exclua valores de block_id.
- Não adicione linhas. Cada linha deve continuar correspondendo a uma string traduzível existente na mensagem.
- Não altere os valores de origem no CSV:
- Para alterar o conteúdo de origem, edite a mensagem diretamente no editor do Klaviyo e, em seguida, exporte um novo CSV.
- Não renomeie as colunas obrigatórias (block_id, source e as colunas de idioma).
- NÃO altere o formato do arquivo:
- Mantenha o arquivo como .csv CSV.
- Salve com a codificação UTF‐8.
Como lidar com células vazias
Se você limpar uma célula de tradução no CSV e deixá-la vazia:
- A importação trata essa string vazia como um valor.
- A tradução existente para essa célula é substituída por um valor vazio. Isso pode, na prática, remover uma tradução.
Se você quiser evitar alterar uma tradução, deixe o valor existente dela no CSV ou remova totalmente a coluna desse idioma antes de importar.
Quando terminar de editar, salve o arquivo como um .csv codificado em UTF-8.
Importar o CSV
Depois de atualizar e salvar o CSV:
- Volte para o editor de tradução da mesma mensagem.
- Clique em Importar CSV.
- No modal de importação, faça uma das opções a seguir:
- Clique em Selecionar arquivo e escolha seu CSV ou
- Arraste e solte seu CSV na área de upload.
- A Klaviyo executa uma validação em "execução de teste" e mostra:
- Um resumo de quantas linhas serão atualizadas, permanecerão inalteradas ou serão ignoradas
- Quaisquer avisos ou erros que ele detectou
- Revise o resumo e os avisos com atenção.
- Se tudo estiver correto, clique em Importar para aplicar as alterações.
Durante a validação, o Klaviyo também verifica:
- Limites de tamanho de arquivo e de linhas (por exemplo, arquivos maiores que 10 MB serão rejeitados).
- Colunas obrigatórias (como block_id, source e pelo menos uma coluna de idioma).
- Códigos de idioma que não são reconhecidos ou não são compatíveis com o canal.
- Valores de tradução em branco e outros possíveis problemas.
Se a validação falhar, você verá uma mensagem de erro e poderá selecionar um novo arquivo sem fazer nenhuma alteração nas suas traduções.
Entenda os resultados da importação
Depois da validação, o resumo da importação mostra o que vai acontecer se você continuar.
Contagens de resumo
O resumo pode incluir contagens como:
- Atualizado – o número de linhas em que pelo menos um valor de tradução será alterado.
- Sem alterações – linhas que estão presentes no CSV, mas em que todos os valores correspondem ao que já está armazenado.
- Ignorado/pulado – linhas que não serão importadas (por exemplo, porque o block_id não existe nesta mensagem ou dados obrigatórios estão ausentes).
As contagens são calculadas por linha, não por idioma. Por exemplo, se um CSV tiver duas linhas e duas colunas de idioma:
- Se uma linha for atualizada em um idioma, a contagem de Atualizado será 1.
- Se uma linha for atualizada em ambos os idiomas, a contagem de Atualizado ainda será 1.
- Se ambas as linhas forem atualizadas em um ou em todos os idiomas, a contagem de Atualizado será 2.
Práticas recomendadas
Para manter seus dados de tradução precisos e fáceis de gerenciar:
- Comece pela exportação mais recente. Evite reutilizar arquivos CSV mais antigos, especialmente depois de alterar o conteúdo ou os idiomas na mensagem.
- Mantenha um backup de cada exportação. Salve uma cópia do CSV antes de fazer alterações para poder reverter, se necessário.
- Coordene-se com os tradutores. Explique quais colunas eles podem editar (somente as colunas de idioma) e quais colunas eles não devem alterar (block_id, source).
- Trabalhe em lotes menores, se necessário. Se o arquivo for muito grande, considere dividir o trabalho entre várias mensagens ou executar várias importações menores.
- Use códigos de idioma compatíveis. Ao adicionar novas colunas de idioma, use códigos BCP-47 compatíveis do artigo Traduções Inteligentes para evitar idiomas “não processáveis”.
Resolva os avisos de validação e os erros de importação
Se você vir avisos ou erros durante a validação da importação, revise as seções abaixo para entender o que eles significam e como corrigi-los.
"As colunas necessárias estão ausentes."
O que isso significa: uma ou mais colunas obrigatórias (block_id ou source) estão ausentes ou foram renomeadas.
O que fazer: verifique se o CSV inclui as colunas block_id e source. Se você copiou dados para uma nova planilha, confirme se a linha de cabeçalho corresponde à exportação original.
"Você tem valores de tradução vazios. Cadeias de caracteres vazias serão tratadas como valores."
O que isso significa: Seu CSV tem valores de tradução vazios, e as cadeias de caracteres vazias serão tratadas como valores.
O que fazer: se você continuar, essas células vazias substituirão quaisquer traduções existentes para essa chave e idioma. Se você quiser manter essas traduções inalteradas, restaure os valores anteriores ou remova essa coluna de idioma e importe o arquivo novamente.
"A(s) chave(s) <count> não existe(m) no seu projeto e não será(ão) incluída(s) na importação."
O que isso significa: Alguns valores de block_id no seu CSV não existem para este modelo (por exemplo, se os valores de block_id foram editados manualmente).
O que fazer: essas linhas são ignoradas, e as traduções dessas chaves não mudam. Para resolver isso, remova essas linhas do CSV ou exporte um arquivo novo, se necessário.
"Seu arquivo contém chaves duplicadas com valores conflitantes. O primeiro valor será usado."
O que isso significa: duas ou mais linhas no seu CSV têm os mesmos valores de block_id (por exemplo, se as linhas foram duplicadas por engano).
O que fazer: Os valores da primeira linha são usados, e as demais linhas duplicadas são ignoradas. Para resolver isso, remova as linhas duplicadas do CSV ou exporte um arquivo novo, se necessário.
"Várias colunas correspondem ao mesmo idioma. Somente a última coluna será usada e as outras serão ignoradas."
O que significa: duas ou mais colunas no seu CSV têm o mesmo código de idioma ou são resolvidas para o mesmo idioma (por exemplo, se uma coluna de idioma foi duplicada por engano).
O que fazer: Os valores da última coluna duplicada são usados e as demais colunas duplicadas são ignoradas. Para resolver isso, remova as colunas duplicadas do CSV ou exporte um novo arquivo, se necessário.
"Seu arquivo contém colunas com códigos de idioma que não são compatíveis com este canal: <código de idioma<invalid language code> inválido>. Elas serão ignoradas, mas as localidades válidas serão importadas."
O que significa: Um cabeçalho de coluna no seu CSV usa um código de idioma que não é compatível ou reconhecido.
O que fazer: para adicionar um novo idioma, use um dos códigos BCP-47 compatíveis da documentação de Traduções Inteligentes. Colunas com códigos não compatíveis são ignoradas.
"Você tem idiomas no seu arquivo que não estão no seu projeto. Os seguintes idiomas serão adicionados ao seu editor de<language detected> tradução:."
O que significa: Seu CSV inclui colunas de idioma que não fazem parte deste modelo no momento.
O que fazer:
- Se você quiser adicionar esses idiomas, revise a lista e clique em Importar para adicioná-los ao editor de tradução.
- Se você não quiser adicioná-las, remova essas colunas e reimporte o arquivo.
"Nenhuma coluna de localidade foi encontrada."
O que isso significa: o CSV inclui as colunas block_id e source, mas nenhum outro cabeçalho de coluna foi detectado.
O que fazer: adicione pelo menos uma coluna de idioma compatível e tente novamente.
"Nenhuma coluna de localidade válida foi encontrada."
O que isso significa: o CSV inclui as colunas block_id e source, mas não tem colunas de idioma válidas.
O que fazer: adicione pelo menos uma coluna de idioma compatível e tente novamente.
Se você vir apenas avisos e entender o impacto deles, você pode prosseguir com a importação. Se você vir um erro, você precisa corrigir o CSV e reenviá-lo antes de continuar. Se você continuar vendo erros, exporte um CSV novo do editor de tradução, faça alterações mínimas e tente outra importação para isolar o problema.
Se você continuar vendo erros depois de verificar esses itens, exporte um CSV novo do editor de tradução, faça mudanças mínimas e tente outra importação para isolar qual mudança está causando o problema.
Recursos adicionais
- Como habilitar as Traduções Inteligentes
Saiba como ativar as Traduções Inteligentes para mensagens, para que você possa enviar campanhas e fluxo em vários idiomas com base nas preferências de idioma do seu público. A Klaviyo pode traduzir o conteúdo de e-mail para mais de 60 idiomas.
- Como criar uma campanha de e-mail multilíngue usando as Traduções Inteligentes
Saiba como criar e enviar uma campanha de e-mail em vários idiomas, dependendo das preferências de idioma do seu público. A Klaviyo pode traduzir o conteúdo de uma campanha para mais de 60 idiomas.
- Como criar uma campanha de SMS multilíngue usando as Traduções Inteligentes
Saiba como criar e enviar uma campanha de SMS em vários idiomas, de acordo com as preferências de idioma do seu público. A Klaviyo pode traduzir o conteúdo de uma campanha para mais de 60 idiomas.
- Como personalizar o conteúdo com base no idioma
Aprenda a coletar o idioma de preferência de uma pessoa e, em seguida, direcioná-la nesse idioma.