Gerador de Hreflang

O que é o Gerador de Hreflang e para que serve?

O Gerador de Hreflang é uma ferramenta desenvolvida para ajudar proprietários de sites, profissionais de SEO e desenvolvedores web a criarem tags rel=alternate hreflang corretas para suas páginas. Quando um site possui versões localizadas para diferentes idiomas ou regiões, os mecanismos de busca utilizam essas tags para identificar a relação entre as páginas e exibir a URL correta para o usuário correspondente.

A ferramenta permite inserir as URLs de cada versão de idioma e região, além de uma URL de fallback opcional para visitantes que não se enquadram em nenhuma das opções específicas configuradas. Com base nessas informações, o gerador valida os dados e cria o conjunto completo de tags pronto para ser adicionado ao código das páginas.

Como usar a ferramenta

Para gerar as suas tags, o processo consiste em preencher os campos estruturados na interface do gerador:

1. Versões de idioma: No campo Idioma ou região, insira o código correspondente à localização da página. No campo URL da versão, insira o endereço web completo (começando com http:// ou https://).
2. Adicionar mais versões: Use o botão para incluir novas linhas. A ferramenta suporta a configuração de até 100 versões de idioma simultaneamente.
3. URL x-default: No campo URL x-default, você pode definir uma URL padrão de fallback para os usuários cujo idioma ou região não possua uma correspondência exata entre as versões listadas.

Após o preenchimento, a ferramenta realiza uma validação automática. Se todos os campos estiverem corretos, a mensagem Todos os códigos e URLs são válidos é exibida e as tags são geradas na seção Tags hreflang geradas. Caso contrário, o painel de validação apontará os erros que precisam ser corrigidos.

Regras de validação e formatação de códigos

Para garantir que os mecanismos de busca interpretem as tags corretamente, o gerador valida rigorosamente os dados inseridos de acordo com os seguintes critérios:

• Estrutura do código de idioma ou região: O campo aceita um código de idioma de duas letras baseado no padrão ISO 639-1. Opcionalmente, ele pode ser seguido por uma subtag de escrita de quatro letras do padrão ISO 15924 e/ou um código de região de duas letras do padrão ISO 3166-1 Alpha-2. Exemplos válidos incluem en, zh-Hant, zh-CN e zh-Hans-US.
• Normalização automática: A ferramenta ajusta automaticamente a capitalização das letras no resultado final (por exemplo, transformando EN-us em en-US). Além disso, os códigos de escrita zh-Hant e zh-Hans são normalizados.
• Códigos rejeitados: O código regional es-419 e quaisquer outros códigos que não correspondam aos padrões ISO suportados são rejeitados pela validação.
• Regras de URL: Todas as URLs fornecidas devem ser completas, iniciar obrigatoriamente com os protocolos http:// ou https:// e possuir comprimento inferior a 2.048 caracteres. Parâmetros de consulta (query parameters) contidos nas URLs são devidamente escapados no código gerado.

Mensagens de erro e resolução de problemas

Se houver alguma inconsistência nos dados inseridos, a geração das tags é interrompida e a ferramenta exibe mensagens de erro específicas para orientar a correção:

• Adicione pelo menos duas versões de idioma.
• A versão {index} precisa de um código de idioma ou idioma-região.
• A versão {index} precisa de uma URL completa.
• A versão {index} deve usar um código de idioma de duas letras, opcionalmente uma escrita ISO 15924 e/ou um código de região de duas letras.
• A versão {index} usa {code}, que não é um código de idioma ISO 639-1 válido.
• A versão {index} usa {code}, que não é um código de região ISO 3166-1 Alpha-2 válido.
• A versão {index} usa {code}, que não é um código de escrita ISO 15924 válido.
• A versão {index} repete o código hreflang {locale}.
• A versão {index} precisa de uma URL completa http:// ou https://.
• A URL para a versão {index} deve ter menos de 2.048 caracteres.
• Adicione a URL que o x-default deve usar.
• A URL x-default precisa de um endereço completo http:// ou https://.
• A URL x-default deve ter menos de 2.048 caracteres.
• Este editor suporta até {max} versões de idioma por vez.

Privacidade dos dados

Ao utilizar este gerador, o processamento das informações ocorre localmente. Todas as URLs inseridas permanecem exclusivamente no seu navegador de internet, garantindo que nenhum dado seja enviado ou salvo nos servidores do BroBroGo.

---

Perguntas Frequentes (FAQ)

Quais códigos hreflang este gerador aceita?

Use um código de idioma ISO 639-1 de duas letras, opcionalmente seguido por uma subtag de escrita ISO 15924 e/ou um código de região ISO 3166-1 de duas letras: en, zh-Hant, zh-CN ou zh-Hans-US. A capitalização das letras é normalizada no resultado final.

Onde devo colocar as tags geradas?

Adicione o conjunto completo e inalterado dentro do <head> de cada versão localizada. Cada página deve fazer referência a si mesma e a todas as outras versões.

Para onde o x-default deve apontar?

Escolha a página para visitantes cujo idioma ou região não possui correspondência exata. Um seletor de idiomas, a página inicial global ou a sua versão principal de idioma podem servir como padrão.