Configurar o idioma e a localidade do usuário

Decida qual sinal determina o idioma que um consumidor recebe. Depois, defina esse valor no perfil do usuário para que Campaigns e Canvas localizados alcancem o público certo.

Sobre este exemplo

A UponVoyage, uma marca de viagens fictícia, personaliza mensagens para consumidores em doze mercados. O time de marketing deriva o idioma de um atributo personalizado market, definido como o país de onde o consumidor reserva a viagem de ida. Esse atributo corresponde a uma região, não a um idioma. Por isso, consumidores que reservam a partir de um país multilíngue, ou de um país diferente do seu, podem receber o idioma errado.

Este exemplo compara três sinais para o idioma de um consumidor e mostra como definir cada um deles no perfil:

• Idioma coletado pelo SDK: O atributo padrão language, capturado a partir da localidade do dispositivo ou do navegador
• Preferência de idioma explícita: Um valor que o consumidor escolhe no seu app ou site, definido pelo SDK ou pela REST API
• Atributo personalizado de mercado ou região: Um atributo de negócio, como market, usado quando o seu conteúdo varia por região, e não por idioma

language e country são atributos padrão separados na Braze. Quando as variantes regionais importam (por exemplo, espanhol europeu em comparação com espanhol latino-americano), direcione pelos dois atributos em vez de armazenar uma string de localidade combinada.

Este exemplo mostra como escolher um sinal de idioma e defini-lo no perfil. Para armazenar e enviar textos traduzidos, consulte Comparar abordagens de tradução.

Considerações

• O país vem primeiro da geolocalização por IP. A Braze identifica country pela geolocalização do endereço IP. Se a geolocalização não estiver disponível, a Braze identifica country pela localidade do dispositivo. Não trate country como um valor informado pelo dispositivo. Para saber mais, consulte Coleta de dados do SDK.
• A coleta de idioma é opcional e pode ser desativada. language é um dado opcional coletado por padrão, então uma integração mínima ou uma lista de permissões de propriedades do dispositivo pode excluí-lo. Confirme que a sua integração ainda o coleta antes de depender dele. Para saber mais, consulte Armazenamento.
• A localidade do dispositivo mais recente pode estar ausente. Nem todo consumidor tem um valor, então planeje um idioma de fallback para as mensagens que a utilizam.
• Definir um valor explicitamente interrompe a coleta automática. Depois que você define language ou country pelo SDK, pela REST API ou por importação de CSV, a Braze deixa de atualizar automaticamente esse campo para aquele consumidor. Planeje como o consumidor poderá mudar a preferência depois.
• Valores explícitos consomem pontos de dados. Atualizações de atributos pelo SDK e pela API registram pontos de dados, enquanto a coleta automática não. Para saber mais, consulte Pontos de dados.
• language precisa ser um código ISO 639-1. Use códigos de duas letras, como en ou nl. Para ver o conjunto compatível, consulte Códigos de idioma. country usa códigos ISO 3166-1 alfa-2, como GB ou BE.
• Mudar o seu modelo de idioma afeta ativos existentes. Ao passar de um atributo personalizado para atributos padrão, revise os Campaigns, Canvas, Segments e o Liquid que fazem referência ao atributo antigo antes de desativá-lo.

Configuração

Etapa 1: Escolha o sinal que determina o idioma

Quando for possível coletar uma preferência explícita, use-a como sinal principal e recorra ao language coletado pelo SDK como fallback. Um atributo market é um substituto ruim para inferir o idioma em países multilíngues, como Bélgica, Canadá e Suíça.

Etapa 2: Confirme o que a sua integração já coleta

1. Acesse Público > Pesquisa de usuários, abra um perfil de consumidor e verifique os campos Idioma e País.
2. Se Idioma estiver vazio nos perfis, confirme que a sua integração do SDK não o exclui da coleta de propriedades do dispositivo.
3. Observe se Localidade do dispositivo mais recente está preenchido. Use esse campo para diagnóstico e não direcione por ele sem um fallback.

Etapa 3: Defina uma preferência de idioma explícita

Use esta etapa apenas se você escolheu uma preferência de idioma explícita na Etapa 1. Para o language coletado pelo SDK, confirme a coleta na Etapa 2 e vá direto para o direcionamento. Para um atributo personalizado market ou de região, defina esse atributo pelo SDK ou pela REST API e continue com as Etapas 4 a 6, conforme necessário.

Quando um consumidor escolher um idioma, envie essa escolha para a Braze para que ela tenha prioridade sobre a coleta automática.

Defina o valor pelo SDK quando a escolha acontecer no seu app ou site. Para ver os nomes dos métodos em cada plataforma, consulte Definir atributos de usuário.

Para preferências armazenadas nos seus próprios sistemas, envie os atributos padrão pelo endpoint /users/track:

1
2
3
4
5
6
7
8
9

{
  "attributes": [
    {
      "external_id": "{YOUR_EXTERNAL_ID}",
      "language": "nl",
      "country": "BE"
    }
  ]
}

Substitua YOUR_EXTERNAL_ID pelo identificador do consumidor cuja preferência mudou.

Etapa 4: Defina o país quando um consumidor indicar uma região

Defina country explicitamente quando um consumidor informar a região dele, por exemplo, ao navegar em um site específico de um país ou selecionar um mercado no cadastro. Use a mesma solicitação /users/track ou o mesmo método do SDK da etapa anterior.

Se você quiser que o país baseado em IP continue sendo atualizado, não defina country explicitamente. Escolha uma única fonte por consumidor e aplique-a de forma consistente.

Etapa 5: Direcione mensagens por idioma e país

1. Crie Segments com os filtros Idioma e País em vez de um atributo de localidade combinado.
2. Para mensagens que variam por região dentro de um mesmo idioma, filtre pelos dois atributos, por exemplo, language é es e country é ES.
3. Para enviar uma única mensagem renderizada por localidade, adicione localidades usando os atributos padrão de idioma e país. Depois, consulte Mensagens multilíngues.
4. Se você mantiver um atributo market para conteúdo regional, adicione uma localidade com base em atributos personalizados em vez de associar esse atributo a um idioma.

Etapa 6: Migre de um modelo de idioma baseado em mercado

1. Pesquise no seu espaço de trabalho os Campaigns, Canvas, Segments e Content Blocks que fazem referência ao atributo market.
2. Preencha language nos perfis existentes por meio da importação de CSV ou da API, nos casos em que você já conhece a preferência do consumidor.
3. Atualize os ativos para filtrar por Idioma, mantendo o atributo market apenas onde o conteúdo varia por região.
4. Confirme que cada localidade é renderizada como esperado com Prévia da mensagem como usuário antes de desativar o atributo antigo.

Artigos relacionados

• Atributos padrão
• Coleta de dados do SDK
• Códigos de idioma
• Definir atributos de usuário
• Objeto de atributos de usuário
• Configurações de localização
• Mensagens multilíngues
• Comparar abordagens de tradução