İçeriğe Geç

JSON-LD Nedir?

JSON-LD, bağlantılı veriyi JSON biçiminde yazmaya yarayan W3C standardıdır; web sayfalarında yapılandırılmış veri çoğunlukla bu biçimde, sayfa metninden ayrı bir script etiketi içinde eklenir.

Diğer Adları: JSON for Linked Data

JSON-LD Nasıl Yazılır?

JSON-LD kaydı, type değeri application/ld+json olan bir script etiketi içinde sayfanın head ya da body bölümüne eklenir. Kayıt sıradan bir JSON nesnesidir; birkaç ayrılmış anahtar ona anlam katar. @context kayıttaki terimlerin hangi sözlüğe ait olduğunu söyler; web sayfalarında bu çoğunlukla Schema.org’dur. @type nesnenin türünü (Service, Article, Organization gibi) belirtir. @id nesneye bir kimlik verir; aynı sayfadaki başka bir kayıt o nesneye bu kimlikle başvurabilir. Öbür alanlar nesnenin özellikleridir.

Örnek: Bir hizmet sayfasının JSON-LD kaydında @type değeri Service’tir; provider alanı sitenin kurumsal kaydına @id ile başvurur, areaServed alanında hizmet verilen il yazılır. Kayıt ziyaretçiye görünmez, ama anlattığı hizmet, sağlayıcı ve il sayfa metninde de yer alır.

JSON-LD ile Microdata ve RDFa Arasındaki Fark

Google Arama yapılandırılmış veri için JSON-LD, Microdata ve RDFa biçimlerini destekler; geçerli ve doğru uygulandıklarında üçü de Google için eşdeğerdir. Microdata ve RDFa, işaretlemeyi görünen içeriğin HTML öğelerine nitelik olarak ekler. JSON-LD ise görünen metinle iç içe geçmez; bu yüzden bir etkinliğin mekânının adresi gibi iç içe nesneleri yazmak daha kolaydır. Google, büyük ölçekte uygulaması ve bakımı en kolay biçim olduğu için mümkün olduğunda JSON-LD’yi önerir. JavaScript ya da içerik yönetim sistemi bileşenleriyle sayfaya sonradan eklenen JSON-LD de okunabilir.

JSON-LD Kullanırken Dikkat Edilecekler

Biçim yalnızca bir yazım yoludur; yapılandırılmış veri kuralları her biçimde aynıdır. Kayıt, ait olduğu sayfanın görünen içeriğini anlatır. Yalnızca yapılandırılmış veri taşımak için boş sayfa açılmaz; ziyaretçinin göremediği bilgi, doğru olsa bile işaretlenmez. Şablondan üretilen kayıtlar yayından sonra bozulabileceği için geliştirme sırasında Zengin Sonuç Testi, yayından sonra Search Console’daki zengin sonuç durum raporları izlenir. Google’a göre daha az sayıda ama eksiksiz ve doğru önerilen özellik vermek, bütün önerilen özellikleri eksik ya da hatalı doldurmaktan daha önemlidir.

JSON-LD Hakkında Sık Sorulan Sorular

JSON-LD kaydında @context, @type ve @id ne işe yarar?

@context, kayıttaki terimlerin ait olduğu sözlüğü gösterir ve web sayfalarında çoğunlukla Schema.org olur. @type nesnenin türünü, örneğin Service, Article ya da Organization olduğunu belirtir. @id ise nesneye bir kimlik verir; sayfadaki başka bir kayıt o nesneye bu kimlikle başvurabilir.

Google hangi yapılandırılmış veri biçimini öneriyor?

Google JSON-LD, Microdata ve RDFa biçimlerini destekler ve mümkün olduğunda JSON-LD’yi önerir; çünkü büyük ölçekte uygulaması ve bakımı daha kolaydır.

JSON-LD JavaScript ile eklenebilir mi?

Evet. Google, JavaScript kodu ya da içerik yönetim sistemindeki bileşenlerle sayfaya sonradan eklenen JSON-LD verisini okuyabilir.