Yapılandırılmış veri (JSON-LD)
5 dk okuma
Adım Structured data, her sayfayı arama motorlarına ürün, yerel işletme, SSS, nasıl yapılır gibi bir tür olarak tanıtır; böylece sonuçlarda yıldızlar, fiyatlar veya sorular gösterilebilir. Eklenti bunu JSON-LD olarak yazdırır; Yoast SEO, Rank Math veya All in One SEO'nun grafiğine birleştirilir, hiçbir SEO eklentisi JSON-LD yazdırmıyorsa tek başına yazdırılır.
Önce Add structured data to the pages seçeneğini açın, ardından nasıl oluşturulacağını seçin.
Builder (oluşturucu)
Önce How to build it bölümünde Builder seçeneğini seçin. Add a type düğmesine tıklayın (“What do the pages describe? Choose a type…”) ve bir tür seçin. Bir görevde en fazla 5 tür olabilir (+ Add another type…), örneğin Product ve FAQ.
Tür | Zorunlu özellikler | Önerilen |
|---|---|---|
Product | Name, Image | Description, Brand, SKU, Offer, Rating (GTIN ve Manufacturer part number isteğe bağlı) |
Service | Name | Description, Area served |
Local business | Name, Address | Image, Phone, Website, Coordinates, Opening hours |
FAQ | Questions | |
How-to | Name, Steps | Description, Image, Total time |
Article | Headline | Image, Author, Published, Modified |
Event | Name, Start, Place | End, Description, Image, Organizer, Tickets |
Job posting | Job title, Description, Posted, Employer, Location | Valid through, Employment type, Salary |
Course | Name, Description | Provider |
Recipe | Name, Image | Description, Ingredients, Steps, Total time, Servings, Category, Cuisine, Author |
Software / app | Name, Offer | Category, Operating system, Rating |
Birçok tür More specific type alanını kabul eder: Local business (Restaurant, Store, Hotel, Medical clinic, Dentist, Legal service, Auto repair, Real estate agent, Home and construction business, Professional service, Beauty salon, Sports activity location) ve Article (Blog posting, News article, Tech article). Varsayılan Any Local business / Any Article.
Zorunlu ve önerilen özellikler Google'ın zengin sonuç belgelerini izler. Kart önce zorunlu ve önerilen özellikleri gösterir; Show %d optional properties geri kalanını açar.
Bir özelliği eşleme
Her özellik satırının bir kaynağı vardır:
Kaynak | Anlamı |
|---|---|
Not used | Özellik dışarıda bırakılır |
From a data column | Bir Column seçin (görevin kaynaklarından; kombinasyon modunda hangi kaynağın sütunu olacağını seçin) |
Fixed value / Fixed value or template | Metin; isteğe bağlı olarak |
Written by AI / Written by AI (Pro) | Sayfa başına bir yapay zekâ değeri; isteğe bağlı Instructions for AI ile (örneğin "alıcıların sipariş vermeden önce sorduğu sorular"); bkz. Yapay zekâ brifingleri ve çalıştırmalar |
Nesne olan özellikler (Offer, Rating, Address, Coordinates, Place, Salary) kendi özelliklerini içeren bir alt forma açılır, örneğin Offer › Price, Currency, Availability.
Değerler özelliğin türüne göre temizlenir; bu nedenle içe aktarılan verinin kusursuz olması gerekmez:
Tür | Kabul ettikleri |
|---|---|
Metin, uzun metin | HTML ayıklanır, boşluklar birleştirilir (500 / 5.000 karakter) |
Sayı |
|
Tarih, tarih ve saat | ISO 8601'e dönüştürülür |
Süre |
|
URL | Mutlak URL'ler |
Görsel | Bir görsel URL'si veya medya kitaplığı kimliği ("Image URL or media ID") |
Seçim (stok durumu, durum…) | Bir etiket veya schema.org URL'si ( |
Boş veya anlaşılamayan bir değer o özelliği dışarıda bırakır; düğümün geri kalanı yine yazdırılır.
Listeler (SSS soruları, adımlar, malzemeler)
Liste özellikleri birden çok öğe alır. Sütun için bir List format seçin:
Biçim | Sütunun içeriği |
|---|---|
One per line | Satır başına bir öğe (metin listeleri, tek metinli nasıl yapılır adımları) |
Separated by | / Separated by commas | Tek satırda öğeler |
JSON list | Her öğe için bir nesne içeren bir JSON listesi, örneğin |
Seçiminiz JSON list ise JSON key of each item value alanına ad verebilirsiniz ("anahtar özellik adıyla aynıysa boş bırakın"). At most öğe sayısını sınırlar (1 ile 20 arası, varsayılan 5).
Örnek çıktı
Product düğümü (adı, açıklaması ve fiyatı sütunlardan, para birimi sabit) ve breadcrumb'lar içeren bir görev, SEO eklentisi olmayan bir sitede:
{"@context":"https://schema.org","@graph":[
{"@type":"Product","@id":"https://example.com/guides/lyon/#product",
"mainEntityOfPage":"https://example.com/guides/lyon/","name":"Lyon",
"offers":{"@type":"Offer","price":12,"priceCurrency":"EUR"},"description":"Food capital."},
{"@type":"BreadcrumbList","@id":"https://example.com/guides/lyon/#breadcrumb",
"itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://example.com/"},
{"@type":"ListItem","position":2,"name":"Visit Lyon","item":"https://example.com/guides/lyon/"}]}]}Her düğümün kimliği, sayfa URL'si artı # ve düğümün id değeridir; mainEntityOfPage onu sayfaya bağlar.
JSON-LD şablonu
Tam denetim için How to build it altında JSON-LD template seçin. JSON'u siz yazarsınız ve değişkenleri tırnak içinde kullanırsınız:
{
"@context": "https://schema.org",
"@type": "Place",
"name": "{{ pseo.src.cities.name }}"
}Her değer JSON için kaçışlanır; bu nedenle verideki bir tırnak işareti yapıyı bozamaz. Notlar:
- En fazla 20.000 karakter.
- Geçerli JSON olmayan bir şablon hiçbir şey yazdırmaz ve Settings › Health bölümünde bildirilir (görev başına saatte bir kez): "The structured data template of “…” is not valid JSON: …". Önizleme "The JSON-LD template is not valid JSON on this page, so nothing is printed: …" mesajını gösterir.
- Çıktı, oluşturucununki gibi sarılır: yukarıdaki şablonunuz
{"@context":"https://schema.org","@graph":[{"@type":"Place","name":"Lyon"}]}yazdırır. Bir SEO eklentisiyle düğüm eklentinin grafiğine katılır.
Önizleme
Yan paneldeki Structured data of the sample page gerçek bir satırın JSON'unu gösterir; ‹ Previous row ve Next row ›, Copy JSON-LD ("Copied.") ve Test in Google’s Rich Results Test ile birlikte. Bir özet Required properties present, "%d required property missing" veya "%d recommended property empty" der. Eksik zorunlu özellikler düğümün yazdırılmasını engellemez, ancak Google bu durumda zengin sonuç göstermeyebilir. Yukarıdaki örnekte Product'ın Image özelliği yoktur ve önizleme bunu bildirir.
Diğer seçenekler
Seçenek | Davranış |
|---|---|
Replace the SEO plugin’s article markup (varsayılan olarak açık) | "SEO eklentileri oluşturulan her sayfayı şablon gibi tanımlar (çoğunlukla Article olarak). Önerilen: bunun yerine sayfayı bu türlerin tanımlamasına izin verin." Görev düğüm eklediğinde eklenti, SEO eklentisinin sayfa için kendi Article, Product, Event, … düğümünü kaldırır. Organization, WebSite ve Person düğümleri kalır. |
Breadcrumb structured data (varsayılan olarak açık) | "Home › üst sayfalar › bu sayfa, URL'den. SEO eklentileri kendi breadcrumb'larını aynı yolla doldurarak yazdırır." |
Bir SEO eklentisi olmayan bir sitede (veya desteklenmeyen bir eklentiyle) eklenti, head bölümünde düğümlerinizi içeren tek bir <script type="application/ld+json"> bloğu yazdırır; hiçbir SEO eklentisi kendi BreadcrumbList'ini yazdırmıyorsa BreadcrumbList eklenir.
Sayfa başına değerler
Sayfa düzenleyicisindeki Structured data bölümünde görevin eşlediği her özellik sayfa başına düzenlenebilir (Set by hand değerleri kilitlenir; çalıştırmalardan ve yapay zekâdan etkilenmez). Yapay zekâ ile eşlenen özelliklerde Written by AI görünür.
Hâlâ takıldınız mı? Destek ile iletişime geçin