Como as Traduções Inteligentes escolhem o idioma do destinatário
Saiba como as Traduções Inteligentes leem um idioma de cada perfil, escolhem uma versão traduzida no momento do envio e o que verificar quando alguém recebe a versão errada.
As Traduções Inteligentes estão disponíveis apenas em planos pagos.
A propriedade de idioma
As Traduções Inteligentes leem uma Propriedades do perfil para decidir o idioma de cada destinatário. O local é o padrão. Para mudar isso, acesse as configurações de tradução da sua conta (Configurações › Tradução) e escolha qualquer Propriedades do perfil na sua conta em Como determinar o idioma preferido.
Propriedade | Tem um valor padrão? | De onde vem o valor |
|---|---|---|
Localidade (padrão, recomendado) | Sim, para algumas integrações | A Shopify (com o Shopify Markets) e a PrestaShop preenchem isso com base na região da loja do cliente. Você também pode definir isso por conta própria. Os valores devem ser códigos BCP-47, como |
Uma propriedade personalizada, como Idioma | Não | Fica vazio até você coletar isso com um formulário, importação de CSV, link de perfil ou a API. Dê o nome que você quiser, como Idioma ou Idioma preferido. |
Locale é a propriedade recomendada. A integração do Shopify mantém isso em sincronia com a sua loja, e você pode configurá-la por conta própria com qualquer código BCP-47. Escolha uma propriedade personalizada apenas se você já armazena preferências de idioma nela.
Se você escolher uma propriedade personalizada e ela estiver vazia em um perfil, as Traduções Inteligentes usarão a Localidade desse perfil. A caixa de seleção Usar a localidade padrão do perfil quando a propriedade de idioma preferido estiver ausente, embaixo do seletor de propriedade, controla isso e fica ativada por padrão. Com ela desativada, o destinatário recebe o idioma de fallback da mensagem.
Valores aceitos
Os valores de localidade devem ser códigos BCP-47. Uma propriedade personalizada também pode conter nomes de idioma ou de país, mas os códigos BCP-47 ainda são recomendados porque são a única forma de escolher uma variante regional, como o francês canadense.
Tipo de valor | Exemplos | O que o destinatário recebe |
|---|---|---|
Código BCP-47 |
| Esse idioma ou variante regional |
Nome do idioma em inglês (somente propriedade personalizada) |
| O idioma principal |
Nome do idioma nesse idioma (somente propriedade personalizada) |
| O idioma principal |
Nome do país (somente propriedade personalizada) |
| O idioma daquele país |
Apenas um conjunto limitado de nomes é reconhecido, então confira antes de confiar em um deles. Nas configurações de tradução da sua conta, Visualizar idiomas reconhecidos mostra com qual idioma cada valor da propriedade escolhida corresponde e quantos perfis têm esse valor.
Algumas regras de formatação se aplicam a todos os valores:
- Maiúsculas e minúsculas não fazem diferença.
FR-caefr-CAcorrespondem ao mesmo idioma. - Os sublinhados funcionam como hífens; portanto,
en_GBcorresponde aen-GB. - Remova espaços antes ou depois do valor.
Germancom um espaço no final não é reconhecido. - Prefira um idioma a um país onde as pessoas falam vários idiomas.
CanadaouSwitzerlandnão conseguem dizer às Traduções Inteligentes qual idioma alguém quer. - A parte de idioma de um código determina o idioma. A Shopify e outros sistemas geralmente associam o idioma de um comprador ao mercado dele, então
en-FRfica em inglês, não em francês.
Para ver todos os idiomas compatíveis e seus respectivos códigos, consulte Supported languages and locale codes. Um valor que as Traduções Inteligentes não reconhecem não causa um erro. Em vez disso, o destinatário recebe o idioma de fallback da mensagem, conforme descrito na próxima seção.
Ordem de correspondência
No envio, as Traduções Inteligentes comparam o valor de cada destinatário com os idiomas para os quais a mensagem foi traduzida e enviam o primeiro que se encaixar.

Ela para na primeira verificação que se encaixa. Um valor que ela não consegue reconhecer pula direto para o idioma de fallback, que você escolhe para cada mensagem ao traduzi-la. Toda mensagem tem um, e ele pode ser o idioma de origem. As novas mensagens começam com o idioma de fallback definido nas configurações de tradução da sua conta.
Por exemplo, considere uma mensagem com estas configurações:
Idioma de origem | Traduções | Alternativa |
|---|---|---|
Inglês ( | Francês ( | Inglês ( |
Aqui está o que
que diferentes destinatários recebem:
Valor do destinatário | Eles recebem | Por quê |
|---|---|---|
| Francês canadense | Correspondência exata |
| Francês | Mesmo idioma |
| Alemão | Nome do idioma em alemão |
| Inglês | Não há versão em espanhol, então usamos a alternativa. |
Nenhum valor e nenhum local | Inglês | Idioma alternativo |
Colete dados de idioma
Grave o valor de cada idioma na mesma propriedade que as Traduções Inteligentes leem. Recomendamos usar Locale, e as integrações com a Shopify mantêm isso sincronizado com a sua loja. Se você mesmo coleta o idioma, grave códigos BCP-47 em Locale ou use uma propriedade personalizada se quiser armazenar nomes.
Método | Como configurar o idioma | Saiba mais |
|---|---|---|
Formulário de inscrição | Adicione um campo suspenso ou de opção única que salve na sua propriedade de idioma. Para um formulário que aparece apenas no site de um idioma, um campo oculto com um valor fixo também funciona. | |
Páginas de consentimento | Adicione | |
Importação de CSV | Adicione uma coluna de valores de idioma e mapeie-a para a sua propriedade durante a importação. | |
Links do perfil | Adicione um link a uma mensagem que define a propriedade quando alguém clica nele, como um link "Leia isto em Español". | |
API | Defina o atributo |
Use o s
Mesmo formato em todos os lugares, de preferência códigos BCP-47. Misturar de, German e Deutsch entre as fontes ainda funciona, mas deixa os relatórios e suas configurações de tradução mais difíceis de ler.
País e localidade do catálogo para conteúdo do produto
Nomes de produtos, preços e moeda em blocos de produtos vêm do seu catálogo da Shopify localizado, não das Traduções Inteligentes. Isso exige o Shopify Markets e um catálogo localizado. A Klaviyo combina o idioma do destinatário com o país dele para escolher os dados do catálogo, então um falante de francês no Canadá vê detalhes do produto fr-CA com preços em dólares canadenses.
Tipo de bloco | O que corresponde | Se não houver correspondência |
|---|---|---|
Bloco de produtos dinâmicos | Idioma do destinatário e propriedade País | Sem país, usa a localidade do catálogo mapeada para o idioma. Os produtos ausentes da localidade escolhida são deixados de fora; se não restar nenhum, o Klaviyo tenta a localidade mapeada e, depois, o catálogo padrão. |
Bloco de produto estático, com Localizar para o destinatário ativado | O idioma e a região do destinatário no envio | Usa o idioma e a região escolhidos para o bloco, depois a localidade da sua conta e, em seguida, o catálogo base. |
Para definir para qual localidade do catálogo cada idioma será revertido, acesse Configurações › Tradução › Mapeamento de localidade do catálogo. Por exemplo, mapeie o francês para fr-FR para que falantes de francês sem país definido ainda vejam dados de produtos em francês. Para ver as etapas de configuração, consulte Como localizar blocos de produtos.
Por que alguém recebeu o idioma errado
As Traduções Inteligentes usam qualquer valor que a propriedade tiver no momento do envio. Quando alguém recebe o idioma errado, a propriedade geralmente tinha um valor diferente naquela época do que tem agora. Verifique o que grava nessa propriedade antes de presumir que a tradução deu errado.
Para verificar um e-mail anterior, abra o perfil do destinatário, encontre o evento E-mail recebido dessa mensagem no feed de atividades e expanda-o. A localidade preferida é o idioma que as Traduções Inteligentes leram do perfil, e a localidade do conteúdo é a versão que elas enviaram. Se a localidade preferida estiver errada, o perfil tinha um valor diferente no horário de envio. Se ela estiver certa, mas a localidade do conteúdo for diferente, a mensagem não tinha tradução para esse idioma.
Motivo | Como identificar | Corrigir |
|---|---|---|
Uma chamada de identificação no site substituiu o valor. | O JavaScript do Klaviyo do seu site envia um valor de localidade ou idioma quando identifica visitantes. | Remova o idioma da chamada identify ou faça com que ela envie a escolha real do visitante. |
Uma importação ou chamada de API substituiu o valor | Uma importação recente de CSV ou integração gravou na propriedade. | Corrija os dados de origem e depois importe novamente. |
O valor não é reconhecido | As configurações de tradução da sua conta mostram um valor que não corresponde a nenhum idioma. As causas comuns incluem um erro de digitação, um espaço no final, um código não compatível ou um nome em Locale. | Altere o valor para um código compatível. Veja os valores aceitos acima. |
A mensagem não tem tradução para esse idioma | O valor está correto, mas esse idioma não é um dos idiomas de destino da mensagem. | Adicione o idioma à mensagem ou aceite o idioma de fallback para ela. |
Essas alterações acontecem de forma silenciosa. O Klaviyo não mostra um erro quando um valor muda ou não pode ser correspondente, então um envio de teste para um perfil semente é a maneira mais rápida de confirmar o que um destinatário vai receber.
Testar o envio por idioma
As Traduções Inteligentes enviam uma mensagem para todo o seu público, então verifique os idiomas dessa mensagem em vez de dividir seu público por idioma.
- Acesse as configurações de tradução da sua conta e use Visualizar idiomas reconhecidos para verificar como os valores da sua propriedade correspondem. Qualquer valor que não corresponda a um idioma recebe o fallback.
- Certifique-se de que a mensagem seja traduzida para cada idioma que seu público usa.
- Visualize a mensagem como perfis com diferentes idiomas, incluindo um sem valor.
- Envie um teste para você em cada idioma. Veja como revisar e editar as traduções.
Após o envio, o detalhamento por idioma no relatório da mensagem mostra como cada idioma teve desempenho. Veja Medir desempenho por idioma.
Limitações
- Uma propriedade por conta. Todas as mensagens usam a mesma propriedade de idioma. Para usar uma fonte diferente para um público, primeiro grave os valores dela nessa propriedade.
- Nenhum aviso para valores sem correspondência. Um erro de digitação ou um valor não compatível envia o idioma de fallback sem mostrar um erro. Verifique suas configurações de tradução e envie um teste em cada idioma antes de envios em grande escala.
- Os formulários de registro não são traduzidos. Os formulários podem coletar um idioma, mas o próprio formulário é exibido no idioma em que você o criou. Crie um formulário por idioma se precisar de formulários traduzidos.
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 usar o Shopify Markets com a Klaviyo
Saiba como integrar o Shopify Markets ao Klaviyo para garantir que os dados dos seus clientes e as informações do produto, a moeda e os preços de cada região e idioma em que você vende sejam sincronizados no Klaviyo.