Hreflang hibák: teljes útmutató

A hreflang hibák akkor keletkeznek, amikor a nyelvi és regionális változatokat jelölő annotációk hiányosak, nem kölcsönösek, rossz kódot használnak vagy nem indexelhető URL-re mutatnak. Ilyenkor a Google figyelmen kívül hagyhatja a jelölést, és rossz nyelvű oldalt mutathat a felhasználónak. A javítás lényege: teljes, kölcsönös, önhivatkozó klaszterek érvényes ISO-kódokkal és kanonikus, 200-as válaszú URL-ekkel.

Alapfogalmak

A hreflang egy jelzés a keresőmotornak arról, hogy egy adott tartalomnak milyen nyelvi vagy regionális változatai léteznek. Nem rangsorolási tényező a szó klasszikus értelmében, és nem is utasítás: a Google tippként kezeli. Ez a különbség fontos, mert a hibák nagy része abból fakad, hogy valaki parancsként képzeli el, és nem érti, miért nem engedelmeskedik a kereső. Ha a jelzés ellentmond más jeleknek (canonical, belső linkek, átirányítások), a Google a saját következtetését követi.

A hreflang hibák tehát nem csak szintaktikai elgépelések. Három nagy csoportba sorolhatók: technikai hibák (rossz kód, hibás URL, hiányzó visszahivatkozás), logikai hibák (rossz oldalak párosítása, nem egyenértékű tartalmak összekötése) és jelkonfliktusok (canonical, noindex, átirányítás ellentmond a hreflangnek). A javítás sorrendjét is érdemes eszerint felépíteni. Ha a tágabb kontextusra vagy kíváncsi, a Nemzetközi SEO témakör ad keretet hozzá.

A hreflang érték felépítése

Az érték egy kötelező nyelvkódból és egy opcionális régiókódból áll, kötőjellel elválasztva. A nyelvkód az ISO 639-1 szabvány szerinti kétbetűs kód (például hu, de, en), a régiókód az ISO 3166-1 alpha-2 szerinti országkód (például HU, AT, GB). A sorrend mindig nyelv, majd ország. Régiókód önmagában nem állhat, nyelv nélkül érvénytelen.

• hu: magyar nyelvű felhasználók, országtól függetlenül.
• de-AT: német nyelvű felhasználók Ausztriában.
• en-GB: angol nyelvű felhasználók az Egyesült Királyságban (nem en-UK).
• x-default: alapértelmezett változat azoknak, akikre egyik megadott érték sem illik.

Klaszter, kölcsönösség, önhivatkozás

A hreflang-klaszter az egymás megfelelőiként jelölt URL-ek csoportja. Három szabály tartja egyben. Az első a kölcsönösség: ha az A oldal a B-re mutat, a B-nek is vissza kell mutatnia az A-ra, különben a Google a kapcsolatot figyelmen kívül hagyhatja. A második az önhivatkozás: minden oldal a saját URL-jét is felsorolja a klaszterben. A harmadik a teljesség: a klaszter minden tagja ugyanazt a teljes listát tartalmazza.

Mit nem old meg a hreflang

Gyakori félreértés, hogy a hreflang megoldja a duplikált tartalom problémáját vagy automatikusan rangsorol egy oldalt egy országban. Valójában csak segít a megfelelő változatot a megfelelő felhasználónak megmutatni azok közül, amelyek egyébként is relevánsak. Ha egy változat gyenge, a hreflang nem emeli fel. Az is tévhit, hogy a hreflang átirányítja a felhasználót: semmilyen átirányítás nem történik, csak a találati listában megjelenő URL változhat.

Mikor számít egy eltérés hibának?

Nem minden figyelmeztetés valódi hiba. Ha egy eszköz jelzi, hogy egy oldalnak nincs x-default értéke, az ajánlás, nem kritikus hiba. Ha viszont a visszahivatkozás hiányzik, az a klaszter adott párosát érvényteleníti. Döntési szabályként érdemes így gondolkodni: kritikus az, ami miatt a Google eldobhatja a jelölést; közepes az, ami ellentmondó jelet ad; alacsony az, ami csak optimalizálási lehetőség.

Hogyan működik?

A működés megértése nélkül a hibák javítása találgatás marad. A folyamat három szakaszra bontható: a Google feltérképezi az oldalakat és összegyűjti az annotációkat, ezután összeállítja a klasztereket és ellenőrzi a kölcsönösséget, végül a lekérdezéskor a felhasználó nyelvi és helyjellemzői alapján kiválasztja, melyik URL jelenjen meg. Bármelyik szakaszban elcsúszhat valami.

1. Feltérképezés és annotációgyűjtés

A Google csak olyan hreflang-jelölést tud feldolgozni, amelyet lát. Ha egy nyelvi változatot a robots.txt tilt, a kereső nem tudja leolvasni róla a visszahivatkozást, így a pár elveszhet. Ha a jelölés JavaScripttel kerül be, az értelmezés a renderelés idejétől függ, ami késleltetést és bizonytalanságot okozhat. A legbiztosabb, ha a jelölés a nyers HTML-ben, HTTP fejlécben vagy XML sitemapben szerepel.

2. Klaszterképzés és ellenőrzés

Az összegyűjtött annotációkból a Google párokat képez. Minden kapcsolatot két irányból vizsgál: ha csak az egyik irány létezik, a párost nem fogadja el. Itt dől el, hogy egy klaszter teljes vagy szétesik részhalmazokra. Egy húsz nyelvű webhelyen egyetlen elfelejtett visszahivatkozás nem dönti romba az egészet, de az érintett pár kiesik. Ezért a hibák hatása arányos azzal, hány pár sérül.

3. Kiválasztás a találati oldalon

Lekérdezéskor a kereső a felhasználó nyelvi beállításai, helye és a lekérdezés nyelve alapján választ a klaszter elemei közül. A canonical URL ebben döntő: a Google általában a kanonikusként kezelt URL-eket rangsorolja, és a hreflang ezek között cserél. Ha egy változat canonicalja egy másik nyelvre mutat, a változat kieshet az indexből, és a hreflang nem tud rá cserélni.

Szemléltető példa egy klaszterre

Vegyünk egy kitalált webáruházat, amely magyar, osztrák német és általános angol változatot üzemeltet. A magyar oldal fejében ez állna:

Attribútum	URL	Szerep
hreflang="hu"	https://pelda.hu/termek/	Önhivatkozás
hreflang="de-AT"	https://pelda.hu/at/produkt/	Osztrák német változat
hreflang="en"	https://pelda.hu/en/product/	Angol változat
hreflang="x-default"	https://pelda.hu/en/product/	Tartalék

Ugyanennek a négy sornak kell szerepelnie az osztrák és az angol oldalon is. Ha az osztrák oldalról az angolra mutató sor hiányzik, az osztrák és az angol változat közötti pár érvénytelen lesz, miközben a magyar oldallal való kapcsolataik működhetnek. Ez a részleges sérülés a leggyakoribb, és nehéz észrevenni, mert a webhely nagyrészt jól működik.

Jelek hierarchiája

Ha a hreflang ütközik más jelekkel, általában azok erősebbek. A gyakorlatban így érdemes rangsorolni őket hibakereséskor:

1. HTTP státuszkód (a 200-tól eltérő URL nem lehet érdemi klasztertag).
2. Indexelhetőség (noindex, robots-tiltás).
3. Canonical (a nem kanonikus URL hreflangje könnyen elveszik).
4. Hreflang annotáció.
5. Belső linkek és tartalmi nyelvi jelek.

A sorrend azt jelenti, hogy egy hreflang-hibát gyakran nem a hreflangnél kell javítani, hanem egy szinttel feljebb. Részletesebb technikai háttér a Hreflang: teljes útmutató oldalon található.

Fő módszerek

A hreflang háromféleképpen adható meg: HTML-ben a head részben elhelyezett link elemekkel, HTTP fejlécben vagy XML sitemapben. A hibák jellege módszerenként eltér, ezért a javítás is más. Egy webhelyen érdemes egyetlen módszert választani; a keverés nem tilos, de ha a két forrás ellentmond, nehezen diagnosztizálható hibák születnek.

HTML head jelölés

A legelterjedtebb módszer. Minden oldal fejében szerepel a teljes klaszter listája. Előnye, hogy átlátható és oldalanként ellenőrizhető. Hátránya, hogy sok nyelv esetén megnő a fej mérete, és sablonhiba esetén egyszerre több ezer oldal sérülhet. Tipikus hibák: a link elem a body-ba kerül (például egy rosszul záródó head miatt, amit egy beszúrt szkript vagy iframe okoz), relatív URL szerepel abszolút helyett, vagy a CMS nem talál fordítást, és üres href kerül be.

HTTP fejléc

Nem HTML fájloknál, például PDF dokumentumoknál ez a járható út. A szerver a válasz Link fejlécében küldi az annotációkat. Hibaforrás itt a szintaxis: a vesszők, pontosvesszők és idézőjelek elrontása az egész fejlécet érvénytelenítheti. Mivel böngészőben nem látszik, könnyen kimarad az ellenőrzésből. A curl -I parancs vagy egy feltérképező eszköz fejlécnézete segít.

XML sitemap

Nagy, sokféle nyelvű webhelyen ez a legjobban karbantartható módszer, mert a jelölés egy helyen él, és generálható. Minden URL bejegyzés alatt fel kell sorolni a teljes klasztert, az önhivatkozással együtt. A tipikus hibák: hiányzó xhtml névtér-deklaráció, a sitemapben szereplő URL eltér az élő oldal kanonikus URL-jétől (például perjel vagy http/https különbség), illetve elavult sitemap, amely törölt oldalakat is tartalmaz.

Melyik módszert válaszd? Döntési szabály

Helyzet	Javasolt módszer	Indok
Kevés nyelv, közepes oldalszám, jól kezelhető sablon	HTML head	Egyszerű, oldalanként ellenőrizhető
Sok nyelv vagy régió, nagy oldalszám	XML sitemap	Kisebb oldalfej, központi generálás
PDF vagy más nem HTML tartalom	HTTP fejléc	Más módon nem jelölhető
Nincs hozzáférés a sablonhoz, de a sitemap generálható	XML sitemap	Fejlesztési függőség nélkül

Javítási workflow lépésenként

Ha meglévő webhelyen kell rendbe tenni a hreflangot, ez a sorrend vált be a logika szerint, mert a felsőbb szintű hibák nélkül az alsók javítása hatástalan:

1. Leltár: gyűjtsd ki az összes nyelvi változat URL-jét egy táblázatba, oszloponként egy nyelv, soronként egy tartalmi egység.
2. Párosítás ellenőrzése: nézd meg, hogy az egy sorban álló URL-ek valóban egymás megfelelői-e (nem kategóriaoldal egy termékoldallal).
3. Státusz és indexelhetőség: minden URL 200-as, indexelhető, önkanonikus legyen.
4. Kódok validálása: nyelv- és országkódok ISO szerint.
5. Generálás egy forrásból: a táblázatból vagy adatbázisból generáld a jelölést, ne kézzel szerkeszd oldalanként.
6. Feltérképezés és visszaellenőrzés: futtass újra feltérképezést, és nézd meg a kölcsönösséget.

Ennek a folyamatnak a legnagyobb értéke az, hogy a leltártáblázat egyetlen igazságforrás lesz. Amikor új nyelv jön, egy oszloppal bővül, és a jelölés automatikusan követi. A tágabb stratégiai döntésekhez (domainstruktúra, ccTLD vagy almappa) a Nemzetközi SEO: teljes útmutató ad támpontot.

Gyakori hibák

Az alábbi hibák adják a gyakorlatban előforduló problémák nagy részét. Mindegyiknél leírom a tünetet, az okot és a javítást. A sorrend nagyjából a súlyosság szerinti: elöl azok, amelyek a jelölés teljes figyelmen kívül hagyásához vezethetnek.

Hiányzó visszahivatkozás

Tünet: az eszközök „no return tag” vagy hasonló figyelmeztetést adnak. Ok: az egyik nyelvi változat sablonja nem tartalmazza a teljes listát, vagy egy fordítás később jött létre, és a régi oldalak nem frissültek. Javítás: egy központi forrásból generált jelölés, így minden oldal ugyanazt a listát kapja. Határeset: ha egy változat szándékosan nem létezik egy adott tartalomhoz, ne szerepeljen a klaszterben sehol.

Hiányzó önhivatkozás

Sok sablon csak a többi nyelvet sorolja fel, a saját URL-t kihagyja. A Google ajánlása szerint az oldalnak magát is fel kell sorolnia. Ez könnyen javítható, de érdemes rendszerszinten, mert ha egy sablonban hiányzik, akkor ezer oldalon hiányzik.

Érvénytelen nyelv- vagy országkód

Klasszikus példák: en-UK az en-GB helyett, hu-HU helyett hu-hu (ez utóbbi a kis- és nagybetű miatt általában nem okoz gondot, de a következetesség segít), vagy országkód nyelvkódként használva, például se a svéd nyelvre (helyesen sv, az SE az ország). Ugyanígy hibás az eu vagy latam régiókód, mert ezek nem ISO 3166-1 országkódok. A hibás érték egyszerűen figyelmen kívül marad.

Nem kanonikus vagy átirányított URL a klaszterben

Ha a hreflang olyan URL-re mutat, amely 301-gyel továbbvisz, vagy amelynek canonicalja máshova mutat, a jel gyengül vagy elvész. Gyakori ok a perjel-következetlenség (/termek vs /termek/), a http-https keveredés, illetve a paraméteres URL-ek. Javítás: a hreflangben mindig a végleges, önkanonikus, 200-as URL szerepeljen.

Canonical a más nyelvű változatra

Az egyik legsúlyosabb hiba: a német oldal canonicalja az angolra mutat, mert valaki „duplikációt” akart megszüntetni. Ezzel lényegében azt jelzed, hogy a német oldal nem önálló, így kieshet az indexből. A fordítások nem duplikátumok. Minden nyelvi változat önmagára kanonizáljon.

Nem egyenértékű oldalak párosítása

Ha az egyik nyelven nincs megfelelő termékoldal, csábító a kategóriaoldalra vagy a kezdőlapra mutatni. Ez logikai hiba: a hreflang egyenértékű tartalmat feltételez. Jobb kihagyni a változatot a klaszterből, mint rossz oldalra küldeni a felhasználót.

Ellentmondó források

Ha a HTML-ben és a sitemapben eltérő hreflang szerepel, a kereső ellentmondó jeleket kap. Ez tipikusan migrációk után marad meg, amikor az új rendszer sitemapet generál, a régi sablon pedig head jelölést. Egy forrás maradjon.

Gyors ellenőrzőlista

• Minden oldal felsorolja magát is?
• Minden pár mindkét irányból létezik?
• ISO 639-1 nyelvkód és ISO 3166-1 országkód, ebben a sorrendben?
• Abszolút, https, végleges URL-ek?
• Minden hivatkozott URL 200-as, indexelhető és önkanonikus?
• Csak egyenértékű tartalmak vannak összekötve?
• Egyetlen jelölési forrás van használatban?
• Van átgondolt x-default?

Gyakori tévhit: az automatikus nyelvi átirányítás segít

Sokan IP vagy böngészőnyelv alapján automatikusan átirányítják a látogatót. Ez ütközhet a hreflanggel, mert a Googlebot jellemzően egy adott régióból térképez fel, és ha minden változat átirányítja, egyes nyelvi verziókat nem lát. Jobb egy nem erőszakos nyelvválasztó sáv. A többnyelvű tartalomstratégiáról bővebben a Többnyelvű SEO: teljes útmutató szól.

Mérés

A javítás csak akkor ér valamit, ha mérni tudod a hatását. A mérésnek két rétege van: a technikai érvényesség (a jelölés helyes-e) és az üzleti hatás (a megfelelő nyelvű oldal jelenik-e meg a megfelelő piacon). Az első gyorsan ellenőrizhető, a második hetek alatt rajzolódik ki.

Technikai érvényesség mérése

A feltérképező eszközök többsége (asztali crawlerek, felhőalapú auditeszközök) képes kigyűjteni a hreflang-annotációkat, és jelezni a hiányzó visszahivatkozást, az érvénytelen kódot és a nem 200-as célokat. Az eszközök pontos funkcióit és elnevezéseit mindig az adott eszköz dokumentációjában nézd meg, mert változnak. A lényeg, hogy rendszeres, ütemezett feltérképezést futtass, ne csak egyszeri auditot.

Érdemes saját mutatókat is képezni a leltártáblázatból:

• Klaszterteljesség: az érvényes párok aránya az elvárt összes párhoz képest.
• Kölcsönösségi arány: hány kimenő hreflang-kapcsolatnak van visszahivatkozása.
• Érvényes célarány: a hivatkozott URL-ek közül hány 200-as, indexelhető és önkanonikus.

Szemléltető számpélda

Az alábbi számok kitaláltak, csak a számítás menetét mutatják. Tegyük fel, hogy van 500 tartalmi egységed 4 nyelven. Egy teljes klaszterben minden oldal 3 másik nyelvre mutat, így az elvárt irányított kapcsolatok száma 500 × 4 × 3 = 6000. Ha a feltérképezés 5100 kölcsönösen igazolt kapcsolatot talál, a kölcsönösségi arány 85%. A javítás után ugyanezt mérve láthatod, hogy a hiányzó 900 kapcsolatból mennyi állt helyre. Ez sokkal beszédesebb, mint egy eszköz összesített „hibaszáma”, mert egy hiba többféleképpen is számolódhat.

Megjelenés mérése a Search Console-ban

A Search Console teljesítményjelentésében az ország és az oldal dimenzió együttes szűrésével megnézheted, melyik nyelvi változat kap megjelenést melyik országban. Ha az osztrák felhasználóknál a magyar oldal kap jelentős megjelenést a német helyett, az jele lehet annak, hogy a hreflang nem érvényesül. Az URL-vizsgáló eszköz megmutatja, melyik URL-t választotta a Google kanonikusnak, ami a canonical-ütközések felderítésére alkalmas.

Mérési rutin

Gyakoriság	Feladat	Mire figyelj
Minden kiadás után	Mintavételes ellenőrzés sablononként	Önhivatkozás, teljes lista megléte
Hetente	Ütemezett feltérképezés	Kölcsönösségi arány változása
Havonta	Search Console ország és oldal szerint	Rossz nyelvű oldal megjelenése egy piacon
Negyedévente	Leltártáblázat felülvizsgálata	Új, törölt, nem egyenértékű tartalmak

Mikor számíts változásra?

A javítás hatása nem azonnali, mert a Google-nek újra fel kell térképeznie a klaszter minden tagját, és mindkét irányt látnia kell. Nagy webhelyen ez hosszabb ideig tarthat, különösen a ritkán látogatott oldalaknál. Ezért ne értékeld a javítást pár nap alapján. A sitemap frissítése és a fontos oldalak újraindexelésének kérése gyorsíthat, de garanciát nem ad.

Határeset: jó jelölés, rossz eredmény

Előfordul, hogy a technikai mutatók hibátlanok, mégis rossz nyelvű oldal jelenik meg. Ilyenkor a tartalomban keresd az okot: túl hasonló a két változat (például osztrák és német oldal szinte azonos ár- és szállítási információval), vagy az egyik változat lényegesen erősebb belső és külső linkprofillal. A hreflang csak választ az erős jelöltek közül, gyenge oldalt nem tesz erőssé.

Kapcsolódó részletes útmutatók

A hreflang hibák javítása szorosan összefügg a nemzetközi webhely egészének felépítésével. Ha a domainstruktúra, a tartalomlokalizáció vagy a jelölés alapjai nem tiszták, a hibák újra és újra visszatérnek. Az alábbi útmutatók abban segítenek, hogy a javítás ne tűzoltás legyen, hanem egy stabil rendszer része.

Érdemes így haladni: előbb a stratégiai keretet tisztázni, utána a nyelvi tartalmak kezelését, végül a jelölés technikai részleteit. Ha már működő webhelyen dolgozol, fordítva is mehetsz: a hibák feltárása után vissza a stratégiához, hogy lásd, melyik döntés okozta őket.

Mit hol találsz?

• Nemzetközi SEO: a témakör kiindulópontja, a kapcsolódó anyagok áttekintése.
• Nemzetközi SEO: teljes útmutató: domainstruktúra, piacválasztás, célzás országokra.
• Többnyelvű SEO: teljes útmutató: fordítás és lokalizáció, kulcsszókutatás nyelvenként.
• Hreflang: teljes útmutató: a jelölés szintaxisa, módszerei és bevezetése az alapoktól.

Hogyan használd együtt őket?

A hibajavítás során a leltártáblázat a közös pont. A stratégiai útmutató alapján döntöd el, mely piacok és nyelvek kerülnek bele, a többnyelvű útmutató alapján azt, hogy a tartalmak valóban egyenértékűek-e, a hreflang útmutató alapján pedig azt, hogyan generálod belőle a jelölést. Ha ez a három réteg összhangban van, a hreflang hibák jelentős része meg sem születik, a maradékot pedig a mérési rutin időben jelzi.

• Multiregionális SEO: teljes útmutató