Mensagens multilíngues

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

Pré-requisitos

• multi-language locales
• message types
• templates

Uso de locais

Etapa 1: Configure os 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 envio de mensagens.

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

Envolva o texto que deseja traduzir com as Liquid tags de tradução {% 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 %}

Localizando 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="{% translation id_1 %}{% landing_page_url xyz%}{% endtranslation %}">Click Here</a>

Atributos e estrutura HTML

Envolva apenas texto legível por humanos nas tags de tradução. Evite envolver atributos HTML (como class, style ou id) ou outro código estrutural. Atributos HTML controlam layout, estilização 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: Adicione locais à sua mensagem

Após adicionar tags de tradução à sua mensagem, selecione Manage languages no editor (Languages nos editores de arrastar e soltar para e-mail e blocos de conteúdo) e selecione pelo menos um local para o qual deseja adicionar traduções.

Blocos de conteúdo contendo traduções

Se sua mensagem contém blocos de conteúdo que já possuem traduções salvas, você não precisa fazer upload dessas traduções novamente. As traduções salvas são aplicadas automaticamente quando o bloco de conteúdo é adicionado à sua mensagem.

No modal Manage languages, os blocos de conteúdo 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.

Etapa 4: Adicione traduções

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

• upload csv template
• use the translation api

Etapa 5: Visualize as traduções

Para visualizar sua mensagem, selecione a opção Multi-Language User no menu suspenso Preview as User. Isso permite que você alterne entre diferentes definições de local para visualizar todas as traduções da sua mensagem.

Gerenciando traduções

Duplicando etapas do canva ou campanhas, e traduções

Quando você duplica uma etapa do canva, campanha ou variação, as traduções são incluídas. Isso também vale ao copiar entre espaços de trabalho, desde que os locais estejam definidos nesse espaço de trabalho de destino. Certifique-se de revisar e atualizar as traduções ao fazer modificações no seu canva ou campanha.

Salvando traduções em blocos de conteúdo

Os blocos de conteúdo suportam multilíngue da mesma forma que as mensagens. Ao criar ou editar blocos de conteúdo, 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 bloco de conteúdo. 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 o á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 de e-mail

Em campanhas de e-mail, a Braze rastreia links adicionando informações de rastreamento (parâmetros de consulta) a cada URL. Esse comportamento suporta tanto link aliasing quanto modelos 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

Para canais baseados em HTML (e-mail, mensagem no app, banners, landing pages e Cartões de conteúdo), a Braze adiciona um atributo de idioma de acessibilidade (lang) à mensagem renderizada. Esse atributo ajuda tecnologias assistivas, como leitores de tela, a interpretar e pronunciar o texto corretamente.

Sem isso, um leitor de tela assume que o conteúdo está no idioma padrão que o usuário definiu no dispositivo durante a configuração. Se a mensagem estiver em um idioma diferente, o leitor de tela pode não pronunciar tudo corretamente.

Configurando o idioma de acessibilidade

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

Nível da mensagem

Nas configurações da sua mensagem, acesse a seção Accessibility e selecione um idioma no menu suspenso ou use Liquid para definir dinamicamente o idioma de acessibilidade. Isso se aplica a todo o conteúdo da mensagem.

Nível do local

Para mensagens multilíngues, defina o idioma de acessibilidade em cada local nas Localization Settings. Quando novas mensagens são criadas, {{accessibility_language}} é selecionado por padrão na seção Accessibility. Isso mapeia o idioma de acessibilidade para as configurações do seu local.

Padrões

O idioma de acessibilidade é mapeado para o atributo HTML lang, um requisito WCAG 2.1 Nível A (Critério de Sucesso 3.1.1). Para conteúdo multilíngue, você também pode definir o idioma em blocos de conteúdo individuais usando o atributo lang diretamente no seu HTML.

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 local podem ter até 409.600 bytes (aproximadamente 409,6 KB).

Posso fazer uma alteração no texto traduzido em um dos meus locais?

Sim. Primeiro, faça a edição no CSV, depois faça upload do arquivo novamente para aplicar a alteração no 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 boa prática, 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 não textuais.

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

Posso fazer uma alteração no texto traduzido em um dos meus locais?

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

Que validações ou verificações extras a Braze faz?