JSON-LD

JSON-LD, verilerin bağlı veriler (Linked Data/LD) kullanılarak aktarıldığı bir veri işaretleme yöntemidir.

İşaretleme kuralları

JSON-LD formatına göre veriler, virgülle ayrılmış anahtar-değer çiftleri kümesi olarak açıklanır. Bu format, açıklama bağlamının (context) belirlenebileceği veya objelerin birbiriyle farklı şekilde ilişkilendirilebileceği önceden ayrılmış anahtarları kullanır. Böylece örneğin @context, bu durumda Schema.org olan obje sözlüğünü, @type ise açıklanan öğe türünü belirler. Önceden ayrılmış anahtarların tam listesi JSON-LD belge setinde bulunur.
Öğe, type="application/ld+json" veya type="ld+json" özelliğine sahip <script> etiketinde, { } parantezi içinde açıklanır. İşaretleme için Schema.org sözlüğünün kullanıldığını belirtin: "@context":"http://schema.org". @type anahtarı yardımıyla söz konusu öğeyi tanımlayan Schema.org sınıfını belirtin. Öğenin özelliklerini işaretlemek için belirlenen Schema.org sınıfının özelliklerini anahtar olarak kullanın.
Sayfadaki birden fazla öğeyi işaretlemek için kullanabilecekler:

<script type="application/ld+json">

JSON-LD hakkında daha fazla bilgi için tıklayın.

İşaretlenebilen içerik türleri

Yandex Metrica, aşağıdaki materyallerin işaretlenmesini destekler:

• Gazete yazısı: Article, haber yazısı: NewsArticle, blog yazısı: BlogPosting,
• Film açıklaması: (Movie),
• İnceleme veya yorum: Review,
• Yemek tarifi (Recipe)
• Soru ve cevap: (Question veya QAPage).

Standart işaretlemeye sahip başka materyaller Yandex Metrica’nın raporlarına dahil edilmez.

Yazı içeriği nasıl işaretlenir?

Yandex Metrica tarafından doğru işlenebilmesi için bilgileri aşağıdaki kurallara uygun olarak işaretleyin. Daha kapsamlı istatistikler alabilmek üzere içeriğin tüm öğelerini işaretlemenizi öneririz. Yine de kimlik belirleyici (ID), başlık ve asıl metin olmak üzere, yalnızca 3 öğenin işaretlenmesi zorunludur.

JSON-LD'yi zaten kullanıyorsanız lütfen sitenizde kullandığınız işaretlemenin bu koşullara uygunluğunu kontrol edin. Kurallarda belirtilen kod örnekleri, doğru olan çok sayıda farklı işaretleme şeklinden sadece bazılarıdır.

Site sayfalarının işaretlenmesi, WordPress eklentileri gibi otomatik araçlar yardımıyla da yapılabilir. Seçtiğiniz eklentiyi çalıştırmadan önce bunun gerekli olan tüm işaretleme öğelerini sayfa koduna yükleyebileceğinden lütfen emin olun.

Yazının aşağıdaki öğelerini işaretleyin (zorunlu öğeler yıldızla işaretlenmiştir):

Kimlik belirleyici*

Kimlik belirleyici özel ayrılmış @id anahtarıyla belirtilir. Bu özellik sayesinde Yandex Metrica farklı yazıları birbirinden ayırt eder. Kimlik belirleyici, raporlarda görüntülenmez. Kimlik belirleyici görevini üstlenebilen öğeler, içeriğe yönlendiren web bağlantısı veya isteğe bağlı başka bir benzersiz değerdir.

"@id": "https://www.example-news.com/life/weather/moscow#cao"

@id anahtarı bulunamadığında sistem onu mainEntity veya mainEntityOfPage anahtarlarında gömülü öğeler içinde arar.

<script type="application/ld+json">
{  
    "@context": "http://schema.org",  
    "@type": "NewsArticle",  
    "mainEntityOfPage":{
           "@type": "WebPage",
           "@id": "https://www.example-news.com/life/weather/moscow#cao"
        }
  }
  </script>

@id içeriği sayfanın sonuna kadar kaydırmalar ve sonuna kadar okumaları hesaplamak için kullanılabilir. Tanımlayıcı olarak,

• Makalenin URL'si belirtilmişse, Yandex Metrica, parçacığı (fragment), # (#fragment) işaretinden sonra belirler. Ardından makalede, o parçacığın olduğu HTML öğesini arar (id="fragment"). Parçacık bulunursa göstergelerin hesaplanması başlar. Yazı URL'si de aynı şekilde işlenir.
• Gelişigüzel bir değer seçilirse ve JSON-LD kodu head satırına yerleştirilirse sistem, göstergeleri body içerip içermediklerine göre sayar. body kodu, başka bir HTML öğesinin içine yerleştirilmişse, bu durumda öğe işaretlemesi bir üst öğeye göre kullanılır. Bu nedenle rapordaki veriler kesin olmayabilir. Yazı URL'sinde # işaretinden sonra parçacık belirtilmemişse, hesaplama gene bu şekilde gerçekleştirilir.

Başlık*

Yandex Metrica raporlarında görüntülenen başlık. headline veya alternativeHeadline anahtarlarda belirtilebilir. Anahtarların ikisi bulunduğunda değerleri aralarına boşluk bırakılarak kaydedilir. Örneğin, başlıkların şu şekilde işaretlendiğini düşünelim:

"headline": "Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı",
"alternativeHeadline": "Kasımda hava sıcaklığı 12 °C'yi aştı"

Bu durumda raporda makalenin adı şöyle görünür: “Moskova'da 1922 Yılının Sıcaklık Rekoru Kırıldı Kasımda hava sıcaklığı 12°C'yi aştı”.

Yukarıdaki anahtarlardan hiçbiri bulunamazsa, başlık olarak name veya itemReviewed (Review sınıfı için) anahtar değeri kullanılacaktır.

Metin*

Metin text anahtarına yerleştirilmelidir. Yazı büyüklüğünün belirlenmesi ve böylece sonuna kadar kaydırma ile sonuna kadar okuma metriklerinin doğru hesaplanması için metindeki karakter sayısı belirlenir.

"text": "Moskova’da 1922’de kayıtlara geçen sıcaklık rekoru 6 Kasım Çarşamba günü kırıldı. 

Fobos Merkezi’nin paylaştığı habere göre hava sıcaklığı 12,1 santigrat derece
olarak ölçüldü."
```

`text` anahtarı bulunamadığında metin olarak alınacak öğeler:
- Konumu `url` veya `@id` anahtarında belirtilen öğenin içeriği:
    
    ```json
    "@context": "https://schema.org",
    "@type": "Article",
    "url": "https://www.example-news.com/life/weather/moscow#cao"
    ```
    
- Tanımlanan öğenin dahil edildiği düğümün içeriği (`<head>` olmamak kaydıyla),
    
- Tüm diğer durumlarda sayfanın `<body>` içeriği.

Metin hacmi hesaplanırken etiketleri belirleyen karakterler dikkate alınmaz.

{% note info %}

Metinle ilgili tam istatistik alabilmek için metnin uzunluğu 500 karakterden fazla olmalıdır.

{% endnote %}

Hazırlayan kişi

Metni hazırlayan kişinin adı author anahtarıyla belirtilir. İçeriği birden fazla kişi hazırlamışsa bunları veri dizisinde sıralayın.

 "author": [
{"@type": "Person", "name": "Ali Örnek"}, 
{"@type": "Person", "name": "Ayşe Keser"}
  ]

Anahtar bulunamadıysa sistem onu mainEntity veya mainEntityOfPage anahtarlarında gömülü öğelerde arar.

<script type="application/ld+json">

{
"@context": "http://schema.org",
"@type": "NewsArticle",
"@id": "12345",
"mainEntityOfPage":{
"@type": "WebPage",
"author":{"@type": "Person", "name": "Ali Örnek"}
}
}

```

Bu veriler sayesinde farklı yazarlarla ilgili istatistiklere erişebilirsiniz.

Konu

Yazı konusu olarak örneğin anahtar sözcükler veya hashtag'ler işaretlenebilir. Konuları about anahtarında belirtin:

"about": [
    {"@type": "Event", "name": "Aşırı sıcaklık"},
    {"@type": "Event", "name": "Moskova"}
]

Tür (@type) aktarımı zorunlu değildir veya standartlar tarafından desteklenen herhangi biri belirtilebilir.

name anahtarı bulunamadığında sistem ilgili değerleri alternateName anahtarında arar.

Yayınlama ve düzenleme tarihleri

Yayınlama ve düzenleme tarihleri datePublished ve dateModified anahtarlarında belirtilir. Tarihler ISO 8601 formatında girilir.

"datePublished": "2018-12-11T08:56:49Z",
"dateModified": "2018-11-06T09:26:10+04:00"

Kategori

Sitedeki yazılar genelikle konularına göre farklı site bölümlerinde yayınlanır. Bölümü belirtmek için BreadcrumbList anahtarını kullanın. Bu şekilde genellikle ilgili konuya adanan ve söz konusu yazıyla sonuçlanan sayfa zinciri ("ekmek kırıntıları" anlamındaki "bread crumbs") belirlenir. BreadcrumbList'in içinde itemListElement anahtarında ListItem türünde birkaç öğe belirlenmelidir. Bu öğeler ilgili bölümün yanı sıra ilgili daha geniş bölümleri tanımlar.

Bölümün içiçelik düzeyi (bölümün hangi bölüme ait olduğu) position anahtarıyla belirlenir. Örneğin “Yaşam Tarzı” bölümü “Hava Durumu” ve “Doğal Afetler” adlarındaki alt bölümleri içerebilir. Değer "position":"1" olarak belirtildiğinde yazı en üst düzeye (Yaşam Tarzı bölümüne), "position":"2" olarak belirtildiğinde ise ikinci düzeye (Hava Durumu’na) ilişkilendirilir.

Böylece position değeri en yüksek olan name anahtar değeri sitede yazının bulunduğu bölümü belirler.

Not

An itibarıyla istatistiklerde site bölümlerine yönelik olarak 2 içiçelik düzeyi yansıtılabilmektedir.

{
  "@context": "http://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item":{
          "@id": "//example-news.ru/life",
          "name": "Yaşam"
        }
    },{
      "@type": "ListItem",
      "position": 2,
      "item":{
          "@id": "//example-news.ru/life/weather",
          "name": "Hava durumu"
        }
    }]
}

URL adresi

İçeriğin URL adresi url anahtarına yerleştirilmelidir. # işaretinden sonra URL parçacığı kullanılmasını tavsiye ediyoruz. Bu parçacık, göstergelerin özellikle hangi materyale göre hesaplama yapacağını sisteme gösterecektir. Daha fazla bilgi.

"url": "https://www.example-news.com/life/weather/moscow#cao"

Veri doğru işaretlenmiş ve Yandex Metrica sayacı doğru yüklenip çalıştırılmışsa yazıyla ilgili istatistikler bir süre sonra Yandex Metrica'da toplanmaya başlar.

İşaretleme örneği

Aşağıdaki örnekte haber işaretleme kodlarını görebilirsiniz.

<script type="application/ld+json">
{
   "@context": "http://schema.org",
   "@graph": [
       {
         "@type":"BreadcrumbList",
         "itemListElement": [
             {
               "@type": "ListItem",
               "position": 1,
               "item": {
                 "@id": "//example-news.ru/life",
                 "name": "Yaşam"
                }
              },
              {
                 "@type": "ListItem",
                 "position": 2,
                 "item": {
                     "@id": "//example-news.ru/life/weather",
                     "name": "Hava Durumu"
                 }
               }
            ]
        },
        {
          "@type": "NewsArticle",
          "@id": "https://www.example-news.com/life/weather/moscow#cao",
          "headline": "Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı",
          "alternativeHeadline": "Kasımda hava sıcaklığı 12 °C'yi aştı",
          "datePublished": "2018-12-11T08:56:49Z",
          "dateModified": "2018-11-06T09:26:10+04:00",
          "text": "Çarşamba günü, 6 Kasım'da Moskova'da 1922 yılında kaydedilen 
 sıcaklık rekoru kırıldı. Hava sıcaklığı 12,1 santigrat derece olarak ölçüldü, 
 Fobos merkezinin bildirdiğine göre",
          "author": [
              {"@type": "Person", "name": "Ali Örnek"}, 
              {"@type": "Person", "name": "Ayşe Keser"}
           ],
          "about": {
              "@type": "Event",
             +04 "name": "Moskova"
          },
          "url": "https://www.example-news.com/life/weather/moscow#cao"
        }
    ]
}
</script>
        

Daha fazla bilgi edinin

• İçerik raporları

Sohbete yaz

<meta itemprop="identifier" content="12345">

<meta itemscope itemprop="mainEntityOfPage" 
   itemType="https://schema.org/WebPage" itemid="/life/weather/12345.html"/>

<h1 itemprop="headline">Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı</h1>
  <h2 itemprop="alternativeHeadline">Kasımda sıcaklık 12 °C’yi aştı</h2>

<h1 itemprop="headline">Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı</h1>
  <h2 itemprop="alternativeHeadline">Kasımda sıcaklık 12 °C’yi aştı</h2>

<p itemprop="articleBody">
   Moskova’da 1922’de kayıtlara geçen sıcaklık rekoru 6 Kasım Çarşamba günü kırıldı. Fobos Merkezi’nin paylaştığı habere göre hava sıcaklığı 12,1 santigrat derece olarak ölçüldü.
</p>

<div itemprop="about">Aşırı sıcaklık</div>
  <div itemprop="about" itemscope itemtype="https://schema.org/Thing">
    <span itemprop="name">Moskova</span>
  </div>

<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z”>10.30, 11 Aralık 2018 </time>

<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z”>10.30, 11 Aralık 2018 </time>

<ol itemscope itemtype="http://schema.org/BreadcrumbList">
   <li itemprop="itemListElement" itemscope
       itemtype="http://schema.org/ListItem">
     <a itemprop="item" href="//example-news.ru/life">
     <span itemprop="name">Yaşam</span></a>
     <meta itemprop="position" content="1" />
   </li>
   <li itemprop="itemListElement" itemscope
       itemtype="http://schema.org/ListItem">
     <a itemprop="item" href="//example-news.ru/life/weather">
     <span itemprop="name">Hava Durumu</span></a>
     <meta itemprop="position" content="2" />
   </li>
 </ol>

<a itemprop="url" href="https://www.example-news.com/life/weather/moscow">example-news.com</a>

<meta itemprop="identifier" content="12345">

<h1 itemprop="headline">Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı</h1>
  <h2 itemprop="alternativeHeadline">Kasımda sıcaklık 12 °C’yi aştı</h2>

<h1 itemprop="headline">Moskova’da 1922 yılına ait hava sıcaklığı rekoru kırıldı</h1>
  <h2 itemprop="alternativeHeadline">Kasımda sıcaklık 12 °C’yi aştı</h2>

<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z”>10.30, 11 Aralık 2018 </time>

<time itemprop="dateModified" datetime="2018-12-11T07:30:00Z”>10.30, 11 Aralık 2018 </time>

<ol itemscope itemtype="http://schema.org/BreadcrumbList">
   <li itemprop="itemListElement" itemscope
       itemtype="http://schema.org/ListItem">
     <a itemprop="item" href="//example-news.ru/life">
     <span itemprop="name">Yaşam</span></a>
     <meta itemprop="position" content="1" />
   </li>
   <li itemprop="itemListElement" itemscope
       itemtype="http://schema.org/ListItem">
     <a itemprop="item" href="//example-news.ru/life/weather">
     <span itemprop="name">Hava Durumu</span></a>
     <meta itemprop="position" content="2" />
   </li>
 </ol>

<div itemprop="about">Aşırı sıcaklık</div>
  <div itemprop="about" itemscope itemtype="https://schema.org/Thing">
    <span itemprop="name">Moskova</span>
  </div>

<a itemprop="url" href="https://www.example-news.com/life/weather/moscow">example-news.com</a>