Hreflang hat eine Eigenschaft, die das Debuggen einzigartig nervt: Jeder Fehlermodus erzeugt Markup, das richtig aussieht Es gibt keinen Konsolenfehler, kein rotes Abzeichen im Browser, keinen Build-Fehler Die Tags rendern, die Seite validiert als HTML, und die Annotation bringt nichts, das erfährt man Wochen später, aus einem Search Console-Bericht oder von jemandem aus einem anderen Land, der einem mitteilt, dass er die falsche Seite bekommen hat.
Davon habe ich jetzt genug debuggt, um eine Liste zu haben Das ist diese Liste, ungefähr danach geordnet, wie oft ich die einzelnen finde, mit dem Symptom, das man beobachten würde und dem Fix Es sitzt unter dem Komplette Hreflang-Führung Neben den Stücken auf x-standard und hreflang versus kanonischdrohen
tl; dr: Die häufigsten hreflang-Fehler sind fehlende Return-Tags, Nicht-ISO-Codes wie
en-UKRelative URLs, ein kanonisches, sprachübergreifendes Zeichen, ein fehlendesx-default‘und Mischimplementierungsmethoden für dieselben URLs. Alle sind still: das Markup rendert und tut nichts Search Console' s International Targeting report fängt Return-Tag - und Unknown-Code-Fehler in großem Maßstab; der Rest braucht einen Crawl oder einen Blick auf das gerenderte HTML. Die hreflang Tag Generator Validiert Codes, URLs, Duplikate und den fehlenden Fallback, bevor Sie es bereitstellen.
1. Fehlende Rücksende-Tags
Symptom: Search Console meldet & quot; keine Rückgabetags" Sprachversionen tauschen nicht gegen die richtigen Märkte aus, und der ganze Satz verhält sich so, als ob Hreflang fehlen würde.
Ursache: Seite A erklärt Seite B als Alternative, Seite B jedoch nicht. Seite A. Google verlangt von beiden Seiten, die Beziehung zu bestätigen, und verwirft Anmerkungen, die nicht erwidert werden.
Fix: Legen Sie den vollständigen, identischen Satz von Anmerkungen auf jede Seite der Gruppe, einschließlich eines selbstreferenziellen Eintrags Versuchen Sie nicht, clever zu sein, welche Seite welchen Eintrag benötigt Die englische Seite listet Englisch, Französisch, Deutsch und x-default auf; ebenso die französische Seite; ebenso die deutsche Seite. Überall derselbe Block.
Dies ist mit Abstand der häufigste Fehler und wird fast immer durch manuelles Bearbeiten pro Seite oder durch eine Vorlage verursacht, die " rendert. die anderen Sprachen" statt " alle Sprachen".
2. Verwendung von Nicht-ISO-Regionalcodes
Symptom: Search Console meldet " unbekannter Sprachcode" oder gar nichts, während die Anmerkung stillschweigend ignoriert wird.
Ursache: en-UK Feld führt. UK Ist kein ISO 3166-1 Alpha-2-Code; das Vereinigte Königreich ist GB. Erfundene regionale Codes wie en-EU und es-LATAM Fehlerklasse sind, so wie en-uk Mit der falschen Hülle gepaart mit einem bereits ungültigen Bereich.
Fix: Sprache von ISO 639-1, Region aus ISO 3166-1 alpha-2, verbunden durch einen Bindestrich Für Lateinamerika ist die gültige Antwort der UN-Code M49 es-419. Für Chinesisch bevorzugen Sie Skript-Untertags: zh-Hant und zh-Hansdrohen
| Falsch | Recht | wieso |
|---|---|---|
en-UK |
en-GB |
UK Ist kein ISO 3166-1 Code |
en-EU |
Separate Einträge pro Land oder einfach en |
Die EU ist kein Ländercode |
es-LATAM |
es-419 |
UN M49-Regionalcode für Lateinamerika |
zh-CH |
zh-Hans oder zh-CN |
CH Schweiz ist |
CA |
en-CA und fr-CA |
Region allein ist nicht gültig |
3. Nur-Region-Anmerkungen
Symptom: Es passiert nichts Die Annotation wird komplett ignoriert.
Ursache: Der Versuch, ein Land ins Visier zu nehmen, ohne eine Sprache zu benennen, wie in hreflang="US" oder hreflang="CA". Hreflang ist vom Design her die Sprache an erster Stelle; Die Region ist eine optionale Einengung einer Sprache und kein eigenständiges Ziel.
Fix: Nennen Sie die Sprache Wenn Sie Kanada in zwei Sprachen bedienen, sind das zwei Einträge: en-CA und fr-CAdrohen
4. Relative URLs
Symptom: Die Annotation wird ignoriert Häufig begleitet von & quot; dies funktioniert auf meiner Maschine" weil relative URLs in einem Browser fein auflösen.
Ursache: href="/fr/pricing" anstelle href="https://example.com/fr/pricing". Hreflang erfordert vollständig qualifizierte absolute URLs einschließlich Protokoll und Host.
Fix: Absolute URLs aussenden Wenn Sie sie in einer Vorlage erstellen, erstellen Sie sie aus einem konfigurierten Site-Ursprung und nicht aus einer fest codierten Zeichenfolge, sodass bei einer Staging-Bereitstellung keine Produktions-URLs veröffentlicht werden oder umgekehrt.
5. Ein Kanonikum, das sprachübergreifend zeigt
Symptom: Eine ganze Sprachversion verschwindet aus dem Index Hreflang erscheint korrekt und hat keine Wirkung.
Ursache: Die französische Seite erklärt die englische Seite als ihre kanonische Das weist Google an, die französische URL fallen zu lassen, und eine URL, die wegkanonisiert wurde, kann niemandem zugestellt werden, egal was hreflang sagt Canonical ist das stärkere Signal und es gewinnt.
Fix: Jede Seite heiligt sich selbst aus Hreflang beschreibt die Beziehungen zwischen jenen selbstkanonischen Seiten Diese ist eine eigene Lektüre wert: hreflang vs. kanonisch Durch die Kombinationen einschließlich parametrisierter URLs funktioniert.
6. Kein x-Standard
Symptom: Besucher aus Ländern, die Sie nicht ins Visier nehmen, landen in einer scheinbar zufälligen Sprachversion.
Ursache: Kein Fallback deklariert, also google pickt Seine Wahl basiert auf Ähnlichkeitssignalen, die für Sie nicht sichtbar sind, so landen niederländische Besucher auf einer deutschen Seite.
Fix: Fügen Sie einen hinzu x-default Eintrag pro Satz, der auf einen Sprachwähler oder Ihre primäre internationale Version zeigt Die x-standard-anleitung Deckt ab, wohin es gerichtet werden soll, und die Fehler, die es nutzlos machen.
7. Mischen von Implementierungsmethoden
Symptom: Intermittierendes, schwer reproduzierbares Verhalten. Einige Seiten tauschen korrekt aus, andere nicht.
Ursache: HTML <link> Tags und XML-Sitemap xhtml:link Einträge, die beide Hreflang für dieselben URLs deklarieren Jede ist allein gültig Zusammen sind sie zwei Wahrheitsquellen, die driften, und wenn sie anderer Meinung sind, haben Sie keine Möglichkeit zu wissen, welche Google verwendet hat.
Fix: Wählen Sie eine Methode pro URL-Set aus HTML-Tags für die meisten Websites, Sitemap-Einträge, wenn Sie viele Locales haben und schlanke Seitenköpfe wünschen, HTTP-Header für Nicht-HTML-Dateien wie PDFs. Entfernen Sie dann die andere, anstatt sie als Backup zu belassen.
8. Trailing-Slash- und Protokollinkongruenzen
Symptom: Return-Tags schlagen fehl, obwohl beide Seiten Anmerkungen enthalten.
Ursache: Die Anmerkung weist auf https://example.com/fr Während die indizierbare URL ist https://example.com/fr/. Oder es zeigt auf http:// Auf einer HTTPS-Seite Das sind verschiedene URLs, so dass das Return-Tag auf der echten Seite nicht mit der URL übereinstimmt, die die andere Seite benannt hat.
Fix: Verwenden Sie die genaue kanonische Form jeder URL, dieselbe Zeichenfolge, die Sie in eine Sitemap einfügen würden Generieren Sie Hreflang aus demselben URL-Builder, den Ihre kanonischen Tags verwenden, sodass die beiden nicht anderer Meinung sein können.
9. Zeigen auf Weiterleitungen oder 404 s
Symptom: Teilweises oder beeinträchtigtes Verhalten; Fehler in der Suchkonsole bei den betroffenen Paaren.
Ursache: Ein Gebietsschema wurde zurückgezogen und seine URLs leiten nun um, oder eine übersetzte Seite wurde gelöscht, während die Anmerkungen, die es benannt haben, blieben. Ein Umleitungsziel löst sich immer noch auf, ist also nicht tödlich, fügt aber einen Hop hinzu und das Rückgabetag auf der endgültigen URL stimmt möglicherweise nicht mit der URL überein, die benannt wurde. Ein 404-Ziel vergiftet das Paar vollständig.
Fix: Krabbeln Sie Ihre eigenen Hreflang-Ziele und überprüfen Sie Statuscodes. Dies ist der Scheck, den niemand ausführt, und er ist derjenige, der Fäulnis in Sätzen findet, die zum Zeitpunkt des Schreibens korrekt waren.
10. Noindex-Seiten anmerken
Symptom: Das Set verhält sich uneinheitlich; einige Abwechselungen erscheinen nie.
Ursache: Eine Seite wird als Sprachalternative beim Tragen beworben noindex. Sie haben Google gesagt, dass sie diese URL sowohl einem Markt zustellen als auch aus dem Index heraushalten soll Der Widerspruch löst sich zugunsten von noindexdrohen
Fix: Entweder die Anmerkung fallen lassen oder die noindex. Die Inszenierung von Resten und nicht übersetzten Platzhalterseiten sind die üblichen Schuldigen.
11. Blockieren von Hreflang-Zielen in Robotern.txt
Symptom: Alternativen werden nie bestätigt Die Search Console zeigt Return-Tag-Fehler für Seiten an, die Return-Tags sichtbar tragen.
Ursache: Das Ziel ist in robots.txt nicht zugelassen, sodass Googlebot es nicht abrufen kann und das Return-Tag nicht sehen kann Die Anmerkung auf Ihrer Seite ist in Ordnung; die Bestätigung auf der anderen Seite ist unerreichbar.
Fix: Erlauben Sie das Crawlen jeder URL, die Sie in einer hreflang-Anmerkung nennen, sollte ein Abschnitt wirklich nicht gecrawlt werden, sollte er sich auch nicht in einem hreflang-Set befinden Die robots.txt-Generator Nützlich ist, um zu prüfen, was Ihre aktuellen Regeln blockieren, was oft breiter ist als beabsichtigt.
12. Duplizieren Sie Codes innerhalb eines Satzes
Symptom: Unvorhersehbar. Google kann das erste, das letzte nehmen oder das Paar verwerfen.
Ursache: Zwei Einträge mit demselben Hreflang-Wert, die auf unterschiedliche URLs verweisen, normalerweise weil zwei Systeme beide Anmerkungen aussenden, oder weil eine Gebietsschema-Karte einen doppelten Schlüssel hat Zwei x-default Einträge sind das gleiche Problem in seiner häufigsten Form.
Fix: Ein Eintrag pro Code pro Satz Sehen Sie sich die gerenderte Quelle und nicht die Vorlage an; ein Plugin, das einen zweiten Block hinzufügt, ist von der Vorlage allein unsichtbar Die Freier Hreflang-Generator Flags duplizieren Codes in dem von Ihnen erstellten Satz, es kann jedoch nicht angezeigt werden, was die Seite sonst noch aussendet.
Wie findet man diese Fehler systematisch?
Drei Pässe in dieser Reihenfolge, da jeder eine andere Klasse fängt.
Suchen Sie zuerst Konsole. Der International Targeting-Bericht deckt die gesamte Eigenschaft ab und findet die beiden Fehler, die skaliert werden: fehlende Return-Tags und unbekannte Sprachcodes. Es bleibt hinter Ihren Deploys zurück, egal wie lange ein vollständiger Recrawl dauert. Behandeln Sie also eine Woche ohne Änderung wie gewohnt.
Eine Kriechsekunde. Jeder Crawler, der hreflang extrahiert, gibt Ihnen den Satz pro URL Gruppe für Cluster und vergleiche zählt: eine Seite mit vier Einträgen in einer Gruppe von fünf ist der Fehler Überprüfen Sie dann den Statuscode jedes Ziels, das ist der Pass, der die Fehler 8, 9, 10 und 11 findet.
Zuletzt gerendertes HTML für die spezifische Seite, die sich schlecht benimmt. curl Es, zählen Sie die Annotationsblöcke, zählen Sie die x-default Einträge, und vergleichen Sie die URLs Zeichen für Zeichen mit dem kanonischen Hier werden Duplikate und Fehler beim Nachziehen und Schrägstrich angezeigt, und es ist der einzige Durchgang, der sieht, was ein Plugin zur Laufzeit eingeschleust hat.
Der Generator lohnt sich, vor all dem zu laufen, denn die Validierung der Menge an dem Punkt, an dem Sie sie schreiben, entfernt die Fehler 2, 3, 4, 6 und 12, bevor sie versenden können Was kein Tool erzwingen kann, ist Gegenseitigkeit, da das eine Eigenschaft von anderen Seiten als der vor Ihnen ist. Dafür ist die Disziplin strukturell: eine Gebietsschema-Karte, ein Renderer, der vollständige Block auf jeder Seite. Die Nächste.js und WordPress Guides zeigen, wie das im Code aussieht.
Häufig gestellte Fragen
Was ist der häufigste hreflang Fehler?
Fehlende Return-Tags Seite A benennt Seite B als Alternative, Seite B jedoch nicht Seite A, sodass Google die Beziehung verworfen hat Die Korrektur besteht darin, den vollständig identischen Satz von Anmerkungen, einschließlich eines selbstreferenziellen Eintrags, auf jede Seite der Gruppe zu setzen.
Warum sagt die Search Console, dass mein Hreflang keine Return-Tags hat?
Denn die Seite, auf die Sie gewiesen haben, zeigt nicht mit einer passenden Anmerkung zurück, oder sie zeigt auf eine etwas andere URL zurück Nachgestellte Schrägstriche, Protokollunterschiede und www versus non-www zählen alle als unterschiedliche URLs.
Ist en-UK ein gültiger Hreflang-Code?
Nein. UK Ist kein ISO 3166-1 Alpha-2 Code Der richtige Code für das Vereinigte Königreich ist GBDer Wert ist also en-GBdrohen en-UK Stille ignoriert wird.
Können hreflang-URLs relativ sein?
Nr. Hreflang benötigt voll qualifizierte absolute URLs inklusive Protokoll und Host, Relative URLs werden ignoriert, obwohl sie sich in einem Browser normal auflösen.
Überschreiben ein kanonisches Tag hreflang?
Effektiv ja Wenn eine Seite in eine andere Sprachversion kanonisiert wird, wird diese URL aus dem Index gestrichen und hreflang kann sie nicht zurückbringen Jede Seite muss für sich selbst kanonisiert werden.
Wie lange dauert es, bis Hreflang-Fixes auftauchen?
Tage bis Wochen. Google muss jede Seite im Set neu crawlen, bevor es die Return-Tags bestätigen kann, und Search Console-Berichte werden nach demselben Zeitplan aktualisiert.
Kann ich sowohl HTML-Tags als auch Sitemap-Hreflang verwenden?
Man kann, aber nicht Zwei Quellen für die gleichen URLs driften auseinander, und wenn sie anderer Meinung sind, gibt es keine Möglichkeit zu sagen, welche verwendet wurde Wählen Sie eine Methode pro eingestellter URL.
Müssen Hreflang-Ziele kriechbar sein?
Ja. Wenn ein Ziel in robots.txt blockiert oder mit noindex markiert ist, kann Google das Return-Tag nicht bestätigen und die Annotation schlägt fehl, obwohl Ihr Markup korrekt ist.
