Mensagens multilíngues

Depois de adicionar locais ao seu espaço de trabalho, você pode direcionar usuários em diferentes idiomas, tudo dentro de um único push, e-mail, banner, mensagem no app ou Content Block.

Pré-requisitos

• locais multilíngues
• tipos de mensagem
• modelos

Usar locais

Etapa 1: Configurar locais

Antes de adicionar traduções a uma mensagem, você deve primeiro criar os locais que deseja suportar. Os locais definem as variantes de idioma (e opcionalmente região) disponíveis para o envio de mensagens.

Etapa 2: Marcar conteúdo para tradução

Envolva o texto que deseja traduzir com as tags de tradução Liquid {% translation your_id_here %} e {% endtranslation %} e atribua um ID de tag. Os IDs das tags de tradução devem ser únicos dentro de uma mensagem. Considere usar nomes de ID semânticos que descrevam claramente o texto, como {% translation header %}.

Aqui está um exemplo de mensagem marcada para tradução: {% translation greeting %}Hello!{% endtranslation %}

Dica

Destaque o texto que deseja traduzir e use o atalho de teclado Cmd + Alt + L (macOS) ou Ctrl + Alt + L (Windows) para envolver com tags de tradução.

Esse atalho funciona em todos os canais que suportam envio de mensagens multilíngue, exceto nos editores de arrastar e soltar para e-mail e Content Blocks. Para esses, use o botão Adicionar personalização para adicionar tags de tradução.

Localizar URLs

Ao traduzir conteúdo, URLs exigem tratamento especial para evitar links quebrados.

URLs padrão (estáticas)

URLs estáticas são inseridas manualmente no editor (por exemplo, https://example.com). Também recomendamos o seguinte:

Uma URL padrão que segue ambas as recomendações é:

1
<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>

URLs geradas por Liquid

Se sua URL é gerada com Liquid (por exemplo, {% landing_page_url %}), recomendamos o seguinte:

Uma URL gerada por Liquid que segue ambas as recomendações é:

1
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

Importante

Se você está usando rastreamento de links de e-mail (alias de link ou modelos de link), é necessária configuração adicional quando URLs são envolvidas em tags de tradução.

Atributos e estrutura HTML

Envolva apenas texto legível por humanos em tags de tradução. Evite envolver atributos HTML (como class, style ou id) ou outro código estrutural. Atributos HTML controlam layout, estilo e funcionalidade. Envolvê-los em tags de tradução pode quebrar a formatação ou os estilos nas versões localizadas da sua mensagem.

Este texto está corretamente envolvido:

1
2
3
<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>

1
2
3
4
5
{% translation id_1 %}
<p class="headline" style="color: red;">
  Welcome to our sale
</p>
{% endtranslation %}

Etapa 3: Adicionar locais à sua mensagem

Após adicionar tags de tradução à sua mensagem, selecione Gerenciar idiomas no editor (Idiomas nos editores de arrastar e soltar para e-mail e Content Blocks) e selecione pelo menos um local para o qual deseja adicionar traduções.

Content Blocks com traduções

Se sua mensagem contém Content Blocks que já possuem traduções salvas, você não precisa reenviar essas traduções. As traduções salvas são aplicadas automaticamente quando o Content Block é adicionado à sua mensagem.

No modal Gerenciar idiomas, os Content Blocks com traduções salvas aparecem na lista, junto com os locais que suportam. Isso permite que você veja quais partes da sua mensagem já estão localizadas antes de adicionar novas traduções.

Importante

Certifique-se de que cada Content Block inclua traduções para todos os locais adicionados à sua mensagem. Se um Content Block não tiver traduções para um dos locais que você adicionou, ele será exibido no idioma original para os usuários nesse local.

Etapa 4: Adicionar traduções

Após selecionar os locais, adicione traduções à sua mensagem usando um dos seguintes métodos:

• enviar modelo csv
• usar a api de tradução

Selecione Baixar modelo para baixar um CSV contendo uma matriz dos seus IDs de tradução e locais selecionados.

Importante

Para evitar problemas de exibição com caracteres não ingleses, evite usar o Excel para o seu CSV de tradução.

Ao preencher o modelo, traduza apenas o conteúdo de texto para cada local. Se tags HTML estiverem presentes no modelo baixado, deixe-as inalteradas e traduza apenas o texto dentro das tags.

Por exemplo, se o modelo contém:

1
<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>

Traduza apenas o texto A charming bakery dedicated to crafting artisanal breads. e mantenha as tags HTML <p style="margin:0;margin-bottom:0"> e </p> como estão.

Em seguida, envie o arquivo preenchido e as traduções serão aplicadas à sua mensagem.

Use uma API de tradução de parceiro para gerenciar e atualizar traduções nas suas Campaigns e Canvas. Isso é útil se você usa um sistema externo para localização ou deseja se conectar diretamente com um parceiro de tradução.

Para usar os endpoints de tradução com Canvas, inclua os seguintes parâmetros:

• workflow_id
• step_id
• message_variation_id

Nota

Ao usar a API de tradução com etapas do Canvas que foram criadas após o lançamento do Canvas, o message_variation_id que você passa para a API estará vazio ou em branco.

Etapa 5: Pré-visualizar traduções

Para pré-visualizar sua mensagem, selecione a opção Usuário multilíngue no menu suspenso Pré-visualizar como usuário. Isso permite que você alterne entre diferentes definições de local para pré-visualizar todas as traduções da sua mensagem.

Gerenciar traduções

Duplicar etapas do Canvas ou Campaigns e traduções

Quando você duplica uma etapa do Canvas, uma Campaign ou uma variante, as traduções são incluídas. Isso também vale ao copiar entre espaços de trabalho, desde que os locais estejam definidos no espaço de trabalho de destino. Revise e atualize as traduções quando fizer modificações no seu Canvas ou Campaign.

Salvar traduções em Content Blocks

Os Content Blocks oferecem suporte a vários idiomas da mesma forma que as mensagens. Ao criar ou editar Content Blocks, você pode marcar conteúdo para tradução, adicionar locais e fazer upload de traduções usando um CSV ou a API de tradução.

As traduções salvas permanecem associadas ao Content Block. Quando o bloco é adicionado a uma mensagem, suas traduções são incluídas automaticamente.

Mensagens da direita para a esquerda

Ao preencher o arquivo de tradução para idiomas escritos da direita para a esquerda (como árabe), envolva a tradução com span para que ela seja formatada corretamente:

1
{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}

Rastreamento de links em e-mail

Em Campaigns de e-mail, a Braze rastreia links adicionando informações de rastreamento (parâmetros de consulta) a cada URL. Esse comportamento oferece suporte tanto ao alias de link quanto ao modelo de link.

Quando uma URL está envolvida em tags de tradução, a Braze pode não conseguir determinar onde adicionar essas informações de rastreamento. Para garantir que isso funcione corretamente, você deve incluir um caractere especial no final da URL para indicar onde o rastreamento deve ser adicionado.

As URLs usam dois caracteres especiais para controlar como isso funciona:

• ? adiciona rastreamento a uma URL que ainda não o possui.
• & adiciona rastreamento adicional se um ? já estiver presente na URL. Uma URL pode conter apenas um ?.

Configurações de idioma e acessibilidade

Comece com Idioma de acessibilidade em Acessibilidade para contexto WCAG, comportamento de canal e editor (incluindo landing pages) e configurações de Acessibilidade no nível da mensagem.

Ao usar mensagens em vários idiomas, alinhe o idioma de acessibilidade com cada local para que os envios localizados declarem o idioma apropriado.

Configurar o idioma de acessibilidade

Você pode definir o idioma de acessibilidade em dois níveis:

Nível da mensagem

No nível da mensagem, defina o idioma de acessibilidade na seção Acessibilidade das configurações da sua mensagem. Para selecionar um idioma, usar Liquid e conhecer as limitações por canal, consulte Idioma de acessibilidade.

Nível do local

Para mensagens em vários idiomas, defina o idioma de acessibilidade para cada local em Configurações de localização. Você pode usar {{accessibility_language}} na seção Acessibilidade para que o idioma do documento ou cartão seja mapeado para esses valores de local.

Se esse token aparece por padrão em novas mensagens depende do canal e do editor. Por exemplo, In-App Messages e Banners se comportam de forma diferente de landing pages e e-mails de arrastar e soltar. Consulte Idioma de acessibilidade para mais detalhes.

Perguntas frequentes

Quais são os limites para tags de tradução?

Ao usar tags de tradução, os seguintes limites se aplicam:

• Cada mensagem pode ter até 200 tags de tradução.
• Cada texto padrão (o conteúdo entre as tags de tradução) pode ter até 2.000 caracteres.
• As traduções por localidade podem ter até 409.600 bytes (aproximadamente 409,6 KB).

Por que estou recebendo um erro ao baixar modelos de e-mail multilíngues?

Se você encontrar erros ao baixar modelos de e-mail multilíngues, as tags de tradução podem estar envolvendo atributos HTML ou estilos CSS que entram em conflito com a forma como a Braze processa os corpos de e-mail.

A Braze trata o corpo HTML e o corpo de texto simples como componentes separados da mesma mensagem. Quando as tags de tradução incluem referências href e estilos CSS, isso pode gerar tags conflitantes que impedem o download correto do modelo.

Para resolver isso:

• Exclua referências href e estilos CSS das tags de tradução.
• Envolva apenas conteúdo de texto legível por humanos nas tags de tradução, conforme descrito em Atributos e estrutura HTML.
• Para URLs, siga as orientações em Localizar URLs.

Posso fazer uma alteração no texto traduzido em uma das minhas localidades?

Sim. Primeiro, faça a edição no CSV e depois faça o upload do arquivo novamente para alterar o texto traduzido.

A Braze fornece traduções?

Não. Você deve fornecer suas próprias traduções fazendo upload de um CSV ou usando a API de tradução.

Posso aninhar tags de tradução?

Não.

Posso envolver mensagens HTML inteiras em uma tag de tradução?

Não. Como prática recomendada, você deve envolver apenas texto legível por humanos ou conteúdo que precisa ser localizado. Isso ajuda a evitar formatação quebrada, links ou outros elementos que não são texto.

Além disso, considere envolver partes menores e semanticamente relacionadas do texto para criar traduções precisas e evitar limitações de desempenho ou tamanho.

Posso fazer uma alteração no texto traduzido em uma das minhas localidades?

Sim. Se estiver usando um CSV, primeiro faça a edição no arquivo e depois faça o upload novamente para alterar o texto traduzido. Se estiver usando a API de tradução, use os endpoints de atualização para fazer alterações.

Quais validações ou verificações adicionais a Braze realiza?