Visão geral
O UserGuiding possui suporte a texto habilitado para aplicativos multilíngues, abrangendo todos os idiomas e scripts disponíveis nos navegadores modernos.
Suponha que você queira exibir seu conteúdo em diferentes idiomas. Nesse caso, você pode ativar o recurso de localização para seus materiais e carregar as versões traduzidas do seu conteúdo seguindo os passos abaixo.
Configurando a localização
Primeiro, você precisa configurar os idiomas que deseja usar para o seu conteúdo.
- Acesse a aba Localização em suas Configurações.
- Clique no botão +Novo idioma

- Selecione o idioma
- Clique em "adicionar critérios de segmentação" e selecione um dos seus segmentos existentes.

Importante: Você precisa criar segmentos de usuários com base em um atributo de idioma. Você pode usar o atributo de idioma padrão, que depende dos cookies do navegador do usuário, ou optar por um atributo personalizado . Recomendamos o uso de um atributo personalizado para maior confiabilidade.
Localização para Guias, Hotspots, Banners, Checklists e Central de Recursos.
Habilitando a localização para um Guia, Hotspots, Banner, Checklists ou Central de recursos.
Ao visitar a página de detalhes de um Guia, Hotspot, Banner, Checklist ou Central de Recursos, acesse a aba Localização no topo. Lá, na lista suspensa, você poderá escolher entre os idiomas adicionais que habilitou para sua conta. Após selecionar o idioma desejado, ative a localização do material para o idioma escolhido.

Após ativar um idioma, você verá a lista de todos os campos pertencentes a esse conteúdo específico na página. Cada campo precisa ser traduzido individualmente para o novo idioma.

Utilizando a função de tradução automática
Você pode usar a função de tradução automática para traduzir cada campo individualmente ou todos os campos de uma só vez usando o botão de tradução automática na parte superior. Essa função traduzirá automaticamente o conteúdo original para o idioma desejado, mantendo também os atributos HTML pertencentes ao conteúdo.
Para banners, listas de verificação e centros de recursos, você pode traduzir cada campo manualmente ou usar o botão "Traduzir tudo automaticamente". Observe que o download/upload de CSV não está disponível para esses materiais; use os campos de tradução embutidos ou a opção "Traduzir tudo automaticamente".
Para Checklists, os campos traduzíveis incluem: título, subtítulo, cabeçalhos dos itens, texto de inicialização, mensagem de itens bloqueados, textos do botão de fechar, cabeçalho e corpo da animação de conclusão e URLs dos itens da página.
Para Central de Recursos , os campos traduzíveis incluem: título, subtítulo, espaço reservado para pesquisa, mensagem de ausência de resultados, cabeçalhos/descrições de módulos e grupos, texto alternativo do corpo do conteúdo e da imagem de capa, URLs de módulos de URL externa, texto de inicialização e nomes de guias para Base de Conhecimento, Atualizações de Produtos e Assistente de IA.
Observação: os campos de URL (itens de URL da página da lista de verificação e módulos de URL externa da Central de Recursos) podem ser traduzidos, mas apenas manualmente. O botão de tradução automática por campo está desativado para URLs, e elas são excluídas da opção "Traduzir tudo automaticamente".
Tradução manual através do download e upload de arquivos CSV (UTF-8)
Observação: a tradução baseada em CSV está disponível apenas para Guias e Hotspots. Para banners, listas de verificação e centros de recursos, use os campos de tradução embutidos na guia Localização.
Para traduzir o conteúdo manualmente, você precisará baixar o arquivo de tradução do seu material. Certifique-se de que o conteúdo do seu material original esteja totalmente pronto para ser localizado antes de baixar o arquivo.
- Clique no botão de download do arquivo CSV na parte superior.
- No arquivo CSV, você verá todo o conteúdo de texto do seu material original, incluindo os botões obrigatórios ou personalizados, imagens, vídeos ou códigos de incorporação HTML, etc.
Traduzir e carregar o conteúdo
- Abra o arquivo CSV com um editor.
- Preencha a coluna "traduzido" para cada texto.
- Salve seu arquivo como CSV com um novo nome.
- Volte às configurações de localização do seu material.
- Faça o upload do seu arquivo traduzido usando o botão de upload de CSV.
Pré-visualização e publicação do material
Cada material localizado pode ser visualizado nos idiomas para os quais você traduziu.
Para Guias e Hotspots, você pode clicar no botão Visualizar na parte superior da página. Você será redirecionado para sua plataforma e poderá visualizar o material através da extensão UserGuiding.

Pré-visualização no Editor (Banners, Listas de Verificação e Centros de Recursos)
Para banners, checklists e central de recursos, você pode visualizar as traduções diretamente no editor de materiais. Na guia Localização, clique em Visualizar no Editor e selecione um idioma no menu suspenso que aparece acima das configurações do editor. O editor exibirá o conteúdo traduzido para o idioma selecionado e as configurações ficarão esmaecidas durante a visualização. Clique em Voltar para retornar à guia Localização. O idioma selecionado permanece mesmo após a troca de guias do editor e a atualização da página.

Sempre que adicionar conteúdo novo à sua Checklist ou Central de Recursos, lembre-se de traduzir os novos itens. Você pode ativar a opção " Show only missing translations" para identificar rapidamente qualquer conteúdo que ainda precise ser traduzido.

Se você estiver satisfeito com o resultado, não se esqueça de salvar e publicar suas alterações.
📌 Observações importantes
- Esses recursos estão disponíveis para os planos Growth e superiores.
- Você não precisa adicionar o idioma padrão que usou para criar seus materiais originais como um novo idioma.
- Se você estiver usando a Tradução Manual via CSV (somente Guias e Pontos de Interesse)
- Não deve haver nenhuma linha em branco na coluna "traduzido".
- Você não deve alterar nada na coluna "padrão".
- Você deve enviar arquivos separados para cada idioma que traduzir. Não é permitido adicionar novas colunas ao arquivo original.
- O arquivo deve estar no formato CSV e a codificação do arquivo deve ser UTF-8 para ser carregado com sucesso.
- Observe que as análises do painel serão exibidas apenas pelos materiais, e não pelos idiomas traduzidos.
- Não é necessário selecionar a segmentação baseada em idioma para seus materiais. O material será exibido de acordo com as configurações de idioma que você definiu na página de Localização.
🤓 Melhores Práticas
- Como editar um arquivo CSV e proteger o tipo de arquivo após salvá-lo pode ser um desafio, sugerimos que você use uma ferramenta online como esta para evitar possíveis erros. E se estiver usando uma planilha, lembre-se de exportar seus arquivos finalizados no formato CSV (UTF-8).
- Se você tiver imagens, GIFs ou vídeos localizados, poderá adicionar os respectivos endereços ou incorporar os códigos na linha correspondente, abaixo da coluna traduzida, no arquivo.
- Certifique-se de que seu material esteja totalmente pronto para ser localizado. A edição do material também exigirá ajustes adicionais nos arquivos de tradução.
- Localizar seus materiais enquanto estiverem inativos é sempre melhor para fins de teste mais eficazes.
- Caso deseje fazer alterações em seus materiais, certifique-se de restaurar todos os arquivos traduzidos como referência para uso futuro.
