Perdi uma tarde sólida para hreflang uma vez Um cliente tinha um site em Inglês e Francês, dividido por /en/ e /fr/, e suas páginas em francês simplesmente não seriam classificadas na França - o Google continuou surgindo a versão em inglês para os pesquisadores franceses A marcação parecia correta Estava na cabeça, os códigos estavam lá, as URLs resolvidas O problema, descobriu-se, era que as páginas em inglês apontavam para as francesas, mas as páginas em francês não apontavam para trás Hreflang tem que ser recíproco, e o Google estava jogando todo o cluster fora porque as tags de retorno estavam faltando Nada no navegador me dizia que. Nenhum erro, nenhum aviso - apenas as páginas silenciosamente falhando em classificar onde deveriam.
Isso é hreflang em poucas palavras O conceito é simples: dizer aos motores de busca qual idioma e versão regional de uma página para mostrar quais usuários A execução é um campo minado de códigos ISO, convenções de casing, regras de reciprocidade e uma tag de fallback metade da internet esquece Eu construo e mantenho sites multilíngues com frequência suficiente - através de Toolz.dev, WP Adminify' s documentação, e vários projetos Laravel e React - que EU queria uma ferramenta que gerasse as tags e pegasse os erros antes de serem enviados É essa a Gerador Hreflang, e este guia é tudo o que eu gostaria de saber naquela tarde.
Para o conceito e não para a ferramenta, comece com tags Hreflang explicadas, que é o centro deste tópico e se conecta às peças sobre x-padrão, erros comuns do hreflange configurações de estrutura para Próximo.js e WordPress.
tl;dr: as tags Hreflang informam aos mecanismos de pesquisa qual idioma/região versão de uma página para atender cada usuário, usando o
rel="alternate" hreflang="x"anotação. Os códigos seguem ISO 639-1 (idioma) e ISO 3166-1 (região) - então o Reino Unido éGB, nãoUK. As tags devem ser recíprocas (cada página tem links para trás) e você deve incluir umx-defaultfallback. O gerador gera tags válidas como links HTML, entradas de mapa de site XML ou um cabeçalho HTTP, valida cada código, captura duplicatas e executa 100% em seu navegador.
O que são tags hreflang e quando você precisa delas?
Uma tag hreflang é uma anotação que diz & quot; existe outra versão desta página para uma linguagem e região específicas, e aqui está a sua URL." A sintaxe é <link rel="alternate" hreflang="fr-CA" href="https://example.com/fr-ca/" />, onde fr-CA significa francês como falado no Canadá Quando o Google entende essas relações, ele pode servir a página de francês canadense para um falante de francês no Canadá e a página de inglês dos EUA para alguém nos Estados Unidos, em vez de adivinhar ou deixar de usar qualquer versão que aconteceu para rastrear primeiro.
Você precisa de hreflang sempre que tiver substancialmente o mesmo conteúdo em mais de um idioma, ou o mesmo idioma direcionado a mais de uma região Um blog que existe apenas em inglês não precisa dele Um site de marketing SaaS traduzido em seis idiomas absolutamente precisa O caso intermediário - um idioma, várias regiões, como lojas separadas dos EUA e do Reino Unido que estão ambas em inglês - é onde o hreflang é mais valioso e mais negligenciado, porque as páginas parecem duplicatas para o Google, a menos que você as declare explicitamente como variantes regionais.
A recompensa é dupla Primeiro, a versão certa classifica no mercado certo, o que levanta o click-through e a conversão porque os usuários pousam em preços, moedas e frases que se encaixam neles Segundo, o hreflang neutraliza o problema do conteúdo duplicado: em vez de suas páginas regionais quase idênticas competindo e canibalizando umas às outras, o Google as trata como um cluster de suplentes e escolhe o melhor ajuste por consulta.
Por que os códigos fazem todos tropeçarem?
Porque seguem padrões, não intuição, e os padrões têm casos extremos.
Os valores são tags de idioma BCP 47, definidas em RFC 5646e Google'próprio documentação de versões localizadas é a autoridade em qual subconjunto ele aceita.
A parte do idioma é um código ISO 639-1: duas letras, minúsculas, como en, fr, de, ja. A parte opcional da região é um código ISO 3166-1 alfa-2: duas letras, maiúsculas, como US, GB, DE. Junte-os com um hífen e você terá en-US ou de-DE. As convenções que mordem as pessoas:
- o Reino Unido é
GB, nãoUK.UKnão é um código ISO 3166-1 válido een-UKé um não-op. - A linguagem vem em primeiro lugar e é obrigatória; a região é opcional e não pode ser independente. Não pode visar
USpor si só - não existe tal coisa como hreflang apenas de região É sempre linguagem, opcionalmente estreitada por região. - A América Latina usa um código UN M49,
es-4190, porque abrange muitos países em vez de um Este código de região de três dígitos é válido e útil para o & quot; Espanhol, variedade latino-americana." - O chinês geralmente precisa de uma subtag de script, tipo
zh-Hant(Tradicional) ouzh-Hans(Simplificado), porque a forma escrita importa mais do que o país.
O gerador valida tudo isso Ele verifica cada código contra a forma esperada, normaliza o invólucro (linguagem minúscula, região maiúscula, script titlecase) e avisa quando uma subtag não é uma linguagem ou região ISO reconhecida - então en-UK é sinalizado antes de desperdiçar um rastreamento.
Como faço para usar o Gerador Hreflang?
A ferramenta é construída em torno de uma lista de versões linguísticas e de uma escolha de formato de saída.
Passo 1 - Adicione suas versões. Cada linha é um código de idioma/região mais o URL completo dessa versão Uma lista de seleção rápida oferece os códigos comuns (en-US, es-419, zh-Hant, x-default, e mais) para que você não tenha que lembrar o invólucro exato Adicione uma linha por versão.
Passo 2 - Inclua um x-default. Adicione uma linha com o código x-default apontando para o seu URL de fallback Esta é a versão servida para usuários cujo idioma você não direcionou explicitamente - geralmente uma página de seletor de idioma ou sua página inicial principal.
Passo 3 - Escolha um formato. Alternar entre HTML <link> tags para o cabeçalho da página, xhtml:link entradas para um mapa de site XML ou HTTP Link cabeçalho para arquivos não HTML À medida que você edita, o gerador valida cada código e URL, captura códigos duplicados e mostra uma tabela de status por linha para que você possa ver rapidamente quais entradas são válidas.
Passo 4 - Copie e implante reciprocamente. Copie a saída e - esta é a parte que importa - adicione o mesmo conjunto completo de tags a cada URL do grupo, incluindo uma entrada autorreferencial Em seguida, confirme a configuração com o relatório de segmentação internacional no Google Search Console.
Tudo é executado no lado do cliente, então sua estrutura de URL - que pode expor toda a sua arquitetura internacional - nunca sai do navegador Esse é o mesmo modelo de privacidade por trás de todas as ferramentas do site, abordadas no Guia de privacidade de dados.
Como é a saída em cada formato?
Aqui está um exemplo trabalhado em vez de uma descrição Uma loja que vende para os EUA, Reino Unido, França e América Latina, com uma página de seletor de idioma como o fallback Cinco linhas entram:
| hreflang | URL |
|---|---|
x-default |
https://example.com/ |
en-US |
https://example.com/us/ |
en-GB |
https://example.com/uk/ |
fr-FR |
https://example.com/fr/ |
es-419 |
https://example.com/latam/ |
Observe duas coisas sobre esse conjunto antes da saída. en-US e en-GB ambos são ingleses, diferindo apenas por mercado, o que é o caso para o qual existe hreflang e o caso para o qual a maioria dos sites pula. E es-419 é o código de região M49 da ONU para a América Latina, que a ferramenta aceita como válido em vez de sinalizar, porque uma região de três dígitos é legal em uma etiqueta de idioma, embora não seja um código ISO 3166-1 alfa-2.
Tags de link HTML, para a página <head>:
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="fr-FR" href="https://example.com/fr/" />
<link rel="alternate" hreflang="es-419" href="https://example.com/latam/" />
Esse bloco exacto vai em todas as cinco páginas, inalterado Não é & quot; os outros quatro & quot; em cada página: todos os cinco, incluindo a entrada page' s. That is what makes the annotations reciprocal.
Entradas do mapa do site XML, onde a ferramenta envolve o mesmo conjunto em a <url> elemento e usa o URL da sua página como o <loc>:
<url>
<loc>https://example.com/us/</loc>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/" />
<xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<xhtml:link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<xhtml:link rel="alternate" hreflang="fr-FR" href="https://example.com/fr/" />
<xhtml:link rel="alternate" hreflang="es-419" href="https://example.com/latam/" />
</url>
O gerador lembra a peça que vive fora do bloco que pode produzir: o <urlset> element precisa do namespace xhtml declarado, ou de todos xhtml:link a entrada é ignorada enquanto o arquivo ainda é validado como mapa do site.
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
Cabeçalho HTTP Link, um único valor de cabeçalho para arquivos sem <head> para editar, como um PDF:
Link: <https://example.com/>; rel="alternate"; hreflang="x-default", <https://example.com/us/>; rel="alternate"; hreflang="en-US", <https://example.com/uk/>; rel="alternate"; hreflang="en-GB", <https://example.com/fr/>; rel="alternate"; hreflang="fr-FR", <https://example.com/latam/>; rel="alternate"; hreflang="es-419"
É uma longa linha projetada: uma única Link cabeçalho carregando valores separados por vírgulas. Em nginx isso é um add_header Link "..."; diretiva; no Apache um Header set Link "...". Dividindo-o em vários Link cabeçalhos também funcionam, mas mantê-lo como um valor torna óbvio que o conjunto está completo.
O que significam os avisos do gerador e #39;?
A ferramenta separa os erros, que impedem a emissão de uma entrada, dos avisos, que a deixam passar, mas sinalizam algo que você deve observar. A distinção é importante porque a maioria dos erros do hreflang são marcações legais que não significam nada.
| mensagem | O que o desencadeou | O que fazer |
|---|---|---|
| Não é uma tag de idioma válida | O valor não corresponde language[-Script][-REGION] |
Use primeiro um código de idioma, região opcional ou literal x-default |
| A subtag de idioma não é um código ISO 639-1 comum | Linguagem bem formada, mas não reconhecida | Verifique-o em relação à ISO 639-1; a etiqueta é emitida de qualquer maneira |
| A subtag da região não é um código ISO 3166-1 comum | Região bem formada, mas não reconhecida | É isto que apanha en-UK, onde GB está correto |
| Hreflang duplicado | O mesmo código aparece duas vezes no conjunto | Remova um; duas entradas para um código são uma contradição |
| Nenhum conjunto x-default | O conjunto não tem linha alternativa | Adicione um apontando para uma página seletora ou para sua versão primária |
| hreflang trabalha em clusters | Apenas um URL no conjunto | Adicione as outras versões de idioma; um cluster de uma entrada não faz nada |
| hreflang deve ser recíproco | Sempre mostrado | Implante o bloco idêntico a cada URL do grupo |
O último é sempre exibido em vez de condicionalmente, porque é a falha que nenhuma ferramenta do lado do cliente pode detectar A reciprocidade é uma propriedade das outras páginas, não do conjunto à sua frente, então o gerador declara a regra em vez de fingir verificá-la Todo outro aviso aqui é algo que ele pode verificar genuinamente.
Observe também que os códigos são normalizados em vez de rejeitados no invólucro: EN-gb torna-se en-GB, zh-hant torna-se zh-Hant. As tags de idioma são combinadas com distinção entre maiúsculas e minúsculas, portanto o invólucro é convencional, mas a saída consistente torna legível uma diferença entre duas páginas.
Qual formato de saída devo escolher?
O Google aceita três métodos de implementação, e o certo depende da sua pilha e contagem de páginas.
| método | melhor para | Compensação |
|---|---|---|
HTML <link> tags |
A maioria dos sites; controle direto por página | Adiciona peso a cada página & #39; s cabeça; deve estar em todas as páginas |
Mapa do site XML xhtml:link |
Grandes sites; mantém HTML limpo | Requer manutenção do mapa do site; mais lento para o processamento do Google |
HTTP Link cabeçalho |
Arquivos não HTML como PDFs | Precisa de configuração do servidor; mais difícil de auditar |
Para um site típico, Tags de link HTML são os mais diretos - você os vê na fonte, eles são fáceis de depurar e cada estrutura pode renderizá-los. Para grandes sites com centenas de variantes de idiomas, colocando hreflang no Mapa do site XML mantém seus cabeçalhos de página enxutos e centraliza as anotações em um arquivo (lembre-se de adicionar xmlns:xhtml="http://www.w3.org/1999/xhtml" ao <urlset> elemento, que a ferramenta lembra).O Cabeçalho HTTP o método é um nicho, mas essencial para recursos não HTML, como PDFs, onde não há cabeçote para colocar uma tag de link.
Seja qual for a sua escolha, use apenas um método por conjunto de páginas A mistura de tags HTML e entradas de mapa do site para os mesmos URLs pode enviar sinais conflitantes do Google Se você já estiver gerando um mapa do site, a ferramenta & #39; s formato de mapa do site slots diretamente na saída do Gerador de mapas de sites XML.
O que é x-default e por que isso importa?
x-default é o valor hreflang que especifica uma página alternativa para qualquer usuário cujo idioma ou região você não tenha visado explicitamente. Se o seu site tiver versões em inglês, francês e alemão, e alguém navegando em japonês chegar x-default diz ao Google para onde enviá-los - geralmente uma página inicial neutra ou uma página que permite escolher um idioma.
É opcional no sentido de que o hreflang funciona sem ele, mas o Google recomenda incluí-lo, e EU o trato como obrigatório na prática Sem um x-default, usuários incomparáveis obtêm qualquer versão que o Google adivinhe que esteja mais próxima, que geralmente é apenas sua página mais rastreada, em vez de uma escolha deliberada.
Para a ferramenta & #39; s part: um conjunto com no x-default linha levanta um aviso em vez de um erro, então você ainda pode copiar a saída, mas você terá sido dito Adicione a linha eo fallback é emitido em qualquer um dos três formatos que você selecionou, na mesma posição em cada página Onde apontá-lo, e os erros que torná-lo inútil, são abordados no guia x-default.
Por que o hreflang deve ser recíproco?
Este é o que me custou uma tarde, então ganha seção própria. As anotações de Hreflang devem ser recíprocas. Se a página A declarar a página B como sua alternativa francesa, a página B deve declarar a página A em troca O Google só confia no relacionamento quando ambos os lados o confirmarem Se a tag de retorno estiver faltando, o Google ignora a anotação inteiramente - silenciosamente, sem erro na página.
A maneira limpa de satisfazer isso é colocar o conjunto completo e idêntico de tags hreflang em todas as páginas do grupo, incluindo uma entrada auto-referencial (a página apontando para si mesma).Então, no seu en-US página, você inclui tags para en-US, en-GB, fr-FR, de-DE, e x-default - e exatamente o mesmo bloco aparece no en-GB página, o fr-FR página, e assim por diante Cada página no cluster carrega o mapa inteiro Parece redundante, mas é o que torna as anotações recíprocas e é o que o Google espera.
É por isso que gerar as tags é apenas o passo um. o gerador livre hreflang produz o bloco completo para você reutilizar em todo o cluster, e ele lembra sobre a reciprocidade em seus avisos, mas a disciplina de implantação - mesmo bloco, cada página - está em você Acerte isso e os códigos corretos, e o hreflang funciona silenciosamente e de forma confiável Erre e falha igualmente silenciosamente Para o contexto mais amplo de montagem de uma pilha técnica de SEO, coletei os utilitários relacionados no visão geral do kit de ferramentas para desenvolvedores web.
Como faço para testar que o hreflang está funcionando?
Após a implantação, verifique com o Relatório de segmentação internacional (historicamente chamado de relatório hreflang) no Google Search Console. Ele lista erros como & quot; sem tags de retorno e quot; e & quot; códigos de idioma desconhecidos e quot; em todo o seu site, o que é muito mais rápido do que verificar as páginas uma por uma. Um rastreamento com uma ferramenta de auditoria de SEO também confirmará que cada página carrega o conjunto recíproco completo.
Os erros que vejo com mais frequência, em ordem aproximada de frequência: tags de retorno ausentes (a falha da reciprocidade acima), sem x-padrão, usando UK em vez de GB ou outros códigos não ISO, tags somente de região que tentam atingir um país sem idioma, URLs relativos onde hreflang requer absolutos, e misturando métodos de implementação para as mesmas páginas. Cada um deles produz marcação que parece plausível e não faz nada.
o gerador de etiquetas Hreflang é projetado para capturar aqueles que uma máquina pode capturar - códigos malformados, subtags desconhecidas, duplicatas, URLs não absolutos e o padrão x ausente - e para lembrá-lo sobre aqueles que ela não pode impor para você, ou seja, reciprocidade O catálogo completo, com o sintoma que cada um produz, está em 12 erros comuns de hreflang. Se você estiver conectando hreflang em uma compilação multilíngue maior, o gerador de meta tags lida com o resto do seu cabeçalho por página e o Guia de ferramentas de codificação completa o fluxo de trabalho do desenvolvedor.
Para quais casos extremos você deve planejar?
Uma vez que o básico esteja em vigor, um punhado de situações surge com frequência suficiente para ser planejado. Tags canônicas e hreflang precisam concordar. Cada página' s canônico deve apontar para si mesmo, não para uma versão de idioma diferente - se sua página em francês canoniza para o Inglês, você está dizendo ao Google para soltar a página em francês inteiramente, o que cancela o hreflang que você acabou de adicionar Mantenha canônicos auto-referenciais dentro de um cluster de linguagem e deixe hreflang descrever as relações entre clusters; hreflang vs canônico funciona através das combinações.
A língua e o país são eixos independentes. É perfeitamente válido ter en-US, en-GB, e en-CA tudo em inglês, mas visando países diferentes, e igualmente válido para ter fr-CA e en-CA ambos visando o Canadá em diferentes idiomas Não assuma uma página por país ou uma por idioma; você está mapeando as combinações específicas que seu site realmente serve.
As barras e protocolos de rastreamento devem corresponder aos seus URLs reais. hreflang aponta URLs exatos, então https://example.com/fr/ e https://example.com/fr são alvos diferentes Use a forma canônica e indexável de cada URL - a mesma que você enviaria em um mapa do site - para que a anotação seja resolvida para uma página ao vivo em vez de um redirecionamento Um redirecionamento em um alvo hreflang não é fatal, mas adiciona um salto e uma chance de o sinal enfraquecer, por isso vale a pena obter a exatidão.
Perguntas frequentes
O que é uma tag hreflang?
Uma tag hreflang informa aos mecanismos de busca qual idioma e versão regional de uma página mostrar a um determinado usuário Ele usa o rel="alternate" hreflang=" x" anotação, onde x é um código de idioma (opcionalmente com uma região), para que um falante de espanhol no México possa receber sua página es-MX em vez da sua página em inglês Hreflang ajuda sites internacionais a evitar problemas de conteúdo duplicado e classificar a página certa em cada mercado.
Qual é o formato Hreflang correto?
O valor é um código de idioma ISO 639-1, opcionalmente seguido por uma região como um código ISO 3166-1 alfa-2 - por exemplo en, en-GB ou pt-BR. A linguagem vem em primeiro lugar e a região é opcional; você não pode segmentar uma região sozinho Observe que os padrões diferem das abreviaturas cotidianas: o Reino Unido é GB, não o Reino Unido.
O que significa x-padrão no hreflang?
x-default Especifica a página de retorno para usuários cujo idioma ou região você não segrou explicitamente. Normalmente é sua página inicial ou uma página de seletor de idiomas. O Google recomenda incluir um padrão X em cada conjunto Hreflang para que visitantes incomparáveis sejam enviados para algum lugar sensato e não em uma versão em linguagem aleatória.
Onde devo colocar tags hreflang?
Você pode implementar hreflang em três lugares: como link rel=" alternativa" tags na cabeça HTML, como entradas xhtml: link em seu mapa do site XML, ou como um cabeçalho HTTP Link (útil para arquivos não-HTML como PDFs) Escolha um método e aplique-o consistentemente - misturá-los para as mesmas páginas pode enviar sinais conflitantes Esta ferramenta gera todos os três.
As tags hreflang precisam ser recíprocas?
Sim. Se a página A declarar a página B como sua alternativa francesa, a página B deverá declarar a página A em troca O Google ignora anotações hreflang que não são confirmadas por tags de retorno nas páginas para as quais apontam A abordagem mais simples é incluir o conjunto completo e idêntico de entradas hreflang - incluindo uma auto-referencial - em todas as páginas do grupo.
As tags Hreflang podem corrigir conteúdo duplicado em todas as regiões?
O Hreflang não remove o conteúdo duplicado, mas informa ao Google que páginas semelhantes são variantes regionais ou de idioma umas das outras em vez de duplicatas para filtrar. Isso ajuda a classificação correta da versão em cada mercado, em vez das páginas canibalizando umas às outras. Para páginas genuinamente idênticas, combine Hreflang com tags canônicas corretas que cada um aponta para si.
Como faço para testar que o hreflang está funcionando?
Use o relatório Internacional de Segmentação (ou Hreflang) no Google Search Console, que lista erros como tags de retorno ausentes e códigos de idioma desconhecidos. Você também pode rastrear o site com uma ferramenta de auditoria de SEO para confirmar que cada página é carregada de conjunto recíproco. As correções podem levar tempo para refletir, pois o Google deve redigitar todas as páginas do grupo.
Meus dados são mantidos privados?
Sim. As tags são geradas inteiramente em seu navegador com JavaScript simples. Seus URLs e estrutura do site nunca são transmitidos, registrados ou armazenados, e o gerador continua funcionando sem uma conexão de rede depois que a página for carregada.
