Yerel işletme için JSON-LD şeması nasıl eklenir?
Yerel işletme için JSON-LD şeması, sayfanın head bölümüne konan ve işletmenin adını, adresini ve telefonunu makineye okutan küçük bir kod bloğudur. Google'a göre yapılandırılmış veri, sayfanın ne hakkında olduğunu tahmin yerine doğrudan söyler. GeoSorgu puan profilinde Yapılandırılmış Veri 5 puan, Marka Sinyalleri 20 puan taşır; eksik adres ve telefon ikisini birden düşürür. Ekleme işi 4 adımdır ve çoğu sitede 1 saat sürer.
Yazar: Ahmet Okan ŞEKER, Elektrik Elektronik Yüksek Mühendisi · Son güncelleme: 21 Ekim 2026 · 6 dakika okuma
JSON-LD nedir ve neden gerekir?
JSON-LD, sayfadaki bilgiyi schema.org sözlüğüyle etiketleyen ve script etiketi içinde duran bir veri biçimidir. İnsan sayfada telefonu görür; bot ise rakam dizisinin telefon mu fatura numarası mı olduğunu bilemez. Etiket bu belirsizliği kaldırır: telephone alanı telefondur, address alanı adrestir. Google'a göre yapılandırılmış veri, yapay zekâ özelliklerinde de aynı işi görür ve sayfanın kim tarafından yayımlandığını gösterir. GeoSorgu her taramada kodu okur; geçerli LocalBusiness ya da Organization bulamazsa Yapılandırılmış Veri kategorisinden 5 puan düşer. Türkiye'de taradığımız KOBİ sitelerinin çoğunda ya hiç kod yoktur ya da yalnızca temanın eklediği boş WebSite kaydı bulunur.
LocalBusiness şemasında hangi alanlar olmalı?
LocalBusiness şemasında olması gereken alanlar name, address, telephone, openingHours, url ve geo alanlarıdır. Örnek alan listesi şöyledir: name işletme adı, telephone +90 ile başlayan numara, openingHours Mo-Fr 09:00-18:00 biçiminde. Adres alanı streetAddress, addressLocality, postalCode ve TR değerli addressCountry satırlarından oluşur. Sektör alt türü daha iyidir: Dentist, Electrician, LegalService ya da Hotel. Google'a göre eksik alan hata değil uyarıdır; ama telefonsuz kayıt yerel soruda aday olmaz. Kayıt sayfadaki görünür bilgiyle birebir aynı olmalıdır.
“Sayfada görünen telefon ve adres, kodda da aynı satırla yazılmalı; yoksa bot hangisine inanacağını bilemez.”
Organization ve WebPage şeması ne ekler?
Organization ve WebPage şeması, işletmenin kimliğini ve sayfanın yazarını birbirine bağlayan iki ek kayıttır. Organization kaydı name, url, logo, founder ve sameAs alanlarını taşır; sameAs içine Google İşletme Profili, LinkedIn ve YouTube adresleri yazılır. founder alanına Person türünde kurucu adı ve jobTitle girilir; hekim ya da avukat sayfasında unvan tam olarak yazılmalıdır. WebPage kaydı ise dateModified, datePublished, author ve publisher alanlarıyla sayfayı kuruma bağlar. dateModified alanı metindeki güncelleme tarihiyle aynı olmalıdır; aksi hâlde Google iki tarihten birini yok sayar. GeoSorgu yazar ve tarih satırını hem metinde hem kodda arar; ikisi örtüşünce İçerik ve Güven kategorisinden 15 puanın tamamı alınır.
FAQPage şeması nasıl yazılır?
FAQPage şeması, sayfadaki soru ve cevap çiftlerini Question ve Answer türleriyle listeleyen kayıttır. Her soru mainEntity dizisinde bir Question olur; name alanına soru, acceptedAnswer içindeki text alanına cevap yazılır. Cevap sayfadaki görünür metinle aynı olmalıdır; gizli cevap Google'a göre kılavuz ihlalidir. Soru sayısı 3–6 arasında tutulur ve her cevap tek paragraf, 20–60 kelime olur. Kayıt yalnızca gerçekten soru-cevap bölümü olan sayfaya konur; her sayfaya kopyalamak işe yaramaz. GeoSorgu'nun kendi sayfalarında bu kayıt bileşen tarafından otomatik üretilir; sonuç sayfasında JSON-LD satırı FAQPage bulununca yeşil döner. Princeton Üniversitesi'nin 2023 tarihli araştırmasına göre doğrudan cevaplar yapay zekâ görünürlüğünü artırır; soru-cevap bölümü bunun en kısa yoludur.
Kod sayfanın neresine konur?
Kodun yeri, sayfanın head bölümü ya da gövdenin sonundaki bir script etiketidir. Etiketin type değeri application/ld+json olur. WordPress'te Yoast ya da Rank Math eklentisi LocalBusiness kaydını ayar ekranından üretir; elle eklemek için tema başlığı ya da Code Snippets eklentisi kullanılır. Wix ve Shopify'da sayfa ayarlarındaki özel kod alanı aynı işi görür. Her sayfaya aynı Organization kaydı, yalnızca ilgili sayfaya FAQPage kaydı konur. Kayıt içinde @context schema.org ve @type alanları zorunludur; @id alanı site adresi artı #org biçiminde yazılırsa diğer kayıtlar ona bağlanır. Değişiklik yayına girdikten sonra sayfa kaynağında script etiketi görünmelidir; önbellek eklentisi varsa önce temizlenir.
Google Rich Results testi ve sık hatalar nelerdir?
Rich Results testi, Google'ın bir sayfadaki yapılandırılmış veriyi okuyup hataları listeleyen ücretsiz aracıdır. Adres girilir, 30 saniye içinde bulunan türler ve uyarılar gelir. En sık 5 hata şunlardır: virgül ya da tırnak eksiği yüzünden geçersiz JSON, sayfadaki telefonla uyuşmayan telephone, boş bırakılan address, 2019'da kalmış dateModified ve her sayfaya kopyalanan aynı FAQPage. İkinci kontrol Search Console'daki Geliştirmeler raporudur; Google'a göre hatalı kayıt zengin sonuç üretmez ama sayfayı cezalandırmaz. GeoSorgu taraması da JSON-LD satırında türü ve eksik alanı yazar. Kendi sitemizde ilk tarama 56 puan verdi; Organization ve WebPage kaydı eklenince 1 iş günü içinde 95'e çıktı.
Sık sorulanlar
JSON-LD eklemek için yazılımcı gerekir mi?
+
Hayır, çoğu sitede yazılımcı gerekmez. WordPress eklentileri kaydı menüden üretir; elle ekleme ise kopyala-yapıştır ile 1 saat sürer.
LocalBusiness yerine Organization kullanabilir miyim?
+
Evet, fiziksel adresi olmayan işletme Organization kullanır. Dükkânı, kliniği ya da atölyesi olan işletme için LocalBusiness alt türü daha çok bilgi taşır.
Şema puanı ne kadar artırır?
+
Yapılandırılmış Veri kategorisi 5 puandır; adres ve telefon alanları Marka Sinyalleri kategorisindeki 20 puanı da etkiler. Hazır kod Başlangıç paketinde sizin bilgilerinizle doldurulmuş gelir.
Kodun çalıştığını nasıl anlarım?
+
Google Rich Results testine sayfa adresini yazın; bulunan türler listelenir. GeoSorgu taraması da JSON-LD satırında aynı türleri gösterir.
Sitenizin JSON-LD kaydını ölçün
Kayıt yok, veri saklanmaz. Sonuç sayfası her bulgunun çözümünü adım adım gösterir.
Kaynaklar
Yazar: Ahmet Okan ŞEKER, Elektrik Elektronik Yüksek Mühendisi (GeoSorgu, Çankaya / Ankara) · Son güncelleme: 21 Ekim 2026 · Yöntem: Nasıl ölçüyoruz