Ir para o conteúdo

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, webhook, banner, mensagem no app ou Content Block.

Pré-requisitos

Recurso Permissões de usuário obrigatórias
Localidades multilíngues Você precisa dessas permissões para criar e gerenciar localidades multilíngues:

  • Editar configurações de localização
  • Excluir configurações de localização
Recurso Permissões de usuário necessárias
Tipos de mensagem Você precisa destas permissões para adicionar locais e traduções a Campaigns e Canvas:

  • Editar Campaigns
  • Editar Canvas
Recurso Permissões de usuário necessárias
Modelos Você precisa destas permissões para o tipo de modelo ao qual deseja adicionar locais e traduções:

  • Editar modelos de e-mail
  • Editar modelos de mensagem no app
  • Editar modelos de webhook
  • Editar modelos de bloco de conteúdo

Usar localidades

Etapa 1: Configurar localidades

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

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

Envolva o texto que você 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 precisam ser únicos dentro de uma mensagem. Use nomes de ID semânticos que descrevam o texto de forma clara, como {% translation header %}. Se a mensagem incluir Content Blocks, consulte Content Blocks com tradução para saber como a exclusividade se aplica.

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

Localizar URLs

Ao traduzir conteúdo, as URLs exigem um cuidado 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:

Recomendação Motivo
Mantenha o protocolo (https://) fora das tags de tradução. Envolva apenas o domínio e o caminho (por exemplo, example.com/en). Os tradutores podem alterar ou remover caracteres especiais por engano, quebrando os links.
Não inclua parâmetros de consulta dentro das tags de tradução (por exemplo, ?utm_source=promo). Os tradutores podem alterar ou remover caracteres especiais por engano, resultando em links quebrados.

Veja uma URL padrão que segue as duas recomendações:

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

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

Recomendação Motivo
Envolva a URL gerada por Liquid em tags de tradução somente se ela precisar ser localizada. A sintaxe Liquid precisa ser preservada com cuidado para ser renderizada corretamente.
Não inclua parâmetros de consulta (por exemplo, ?utm_source=promo) dentro das tags de tradução. Os tradutores podem alterar ou remover caracteres especiais por engano, resultando em links quebrados.

Veja uma URL gerada por Liquid que segue as duas recomendações:

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

Atributos e estrutura HTML

Envolva em tags de tradução apenas o texto legível por pessoas. Evite envolver atributos HTML (como class, style ou id) ou outros códigos estruturais. Os atributos HTML controlam o layout, o estilo e a 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á envolvido corretamente:

<p class="headline" style="color: red;">
  {% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>
Texto envolvido incorretamente

Este texto está envolvido incorretamente:

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

Etapa 3: Adicionar localidades à sua mensagem

Depois de adicionar as 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 uma localidade para a qual deseja adicionar traduções.

Menu suspenso Adicionar localidade com opções para selecionar a localidade padrão ou atributos personalizados.

Content Blocks com tradução

Content Blocks com tags de tradução se comportam de forma diferente dependendo de o bloco ter ou não suas próprias traduções salvas:

Estado do Content Block Onde as traduções são gerenciadas
Tags de tradução, mas sem localidades ou traduções salvas CSV de Gerenciar idiomas da mensagem principal
Tags de tradução com localidades e traduções salvas CSV próprio do Content Block ou API de tradução
Content Blocks com traduções salvas

Se a sua mensagem contiver Content Blocks que já têm traduções salvas, não é preciso fazer upload dessas traduções novamente. As traduções salvas são aplicadas automaticamente quando o Content Block é adicionado à sua mensagem. Esses blocos mantêm seus próprios IDs de tag, que não precisam ser únicos em relação à mensagem principal. Para saber como salvar traduções no próprio bloco, consulte Salvar traduções em Content Blocks.

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

Seção Gerenciar idiomas com uma lista de Content Blocks que têm traduções salvas.

Content Blocks apenas com tags de tradução

Quando um Content Block tem tags de tradução, mas não tem localidades nem traduções salvas, suas tags são tratadas como conteúdo de origem não traduzido na mensagem principal. A exportação de Gerenciar idiomas da mensagem principal inclui essas tags, e o CSV da mensagem principal precisa fornecer as traduções delas. Essas tags precisam ser únicas em relação às outras tags da mensagem principal.

Se você reutilizar um Content Block não traduzido em outra mensagem, essa segunda mensagem também precisará fornecer traduções para as tags do bloco. Para não ter que fornecer traduções em cada mensagem que usa um Content Block, adicione localidades e traduções diretamente ao próprio Content Block.

Etapa 4: Adicionar traduções

Depois de selecionar as localidades, adicione traduções à sua mensagem usando um dos seguintes métodos:

Guia Adicionar traduções com opções para fazer upload de traduções por CSV ou conectar-se a parceiros de tradução.

Selecione Baixar modelo para baixar um CSV com uma matriz dos IDs de tradução e das localidades selecionadas.

Ao preencher o modelo, traduza apenas o conteúdo de texto de cada localidade. Se houver tags HTML no modelo baixado, mantenha-as inalteradas e traduza apenas o texto dentro das tags.

Por exemplo, se o modelo contiver:

<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.

Depois, faça upload do arquivo preenchido, e as traduções serão aplicadas à sua mensagem.

CSV com tags de tradução para um título, texto da oferta, valor da oferta e CTA.

Use uma API de tradução de parceiro para gerenciar e atualizar as traduções em Campaigns, Canvas, Content Blocks, modelos de e-mail e modelos de webhook. Isso é útil se você usa um sistema externo de localização ou quer se conectar diretamente a 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

Etapa 5: Fazer a prévia das traduções

Para fazer a prévia da sua mensagem, selecione a opção Usuário multilíngue no menu suspenso Prévia como usuário. Assim, você pode alternar entre diferentes definições de localidade para ver a prévia de todas as traduções da sua mensagem.

Prévias por localidade

Gerenciar traduções

Duplicar etapas do Canvas ou Campaigns e traduções

Quando você duplica uma etapa do Canvas, uma Campaign ou uma variação, as traduções são incluídas. Isso também vale ao copiar entre espaços de trabalho, desde que as localidades estejam definidas no espaço de trabalho de destino. Revise e atualize as traduções sempre que 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 localidades e fazer upload de traduções usando um CSV ou a API de tradução.

As traduções salvas continuam associadas ao Content Block. Quando o bloco é adicionado a uma mensagem, as traduções dele 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:

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

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 aliasing de links quanto ao modelo de links.

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 que isso funcione corretamente, você precisa incluir um caractere especial no final da URL para indicar onde o rastreamento deve ser adicionado.

As URLs usam dois caracteres especiais para controlar esse funcionamento:

  • ? adiciona rastreamento a uma URL que ainda não o tem.
  • & adiciona rastreamento extra se já houver um ? na URL. Uma URL só pode conter um ?.
URL Contém ? Descrição Exemplo
URL padrão Não Adicione ? depois da tag de tradução de fechamento se a URL ainda não contiver um. <a href="https://{% translation id_1 %}example.com{% endtranslation %}?">Shop Now</a>
URL padrão Sim Use & no final da URL (depois da tag de tradução de fechamento) se ela já contiver ?. <a href="https://{% translation id_1 %}example.com{% endtranslation %}?ref=4&">Shop Now</a>
Gerada por Liquid Não Use ? depois das tags de tradução de fechamento se a URL gerada ainda não contiver um. <a href="{% translation id_1 %}{{ product_url }}{% endtranslation %}?">Shop Now</a>
Gerada por Liquid Sim Use & depois da tag de tradução de fechamento se a URL gerada já contiver um ?. <a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}&">Shop Now</a>

Configurações de idioma e acessibilidade

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

Ao usar mensagens em vários idiomas, alinhe o idioma de acessibilidade a cada localidade para que os envios localizados declarem o idioma adequado.

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 mensagem. Para saber como selecionar um idioma, usar Liquid e conhecer as limitações por canal, consulte Idioma de acessibilidade.

Nível da localidade

Em mensagens em vários idiomas, defina o idioma de acessibilidade de cada localidade em Configurações de localização. Você pode usar {{accessibility_language}} na seção Acessibilidade para que o idioma do documento ou do cartão corresponda aos valores dessas localidades.

Se esse token aparece por padrão em novas mensagens depende do canal e do editor. Por exemplo, mensagens no app e banners se comportam de forma diferente de landing pages e e-mails criados no editor 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 o corpo dos e-mails.

A Braze trata o corpo em HTML e o corpo em 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 o 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. Depois, faça upload do arquivo novamente para alterar o texto traduzido.

A Braze fornece traduções?

Não. Você precisa fornecer suas próprias traduções, seja 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, envolva apenas o texto legível por humanos ou o conteúdo que precisa ser localizado. Isso ajuda a evitar problemas de formatação, links quebrados ou falhas em outros elementos que não são texto.

Além disso, considere envolver trechos menores de texto que tenham relação semântica entre si. Assim, você cria traduções precisas e evita limitações de performance 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. Depois, faça upload dele novamente para alterar o texto traduzido. Se estiver usando a API de tradução, use os endpoints de atualização para fazer as alterações.

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

Cenário Validação na Braze
Uma mensagem contém dois ou mais IDs de tradução correspondentes que mapeiam para textos diferentes. Não será feito o download deste arquivo de tradução.
Um arquivo de tradução não contém um ou mais IDs de tags de tradução. Não será feito o upload deste arquivo de tradução.
Um arquivo de tradução contém localidades que não existem na mensagem. Não será feito o upload deste arquivo de tradução.
As tags de tradução precisam ser adicionadas a uma mensagem antes do download do modelo de tradução. Não será feito o download deste arquivo de tradução.
As tags de tradução encontradas no arquivo enviado não existem na sua mensagem. As traduções extras não serão salvas na mensagem.
Uma mensagem contém uma ou mais Liquid tags quebradas. Para abrir tags, use {% translation your_id_here %}. Para fechar tags de tradução, use {% endtranslation %}. Não será feito o download deste arquivo de tradução.
Um arquivo de tradução contém um texto padrão que não corresponde ao que está na mensagem. As traduções são adicionadas, mas o texto original da mensagem não é atualizado.
Uma ou mais localidades de uma mensagem foram excluídas nas configurações e não existem mais. As traduções já adicionadas continuam existindo na mensagem. Se forem excluídas da mensagem, as traduções serão perdidas.
As tags de tradução contêm URLs completas ou URLs geradas por Liquid. As tags de tradução que contêm URLs são identificadas caso ocorram problemas com links quebrados ou com o rastreamento de links.
As tags de tradução incluem parâmetros de consulta. As tags de tradução que contêm parâmetros de consulta são identificadas caso ocorram problemas com links quebrados ou com o rastreamento de links.
As tags de tradução contêm atributos ou estruturas HTML. As tags de tradução que contêm atributos ou estruturas HTML são identificadas caso ocorram problemas com estilos e formatação.
New Stuff!