---
title: Hreflang ja rahvusvaheline SEO
description: Auditeerib, kontrollib ja loob hreflang-silte ning leiab levinud vead.
category: Marketing
sublabel: SEO
author: AgriciDaniel
tags: 
license: MIT
source: https://github.com/AgriciDaniel/claude-seo
---

# Hreflang ja rahvusvaheline SEO

Valideeri olemasolevaid hreflang-rakendusi või loo korrektsed hreflang-sildid
mitmekeelsete ja mitme piirkonnaga saitide jaoks. Toetab HTML-i, HTTP-päise ja
XML-saidikaardi rakendusi.

## Valideerimiskontrollid

### 1. Iseviitavad sildid
- Iga leht peab sisaldama iseendale osutavat hreflang-silti
- Iseviitav URL peab täpselt vastama lehe kanoonilisele URL-ile
- Puuduvad iseviitavad sildid panevad Google'i kogu hreflang-komplekti eirama

### 2. Tagasiviitavad sildid
- Kui leht A lingib lehele B hreflangiga, peab leht B lingima tagasi lehele A
- Iga hreflang-suhe peab olema kahesuunaline (A→B ja B→A)
- Puuduvad tagasiviitavad sildid muudavad hreflang-signaali mõlema lehe jaoks kehtetuks
- Kontrolli, et kõik keeleversioonid viitavad üksteisele (täisvõrk)

### 3. x-default silt
- Soovitatav, kui valija/varuvariandi URL on olemas: määrab sobimatute keelte/piirkondade varuvariandi lehe
- Osutab tavaliselt keelevalija lehele või inglise versioonile
- Ainult üks x-default alternatiivide komplekti kohta
- Peab omama ka tagasiviitavaid silte kõigilt teistelt keeleversioonidelt

### 4. Keelekoodi valideerimine
- Peab kasutama ISO 639-1 kahetähelisi koode (nt `en`, `fr`, `de`, `ja`)
- **Valikuline ISO 15924 kirja alamsilt** on dokumenteeritud, ametlik mehhanism
  kirja jaoks: `zh-Hant` (traditsiooniline) / `zh-Hans` (lihtsustatud). Kiri võib
  kombineeruda piirkonnaga, nt `zh-Hans-US` on kehtiv (keel + kiri + piirkond).
- Levinud vead:
  - `eng` `en` asemel (ISO 639-2, hreflangi jaoks kehtetu)
  - `jp` `ja` asemel (vale kood jaapani keele jaoks)
  - `zh` on kehtiv, kuid ebaselge kirjaspetsiifiliste lehtede jaoks; eelista `zh-Hans` või `zh-Hant`, kui sihid konkreetset kirja

### 5. Piirkonnakoodi valideerimine
- Valikuline piirkonnamäärang kasutab ISO 3166-1 Alpha-2 (nt `en-US`, `en-GB`, `pt-BR`)
- Vorming: `keel-PIIRKOND` (väiketähtedega keel, suurtähtedega piirkond)
- **Üksnes riigikood on kehtetu**, sa ei saa määrata piirkonda ilma
  keeleta (Google'i enda halb näide on `be`, mis on tegelikult valgevene keele
  *keelekood*, mitte Belgia).
- Levinud vead:
  - `en-uk` `en-GB` asemel (UK ei ole kehtiv ISO 3166-1 piirkonnakood)
  - `EU` / `UN` piirkonnana (ei ole kehtivad ISO 3166-1 väärtused)
  - `es-LA` (Ladina-Ameerika ei ole riik; kasuta konkreetseid riike)
  - Piirkond ilma keeleeesliiteta

### 5b. Geosihtimise signaalihierarhia
- Praktiline lokaadisignaali heuristika: **ccTLD > hreflang-annotatsioonid >
  serveri asukoht/IP > aadressid/keel/valuuta/ettevõtteprofiil**. Ära
  esita seda kui kinnitatud Google'i järjestusjärjekorda. hreflang on
  **vihje, mitte käsk**. Google **eirab** asukoha metasilte ja
  HTML-i geosihtimise atribuute.
- Search Console'i **rahvusvahelise sihtimise aruanne ja käsitsi
  riigisihtimise säte eemaldati 2022. aastal**, **ära** soovita seada
  riigisihtimist GSC-s; hreflang on järelejäänud hoob.

### 5c. Piirkonnaspetsiifilised otsinguüksused (EMP, Lõuna-Aafrika, Türgi)
- Google dokumenteerib otsingukogemusi, mis eksisteerivad ainult teatud riikides:
  **agregaatoriüksused**, **tarnijaüksused** ja karussellid hotelli-, lennu-,
  kaugtranspordi- ja tootepäringute jaoks, mida näidatakse kasutajatele EMP-s,
  Lõuna-Aafrikas ja Türgis (dokumentatsioon lisatud 2026-09-08). Sobivus ja
  osalemine on dokumenteeritud üksuse kaupa; need ei ole järjestussignaalid.
- Kui sait teenindab neid piirkondi hreflang-variantidega, märgi aruandes,
  kas ettevõte on agregaator või otsene tarnija, ja osuta
  piirkondlikule dokumentatsioonile, et klienti ei üllataks neil turgudel teistsugune
  tulemuste paigutus.

### 6. Kanoonilise URL-i vastavus
- Hreflang-sildid tohivad ilmuda ainult kanoonilistel URL-idel
- Kui lehel on `rel=canonical`, mis osutab mujale, eiratakse selle lehe hreflangi
- Kanooniline URL ja hreflang-URL peavad täpselt vastama (sealhulgas lõpukaldkriipsud)
- Mittekanoonilised lehed ei tohiks olla üheski hreflang-komplektis

### 7. Protokolli järjepidevus
- Kõik URL-id hreflang-komplektis peavad kasutama sama protokolli (HTTPS või HTTP)
- Segane HTTP/HTTPS hreflang-komplektides põhjustab valideerimistõrkeid
- Pärast HTTPS-migratsiooni uuenda kõik hreflang-sildid HTTPS-ile

### 8. Domeeniülene tugi
- Hreflang töötab eri domeenide vahel (nt example.com ja example.de)
- Domeeniülene hreflang nõuab tagasiviitavaid silte mõlemal domeenil
- Kasuta jälgimiseks Google Search Console'i kinnitamist või vajadusel saiditeülest saidikaardi esitamist
- Saidikaardipõhine rakendus on soovitatav domeeniüleste seadistuste jaoks

## Levinud vead

| Probleem | Raskusaste | Parandus |
|-------|----------|-----|
| Puuduv iseviitav silt | Kriitiline | Lisa hreflang, mis osutab sama lehe URL-ile |
| Puuduvad tagasiviitavad sildid (A→B, kuid pole B→A) | Kriitiline | Lisa vastavad tagasiviitavad sildid kõigile alternatiividele |
| Puuduv x-default, kui varuvariandi käitumine on nõutav | Keskmine | Lisa x-default, mis osutab varuvariandi/valija lehele |
| Kehtetu keelekood (nt `eng`) | Kõrge | Kasuta ISO 639-1 kahetähelisi koode |
| Kehtetu piirkonnakood (nt `en-uk`) | Kõrge | Kasuta ISO 3166-1 Alpha-2 koode |
| Hreflang mittekanoonilisel URL-il | Kõrge | Liiguta hreflang ainult kanoonilisele URL-ile |
| HTTP/HTTPS mittevastavus URL-ides | Keskmine | Standardiseeri kõik URL-id HTTPS-ile |
| Lõpukaldkriipsu ebajärjepidevus | Keskmine | Vasta täpselt kanoonilise URL-i vormingule |
| Hreflang nii HTML-is kui saidikaardis | Madal | Vali üks meetod (saidikaart eelistatud suurte saitide jaoks) |
| Keel ilma piirkonnata, kui vaja | Madal | Lisa piirkonnamäärang geosihitud sisu jaoks |

## Rakendusmeetodid

### 1. meetod: HTML-link-sildid
Parim: Saidid, kus lehe kohta on <50 keele-/piirkonnavarianti.

```html
<link rel="alternate" hreflang="en-US" href="https://example.com/page" />
<link rel="alternate" hreflang="en-GB" href="https://example.co.uk/page" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
<link rel="alternate" hreflang="x-default" href="https://example.com/page" />
```

Paiguta `<head>` jaotisse. Iga leht peab sisaldama kõiki alternatiive, sealhulgas iseennast.

### 2. meetod: HTTP-päised
Parim: Mitte-HTML-failid (PDF-id, dokumendid).

```
Link: <https://example.com/page>; rel="alternate"; hreflang="en-US",
      <https://example.com/fr/page>; rel="alternate"; hreflang="fr",
      <https://example.com/page>; rel="alternate"; hreflang="x-default"
```

Sea serveri konfiguratsiooni või CDN-reeglite kaudu.

### 3. meetod: XML-saidikaart (soovitatav suurte saitide jaoks)
Parim: Saidid paljude keelevariantidega, domeeniülesed seadistused või 50+ lehte.

Vaata allpool olevat jaotist Hreflang-saidikaardi loomine.

### Meetodite võrdlus
| Meetod | Parim | Plussid | Miinused |
|--------|----------|------|------|
| HTML-link-sildid | Väikesed saidid (<50 varianti) | Lihtne rakendada, lähtekoodis nähtav | Paisutab `<head>`-i, mastaabis raske hooldada |
| HTTP-päised | Mitte-HTML-failid | Töötab PDF-ide, piltide jaoks | Keerukas serveri konfiguratsioon, HTML-is mittenähtav |
| XML-saidikaart | Suured saidid, domeeniülene | Skaleeritav, tsentraliseeritud haldus | Lehel mittenähtav, nõuab saidikaardi hooldust |

## Hreflangi loomine

### Protsess
1. **Tuvasta keeled**: Skaneeri sait keeleindikaatorite osas (URL-tee, alamdomeen, TLD, HTML-i lang-atribuut)
2. **Vastenda lehe ekvivalendid**: Sobita vastavad lehed keelte/piirkondade vahel
3. **Valideeri keelekoodid**: Kontrolli kõik koodid ISO 639-1 ja ISO 3166-1 vastu
4. **Loo sildid**: Loo iga lehe jaoks hreflang-sildid, sealhulgas iseviitav
5. **Kontrolli tagasiviitavad sildid**: Kinnita, et kõik suhted on kahesuunalised
6. **Lisa x-default**: Sea varuvariant iga lehekomplekti jaoks
7. **Väljund**: Loo rakenduskood (HTML, HTTP-päised või saidikaardi XML)

## Hreflang-saidikaardi loomine

### Saidikaart hreflangiga
```xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://example.com/page</loc>
    <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/page" />
    <xhtml:link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
    <xhtml:link rel="alternate" hreflang="de" href="https://example.de/page" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/page" />
  </url>
  <url>
    <loc>https://example.com/fr/page</loc>
    <xhtml:link rel="alternate" hreflang="en-US" href="https://example.com/page" />
    <xhtml:link rel="alternate" hreflang="fr" href="https://example.com/fr/page" />
    <xhtml:link rel="alternate" hreflang="de" href="https://example.de/page" />
    <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/page" />
  </url>
</urlset>
```

Põhireeglid:
- Lisa `xmlns:xhtml` nimeruumi deklaratsioon
- Iga `<url>` kirje peab sisaldama KÕIKI keelealternatiive (sealhulgas iseennast)
- Iga alternatiiv peab ilmuma eraldi `<url>` kirjena oma täieliku komplektiga
- Jaga, kumb enne saabub: 50 000 URL-i või 50 MB pakkimata saidikaardifaili kohta

## Väljund

### Hreflangi valideerimisaruanne

#### Kokkuvõte
- Skaneeritud lehti kokku: XX
- Tuvastatud keelevariante: XX
- Leitud probleeme: XX (kriitilisi: X, kõrgeid: X, keskmisi: X, madalaid: X)

#### Valideerimistulemused
| Keel | URL | Iseviide | Tagasiviited | x-default | Olek |
|----------|-----|----------|-------------|-----------|--------|
| en-US | https://... | ✅ | ✅ | ✅ | ✅ |
| fr | https://... | ❌ | ⚠️ | ✅ | ❌ |
| de | https://... | ✅ | ❌ | ✅ | ❌ |

### Loodud hreflang-sildid
- HTML-i `<link>` sildid (kui valitud HTML-meetod)
- HTTP-päise väärtused (kui valitud päisemeetod)
- `hreflang-sitemap.xml` (kui valitud saidikaardimeetod)

### Soovitused
- Lisatavad puuduvad rakendused
- Parandatavad valed koodid
- Meetodi migratsiooni ettepanekud (nt HTML saidikaardile mastaabi jaoks)

## Kultuurilise kohandamise hindamine

Mitmekeelse saidi analüüsimisel mine tehnilisest hreflang-valideerimisest kaugemale, et hinnata,
kas sisu on iga sihtturu jaoks kultuuriliselt kohandatud.

Laadi `references/cultural-profiles.md` eelnevalt koostatud profiilide jaoks (DACH, prantsuskeelne, hispaania, jaapani).

**Hindamise sammud:**
1. Tuvasta kõik keeleversioonid ja nende sihtturud
2. Laadi asjakohane kultuuriprofiil(id)
3. Kontrolli, et CTA-d vastavad kultuurilistele ootustele (otsene vs kaudne)
4. Kontrolli, et usaldussignaalid on lokaadile sobivad (sertifikaadid, juriidilised lehed)
5. Kontrolli võõraid brändiviiteid lokaliseeritud lehtedel
6. Kontrolli numbri-/kuupäeva-/valuutavormingu järjepidevust
7. Märgista kultuurilise kohandamise probleemid keskmise raskusastmena

**Väljund:** Kultuurilise kohandamise skoor keeleversiooni kohta (0–100) koos konkreetsete leidudega.

## Sisu võrdväärsuse audit

**Käsk:** `/seo hreflang audit <directory-or-url>`

Auditeeri sisu võrdväärsust saidi või kohaliku sisukataloogi kõigi keeleversioonide lõikes.

Laadi `references/content-parity.md` täieliku võrdväärsusmaatriksi ja hindamismetoodika jaoks.

**Mida see kontrollib:**
- Lehe olemasolu kõigis deklareeritud keeltes
- Jaotiste struktuuri võrdväärsus (H2/H3 arv)
- SEO-elementide võrdväärsus (pealkiri, meta, skeemi lokaliseerimine)
- Sõnade arvu suhte valideerimine (DE peaks olema 25–35% pikem kui EN, JA 10–25% lühem)
- Värskuse jälgimine (vananenud tõlked tuvastatud ajatemplite kaudu)
- Kultuurimarkerite skaneerimine (võõrad brändid, valed juriidilised viited, tõlkimata elemendid)

**Väljund:** Võrdväärsusmaatriksi tabel koos lehepõhiste skooride ja prioriseeritud tegevuspunktidega.

## Lokaadivormingu valideerimine

Laadi `references/locale-formats.md` numbri-, kuupäeva-, valuuta-, aadressi- ja telefonivormingu
viitetabelite jaoks lokaadi kaupa.

**Kontrollid:**
- Numbrivormingu järjepidevus (nt „1,000.00“ peaks de-DE lehtedel olema „1.000,00“)
- Kuupäevavorming vastab lokaadi ootustele
- Valuutasümbolid ja paigutus õiged sihtturu jaoks
- Telefoninumbrid kasutavad rahvusvahelist vormingut koos õige riigikoodiga

## Viitefailid

Laadi vajaduspõhiselt (ÄRA laadi kõike käivitamisel):
- `references/cultural-profiles.md`: DACH, prantsuskeelsed, hispaania, jaapani kultuurilise kohandamise profiilid
- `references/locale-formats.md`: Numbri-, kuupäeva-, valuuta-, aadressi-, telefonivormingu tabelid lokaadi kaupa
- `references/content-parity.md`: Sisu võrdväärsuse auditi metoodika ja hindamine

## Vigade käsitlemine

| Stsenaarium | Tegevus |
|----------|--------|
| URL kättesaamatu (DNS-tõrge, ühendusest keeldumine) | Teata veast selgelt. Ära oleta saidi struktuuri. Soovita kasutajal URL üle kontrollida ja uuesti proovida. |
| Hreflang-silte ei leitud | Teata nende puudumisest. Kontrolli muid rahvusvahelistamise signaale (alamkataloogid, alamdomeenid, ccTLD-d) ja soovita sobivat hreflang-rakendusmeetodit. |
| Tuvastatud kehtetud keele-/piirkonnakoodid | Loetle iga kehtetu kood koos õige asendusega. Esita parandatud hreflang-siltide komplekt, mis on valmis rakendamiseks. |
| Kultuuriprofiili pole keele jaoks saadaval | Kasuta cultural-profiles.md vaikeprofiili kontrollnimekirja. Märgi, et hindamine põhineb üldistel juhistel, mitte eelnevalt koostatud profiilil. |
| Sisu võrdväärsuse kataloog tühi | Teata, et sisufaile ei leitud. Soovita kontrollida kataloogiteed või esitada URL elava saidi analüüsiks. |