Screpy Yapılandırılmış Veri Kontrolü, herkese açık bir sayfadan veya yapıştırılan koddan JSON-LD’yi inceler. Ayrıştırma hatalarını bulur, tanımlanan varlıkları listeler ve desteklenen beş şema türünün seçili özelliklerindeki sorunları işaretler. Raporu, neyin düzeltilmesi ve neyin daha kapsamlı kontrol edilmesi gerektiğini belirlemek için kullanın. Geçerli sözdizimi, desteklenen kontroller ve Google zengin sonuç uygunluğu ayrı konulardır; buradaki yeşil durum üçünü birden doğrulamaz.
Sayfa URL’si veya yapıştırılmış JSON-LD seçin
Yayımlanmış bir sayfayı incelemek için Sayfa URL’si seçin. Bu, ürün ayrıntı sayfası veya işletmenin iletişim sayfası olabilir. Otomatik olarak ana sayfayı kullanmak yerine ilgili sayfanın herkese açık HTTP veya HTTPS adresini girin: farklı şablonlar farklı işaretlemeler içerebilir. URL modu, sayfanın döndürdüğü HTML’yi okur. Özel veya şifre korumalı bir sayfa aynı herkese açık kanıtı sunamaz; sayfanın alınamaması yapılandırılmış verinin bozuk olduğunu kanıtlamaz.
Bir taslağı, çıkarılmış betiği veya elinizdeki HTML’yi incelemek için Kod yapıştır seçin. Çevresinde <script> öğesi bulunmayan JSON’un kendisi için JSON-LD biçimini seçin. Girdiniz <script type="application/ld+json"> blokları içeriyorsa HTML seçin. Tek başına bir JSON dosyasının adresi HTML sayfası değildir; dosyanın içeriğini JSON-LD modunda yapıştırın. Yapıştırılan girdi UTF-8 baytlarıyla ölçülen 256 KiB ile sınırlıdır; izin verilen karakter sayısı metne göre değişir.
URL kontrolleri JavaScript çalıştırmaz. Sayfa yüklendikten sonra eklenen işaretleme alınan kaynakta bulunmayabilir. Google dinamik olarak eklenen JSON-LD’yi işleyebilir; bu yüzden raporda blok bulunmaması Google’ın da hiçbir şey görmediğini kanıtlamaz. Bu ayrım önemliyse ilgili işlenmiş işaretlemeyi inceleyin veya Google’ın özellik testini kullanın. Kod yapıştırmak sağladığınız içeriği kontrol eder; canlı sayfanın ne sunduğunu doğrulamaz.
Yapılandırılmış veri raporunu okuyun
Önce kapsamı, ardından bulguları ve varlık tablosunu okuyun. JSON-LD blokları, HTML’de tespit edilen betikleri sayar; yapıştırılan JSON-LD tek blok olarak değerlendirilir. Varlıklar, JSON’u başarıyla ayrıştırılan ve sonuçta tutulan tür tanımlı nesneleri sayar; bir betik birden fazla varlık içerebilir. Sözdizimi hataları, işlenen ancak ayrıştırılamayan blokların sayısıdır. Bunlar farklı ölçülerdir; üç blok içeren sayfanın üç varlığı olması gerekmez. Kısmi rapordaki tespit edilen blok sayısı bütün blokların incelendiğini kanıtlamaz.
Her satır Sözdizimi ile Kapsam bilgisini ayırır. Yeşil geçerli sözdizimi, JSON ayrıştırıcısının bloğu kabul ettiğini gösterir. Yeşil desteklenen kontroller, varlığın bu aracın seçili özellik kontrollerine uygun olduğunu gösterir. Bulgularını da okuyun: bu etiketlerin hiçbiri bütün özelliklerin doğru olduğunu doğrulamaz. Kırmızı ayrıştırma hatalarını veya hata bulgularını, sarı uyarıları ve kısmi kapsamı, gri ise desteklenmeyen veya kullanılamayan kanıtı belirtir. Rengin yanında yazılı durumu da değerlendirin.
Yol sütunu iç içe nesneleri bulmanıza yardımcı olur. Örneğin $.author, kökün içindeki yazar nesnesini; $.@graph[1] ise @graph dizisinin ikinci nesnesini gösterir. Yollar kendi JSON-LD bloklarına göredir; aynı yol birden fazla betikte bulunabilir. İndirilen JSON bunları ayırmak için blok numaralarını içerir.
Ad sütunu her türün gösterim özelliğini değil, name değerini okur. Bu nedenle geçerli headline içeren bir Article satırının Ad hücresi boş olabilir. Bu boşluğu içerik hatası saymadan önce ilgili özelliği ve bulguyu inceleyin.
Özellik uyarılarından önce JSON sözdizimini düzeltin
Geçersiz blok güvenilir varlık bulguları sağlayamaz. Önce JSON’u düzeltin; ardından eksik özellik uyarılarını yorumlamadan önce kontrolü yeniden çalıştırın. Yaygın nedenler, ad veya metinlerin tek tırnakla yazılması, son özellikten sonra fazladan virgül bulunması, kapanış parantezinin eksik olması ve metin içindeki tırnak işaretinin kaçış karakteriyle yazılmamasıdır. JSON çift tırnaklı metinler ve üyeler arasında virgül kullanır; RFC 8259 sözdizimini tanımlar.
Bu kurgusal Organization, Kod yapıştır → JSON-LD için en küçük sözdizimi örneklerinden biridir:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Example Studio",
"url": "https://example.com/"
}
Örnek, bu aracın Organization için aradığı iki özelliği sağlar. Herhangi bir Google arama özelliği için eksiksiz şablon değildir. Yayımlamadan önce kurgusal değerleri sayfanın gerçek bilgileriyle değiştirin ve ilgili özelliğin gerekliliklerini inceleyin.
Geçerli JSON tek başına kullanılabilir yapılandırılmış veri anlamına gelmez. Tek bir metin veya sayı geçerli JSON olabilir ancak beklenen varlığı tanımlayamaz; araç kökte nesne veya dizi gerektiğini bildirir. Benzer şekilde @type tanımlanmayan ayrıştırılmış bir nesne, varlık satırı üretmeyebilir. Yalnızca raporu temizlemek için özellik eklemeden önce gerçek yapıyı kontrol edin.
Hangi şema özellikleri kontrol edilir?
Yapılandırılmış Veri Kontrolü, bağlamları tanındığında beş türü birebir eşleştirerek seçili kontroller uygular. Tabloyu Schema.org özelliklerinin veya Google’ın zorunlu alanlarının tam listesi olarak değil, bir bulguyu anlamak için kullanın.
| Tanımlanan tür | Bu aracın inceledikleri | Bulgu nasıl değerlendirilir? |
|---|---|---|
Organization |
name ve url varlığı |
Gerçek kuruluşu ve doğru web sitesini tanımladıklarını kontrol edin. |
LocalBusiness |
name ve address varlığı |
Gerçek işletme kimliğini ve adresini inceleyin; adres bileşenleri tamamen doğrulanmaz. |
Article |
headline, author, datePublished ve image varlığı |
Değerleri makaleyle karşılaştırın; biçimleri ayrıca inceleyin. |
Product |
name varlığı; offers, review veya aggregateRating değerlerinden birinin sağlanıp sağlanmadığı |
Yalnızca doğru ve ilgili ürün verilerini kullanın. Uyarıyı kaldırmak için teklif veya yorum uydurmayın. |
BreadcrumbList |
Boş olmayan itemListElement dizisi; incelenen her öğenin pozitif tam sayı position ve boş olmayan metin name değeri |
Belirtilen öğeyi düzeltin; ardından bütün gezinme yolunu ve hedef URL’leri ayrıca kontrol edin. |
Bunların çoğu varlık kontrolleridir. Bir değer mevcutken URL’si, tarihi, görseli, nesne yapısı veya gerçek içeriği yanlış olabilir. Boş nesne bir varlık kontrolünü karşılayabilir; yalnızca boşluk içeren değerler her kontrolde reddedilmez. Dolayısıyla desteklenen durum, adresin, yazarın veya teklifin eksiksiz olduğunu doğrulamaz.
Breadcrumb kontrolleri seçili öğe değerlerini de inceler ancak konumların ardışık veya benzersiz olduğunu, item URL’lerinin doğruluğunu ya da ListItem anlamının tamamını doğrulamaz. Rapor varlık başına en fazla 100 özellik bulgusu tutar. Uzun bir gezinme yolu veya çok sayıda tekrarlanan kusuru olan varlık, bu bulgulardan sonra ek inceleme gerektirebilir.
Bulguyu sayfanın bağlamında düzeltin. Makalenin yazarı bir kişiyse iç içe Person bu aracın kapsamı dışında görünse bile doğru yazar yapısını koruyun. Sırf yeşil etiket almak için doğru işaretlemeyi değiştirmek, asıl sorunu çözmek yerine gizleyebilir.
Geçerli işaretleme neden desteklenmeyen veya kısmi görünüyor?
Desteklenmeyen, aracın o varlığa seçili özellik kontrollerini uygulamadığı anlamına gelir. Schema.org’un türü yasakladığı anlamına gelmez. Örneğin desteklenen Article, iç içe Person yazarı içerebilir. Article seçili kontrollerden geçerken Person desteklenmeyen görünür ve kapsam kısmi olur. Restaurant da daha özel bir işletme türü olmasına rağmen birebir desteklenen beş türün dışındadır. Konuyu doğru tanımlayan türü koruyun ve kalan kontroller için daha kapsamlı bir doğrulayıcı kullanın.
Bağlam da aynı ayrımı oluşturabilir. Araç, sondaki eğik çizgiyle veya çizgi olmadan düz http://schema.org ya da https://schema.org bağlamını tanır; üst nesneden miras alınan bağlam da buna dahildir. Nesne veya dizi bağlamlarını çözümlemez. Bu biçimler W3C JSON-LD bağlam tanımına göre geçerli olabilir. Bir varlık birden fazla tür tanımladığında özellik kontrollerinin çalışması için hepsinin desteklenen kümede bulunması gerekir.
Kapsamın işlem sınırları da vardır. Araç ilk 50 JSON-LD bloğunu değerlendirir; geçersiz blok satırları dahil en fazla 500 sonuç satırı tutar. 32 iç içe seviyenin veya blok başına 10.000 ziyaret edilen değerin ötesinde dolaşmayı durdurur. Bu sınırlar sonraki varlıkları kontrol dışında bırakabilir. HTML’de Microdata veya RDFa tespiti de raporu kısmi yapar; bu biçimler burada doğrulanmaz.
Büyük yapıştırılmış girdileri tam JSON-LD blokları halinde ayrı ayrı kontrol edin; nesneyi ortasından kesip yeni bir sözdizimi hatası oluşturmayın. Asıl kaynağı saklayın ve her raporun hangi bölümleri kapsadığını belirtin. Bu kontroller otomatik olarak eksiksiz bir sayfa denetiminde birleştirilmez.
İşaretlemeyi düzelttikten sonra sayfayı doğrulayın
Önce işaretlemeyi ziyaretçinin sayfada okuyabildikleriyle karşılaştırın. Kimlikleri, tarihleri, adresleri, ürün ayrıntılarını ve varsa yorumları gerçek içerikle kontrol edin. Google’ın yapılandırılmış veri yönergeleri, ilgili ve doğru bilgileri ve geçerli özellik gerekliliklerini ister; ayrıştırıcı bu bilgilerin gerçekliğini doğrulayamaz. Özellik uyarısını gidermek için uydurma ayrıntı eklemeyin.
Sonraki kontrolü yanıtlanmamış soruya göre seçin. Microdata ve RDFa dahil daha kapsamlı Schema.org işaretleme incelemesi için Schema.org İşaretleme Doğrulayıcısı kullanın. Onun da sınırları vardır: diğer bağlam URL’lerini almaz veya yorumlamaz. Desteklenen Google arama özelliklerini ve bildirilen hata veya uyarıları incelemek için Google’ın Zengin Sonuçlar Testi aracını kullanın. Bir testten geçmek Google’ın zengin sonuç göstereceğini garanti etmez.
İşletme işaretlemesi hazırlıyorsanız Yerel İşletme Schema Oluşturucu gerçek bilgilerinizden JSON-LD üretebilir. Yayımlamadan önce çıktısını inceleyin. Özel işletme türleri ve iç içe PostalAddress nesneleri bu kontrol aracında desteklenmeyen kalabilir; üretim ve seçili doğrulama ayrı işlerdir.
Düzeltmeyi uyguladıktan sonra ilgili kontrolü yalnızca taslakta değil, yayımlanmış sayfada yeniden çalıştırın. Sunulan işaretlemenin amaçlanan değişikliği içerdiğini doğrulayın ve kalan bulguları karşılaştırın. O çalıştırmanın blok numaralarını, varlık yollarını, bulgularını ve kapsamını saklamak için JSON indir kullanın. Başka bir inceleyenin kanıtı anlayabilmesi için girdiyi ve kapsamı dışa aktarılan dosyayla birlikte saklayın. Kaydedilmiş rapor bir kontrolü belgeler; gelecekteki şablon veya içerik değişikliklerini sürekli izlemez.