Como gerenciar traduções em massa com CSV

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:

1. Abra a mensagem que você quer atualizar (e-mail de campanha, e-mail de fluxo, SMS, mensagem do WhatsApp etc.).
2. Clique no ícone ou botão Traduzir da mensagem ou no botão que mostra o número de traduções para abrir o editor de tradução. Se a mensagem ainda não tiver sido traduzida, conclua primeiro a configuração de idioma.
3. No editor de tradução, abra o menu de ações de três pontos e clique em Exportar.

4. Em Selecione o formato de exportação, escolha CSV. Mantenha compatível com Smartling selecionado se você for enviar o arquivo para a Smartling ou desmarque para editar um CSV padrão em uma planilha.

5. Em Idiomas para exportar, escolha Selecionar tudo para incluir todos os idiomas de tradução existentes ou Seleção personalizada para escolher idiomas específicos. Para exportar apenas o texto de origem para um tradutor, escolha a opção somente no idioma de origem. O idioma de origem é incluído em todas as exportações.
6. Clique em Exportar para baixar o CSV.

Smartling CSV

Um CSV compatível com Smartling inclui:

Diretivas do Smartling no topo do arquivo, incluindo:

# 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.
• Colunas de idioma para os idiomas de tradução que você selecionou, se houver.

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 job terminar, baixe o CSV traduzido. Antes de importar para o Klaviyo, remova todas as linhas de diretiva # smartling. iniciais para que a primeira linha contenha os cabeçalhos das colunas. Mantenha a coluna block_id, a coluna no idioma de origem e pelo menos 1 coluna de idioma de tradução compatível. Em seguida, siga Importar o CSV abaixo.

CSV Standard

Um CSV padrão inclui:

• block_id – o identificador exclusivo de cada string traduzível nesta mensagem.
• source – o texto de origem original dessa string.
• Colunas de idioma: 1 coluna por idioma de tradução selecionado, nomeada com o código de idioma (por exemplo, en, fr, es-MX). Uma exportação somente da fonte não tem colunas de idioma de tradução.

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, os idiomas compatíveis com novos valores de tradução são adicionados ao editor de traduções desta mensagem.

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.
• Mantenha os cabeçalhos das colunas block_id e source inalterados. Em um CSV do Smartling, mantenha o cabeçalho da coluna do idioma de origem em vez de source. Mantenha cada coluna do idioma de tradução rotulada com o código de idioma compatível.
• NÃO altere o formato do arquivo:
  • Mantenha o arquivo como .csv CSV.
  • Salve com a codificação UTF‐8.

Mantenha as tag de modelo e as tag de modelo, como {{ first_name }} e {% if ... %}, inalteradas em cada tradução. Se esses placeholders forem diferentes da mensagem de origem, a validação bloqueia a importação.

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 limpar uma célula também remover os espaços reservados que estão presentes na origem, a validação bloqueia a importação. Restaure os espaços reservados ou remova essa coluna de idioma antes de importar.

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:

1. Volte para o editor de tradução da mesma mensagem.
2. Abra o menu de ações de 3 pontos e clique em Importar CSV.
3. 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.

4. Clique em Próxima para validar o arquivo e pré-visualizar as alterações.

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

1. Revise o resumo e os avisos com atenção.
2. Se tudo estiver correto, clique em Importar para aplicar as alterações.

Quando a importação é concluída, o modal é fechado e suas traduções são atualizadas no editor de tradução. Revise as traduções importadas.

Durante a validação, o Klaviyo também verifica:

• Tipo de arquivo e codificação: use um CSV codificado em UTF-8.
• Colunas do CSV: mantenha block_id, a coluna de origem (ou a coluna do idioma de origem para o Smartling) e pelo menos 1 coluna de idioma de tradução compatível.
• 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.
• Tags de modelo e tags de modelo que diferem da mensagem de origem.

Se a validação falhar, você verá uma mensagem de erro. Clique em Selecionar novo arquivo depois de corrigir o CSV para tentar novamente; a validação não altera 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:

• Atualizadas: o número de linhas em que pelo menos 1 valor de tradução será alterado.
• Ignorado (sem alterações): linhas no CSV em que todos os valores de tradução incluídos correspondem ao que já está armazenado.
• Ignorado: linhas que não serão importadas, como linhas duplicadas após a primeira ocorrência ou linhas cujo block_id não existe nesta mensagem.

Práticas recomendadas

Para manter seus dados de tradução precisos e fáceis de gerenciar:

1. Comece pela exportação mais recente. Evite reutilizar arquivos CSV mais antigos, especialmente depois de alterar o conteúdo ou os idiomas na mensagem.
2. Mantenha um backup de cada exportação. Salve uma cópia do CSV antes de fazer alterações para poder reverter, se necessário.
3. 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).
4. 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.
5. 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.

Recursos adicionais