Hreflang tem uma propriedade que torna exclusivamente irritante depurar: todo modo de falha produz marcação que parece correta Não há erro de console, nenhum emblema vermelho no navegador, nenhuma falha de construção As tags renderizam, a página valida como HTML e a anotação não descobre semanas depois, a partir de um relatório do Search Console ou de alguém em outro país dizendo que obteve a página errada.
Eu depurei o suficiente destes agora para ter uma lista Esta é aquela lista, ordenada aproximadamente por quantas vezes EU encontro cada um, com o sintoma que você observaria e a correção Ele senta-se sob o guia completo de hreflang ao lado das peças x-padrão e hreflang versus canônico.
tl;dr: Os erros de hreflang mais comuns são tags de retorno ausentes, como códigos não ISO
en-UK, URLs relativos, um canônico que aponta para vários idiomas, faltandox-default, e misturando métodos de implementação para os mesmos URLs Todos eles são silenciosos: a marcação renderiza e não faz nada Search Console' s International Targeting report pega erros de return-tag e código desconhecido em escala; o resto precisa de um rastreamento ou uma olhada no HTML renderizado O gerador de etiquetas Hreflang valida códigos, URLs, duplicatas e o fallback ausente antes de implantar.
1. tags de retorno ausentes
Sintoma: Pesquisar relatórios do Console & quot; sem tags de retorno & quot; As versões linguísticas não trocam pelos mercados certos, e todo o conjunto se comporta como se o hreflang estivesse ausente.
Causa: A página A declara a página B como sua alternativa, mas a página B não declara a página A. O Google exige que ambos os lados confirmem o relacionamento e descarta anotações que não são retribuídas.
Correção: Coloque o conjunto completo e idêntico de anotações em todas as páginas do grupo, incluindo uma entrada auto-referencial Não tente ser inteligente sobre qual página precisa de qual entrada A página em inglês lista inglês, francês, alemão e x-padrão; o mesmo acontece com a página em francês; o mesmo acontece com a página em alemão Mesmo bloco em todos os lugares.
Esta é, por uma ampla margem, a falha mais comum e é quase sempre causada pela edição manual por página ou por um modelo que renderiza o & quot; os outros idiomas e quot; em vez de " todos os idiomas e quot;.
2. Usando códigos de região não ISO
Sintoma: Relatórios do Console de Pesquisa & quot; código de idioma desconhecido e quot;, ou nada enquanto a anotação é silenciosamente ignorada.
Causa: en-UK lidera o campo. UK não é um código ISO 3166-1 alfa-2; o Reino Unido é GB. Códigos regionais inventados como en-EU e es-LATAM são a mesma classe de erro, como é en-uk com o invólucro errado emparelhado com uma região já inválida.
Correção: Língua de ISO 639-1, região da ISO 3166-1 alfa-2, unida por um hífen Para a América Latina, a resposta válida é o código M49 da ONU es-419. Para chinês, prefira subtags de script: zh-Hant e zh-Hans.
| Errado | Direita | por que |
|---|---|---|
en-UK |
en-GB |
UK não é um código ISO 3166-1 |
en-EU |
Entradas separadas por país ou simples en |
A UE não é um código de país |
es-LATAM |
es-419 |
Código da região UN M49 para a América Latina |
zh-CH |
zh-Hans ou zh-CN |
CH é Suíça |
CA |
en-CA e fr-CA |
A região por si só não é válida |
3. Anotações somente de região
Sintoma: Nada acontece A anotação é totalmente ignorada.
Causa: Tentar atingir um país sem nomear um idioma, como em hreflang="US" ou hreflang="CA". Hreflang é a língua em primeiro lugar por design; a região é um estreitamento opcional de uma língua, não um alvo por si só.
Correção: Nomeie o idioma Se você servir o Canadá em dois idiomas, isso é duas entradas: en-CA e fr-CA.
4. URLs relativos
Sintoma: A anotação é ignorada Frequentemente acompanhada pelo & quot; isto funciona na minha máquina & quot; porque os URLs relativos resolvem - se bem num navegador.
Causa: href="/fr/pricing" em vez de href="https://example.com/fr/pricing". Hreflang requer URLs absolutos totalmente qualificados, incluindo protocolo e host.
Correção: Emita URLs absolutos Se você estiver construindo-os em um modelo, construa-os a partir de uma origem de site configurada em vez de uma string codificada, para que uma implantação de teste não publique URLs de produção ou vice-versa.
5. Um canônico que aponta para vários idiomas
Sintoma: Uma versão inteira da linguagem desaparece do índice Hreflang parece correta e não tem efeito.
Causa: A página em francês declara a página em inglês como sua canônica Que instrui o Google a soltar a URL em francês, e uma URL que foi canonizada de distância não pode ser servida a ninguém, independentemente do que hreflang diz Canônico é o sinal mais forte e ganha.
Correção: Cada página canoniza para si mesma Hreflang descreve as relações entre aquelas páginas auto-canônicas Esta vale a pena sua própria leitura: hreflang vs canônico funciona através das combinações incluindo URLs parametrizados.
6. Sem x-padrão
Sintoma: Visitantes de países que você não segmenta pousam em uma versão aparentemente aleatória do idioma.
Causa: Nenhum fallback declarado, então o Google escolhe Sua escolha é baseada em sinais de similaridade que não são visíveis para você, que é como os visitantes holandeses acabam em uma página alemã.
Correção: Adicionar um x-default entrada por conjunto, apontando para um seletor de idiomas ou para sua versão internacional primária. O guia x-default cobre onde apontá-lo e os erros que o tornam inútil.
7. Misturando métodos de implementação
Sintoma: Comportamento intermitente e difícil de reproduzir. Algumas páginas trocam corretamente e outras não.
Causa: HTML <link> tags e mapa do site XML xhtml:link entradas ambos declarando hreflang para os mesmos URLs Cada um é válido sozinho Juntos eles são duas fontes de verdade que deriva, e quando eles discordam você não tem como saber qual deles Google usou.
Correção: Escolha um método por conjunto de URL. tags HTML para a maioria dos sites, entradas de mapa do site quando você tem muitos locais e deseja cabeçalhos de página enxutos, cabeçalhos HTTP para arquivos não HTML como PDFs. Em seguida, remova o outro em vez de deixá-lo como backup.
8. Trailing-slash e incompatibilidades de protocolo
Sintoma: As tags de retorno falham mesmo que ambas as páginas contenham anotações.
Causa: A anotação aponta para https://example.com/fr enquanto o URL indexável é https://example.com/fr/. Ou aponta para http:// em um site HTTPS Estes são URLs diferentes, então a tag return na página real não corresponde ao URL que a outra página nomeou.
Correção: Use a forma canônica exata de cada URL, a mesma string que você colocaria em um mapa do site Gere hreflang a partir do mesmo construtor de URL que suas tags canônicas usam, para que os dois não possam discordar.
9. Apontando para redirecionamentos ou 404s
Sintoma: Comportamento parcial ou degradado; Erros do console de pesquisa nos pares afetados.
Causa: Um locale foi retirado e seus URLs agora redirecionam, ou uma página traduzida foi excluída enquanto as anotações que o nomearam permaneceram Um alvo de redirecionamento ainda é resolvido, portanto não é fatal, mas adiciona um salto e a tag de retorno no URL final pode não corresponder ao URL que foi nomeado Um alvo 404 envenena o par imediatamente.
Correção: Rasteje seus próprios alvos hreflang e verifique os códigos de status Este é o cheque que ninguém executa, e é aquele que encontra podridão em conjuntos que estavam corretos quando foram escritos.
10. Anotando páginas noindex
Sintoma: O conjunto se comporta de maneira inconsistente; alguns suplentes nunca aparecem.
Causa: Uma página é anunciada como uma alternativa de idioma durante o transporte noindex. Você disse ao Google para servir esse URL a um mercado e mantê-lo fora do índice. A contradição resolve a favor de noindex.
Correção: Deixe cair a anotação ou solte a noindex. Encenar sobras e páginas de espaço reservado não traduzidas são os culpados habituais.
11. Bloquear alvos hreflang em robôs.txt
Sintoma: Alternativas nunca são confirmadas O Console de Pesquisa mostra erros de tag de retorno para páginas que carregam visivelmente tags de retorno.
Causa: O alvo é anulado em robots.txt, então o Googlebot não pode buscá-lo e não pode ver a tag de retorno A anotação do seu lado está boa; a confirmação do outro lado é inacessível.
Correção: Permitir o rastreamento de cada URL que você nomear em uma anotação hreflang Se uma seção genuinamente não deve ser rastreada, ela também não deve estar em um conjunto hreflang O Gerador de Robôs.txt é útil para auditar o que suas regras atuais bloqueiam, o que geralmente é mais amplo do que o pretendido.
12. Códigos duplicados dentro de um conjunto
Sintoma: Imprevisível. O Google pode pegar o primeiro, o último ou descartar o par.
Causa: Duas entradas com o mesmo valor hreflang apontando para URLs diferentes, geralmente porque dois sistemas emitem anotações ou porque um mapa de localidade possui uma chave duplicada. Dois x-default as entradas são o mesmo problema em sua forma mais comum.
Correção: Uma entrada por código por conjunto Visualize a fonte renderizada em vez do modelo; um plugin adicionando um segundo bloco é invisível apenas do modelo O gerador livre hreflang sinaliza códigos duplicados no conjunto que você constrói, embora não consiga ver o que mais a página emite.
Como você encontra esses erros sistematicamente?
Três passes, nesta ordem, porque cada um pega uma classe diferente.
Pesquise primeiro o console. O relatório de segmentação internacional cobre toda a propriedade e encontra os dois erros que escalam: tags de retorno ausentes e códigos de idioma desconhecidos. Ele fica atrás de suas implantações por quanto tempo leva um recrastreamento completo, portanto, trate uma semana sem alterações normalmente.
Um segundo de rastreamento. Qualquer rastreador que extraia hreflang fornece o conjunto por URL. Agrupe por cluster e compare as contagens: uma página com quatro entradas em um grupo de cinco é o bug. Em seguida, verifique o código de status de cada destino, que é a passagem que encontra os erros 8, 9, 10 e 11.
HTML renderizado por último, para a página específica que está se comportando mal. curl ele, conte os blocos de anotação, conte o x-default entradas, e comparar os URLs caractere por caractere contra o canônico É aqui que as duplicatas e incompatibilidades de barra de arrasto aparecem, e é a única passagem que vê o que um plugin injetado em tempo de execução.
Vale a pena executar o gerador antes de qualquer um deles, porque validar o conjunto no ponto em que você o escreve remove os erros 2, 3, 4, 6 e 12 antes que eles possam enviar O que nenhuma ferramenta pode impor é a reciprocidade, já que essa é uma propriedade de páginas diferentes da que está à sua frente Para isso, a disciplina é estrutural: um mapa de localidade, um renderizador, o bloco completo em cada página O Próximo.js e WordPress os guias mostram como isso se parece no código.
Perguntas frequentes
Qual é o erro mais comum do hreflang?
Faltam tags de retorno A página A nomeia a página B como alternativa, mas a página B não nomeia a página A, então o Google descarta o relacionamento A correção é colocar o conjunto completo idêntico de anotações, incluindo uma entrada autorreferencial, em todas as páginas do grupo.
Por que o Search Console diz que meu hreflang não possui tags de retorno?
Porque a página que você apontou não aponta para trás com uma anotação correspondente, ou aponta para trás em um URL ligeiramente diferente Trailing slashes, diferenças de protocolo, e www versus não-www todos contam como URLs diferentes.
En-UK é um código hreflang válido?
Não. UK não é um código ISO 3166-1 alfa-2. o código correto para o Reino Unido é GB, então o valor é en-GB. en-UK é ignorado silenciosamente.
Os URLs do hreflang podem ser relativos?
No. Hreflang requer URLs absolutos totalmente qualificados, incluindo o protocolo e o host URLs relativos são ignorados, embora resolvam normalmente em um navegador.
Uma tag canônica substitui o hreflang?
Efetivamente sim Se uma página canoniza para uma versão de idioma diferente, esse URL é retirado do índice e o hreflang não pode trazê-lo de volta Cada página deve canonizar para si mesma.
Quanto tempo as correções de hreflang levam para aparecer?
Dias a semanas. O Google precisa rastrear novamente todas as páginas do conjunto antes de poder confirmar as tags de retorno e os relatórios do Search Console são atualizados no mesmo cronograma.
Posso usar tags HTML e hreflang de mapa do site?
Você pode, mas não. Duas fontes para os mesmos URLs se separam e, quando discordam, não há como saber qual delas foi usada. Escolha um método por conjunto de URLs.
Os alvos do hreflang precisam ser rastreáveis?
Sim. Se um alvo estiver bloqueado em robots.txt ou marcado como noindex, o Google não poderá confirmar a tag de retorno e a anotação falhará, mesmo que sua marcação esteja correta.
