Hreflang: Dil ve Ülke Versiyonları Doğru Şekilde Nasıl Kurulur?

Kısaca: hreflang, Google'a her arama yapan kullanıcıya bir sayfanın hangi dil veya ülke versiyonunu göstereceğini söyler. Her versiyon, kendisi de dahil tüm versiyonları ISO 639-1 dil kodu ve isteğe bağlı ISO 3166-1 alpha-2 bölge koduyla (en, de, en-GB, pt-BR) ve isteğe bağlı bir x-default yedeğiyle listeler. Bağlantılar mutlak olmalı ve çift yönlü verilmelidir; aksi halde Google bunları yok sayar. Her versiyonun kendine işaret eden bir canonical'ı olmalıdır; başka bir dile işaret eden canonical tüm kurguyu iptal eder. Google sayfa dilini içerikten algılar, bu yüzden çevirinin gerçekten yapılmış olması gerekir.

Uluslararası siteler trafiği sessiz bir şekilde kaybeder. İngilizce sayfa Almanya'da sıralanır, Meksika için bir versiyon hazırladığınız halde İspanyolca sayfa Meksika'da görünür ya da İngiltere mağazası Amerikalı kullanıcılara sterlin fiyatlarıyla çıkar. Sitede bozuk bir şey yoktur; Google sadece hangi versiyonu göstereceğini tahmin etmiştir. hreflang, bu tahmini ortadan kaldırmanın yoludur.

Bu rehber, Google'ın dokümantasyonuna göre hreflang'in nasıl çalıştığını, çoğu siteyi yanıltan kod kurallarını, canonical ile etkileşimini, ücretsiz hreflang checker aracımızın neleri test ettiğini ve her sorunun nasıl çözüleceğini anlatır.

hreflang ne yapar, ne yapmaz

hreflang notasyonları, birbirinin versiyonu olan bir sayfa kümesini tanımlar: aynı içeriğin başka bir dildeki hali veya aynı dilin başka bir ülkeye uyarlanmış hali. Google bunları sonuçlarda eşleşen versiyonu göstermek için kullanır.

Yapmadıkları:

• Dil algılamaz. Google, "sayfanın dilini algılamak için hreflang'i veya HTML lang özniteliğini kullanmadığını", görünen içeriğe baktığını söyler (çok bölgeli siteler). İngilizce metin içeren ve de olarak etiketlenmiş bir sayfa, İngilizce bir sayfadır.
• Zayıf çevirileri kopya ya da orijinal haline getirmez. Google, yerelleştirilmiş versiyonların "yalnızca sayfanın ana içeriği çevrilmemişse kopya sayıldığını" söyler. Menüsü çevrilmiş ama gövde metni İngilizce olan bir sayfa kopyadır.
• Kimseyi yönlendirmez. Yalnızca sonuçlarda hangi URL'nin görüneceğini değiştirir. Ziyaretçiler yine de istedikleri versiyonu açabilir.

hreflang eklemenin üç yolu

Google, üç yöntemin "Google açısından eşdeğer" olduğunu söyler. Sayfa başına birini kullanın; karıştırmak yalnızca hata yapılacak yer sayısını artırır.

1. <head> içinde HTML link öğeleri, en yaygın tercih. https://example.com/en/pricing sayfasında:

<link rel="alternate" hreflang="en" href="https://example.com/en/pricing" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise" />
<link rel="alternate" hreflang="fr" href="https://example.com/fr/tarifs" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/pricing" />

Almanca ve Fransızca sayfalar da birebir aynı dört satırı taşır. Google, etiketlerin "düzgün biçimlendirilmiş bir <head> bölümü içinde" olmasını ister; tarayıcının gövdeye taşıdığı bir görsel ya da bağlantıların üstündeki kapatılmamış bir etiket gibi başıboş bir öğe head'i erken bitirebilir.

2. HTTP Link başlıkları, PDF gibi HTML olmayan dosyalar için tek seçenek:

Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
      <https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"

Google, başlığın tüm versiyonlar için aynı olması gerektiğini söyler.

3. XML sitemap, şablon değişikliği gerektirmediği için büyük sitelerde kullanışlıdır:

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <url>
    <loc>https://example.com/en/pricing</loc>
    <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>
    <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise"/>
  </url>
  <url>
    <loc>https://example.com/de/preise</loc>
    <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>
    <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise"/>
  </url>
</urlset>

Her <url>, kendisi de dahil tüm versiyonları listeler.

Google'ın uyguladığı kurallar

Karşılıklı bağlantılar ve kendine referans

"İki sayfa birbirine işaret etmiyorsa etiketler yok sayılır." Bozuk kurulumların çoğunun ardındaki kural budur. İngilizce sayfa Almanca sayfayı listeliyor ama Almanca sayfa İngilizceyi listelemiyorsa, Google çifti çöpe atar. Google ayrıca "her dil versiyonunun kendisini de listelemesi gerektiğini" söyler.

Dil ve bölge kodları

"Yalnızca ISO 639-1'de listelenen dil kodları ve ISO 3166-1 Alpha 2'de listelenen bölge kodları desteklenir." Önce dil gelir; bölge isteğe bağlıdır. Google ayrıca birden fazla alfabeyle yazılan diller için zh-Hant ve zh-Hans gibi alfabe alt etiketlerini ve zh-Hans-US gibi kombinasyonları destekler.

Latin Amerika genelinde İspanyolca için ya tek bir ortak İspanyolca versiyon için es kullanın ya da hedeflediğiniz ülkeleri (es-MX, es-AR, es-CO) aynı URL'ye işaret edecek şekilde listeleyin.

x-default

"Ayrılmış x-default değeri, hiçbir dil/bölge kullanıcının tarayıcı ayarıyla eşleşmediğinde kullanılır." Bunu bir dil seçici sayfaya veya ana uluslararası versiyonunuza yönlendirin. İsteğe bağlıdır ama faydalıdır: olmazsa, sunmadığınız bir dilde arama yapan kullanıcı Google'ın seçtiği versiyonu görür.

Mutlak URL'ler

"Alternatif URL'ler, protokol dahil tam nitelikli olmalıdır." https://example.com/de/ çalışır; /de/ ve //example.com/de/ çalışmaz.

hreflang ve canonical etiketleri

İkisi uyumlu olmalıdır. Her versiyonun canonical'ı İngilizce ya da ana versiyona değil, kendisine işaret etmelidir. Google'ın canonicalization rehberi, "aynı dilde bir canonical sayfa belirtmenizi" ya da "aynı dilde canonical sayfa yoksa mümkün olan en iyi alternatif dili" belirtmenizi söyler ve hreflang kümelerinin canonical seçimini etkilediğini, karşılıklı bağlantı veren URL'leri tercih ettiğini not eder.

Klasik hata: her dil versiyonunun <link rel="canonical" href="https://example.com/en/..."> taşıması. Bu, Google'a diğer versiyonların İngilizce sayfanın kopyası olduğunu söyler ve bunlar hreflang notasyonlarıyla birlikte dizinden düşer.

Kaçınılması gereken iki çakışma daha: yönlendirme yapan hreflang URL'leri (son URL'yi listeleyin) ve noindex taşıyan hreflang URL'leri (Google'ın dizinleyemediği bir versiyon gösterilemez).

Site yapısı ve otomatik yönlendirmeler

Google'ın çok bölgeli rehberi URL yapılarını karşılaştırır:

Hangisini seçerseniz seçin, ziyaretçileri IP'ye veya tarayıcı diline göre otomatik yönlendirmeyin. Google, bunun "kullanıcıların (ve arama motorlarının) sitenizin tüm versiyonlarını görmesini engelleyebileceğini" ve Googlebot'un "genellikle ABD'den geldiğini" söyler. Bunun yerine bir öneri banner'ı gösterin ve arama sonuçlarını hreflang'e bırakın.

Searvia hreflang checker nasıl çalışır

hreflang checker, website SEO checker aracımızla aynı motoru kullanır: bir alan adı veya sayfa adresi girersiniz, araç o sayfayı (yalnızca alan adı girerseniz ana sayfanızı) ve çevresindeki site dosyalarını yaklaşık 20 saniyede 38 kontrolle denetler ve bu aracın konusu olan üç kontrolü en başa koyar. Test ettikleri tam olarak şunlardır.

Dil versiyonları, hreflang (düşük öncelik). Checker, yönlendirmeleri takip edip son adrese ulaştıktan sonra o sayfanın HTML'indeki her <link rel="alternate" hreflang="..." href="..."> öğesini okur.

• Hiç yoksa sonuç bilgilendiricidir: "No language versions are declared (fine for a single-language site)." Notunuzu etkilemez.
• Her kod, Google'ın desteklediği kodlara göre kontrol edilir: x-default veya iki harfli bir ISO 639-1 dili; ardından isteğe bağlı dört harfli bir alfabe (zh-Hant) ve iki harfli bir ISO 3166-1 alpha-2 ülkesi (pt-BR, en-GB). en-UK gibi yaygın bir hata düzeltmesiyle işaretlenir (→ en-GB); es-419, üç harfli diller ve Google'ın kabul etmediği diğer kodlar geçersiz olarak işaretlenir. Rapordaki her satır kodu, URL'sini, bir onay ya da çarpı işaretini ve bu notu gösterir. En fazla 20 satır gösterilir.
• Kendine referansı kontrol eder: listelenen URL'lerden biri sayfanın kendisi olmalıdır. Karşılaştırma http ile https farkını, baştaki www. ifadesini, sorgu dizelerini ve sondaki eğik çizgiyi yok sayar.
• Her kod geçerliyse ve sayfa kendini listeliyorsa başarılı; x-default yoksa mesaj bu isteğe bağlı yedeğin eksik olduğunu ekler. Aksi halde "The language versions do not include this page itself" veya "Some language codes are not valid" ile uyarı verilir.

Sayfa dili (düşük öncelik). <html> öğesinde lang özniteliği varsa geçer ve dilini gösterir; yoksa uyarır.

Canonical URL (orta öncelik). Canonical etiketi sayfanın kendisine işaret ediyorsa geçer; eksikse veya başka bir adrese işaret ediyorsa uyarır ve o adresi gösterir.

Neleri test etmez

• Karşılıklı bağlantılar. Checker tek bir sayfayı okur ve diğer versiyonları çekmez; bu yüzden onların geri bağlantı verdiğini doğrulayamaz. Karşılıklılığı kontrol etmek için her versiyonun kaynağını açın veya bir site tarayıcısı kullanın.
• HTTP başlıkları ve sitemap'ler. Yalnızca HTML <link> öğeleri okunur. hreflang'i sitemap içinde tanımlıyorsanız, checker hiç versiyon bildirmez.
• Mutlak URL'ler ve tekrarlar. Göreli URL'ler işaretlenmez, çözümlenir; aynı kod iki kez geçerse yalnızca biri tutulur.
• Diğer sayfalar. Her çalıştırmada tek sayfa kontrol edilir. Kontrol etmek istediğiniz her versiyonun adresini girin (example.com/de/pricing, de.example.com) veya tüm site için bir tarayıcı kullanın.

Sonucu okumak

A+ ile F arasındaki genel not, öncelikle ağırlıklandırılmış (yüksek 10, orta 5, düşük 2; uyarılar yarım puan alır) 38 kontrolün tamamını kapsar ve "Fix these first" listesi ile paylaşılabilir bir rapor içerir.

Her hreflang sorunu nasıl çözülür

1. Dil versiyonları tanımlanmamış, ama var

1. Sayfanın her versiyonunu ve tam URL'sini listeleyin, örneğin /en/, /de/, /fr/.
2. Bir yöntem seçin: çoğu site için HTML etiketleri, şablonları değiştirmek zorsa sitemap.
3. Etiketleri kodunuzda veya CMS'inizde tek bir kaynaktan üretin; böylece her versiyon aynı eksiksiz kümeyi verir. Elle yazılan etiketler zamanla birbirinden ayrışır.
4. Çok dilli bir eklenti ya da platformunuzun yerleşik pazarlar özelliğini kullanıyorsanız, hreflang'i genellikle o üretir; her çevirinin orijinaline bağlı ve yayınlanmış olduğunu kontrol edin, çünkü bağlanmamış çevirilere etiket eklenmez.
5. hreflang checker aracını yeniden çalıştırın.

2. Dil versiyonları bu sayfanın kendisini içermiyor

Mevcut sayfa için kendi koduyla bir satır ekleyin. Bir şablonda bu genellikle diller üzerindeki döngünün geçerli dili atlaması anlamına gelir; bu koşulu kaldırın. Kendi URL'sinin canonical URL ile, yani aynı protokol, host ve sondaki eğik çizgi kuralıyla aynı olduğundan emin olun.

3. Bazı dil kodları geçerli değil

1. Raporda çarpı işareti olan satırları bulun.
2. Biçimi düzeltin: alt çizgi değil kısa çizgi, önce dil sonra bölge (GB-en değil en-GB).
3. Desteklenmeyen kodları değiştirin: en-UK en-GB olur (rapor bunu önerir), es-419 es veya bir ülke kodu listesi olur, üç harfli kodlar iki harfliye dönüşür.
4. Kodun kastettiğiniz dil olduğunu kontrol edin: be Belarusçadır, cz bir dil kodu değildir (Çekçe cs'tir), jp bir dil kodu değildir (Japonca ja'dır), dk de değildir (Danca da'dır).

4. Sayfa dilini bildirmiyor

Dili kök öğeye ekleyin, örneğin <html lang="en"> veya <html lang="pt-BR">. Google bunu dil algılamak için kullanmaz, ancak MDN'in anlattığı gibi tarayıcılar, çeviri araçları ve ekran okuyucular kullanır.

5. Canonical başka bir adrese işaret ediyor

Çok dilli bir sitede bu çoğunlukla diller arası canonical sorunudur. Her versiyonun canonical'ını kendi URL'sine çevirin. Canonical aynı sayfaya başka bir biçimde işaret ediyorsa (https yerine http ya da www olmadan), nihai adresinizle birebir eşleşmesini sağlayın.

6. Karşılıklı bağlantılar eksik (checker tarafından test edilmez)

İki versiyonu yan yana açıp hreflang listelerini karşılaştırın: kümeler aynı olmalıdır. Farklıysa neden neredeyse her zaman onları üreten şablon veya eklentidir; üreticiyi bir kez düzeltmek her sayfayı düzeltir.

Uygulamalı örnek (varsayımsal)

Aşağıdaki varsayımsal bir örnektir, gerçek veri değildir. Kestrel Gear, uydurma bir outdoor markası, example.com adresinde İngilizce yayın yapıyor ve /de/, /fr/ ve /es/ versiyonları var. Alman kullanıcılar sürekli İngilizce sayfalara düşüyor. hreflang checker şunu raporluyor:

Canonical: "The canonical URL points to the page itself." Sayfa dili: en.

es_ES üzerindeki çarpı bir biçim hatasıdır. en-UK üzerindeki çarpı "→ en-GB" notuyla gelir: Google bölge olarak UK'yi kabul etmez, bu yüzden İngilizce sayfanın kullanılabilir bir notasyonu yoktu. Almanca sayfanın kaynağına bakınca üçüncü bir sorun çıkıyor: canonical'ı İngilizce ana sayfaya işaret ediyor, bu yüzden Google /de/ sayfasını kopya saymış. Çözümler:

1. Kodlar en, de, fr, es olarak değiştirildi (dil başına bir versiyon, bölgeye gerek yok) ve İngilizce ana sayfaya işaret eden x-default eklendi.
2. hreflang çıktısı tek bir ortak şablona taşındı; böylece her versiyon kendisi de dahil aynı kümeyi basıyor.
3. Her versiyona kendine işaret eden bir canonical verildi.
4. Almanya'dan gelen ziyaretçileri otomatik olarak /de/ sayfasına gönderen IP tabanlı yönlendirme kaldırıldı ve yerine bir öneri banner'ı konuldu.

20 dakikalık hreflang kontrol listesi

1. Ücretsiz hreflang checker aracını ana sayfanızda ve her dil versiyonunda çalıştırın.
2. Her kodu ISO 639-1 ve ISO 3166-1 alpha-2 ile karşılaştırın.
3. Her versiyonun kendisini ve diğer tüm versiyonları listelediğini doğrulayın.
4. İki versiyonu açıp kümelerin aynı olduğunu doğrulayın.
5. Her versiyonun canonical'ının kendisine işaret ettiğini kontrol edin.
6. x-default ekleyin (isteğe bağlı ama faydalı).
7. Hiçbir otomatik yönlendirmenin versiyonları Googlebot'tan gizlemediğinden emin olun.

Searvia nasıl yardımcı olur

Ücretsiz hreflang checker, girdiğiniz sayfanın hreflang bağlantılarını, sayfa dilini ve canonical'ını, website SEO checker aracının diğer kontrolleriyle birlikte tek bir paylaşılabilir raporda doğrular. Searvia hesabında Search Console bağlayarak her dil versiyonu için ülkeye göre tıklamaları ve konumları görebilir, site audit aracını her hafta çalıştırarak başka yere işaret eden canonical'ları, dil versiyonları arasındaki yinelenen başlıkları ve bozuk sayfaları yakalayabilirsiniz. Web sitelerinin yanı sıra uygulama da yayınlıyorsanız, App Store yerelleştirme rehberimiz aynı sorunu mağaza tarafında ele alır. Teknik kontrol listesinin tamamı için teknik SEO denetimi rehberine bakın.