Gerador de Hreflang

O papel das etiquetas hreflang no SEO internacional

As etiquetas rel="alternate" hreflang são elementos HTML cruciais para websites multilíngues e multi-regionais. Estas etiquetas informam os motores de busca sobre a existência de diferentes versões de uma página web, permitindo que estes apresentem o URL com o idioma ou a variação regional mais adequada a cada utilizador.

Quando um utilizador realiza uma pesquisa, os motores de busca analisam os sinais de localização e as preferências de idioma do utilizador. Ao mapear corretamente as relações entre as páginas através de atributos hreflang, evita-se que diferentes versões linguísticas compitam entre si nos resultados de pesquisa, consolidando a autoridade do sítio web e direcionando o público-alvo para a versão correta.

Estrutura e sintaxe dos atributos hreflang

Uma etiqueta hreflang segue uma estrutura padronizada que deve ser inserida no cabeçalho HTML de um documento. A sintaxe básica de uma etiqueta é a seguinte:

<link rel="alternate" hreflang="codigo-idioma-regiao" href="https://exemplo.com/pagina" />

O atributo hreflang é composto por códigos normalizados que especificam o público-alvo da página:

• Código de idioma: Um código de duas letras em conformidade com a norma ISO 639-1.
• Subetiqueta de escrita (opcional): Um código de quatro letras baseado na norma ISO 15924, útil para idiomas com mais do que um sistema de escrita (por exemplo, o chinês).
• Código de região (opcional): Um código de duas letras em conformidade com a norma ISO 3166-1 Alpha-2, que define o país ou território geográfico específico.

Exemplos de combinações válidas incluem en (inglês geral), zh-Hant (chinês tradicional), zh-CN (chinês simplificado para a China) e zh-Hans-US (chinês simplificado para utilizadores nos Estados Unidos).

O papel do atributo x-default

O valor x-default é um atributo especial utilizado para definir uma página de fallback (retorno). Este URL é apresentado aos utilizadores cujo idioma ou região geográfica não possui uma versão explicitamente mapeada nas restantes etiquetas hreflang.

A implementação do x-default é recomendada para páginas de seleção global de idioma, páginas iniciais genéricas ou para a versão principal do site que deve acolher o tráfego internacional não segmentado. A sua inclusão garante que existe sempre um destino predefinido e estruturado para qualquer visitante global.

Regras de validação e funcionamento do gerador

O Gerador de Hreflang processa os dados introduzidos localmente para garantir a conformidade com as especificações técnicas exigidas pelos motores de busca. O processamento dos dados ocorre inteiramente no navegador do utilizador; os URLs introduzidos não são enviados para o BroBroGo.

Para que o conjunto de etiquetas seja gerado com sucesso, o utilizador deve cumprir as seguintes regras de validação do sistema:

• Limite de versões: O editor suporta a configuração de até 100 versões de idioma em simultâneo.
• Comprimento de URL: Cada URL introduzido deve ter menos de 2048 caracteres.
• Protocolo: Todos os endereços devem ser URLs completos iniciados por http:// ou https://.
• Normalização: O gerador normaliza automaticamente a capitalização de letras no resultado final (por exemplo, convertendo EN-us para en-US) e escapa parâmetros de consulta (query parameters) nos URLs de saída. As variantes zh-Hant e zh-Hans são igualmente normalizadas.
• Códigos rejeitados: Códigos regionais inválidos ou desconhecidos, bem como a especificação regional es-419 (espanhol da América Latina, que não cumpre o formato ISO 3166-1 Alpha-2 de duas letras), são rejeitados pelo validador.

Se existirem erros de validação em qualquer uma das linhas ou no campo x-default, a pré-visualização das etiquetas geradas permanecerá vazia até que todos os problemas sejam corrigidos.

Mensagens de erro e diagnóstico do sistema

O gerador analisa em tempo real os dados introduzidos e exibe mensagens de erro específicas para orientar a correção:

• Adicione pelo menos duas versões de idioma. (Disparado quando o utilizador tenta gerar etiquetas com menos de duas linhas preenchidas).
• A versão {index} precisa de um código de idioma ou idioma-região.
• A versão {index} precisa de um URL completo.
• 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.
• A versão {index} usa {code}, que não é um código de região ISO 3166-1 Alpha-2.
• 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 um URL completo http:// ou https://.
• O URL para a versão {index} deve ter menos de 2048 caracteres.
• Adicione o URL que o x-default deve usar.
• O URL x-default precisa de um endereço completo http:// ou https://.
• O URL x-default deve deve ter menos de 2048 caracteres.
• Este editor suporta até {max} versões de idioma de cada vez.

Perguntas Frequentes

Que códigos hreflang este gerador aceita?
Use um código de idioma ISO 639-1 de duas letras, opcionalmente seguido por uma subetiqueta 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 etiquetas 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 deve apontar o x-default?
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.