Hreflang tiene una propiedad que hace que depurar sea excepcionalmente molesto: cada modo de falla produce un marcado que parece correcto. No hay error en la consola, ni placa roja en el navegador, ni fallo de compilación. Las etiquetas se representan, la página se valida como HTML y la anotación no hace nada. Semanas más tarde, te descubrirás a partir de un informe de la consola de búsqueda o de alguien en otro país que te dice que obtuvo la página equivocada.
He depurado suficientes de estos ahora para tener una lista. Esta es esa lista, ordenada aproximadamente según la frecuencia con la que encuentro cada una, con el síntoma que observarías y la solución. Se encuentra debajo del guía completa de hreflang junto a las piezas x-predeterminado y hreflang versus canónico.
TL;Dr: Los errores de hreflang más comunes son la falta de etiquetas de retorno, como códigos que no son ISO
en-UK, URL relativas, un canónico que apunta a todos los idiomas, faltax-default, y mezclar métodos de implementación para las mismas URL. Todos ellos guardan silencio: el marcado representa y no hace nada. Search Console's El informe de orientación internacional detecta errores de etiquetas de retorno y códigos desconocidos a escala; el resto necesita un rastreo o una mirada al HTML renderizado. El generador de etiquetas Hreflang valida códigos, URL, duplicados y el respaldo que falta antes de implementar.
1. Faltan etiquetas de retorno
Síntoma: Buscar informes de consola " sin etiquetas de retorno" Las versiones de idiomas no se intercambian por los mercados correctos y todo el conjunto se comporta como si hreflang estuviera ausente.
Causa: La página A declara la página B como su alternativa, pero la página B no declara la página A. Google requiere que ambas partes confirmen la relación y descarta anotaciones que no sean correspondidas.
Arreglar: Coloque el conjunto completo e idéntico de anotaciones en cada página del grupo, incluida una entrada autorreferencial. No intente ser inteligente acerca de qué página necesita qué entrada. La página en inglés enumera inglés, francés, alemán y x-default; también lo hace la página francesa; también lo hace la página alemana. Mismo bloque en todas partes.
Este es, por un amplio margen, el fallo más común y casi siempre se debe a la edición manual por página o a una plantilla que representa "los otros idiomas" en lugar de "todos los idiomas".
2. Uso de códigos de región que no son ISO
Síntoma: Buscar informes de consola "código de idioma desconocido" o nada en absoluto mientras la anotación se ignora silenciosamente.
Causa: en-UK lidera el campo. UK no es un código ISO 3166-1 alfa-2; el Reino Unido lo es GB. Códigos regionales inventados como en-EU y es-LATAM son la misma clase de error que es en-uk con la carcasa incorrecta combinada con una región ya no válida.
Arreglar: Idioma de ISO 639-1, región de ISO 3166-1 alfa-2, unida por un guión. Para América Latina, la respuesta válida es el código ONU M49 es-419. Para chino, prefiera las subetiquetas de escritura: zh-Hant y zh-Hans.
| Mal | Correcto | porque |
|---|---|---|
en-UK |
en-GB |
UK no es un código ISO 3166-1 |
en-EU |
Entradas separadas por país o simple en |
La UE no es un código de país |
es-LATAM |
es-419 |
código de región ONU M49 para América Latina |
zh-CH |
zh-Hans investigaciones operacionales zh-CN |
CH es Suiza |
CA |
en-CA y fr-CA |
La región por sí sola no es válida |
3. Anotaciones exclusivas de región
Síntoma: No pasa nada. La anotación se ignora por completo.
Causa: Intentar apuntar a un país sin nombrar un idioma, como en hreflang="US" investigaciones operacionales hreflang="CA". Hreflang es el lenguaje primero por diseño; la región es una reducción opcional de un idioma, no un objetivo por sí solo.
Arreglar: Nombra el idioma. Si sirve a Canadá en dos idiomas, son dos entradas: en-CA y fr-CA.
4. Url relativas
Síntoma: La anotación se ignora. Frecuentemente acompañado de "esto funciona en mi máquina" porque las URL relativas se resuelven bien en un navegador.
Causa: href="/fr/pricing" en vez de href="https://example.com/fr/pricing". Hreflang requiere URL absolutas totalmente calificadas, incluido el protocolo y el host.
Arreglar: Emitir URL absolutas. Si los está creando en una plantilla, constrúyalos desde un origen de sitio configurado en lugar de una cadena codificada, por lo que una implementación de estadificación no publica URL de producción o viceversa.
5. Un canónico que apunta a todos los idiomas
Síntoma: Una versión completa del idioma desaparece del índice. Hreflang parece correcto y no tiene ningún efecto.
Causa: La página francesa declara que la página en inglés es canónica. Eso le indica a Google que elimine la URL francesa, y una URL que ha sido canonicalizada no se puede entregar a nadie independientemente de lo que diga hreflang. Canonical es la señal más fuerte y gana.
Arreglar: Cada página se canonicaliza a sí misma. Hreflang describe las relaciones entre esas páginas autocanónicas. Este vale su propia lectura: hreflang vs canónico funciona a través de combinaciones que incluyen URL parametrizadas.
6. Sin x-default
Síntoma: Visitantes de países a los que no se dirige la tierra en una versión de idioma aparentemente aleatoria.
Causa: No se declara ningún respaldo, por lo que Google elige. Su elección se basa en señales de similitud que no son visibles para usted, que es como los visitantes holandeses terminan en una página alemana.
Arreglar: Agrega uno x-default entrada por conjunto, apuntando a un selector de idioma o su versión internacional principal. El guía predeterminada X cubre dónde señalarlo y los errores que lo hacen inútil.
7. Mezcla de métodos de implementación
Síntoma: Comportamiento intermitente y difícil de reproducir. Algunas páginas se intercambian correctamente y otras no.
Causa: HTML <link> etiquetas y mapa del sitio XML xhtml:link entradas que declaran hreflang para las mismas URL. Cada uno es válido solo. Juntos son dos fuentes de verdad que se desvían, y cuando no están de acuerdo no tienes forma de saber cuál usó Google.
Arreglar: Elija un método por conjunto de URL. Etiquetas HTML para la mayoría de los sitios, entradas de mapas de sitio cuando tiene muchas ubicaciones y desea encabezados de página ajustados, encabezados HTTP para archivos que no son HTML como PDF. Luego elimine el otro en lugar de dejarlo como copia de seguridad.
8. Desajustes de protocolo y barra diagonal
Síntoma: Las etiquetas de retorno fallan aunque ambas páginas tengan anotaciones.
Causa: La anotación apunta a https://example.com/fr mientras que la URL indexable es https://example.com/fr/. Sau puncte la http:// en un sitio HTTPS. Estas son URL diferentes, por lo que la etiqueta de retorno en la página real no coincide con la URL de la otra página nombrada.
Arreglar: Utilice la forma canónica exacta de cada URL, la misma cadena que colocaría en un mapa del sitio. Genere hreflang desde el mismo generador de URL que usan sus etiquetas canónicas, para que los dos no puedan estar en desacuerdo.
9. Apuntar a redirecciones o 404s
Síntoma: Comportamiento parcial o degradado; Errores de la consola de búsqueda en los pares afectados.
Causa: Se retiró una configuración regional y sus URL ahora se redirigieron, o se eliminó una página traducida mientras las anotaciones que la nombraban permanecían. Un objetivo de redireccionamiento aún se resuelve, por lo que no es fatal, pero agrega un salto y es posible que la etiqueta de retorno en la URL final no coincida con la URL que se nombró. Un objetivo 404 envenena a la pareja directamente.
Arreglar: Rastree sus propios objetivos de hreflang y verifique los códigos de estado. Este es el control que nadie ejecuta, y es el que encuentra podredumbre en conjuntos que eran correctos cuando se escribieron.
10. Anotar páginas sin índice
Síntoma: El conjunto se comporta de manera inconsistente; algunas alternativas nunca aparecen.
Causa: Una página se anuncia como un idioma alternativo mientras se lleva noindex. Le ha dicho a Google que envíe esta URL a un mercado y la mantenga fuera del índice. La contradicción se resuelve a favor de noindex.
Arreglar: O suelte la anotación o suelte el noindex. Los culpables habituales son las sobras de puesta en escena y las páginas de marcadores de posición no traducidas.
11. Bloqueo de objetivos hreflang en robots.txt
Síntoma: Las alternativas nunca se confirman. Search Console muestra errores de etiquetas de retorno para páginas que llevan etiquetas de retorno visiblemente.
Causa: El objetivo no está permitido en robots.txt, por lo que Googlebot no puede buscarlo ni ver la etiqueta de retorno. La anotación de tu lado está bien; la confirmación del otro lado es inalcanzable.
Arreglar: Permitir el rastreo de cada URL que nombre en una anotación hreflang. Si realmente no se debe rastrear una sección, tampoco debe estar en un conjunto hreflang. El Generador de robots.txt es útil para auditar lo que bloquean sus reglas actuales, que a menudo es más amplio de lo previsto.
12. Códigos duplicados dentro de un conjunto
Síntoma: Impredecible. Google puede tomar el primero, el último o descartar el par.
Causa: Dos entradas con el mismo valor hreflang apuntando a URL diferentes, generalmente porque dos sistemas emiten anotaciones o porque un mapa de configuración regional tiene una clave duplicada. Dos x-default las entradas son el mismo problema en su forma más común.
Arreglar: Una entrada por código por conjunto. Vea la fuente renderizada en lugar de la plantilla; un complemento que agrega un segundo bloque es invisible solo desde la plantilla. El generador hreflang gratuito los indicadores duplican códigos en el conjunto que construye, aunque no puede ver qué más emite la página.
¿Cómo se encuentran estos errores sistemáticamente?
Tres pases, en este orden, porque cada uno atrapa una clase diferente.
Busque la consola primero. El informe de orientación internacional cubre toda la propiedad y encuentra los dos errores que escalan: etiquetas de retorno faltantes y códigos de idioma desconocidos. Está por detrás de sus implementaciones por mucho tiempo que tarde un nuevo rastreo completo, así que trate una semana sin cambios como de costumbre.
Un segundo de rastreo. Cualquier rastreador que extraiga hreflang le proporciona el conjunto por URL. Agrupar por clúster y comparar recuentos: una página con cuatro entradas en un grupo de cinco es el error. Luego verifique el código de estado de cada destino, que es el pase que encuentra los errores 8, 9, 10 y 11.
Html renderizado al final, para la página específica que se está portando mal. curl cuenta los bloques de anotaciones, cuenta el x-default entradas y compare las URL carácter por carácter con las canónicas. Aquí es donde aparecen duplicados y desajustes de barra diagonal, y es el único pase que ve lo que se inyecta un complemento en tiempo de ejecución.
Vale la pena ejecutar el generador antes de todo eso, porque validar el conjunto en el momento en que lo escribe elimina los errores 2, 3, 4, 6 y 12 antes de que puedan enviarse. Lo que ninguna herramienta puede imponer es la reciprocidad, ya que es una propiedad de páginas distintas a la que tienes delante. Para eso, la disciplina es estructural: un mapa local, un renderizador, el bloque completo en cada página. El Siguiente.js y WordPress las guías muestran cómo se ve eso en el código.
Preguntas frecuentes
¿cuál es el error de hreflang más común?
Faltan etiquetas de retorno. La página A nombra la página B como alternativa, pero la página B no nombra la página A, por lo que Google descarta la relación. La solución es colocar el conjunto idéntico completo de anotaciones, incluida una entrada autorreferencial, en cada página del grupo.
¿por qué Search Console dice que mi hreflang no tiene etiquetas de retorno?
Porque la página a la que apuntó no apunta hacia atrás con una anotación coincidente, o apunta hacia atrás con una URL ligeramente diferente. Las barras diagonales finales, las diferencias de protocolo y www versus no www cuentan como URL diferentes.
¿es en-UK un código hreflang válido?
No. UK no es un código ISO 3166-1 alfa-2. El código correcto para el Reino Unido es GB, entonces el valor es en-GB. en-UK se ignora en silencio.
¿pueden las URL de hreflang ser relativas?
No. Hreflang requiere URL absolutas totalmente calificadas, incluidos el protocolo y el host. Las URL relativas se ignoran aunque se resuelvan normalmente en un navegador.
¿una etiqueta canónica anula hreflang?
Efectivamente sí. Si una página se canonicaliza a una versión de idioma diferente, esa URL se elimina del índice y hreflang no puede recuperarla. Cada página debe canonicalizarse a sí misma.
¿cuánto tiempo tardan en aparecer las correcciones de hreflang?
Días a semanas. Google tiene que volver a dibujar cada página del conjunto antes de poder confirmar las etiquetas de retorno, y Search Console informa la actualización en el mismo cronograma.
¿puedo usar etiquetas HTML y hreflang de mapas de sitio?
Puedes, pero no lo haces. Dos fuentes para las mismas URL se separan y, cuando no están de acuerdo, no hay forma de saber cuál se utilizó. Elija un método por conjunto de URL.
¿los objetivos hreflang deben poder rastrearse?
Sí. Si un objetivo está bloqueado en robots.txt o marcado como noindex, Google no puede confirmar la etiqueta de retorno y la anotación falla aunque su marcado sea correcto.
