Veri kümesi (Dataset, DataCatalog, DataDownload) yapılandırılmış verisi

Bir veri kümesinin adı, açıklaması, oluşturucusu ve dağıtım biçimleri gibi destekleyici bilgileri yapılandırılmış veri olarak sağladığınızda söz konusu veri kümesini Veri Kümesi Arama aracında bulmak daha kolay olur. Google'ın veri kümesi keşfine yaklaşımı, schema.org'dan ve veri kümelerini açıklayan sayfalara eklenebilecek diğer meta veri standartlarından faydalanır. Bu işaretlemenin amacı; yaşam bilimleri, sosyal bilimler, makine öğrenimi gibi alanlardan, şehre ve devlete ait verilerden elde edilen veri kümelerinin keşfedilmesini kolaylaştırmaktır.

Veri Seti Arama örneği

Burada, veri kümesi olarak nitelendirilebilecek bazı örnekleri görebilirsiniz:

  • Bazı veriler içeren bir tablo veya CSV dosyası
  • Düzenlenmiş bir tablo koleksiyonu
  • Veri içeren özel bir biçimdeki bir dosya
  • Birlikte anlamlı bir veri kümesi oluşturan dosya koleksiyonu
  • İşlemek üzere özel bir araca yüklemek isteyebileceğiniz, başka biçimde veriler içeren bir yapılandırılmış nesne
  • Veri yakalayan resimler
  • Eğitilmiş parametreler veya sinir ağı yapısı tanımları gibi makine öğrenimiyle ilgili dosyalar

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据,可以详细了解结构化数据的运作方式

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南,请查看结构化数据 Codelab

  1. 添加必要属性。根据您使用的格式,了解在网页上的什么位置插入结构化数据
  2. 遵循指南
  3. 使用富媒体搜索结果测试验证您的代码,并修复所有严重错误。此外,您还可以考虑修正该工具中可能会标记的任何非严重问题,因为这些这样有助于提升结构化数据的质量(不过,要使内容能够显示为富媒体搜索结果,并非必须这么做)。
  4. 部署一些包含您的结构化数据的网页,然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问,不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题,您可以请求 Google 重新抓取您的网址
  5. 为了让 Google 随时了解日后发生的更改,我们建议您提交站点地图Search Console Sitemap API 可以帮助您自动执行此操作。

Veri Kümesi Arama sonuçlarından veri kümesi silme

Veri Seti Arama sonuçlarında bir veri kümesinin görünmesini istemiyorsanız veri kümenizin nasıl dizine eklendiğini kontrol etmek için robots metaetiketini kullanın. Değişikliklerin Veri Seti Arama'ya yansımasının biraz zaman alabileceğini (tarama zamanına bağlı olarak günler veya haftalar sürebilir) unutmayın.

Veri kümesi keşfi konusundaki yaklaşımımız

Web sayfalarındaki veri kümeleriyle ilgili yapılandırılmış verileri, schema.org Dataset işaretlemesini veya W3C'nin Veri Kataloğu Sözlüğü (DCAT) biçiminde gösterilen eşdeğer yapıları kullanarak anlayabiliriz. Ayrıca, yapılandırılmış verilere yönelik deneysel desteği W3C CSVW doğrultusunda araştırıyoruz ve veri kümesi açıklamasına yönelik en iyi uygulamalar ortaya çıktıkça yaklaşımımızı geliştirmeyi ve uyarlamayı umuyoruz. Veri kümesi keşfi konusundaki yaklaşımımız hakkında daha fazla bilgi için Veri kümelerinin keşfini kolaylaştırma bölümüne bakın.

Örnekler

Zengin Sonuçlar Testi'nde JSON-LD ve schema.org söz dizimini (tercih edilen) kullanan veri kümeleriyle ilgili bir örneği burada bulabilirsiniz. Aynı schema.org sözlüğü, RDFa 1.1 veya Mikro veri söz dizimlerinde de kullanılabilir. Meta verileri açıklamak için W3C DCAT sözlüğünü de kullanabilirsiniz. Aşağıdaki örnek, gerçek bir veri kümesi açıklamasına dayanmaktadır.

JSON-LD

Bir JSON-LD veri kümesi örneğini burada bulabilirsiniz:


<html>
  <head>
    <title>NCDC Storm Events Database</title>
    <script type="application/ld+json">
    {
      "@context":"https://schema.org/",
      "@type":"Dataset",
      "name":"NCDC Storm Events Database",
      "description":"Storm Data is provided by the National Weather Service (NWS) and contain statistics on...",
      "url":"https://catalog.data.gov/dataset/ncdc-storm-events-database",
      "sameAs":"https://gis.ncdc.noaa.gov/geoportal/catalog/search/resource/details.page?id=gov.noaa.ncdc:C00510",
      "identifier": ["https://doi.org/10.1000/182",
                     "https://identifiers.org/ark:/12345/fk1234"],
      "keywords":[
         "ATMOSPHERE > ATMOSPHERIC PHENOMENA > CYCLONES",
         "ATMOSPHERE > ATMOSPHERIC PHENOMENA > DROUGHT",
         "ATMOSPHERE > ATMOSPHERIC PHENOMENA > FOG",
         "ATMOSPHERE > ATMOSPHERIC PHENOMENA > FREEZE"
      ],
      "license" : "https://creativecommons.org/publicdomain/zero/1.0/",
      "isAccessibleForFree" : true,
      "hasPart" : [
        {
          "@type": "Dataset",
          "name": "Sub dataset 01",
          "description": "Informative description of the first subdataset...",
          "license" : "https://creativecommons.org/publicdomain/zero/1.0/",
          "creator":{
             "@type":"Organization",
             "name": "Sub dataset 01 creator"
          }
        },
        {
          "@type": "Dataset",
          "name": "Sub dataset 02",
          "description": "Informative description of the second subdataset...",
          "license" : "https://creativecommons.org/publicdomain/zero/1.0/",
          "creator":{
             "@type":"Organization",
             "name": "Sub dataset 02 creator"
          }
        }
      ],
      "creator":{
         "@type":"Organization",
         "url": "https://www.ncei.noaa.gov/",
         "name":"OC/NOAA/NESDIS/NCEI > National Centers for Environmental Information, NESDIS, NOAA, U.S. Department of Commerce",
         "contactPoint":{
            "@type":"ContactPoint",
            "contactType": "customer service",
            "telephone":"+1-828-271-4800",
            "email":"ncei.orders@noaa.gov"
         }
      },
      "funder":{
         "@type": "Organization",
         "sameAs": "https://ror.org/00tgqzw13",
         "name": "National Weather Service"
      },
      "includedInDataCatalog":{
         "@type":"DataCatalog",
         "name":"data.gov"
      },
      "distribution":[
         {
            "@type":"DataDownload",
            "encodingFormat":"CSV",
            "contentUrl":"https://www.ncdc.noaa.gov/stormevents/ftp.jsp"
         },
         {
            "@type":"DataDownload",
            "encodingFormat":"XML",
            "contentUrl":"https://gis.ncdc.noaa.gov/all-records/catalog/search/resource/details.page?id=gov.noaa.ncdc:C00510"
         }
      ],
      "temporalCoverage":"1950-01-01/2013-12-18",
      "spatialCoverage":{
         "@type":"Place",
         "geo":{
            "@type":"GeoShape",
            "box":"18.0 -65.0 72.0 172.0"
         }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>
RDFa

Aşağıda, DCAT sözlüğünü kullanan bir RDFa veri kümesi örneği verilmiştir (Zengin Sonuçlar Testi'nde desteklenmez):

<article about="/node/1234" typeof="dcat:Dataset">
    <dl>
      <dt>Name:</dt>
      <dd property="dc:title">ACME Inc Cash flow data</dd>
      <dt>Identifiers:</dt>
      <dd property="dc:identifier">https://doi.org/10.1000/182</dd>
      <dd property="dc:identifier">https://identifiers.org/ark:/12345/fk1234</dd>
      <dt>Description:</dt>
      <dd property="dc:description">Financial Statements - Consolidated Statement of Cash Flows</dd>
      <dt>Category:</dt>
      <dd rel="dc:subject">Financial</dd>
      <dt class="field-label">Downloads:</dt>
      <dd>
        <ul>
          <li>
            <a rel="dcat:distribution" href="Consolidated_Statement_of_Cash_Flows_en.csv"><span property="dcat:mediaType" content="text/csv" >Consolidated_Statement_of_Cash_Flows_en.csv</span></a>
          </li>
         <li>
            <a rel="dcat:distribution"  href="files/Consolidated_Statement_of_Cash_Flows_en.xls"><span property="dcat:mediaType" content="application/vnd.ms-excel">Consolidated_Statement_of_Cash_Flows_en.xls</span></a>
          </li>
          <li>
            <a rel="dcat:distribution"  href="files/consolidated_statement_of_cash_flows_en.xml"><span property="dcat:mediaType" content="application/xml">consolidated_statement_of_cash_flows_en.xml</span></a>
          </li>
        </ul>
      </dd>
    </dl>
  </article>

Yönergeler

Siteler, yapılandırılmış veri yönergelerine uymalıdır. Yapılandırılmış veri yönergelerine ek olarak, aşağıdaki site haritasının yanı sıra kaynak ve köken ile ilgili en iyi uygulamaları öneririz.

Site haritası en iyi uygulamaları

Google’ın URL’lerinizi bulmasına yardımcı olmak için bir site haritası dosyası kullanın. Site haritası dosyalarının ve sameAs işaretlemesinin kullanılması, veri kümesi açıklamalarının sitenizde nasıl yayınlandığını belgelemeye yardımcı olur.

Bir veri kümesi havuzunuz varsa muhtemelen en az iki sayfa türünüz olur: her bir veri kümesi için standart ("açılış") sayfalar ve birden fazla veri kümesinin listelendiği sayfalar (örneğin, arama sonuçları veya bazı veri kümelerinin alt kümeleri). Standart sayfalara bir veri kümesiyle ilgili yapılandırılmış veri eklemenizi öneririz. Arama sonuçları sayfalarındaki girişler gibi veri kümesinin birden çok kopyasına yapılandırılmış veri eklerseniz standart sayfaya bağlantı vermek için sameAs özelliğini kullanın.

Kaynak ve köken en iyi uygulamaları

Açık veri kümelerinin yeniden yayınlanması, toplanması ve başka veri kümelerine dayanması yaygın görülen bir durumdur. Bu, bir veri kümesinin başka bir veri kümesinin kopyası olduğu veya başka bir veri kümesine dayandığı durumları göstermek için kullandığımız yaklaşımın bir ilk taslağıdır.

  • Veri kümesi veya açıklamanın başka yerde yayınlanmış materyallerin yeniden yayını olduğu durumlarda, orijinale en uygun standart URL’leri belirtmek için sameAs özelliğini kullanın. sameAs değerinin, veri kümesinin kimliğini açık bir şekilde belirtmesi gerekir. Diğer bir deyişle, iki farklı veri kümesi için aynı sameAs değerini kullanmayın.
  • Yeniden yayınlanan veri kümesinin (meta verileri dahil) önemli ölçüde değiştiği durumlarda isBasedOn özelliğini kullanın.
  • Bir veri kümesi birkaç orijinalden türetildiğinde veya toplandığında isBasedOn özelliğini kullanın.
  • Alakalı Dijital Nesne tanımlayıcılarını (DOI'ler) veya Kompakt Tanımlayıcıları eklemek için identifier özelliğini kullanın. Veri kümesinde birden fazla tanımlayıcı varsa identifier özelliğini tekrarlayın. JSON-LD kullanılıyorsa bu, JSON listesi söz dizimi kullanılarak gösterilir.

Önerilerimizi, özellikle köken açıklaması, sürüm oluşturma ve zaman serisi yayınlarıyla ilişkili tarihlerle ilgili geri bildirimlere dayanarak daha iyi hale getirmeyi umuyoruz. Lütfen topluluk tartışmalarına katılın.

Metin özelliği önerileri

Tüm metin özelliklerini en fazla 5.000 karakter ile sınırlandırmanızı öneririz. Google Veri Seti Arama, metin özelliklerinin yalnızca ilk 5.000 karakterini kullanır. Adlar ve başlıklar genellikle birkaç kelimeden veya kısa bir cümleden oluşur.

Bilinen Hatalar ve Uyarılar

Google'ın Zengin Sonuçlar Testi'nde ve diğer doğrulama sistemlerinde hatalar veya uyarılarla karşılaşabilirsiniz. Doğrulama sistemleri, kuruluşların iletişim bilgilerinin contactType içermesi gerektiğini de belirtebilir; faydalı değerler arasında customer service, emergency, journalist, newsroom ve public engagement bulunur. Ayrıca, mainEntity özelliği için beklenmedik bir değer olan csvw:Table hatalarını yok sayabilirsiniz.

Yapılandırılmış veri türü tanımları

İçeriğinizin zengin sonuç olarak görüntülenmeye uygun olması için gereken özellikleri eklemeniz gerekir. İçeriğiniz hakkında daha fazla bilgi ekleyerek daha iyi bir kullanıcı deneyimi sağlamak için önerilen özellikleri de dahil edebilirsiniz.

İşaretlemenizi doğrulamak için Zengin Sonuçlar Testi'ni kullanabilirsiniz.

Buradaki asıl amaç, bir veri kümesi ile ilgili bilgileri (kümenin meta verileri) açıklamak ve içeriklerini temsil etmektir. Örneğin, veri kümesi meta verileri, veri kümesinin ne hakkında olduğunu, hangi değişkenleri ölçtüğünü, kimin tarafından oluşturulduğunu ve benzer bilgileri belirtir. Örneğin, değişkenler için belirli değerler içermez.

Dataset

Dataset öğesinin tam tanımını schema.org/Dataset adresinde bulabilirsiniz.

Lisans, yayınlanma zamanı, DOI'si veya farklı bir veri havuzundaki veri kümesi standart sürümünü işaret eden bir sameAs özelliği gibi veri kümesinin yayınlanmasıyla ilgili ek bilgileri açıklayabilirsiniz. Köken ve lisans bilgileri sağlayan veri kümeleri için identifier, license ve sameAs ekleyin.

Google tarafından desteklenen özellikler şunlardır:

Zorunlu özellikler
description Text

Veri kümesini açıklayan kısa bir özet.

Yönergeler

  • Özet, 50-5.000 karakter uzunluğunda olmalıdır.
  • Özet, Markdown söz dizimini içermelidir. Yerleştirilmiş resimlerin, mutlak yol URL'leri kullanmaları gerekir (göreli yollar yerine).
  • JSON-LD biçimini kullanırken yeni satırları \n (iki karakter: ters eğik çizgi ve küçük "n" harfi) ile belirtin.
name Text

Veri kümesinin açıklayıcı adı. Örneğin, "Kuzey Yarım Küre'de kar kalınlığı".

Yönergeler

  • Farklı veri kümeleri için mümkün olduğunca benzersiz adlar kullanın.
  • Önerilen: İki farklı veri kümesi için "Snow depth in the Northern Hemisphere" ve "Snow depth in the Southern Hemisphere".

    Önerilmeyen: İki farklı veri kümesi için "Snow depth" ve "Snow depth".

Önerilen özellikler
alternateName Text

Bu veri kümesini tanımlamak için kullanılmış olan takma adlar veya kısaltmalar gibi alternatif adlar. Örneğin (JSON-LD biçiminde):

"name": "The Quick, Draw! Dataset"
"alternateName": ["Quick Draw Dataset", "quickdraw-dataset"]
creator Person veya Organization

Bu veri kümesinin üreticisi veya yazarı. Kullanıcıları benzersiz bir şekilde tanımlamak için Person türünün sameAs özelliğinin değeri olarak ORCID ID'yi kullanın. Kurum ve kuruluşları benzersiz bir şekilde tanımlamak için ROR ID'yi kullanın. Örneğin (JSON-LD biçiminde):

"creator": [
  {
    "@type": "Person",
    "sameAs": "https://orcid.org/0000-0000-0000-0000",
    "givenName": "Jane",
    "familyName": "Foo",
    "name": "Jane Foo"
  },
  {
    "@type": "Person",
    "sameAs": "https://orcid.org/0000-0000-0000-0001",
    "givenName": "Jo",
    "familyName": "Bar",
    "name": "Jo Bar"
  },
  {
    "@type": "Organization",
    "sameAs": "https://ror.org/xxxxxxxxx",
    "name": "Fictitious Research Consortium"
  }
]
citation Text veya CreativeWork

Alıntı yapılan veri kümesinin kendisine ek olarak veri sağlayıcısı tarafından önerilen akademik makaleleri tanımlar. Veri kümesinin kendisi için olan alıntıyı, name, identifier, creator ve publisher gibi diğer özelliklerle sağlayın. Örneğin bu özellik, veri tanımlayıcısı, veri kağıdı veya bu veri kümesi için tamamlayıcı materyal olan bir makale gibi ilgili akademik yayını benzersiz şekilde tanımlayabilir. Örnekler (JSON-LD biçiminde):

"citation": "https://doi.org/10.1111/111"
"citation": "https://identifiers.org/pubmed:11111111"
"citation": "https://identifiers.org/arxiv:0111.1111v1"
"citation":
 "Doe J (2014) Influence of X ... https://doi.org/10.1111/111"

Ek yönergeler

  • Bu özelliği, veri kümesinin kendisi için alıntı bilgilerini sağlamak amacıyla kullanmayın. Bu alan, veri setinin kendisini değil, ilgili akademik makaleleri tanımlamak içindir. Veri kümesinin kendisini alıntılamak için gereken bilgileri sağlarken, bu özellik yerine name, identifier, creator ve publisher özelliklerini kullanın.
  • Alıntı özelliğini bir alıntı snippet'iyle doldururken, mümkün olduğunda makale tanımlayıcısını (DOI gibi) sağlayın.

    Önerilen: "Doe J (2014) Influence of X. Biomics 1(1). https://doi.org/10.1111/111"

    Önerilmeyen: "Doe J (2014) Influence of X. Biomics 1(1)."

funder Person veya Organization

Bu veri kümesi için maddi destek sağlayan bir kişi veya kuruluş. Kullanıcıları benzersiz bir şekilde tanımlamak için Person türünün sameAs özelliğinin değeri olarak ORCID ID'yi kullanın. Kurum ve kuruluşları benzersiz bir şekilde tanımlamak için ROR ID'yi kullanın. Örneğin (JSON-LD biçiminde):

"funder": [
  {
    "@type": "Person",
    "sameAs": "https://orcid.org/0000-0000-0000-0002",
    "givenName": "Jane",
    "familyName": "Funder",
    "name": "Jane Funder"
  },
  {
    "@type": "Organization",
    "sameAs": "https://ror.org/yyyyyyyyy",
    "name": "Fictitious Funding Organization"
  }
]
hasPart veya isPartOf URL veya Dataset

Veri kümesi daha küçük veri kümelerinden oluşan bir koleksiyonsa bu ilişkiyi belirtmek için hasPart özelliğini kullanın. Tersine, veri kümesi daha büyük bir veri kümesinin parçasıysa isPartOf özelliğini kullanın. Her iki özellik de bir URL veya Dataset örneği biçiminde olabilir. Değer olarak Dataset kullanılıyorsa bağımsız bir Dataset için gereken tüm özellikleri içermelidir. Örnekler:

"hasPart" : [
  {
    "@type": "Dataset",
    "name": "Sub dataset 01",
    "description": "Informative description of the first subdataset...",
    "license": "https://creativecommons.org/publicdomain/zero/1.0/",
    "creator": {
      "@type":"Organization",
      "name": "Sub dataset 01 creator"
    }
  },
  {
    "@type": "Dataset",
    "name": "Sub dataset 02",
    "description": "Informative description of the second subdataset...",
    "license": "https://creativecommons.org/publicdomain/zero/1.0/",
    "creator": {
      "@type":"Organization",
      "name": "Sub dataset 02 creator"
    }
  }
]
"isPartOf" : "https://example.com/aggregate_dataset"
identifier URL, Text veya PropertyValue

DOI veya Kompakt Tanımlayıcı gibi bir tanımlayıcı. Veri kümesinde birden fazla tanımlayıcı varsa identifier özelliğini tekrarlayın. JSON-LD kullanılıyorsa bu, JSON listesi söz dizimi kullanılarak gösterilir.

isAccessibleForFree Boolean

Veri kümesinin ücretsiz olarak erişilebilir olup olmadığı.

keywords Text

Veri kümesini özetleyen anahtar kelimeler.

license URL veya CreativeWork

Veri kümesinin dağıtımını belirleyen bir lisans. Örneğin:

"license" : "https://creativecommons.org/publicdomain/zero/1.0/"
"license" : {
  "@type": "CreativeWork",
  "name": "Custom license",
  "url": "https://example.com/custom_license"
  }

Ek yönergeler

  • Kullanılan lisansın belirli bir sürümünü açıkça tanımlayan bir URL sağlayın.

    Önerilen

    "license" : "https://creativecommons.org/licenses/by/4.0"

    Önerilmeyen

    "license" : "https://creativecommons.org/licenses/by"
measurementTechnique Text veya URL

variableMeasured özelliğinde açıklanan değişkenlere karşılık gelebilen veri kümesinde kullanılan teknik, teknoloji veya metodoloji.

sameAs URL

Veri kümesinin kimliğini açık bir şekilde tanımlayan bir referans web sayfasının URL'si.

spatialCoverage Text veya Place

Veri kümesinin uzamsal yönünü açıklayan tek bir nokta sağlayabilirsiniz. Bu özelliği yalnızca veri kümesi uzamsal bir boyuta sahipse ekleyin. Örneğin, tüm ölçümlerin toplandığı tek bir nokta veya bir alan için sınırlayıcı kutunun koordinatları.

Noktalar

"spatialCoverage:" {
  "@type": "Place",
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 39.3280,
    "longitude": 120.1633
  }
}

Şekiller

Farklı şekillerdeki alanları açıklamak için GeoShape özelliğini kullanın. Örneğin, bir sınırlayıcı kutu belirtmek için.

"spatialCoverage:" {
  "@type": "Place",
  "geo": {
    "@type": "GeoShape",
    "box": "39.3280 120.1633 40.445 123.7878"
  }
}

box, circle, line veya polygon özelliklerinin içindeki noktalar, enlem ve boylama (bu sırayla) karşılık gelen, boşlukla ayrılmış iki değer çifti olarak ifade edilmelidir.

Adlandırılmış konumlar

"spatialCoverage:" "Tahoe City, CA"
temporalCoverage Text

Veri kümesindeki veriler belirli bir zaman aralığını kapsar. Bu özelliği yalnızca veri kümesi geçici bir boyuta sahipse ekleyin. Schema.org, zaman aralıklarını ve zaman noktalarını açıklamak için ISO 8601 standardını kullanır. Veri kümesi aralığına bağlı olarak tarihleri farklı biçimde tanımlayabilirsiniz. Açık uçlu aralıkları iki ondalık basamakla (..) belirtin.

Tek tarih

"temporalCoverage" : "2008"

Dönem

"temporalCoverage" : "1950-01-01/2013-12-18"

Açık uçlu dönem

"temporalCoverage" : "2013-12-19/.."
variableMeasured Text veya PropertyValue

Bu veri kümesinin ölçtüğü değişken. Örneğin, sıcaklık veya basınç.

version Text veya Number

Veri kümesinin sürüm numarası.

url URL

Veri kümesini açıklayan bir sayfanın konumu.

DataCatalog

DataCatalog öğesinin tam tanımını schema.org/DataCatalog adresinde bulabilirsiniz.

Veri kümeleri genellikle başka birçok veri kümesi içeren veri havuzlarında yayınlanır. Aynı veri kümesi, böyle birden fazla veri havuzuna dahil edilebilir. Aşağıdaki özellikleri kullanıp doğrudan başvuruda bulunarak bu veri kümesinin ait olduğu veri kataloğuna referans verebilirsiniz.

Önerilen özellikler
includedInDataCatalog DataCatalog

Veri kümesinin ait olduğu katalog.

DataDownload

DataDownload öğesinin tam tanımını schema.org/DataDownload adresinde bulabilirsiniz. Dataset özelliklerine ek olarak, indirme seçenekleri sunan veri kümeleri için aşağıdaki özellikleri ekleyin.

URL genellikle veri kümesini tanımlayan açılış sayfasını işaret ettiğinden distribution özelliği, veri kümesinin kendisinin nasıl alınacağını açıklar. distribution özelliği, verilerin nereden alınacağını ve hangi biçimde olacağını açıklar. Bu özelliğin birkaç değeri olabilir: Örneğin, bir CSV sürümünün bir URL'si vardır ve bir Excel sürümü başka bir URL'de bulunmaktadır.

Zorunlu özellikler
distribution.contentUrl URL

İndirme bağlantısı.

Önerilen özellikler
distribution DataDownload

Veri kümesi indirme dosyasının konumunun ve indirilecek dosya biçiminin açıklaması.

distribution.encodingFormat Text veya URL

Dağıtımın dosya biçimi.

Tablo biçiminde veri kümeleri

Tablo biçiminde veri kümesi, öncelikle bir satır ve sütun ızgarası şeklinde düzenlenir. Tablo biçiminde veri kümelerini yerleştiren sayfalar için temel yaklaşıma dayanarak, daha belirgin bir işaretleme de oluşturabilirsiniz. Şu anda, HTML sayfasındaki kullanıcı odaklı tablo biçimli içeriğe paralel olarak sağlanan bir CSVW ("Web’deki CSV", bkz. W3C) çeşidini anlıyoruz.

Burada, CSVW JSON-LD biçiminde kodlanmış küçük bir tabloyu gösteren bir örneği görebilirsiniz. Zengin Sonuçlar Testi'nde bazı bilinen hatalar bulunmaktadır.


<html>
  <head>
    <title>American Humane Association</title>
    <script type="application/ld+json">
    {
      "@context": ["https://schema.org", {"csvw": "https://www.w3.org/ns/csvw#"}],
      "@type": "Dataset",
      "name":"AMERICAN HUMANE ASSOCIATION",
      "description": "ProPublica's Nonprofit Explorer lets you view summaries of 2.2 million tax returns from tax-exempt organizations and see financial details such as their executive compensation and revenue and expenses. You can browse raw IRS data released since 2013 and access over 9.4 million tax filing documents going back as far as 2001.",
      "publisher": {
        "@type": "Organization",
        "name": "ProPublica"
      },
      "mainEntity" : {
        "@type" : "csvw:Table",
        "csvw:tableSchema": {
          "csvw:columns": [
            {
              "csvw:name": "Year",
              "csvw:datatype": "string",
              "csvw:cells": [
                {
                  "csvw:value": "2024",
                  "csvw:primaryKey": "2024"
                },
                {
                  "csvw:value": "2024",
                  "csvw:primaryKey": "2024"
                }]
            },
            {
              "csvw:name": "Organization name",
              "csvw:datatype": "string",
              "csvw:cells": [
                {
                  "csvw:value": "AMERICAN HUMANE ASSOCIATION",
                  "csvw:primaryKey": "2024"
                },
                {
                  "csvw:value": "AMERICAN HUMANE ASSOCIATION",
                  "csvw:primaryKey": "2024"
                }]
            },
            {
              "csvw:name": "Organization address",
              "csvw:datatype": "string",
              "csvw:cells": [
                {
                  "csvw:value": "1400 16TH STREET NW",
                  "csvw:primaryKey": "2024"
                },
                {
                  "csvw:value": "1400 16TH STREET NW",
                  "csvw:primaryKey": "2024"
                }]
            },
            {
              "csvw:name": "Organization NTEE Code",
              "csvw:datatype": "string",
              "csvw:cells": [
                {
                  "csvw:value": "D200",
                  "csvw:notes": "Animal Protection and Welfare",
                  "csvw:primaryKey": "2024"
                },
                {
                  "csvw:value": "D200",
                  "csvw:notes": "Animal Protection and Welfare",
                  "csvw:primaryKey": "2024"
                }]
            },
            {
              "csvw:name": "Total functional expenses ($)",
              "csvw:datatype": "integer",
              "csvw:cells": [
                {
                  "csvw:value": "13800212",
                  "csvw:primaryKey": "2024"
                },
                {
                  "csvw:value": "13800212",
                  "csvw:primaryKey": "2024"
                }]
            }]
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

使用 Search Console 监控富媒体搜索结果

Search Console 是一款工具,可帮助您监控网页在 Google 搜索结果中的显示效果。即使没有注册 Search Console,您的网页也可能会显示在 Google 搜索结果中,但注册 Search Console 能够帮助您了解 Google 如何查看您的网站并做出相应的改进。建议您在以下情况下查看 Search Console:

  1. 首次部署结构化数据后
  2. 发布新模板或更新代码后
  3. 定期分析流量时

首次部署结构化数据后

等 Google 将网页编入索引后,请在相关的富媒体搜索结果状态报告中查看是否存在问题。 理想情况下,有效项目数量会增加,而无效项目数量不会增加。如果您发现结构化数据存在问题,请执行以下操作:

  1. 修正无效项目
  2. 检查实际网址,核实问题是否仍然存在。
  3. 使用状态报告请求验证

发布新模板或更新代码后

如果对网站进行重大更改,请监控结构化数据无效项目的增幅。
  • 如果您发现无效项目增多了,可能是因为您推出的某个新模板无法正常工作,或者您的网站以一种新的错误方式与现有模板交互。
  • 如果您发现有效项目减少了(但无效项目的增加情况并不对应),可能是因为您的网页中未再嵌入结构化数据。请通过网址检查工具了解导致此问题的原因。

定期分析流量时

请使用效果报告分析您的 Google 搜索流量。数据将显示您的网页在 Google 搜索结果中显示为富媒体搜索结果的频率、用户点击该网页的频率以及网页在搜索结果中的平均排名。您还可以使用 Search Console API 自动提取这些结果。

问题排查

如果您在实施或调试结构化数据时遇到问题,请查看下面列出的一些实用资源。

  • 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站,请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
  • Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因,请参阅结构化数据常规指南
  • 您的结构化数据可能存在错误。请参阅结构化数据错误列表
  • 如果您的网页受到结构化数据手动操作的影响,其中的结构化数据将会被忽略(但该网页仍可能会出现在 Google 搜索结果中)。如需修正结构化数据问题,请使用“人工处置措施”报告
  • 再次查看相关指南,确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过,问题可能不是语法问题,因此富媒体搜索结果测试无法识别这些问题。
  • 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查
  • 请等待一段时间,以便 Google 重新抓取您的网页并重新将其编入索引。请注意,网页发布后,Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题,请参阅 Google 搜索抓取和索引编制常见问题解答
  • Google 搜索中心论坛中发帖提问。

Belirli veri kümesi, Veri Kümesi Arama sonuçlarında görünmüyor

Sorunun nedeni: Sitenizde veri kümelerini açıklayan sayfada yapılandırılmış veriler yoktur veya sayfa henüz taranmamıştır.

Sorunu düzeltme

  1. Veri Seti Arama sonuçlarında görmeyi beklediğiniz sayfanın bağlantısını kopyalayıp Zengin Sonuçlar Testi'ne yapıştırın. "Sayfa bu test tarafından bilinen zengin sonuçlar için uygun değil" veya "Tüm işaretleme zengin sonuçlar için uygun değil" mesajı görüntüleniyorsa bu, sayfada veri kümesi işaretlemesi bulunmadığı veya işaretlemenin hatalı olduğu anlamına gelir. Bu sorunu, Yapılandırılmış veri ekleme bölümüne bakarak düzeltebilirsiniz.
  2. Sayfada işaretleme varsa henüz taranmamış olabilir. Search Console ile tarama durumunu kontrol edebilirsiniz.

Sonuçlara göre şirket logosu eksik veya doğru görünmüyor

Sorunun nedeni: Sayfanızda kuruluş logoları için schema.org işaretlemesi eksik olabilir veya işletmeniz Google ile oluşturulmamış olabilir.

Sorunu düzeltme

  1. Sayfanıza yapılandırılmış logo verileri ekleyin.
  2. İşletme bilgilerinizi Google ile oluşturun.