Her sürüm aynı bağlantı grubunu taşımalı
Hreflang etiketi, aynı içeriğin dil veya bölge sürümlerini birbirine bağlar. Türkçe ürün sayfasının İngilizce eşini göstermek yeterli değildir: İngilizce sayfada da Türkçe sürüme dönüş bağlantısı bulunmalıdır. Her sayfa grubun içinde kendi adresini de listeler. Bu oluşturucu, girilen tüm sürümler için tek ve aynı HTML bağlantı grubunu hazırlar.
Google’ın yerelleştirilmiş sayfa rehberi, kendine referansı, karşılıklı bağlantıları ve tam URL kullanımını açıklar. Kod, her sürümün <head> bölümüne eklenmelidir. Araç bağlantıları siteye yerleştirmez; yalnız uygulanacak kodu ve adres listesini üretir.
Hreflang examples: Ürün sayfası için bir grup
Aşağıdaki adresler açıklama için hazırlanmıştır. Kendi sitenizde gerçekten var olan, aynı ürünü anlatan karşılıkları kullanın. Başka bir ürünün veya genel kategori sayfasının URL’sini boşluğu doldurmak için eklemeyin.
| Kod | URL | Görevi |
|---|---|---|
| tr | https://example.com/tr/urun/ | Türkçe ürün sürümü |
| en-GB | https://example.com/en/product/ | Birleşik Krallık için İngilizce sürüm |
| x-default | https://example.com/choose-product/ | Eşleşmeyen kullanıcılar için seçim sayfası |
Bu üç satır araçta üç etiket verir. Türkçe sayfaya ekleyeceğiniz koddan tr satırını çıkarmayın; o satır sayfanın kendisine referansıdır. İngilizce sürüme ve seçim sayfasına da aynı üç satır uygulanır.
<link rel="alternate" hreflang="tr" href="https://example.com/tr/urun/">
<link rel="alternate" hreflang="en-GB" href="https://example.com/en/product/">
<link rel="alternate" hreflang="x-default" href="https://example.com/choose-product/">Sonuçtaki Kopyala düğmesi yalnız bu HTML kodunu alır. HTML kodunu indir seçeneği aynı kodu hreflang.html dosyasına yazar. Her ikisinde de adresler girdinizden gelir; araç yeni çeviri URL’si tahmin etmez.
Dil, bölge ve yazı sistemini ayırın
Dil kodu iki harflidir; ardından isteğe bağlı yazı sistemi ve ülke/bölge gelebilir. Dil kodları ISO 639 listesinin iki harfli sütunuyla, yazı sistemi kodları ISO 15924 listesiyle karşılaştırılır. Kodun biçimi doğru görünse bile kayıtlı değilse araç kabul etmez.
| Girdi | Aracın yorumu |
|---|---|
| tr | Bölge sınırlaması olmayan Türkçe |
| tr-TR | Türkiye için Türkçe |
| EN-gb | en-GB olarak düzenlenir |
| zh-Hant | Geleneksel Çince yazı sistemi |
| zh-Hans-US | ABD için basitleştirilmiş Çince yazı sistemi |
| en-UK | Reddedilir; atanmış bölge kodu GB kullanılmalıdır |
| zz veya en-Abcd | Kayıtlı kod koşulunu sağlamadığı için reddedilir |
Ülke/bölge kodu dilin yerine geçmez. Örneğin be Belarusça dilidir; Belçika hedefi için uygun dilin arkasına BE eklenir. Araç büyük-küçük harfi standart biçime getirir, fakat alt çizgiyi tireye veya yanlış ülke kodunu doğru olabileceğini düşündüğü başka bir koda sessizce çevirmez. en-US ve EN-us aynı kod sayılır; ikisini ayrı satırlara koyamazsınız.
x-default dil kodu olmayan özel bir değerdir. Dil veya bölge eşleşmesi bulunmadığında kullanılacak adresi belirtir; grubun zorunlu bir üyesi değildir. Eklemek isterseniz dil alanına yalnız x-default yazın. x-default-TR gibi bir ek kabul edilmez.
URL alanı neyi kontrol eder?
Her adres https:// veya http:// ile başlamalıdır. /en/product/ gibi göreli yollar kabul edilmez. Adreste kullanıcı adı/şifre, # parçası, boşluk veya ters eğik çizgi bulunamaz; uzunluk en fazla 2.048 karakterdir. Sorgu parametreleri kullanılabilir. Örneğin adresin içindeki & işareti HTML kodunda & olarak kaçırılır; bu, sorgu parametresini silmez.
Form 2 ile 30 satır içindir. Boş bir satır eklerseniz eski çıktı kapanır; o satır tamamlanıncaya veya kaldırılıncaya kadar eksik grup kopyalanmaz. Geçersiz kod ya da URL varsa ilgili alan hata gösterir. Girdiyi değiştirmek önceki indirme bağlantısını temizler. Sıfırla, formu yeniden iki boş satıra döndürür.
Kodu üretmek, yayını doğrulamak değildir
Bu araç adreslerin açılıp açılmadığını, yönlendirme durumunu, sayfa dilini veya mevcut etiketleri sorgulamaz. Üretilen grubu yayına aldıktan sonra listedeki her sayfanın kaynak kodunda tamamının bulunduğunu ayrıca kontrol edin. Eksik kendine referans veya dönüş bağlantısı, bu oluşturucudan önce ya da sonra yapılan site uygulamasında da ortaya çıkabilir.
Canonical ayarını hreflang koduyla karıştırmayın. Google’ın canonical rehberi, hreflang kullanılan sayfada mümkünse aynı dilde bir canonical seçilmesini belirtir. Oluşturucu sizin yerinize tercih edilen URL’yi seçmez; hreflang eklenmesi de Google’ın her etiketi kabul edeceği veya sıralamanın yükseleceği garantisi değildir.
Sık sorulan sorular
Hreflang ile canonical aynı etikette birleştirilir mi?
Hayır. Canonical benzer veya yinelenen sayfalarda tercih edilen URL’yi, hreflang ise dil ve bölge alternatiflerini belirtir. Google canonical bağlantısına hreflang eklenmesini canonical sinyali olarak kullanmaz. Bu araç yalnız rel="alternate" hreflang bağlantıları üretir; canonical seçmez veya mevcut canonical kodunuzu değiştirmez.
Aynı URL’ye hem en hem en-US atayabilir miyim?
Evet, aynı sayfa hem genel İngilizce hem ABD hedefi için gerçekten kullanılacaksa farklı kodlar aynı URL’yi gösterebilir. Araç URL tekrarını yasaklamaz; aynı hreflang kodunu ikinci kez kullanmanızı engeller. Sonuçta uygulanacak farklı URL sayısını ayrıca gösterir.
Üç harfli dil veya es-419 kodum neden kabul edilmiyor?
Bu araç Google’ın belirttiği iki harfli ISO 639-1 dil ve atanmış iki harfli ISO 3166-1 bölge kapsamını kullanır. Genel BCP 47 dil etiketi kuralları daha geniştir; orada geçerli olmak Google hreflang kapsamına girmekle aynı şey değildir. Özel kullanım ve desteklenmeyen ek varyantlar burada üretilmez.
PDF veya XML sitemap için de çıktı verir mi?
Bu sürüm HTML head bölümüne eklenecek link etiketlerini üretir. PDF yanıt başlığı veya XML sitemap çıktısı hazırlamaz. İndirilen hreflang.html dosyası bir kod parçasıdır; siteye yüklemek tek başına etiketleri mevcut sayfalara uygulamaz.