JSON-LD
Struktura JSON-LD musí být přítomna už při načtení HTML kódu stránky. Pokud bude dogenerovávána až javascriptem, tak se data JSON-LD nezpracují. Bližší popis k jednotlivým typů naleznete na https://schema.org/. Otestovat, jestli je vaše JSON-LD validní, můžete tímto nástrojem: https://search.google.com/structured-data/testing-tool?hl=cs
1. Stručné informace
Typ článkuMůže nabývat hodnot Article
, NewsArticle
nebo ReportageNewsArticle
. Ostatní typy se ignorují.
Načítáme je z více hodnot a to about
nebo keywords
. U about
se očekává objekt (minimálně s atributem name
), seznam textových názvu nebo textový řetezec obsahující hodnoty oddělené čárkami, u keywords
se očekává seznam textových položek nebo textový řetezec obsahující položky oddělené čárkami.
Při správném vyplnění tohoto objektu bude článek zařazený do tematických podstránek.
Obrázek imageTady může být jen jeden obrázek jako odkaz na obrázek, seznam odkazů na obrázky, objekt typu ImageObject
nebo seznam objektů ImageObject
. Pro uvedení zdroje nebo informací o původu obrázku je potřeba zadat tyto údaje do atributu creditText
u objektu ImageObject
.
Pokud je u položek author
a nebo about
nastaven atribut @id=wd:
, tak se identifikuje autor na základě tohoto ID, místo vyhledání podle názvu
U autora se detekuje i typ. Může nabývat hodnot Person
, Organization
. Výchozí hodnota, pokud není definováno je Person
.
Pro detekci fotogalerie u článku se používá existence hasPart[@type="ImageGallery"]
, kde se očekává url odkazu na galerii a seznam obrázků image
Datum expirace hodnotami expires a sznRecommendExpires NEPOUŽÍVAT !
Tyto hodnoty jsou sice ještě načítány, ale raději je nepouživejte, protože můžou způsobit expiraci článku v Google vyhledavači nebo nevalidní JSON-LD data. Místo toho používejte hodnotu v hlavičce HTML <meta name="szn:hp-expire" ... />
Pro zobrazení komentářů z externích webů je potřeba zadat discussionUrl
. Je to URL na kterou se přesměruje uživatel, který kliknul na komentáře u daného článku.
Vyplnění tagu contentLocation
je užitečné pouze u lokálního obsahu (např. "V místě X bude uzavírka.").
Pokud budou vyplněny správné GEO koordináty, obsah bude doporučován podle lokality návštěvníků.
U témat relevantních celorepublikově, nemají GEO souřadnice význam (např. "Poslanec X řekl Y.").
Vhodný nebo erotický obsahPokud vyplníte tag isFamilyFriendly: false
, článek se přesto zařadí, ale bude se vydávat pouze v časovém rozmezí mezi 22:00 a 5:00.
2. Ukázka možných hodnot
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Toto je název článku",
"description": "Toto je perex článku",
"image": [
"https://example.com/photos/photo.jpg",
{
"@type": "ImageObject",
"url": "https://example.com/photos/photo2.jpg",
"caption": "Titulek obrázku",
"description": "Popis obrázku",
"creditText": "Zdroj obrázku nebo další informace o obrázku"
}
],
"datePublished": "2015-02-05T08:00:00+08:00",
"dateModified": "2015-02-05T09:20:00+08:00",
"author": {
"@id": "wd:Q12024882",
"@type": "Person",
"name": "Jindřich Šídlo",
"url" : "https://www.seznamzpravy.cz/autor/jindrich-sidlo-54",
"sameAs" : [
"https://www.facebook.com/jindrich.sidlo",
"https://twitter.com/jindrichsidlo"
]
},
"about": [
{"name":"Fotbal", "@id": "wd:Q2736"},
{"name":"Arsenal", "@id": "wd:Q9617"}
],
"contentLocation" : {
"@type" : "Place",
"geo": {
"@type": "GeoCoordinates",
"latitude": "50.0713456",
"longitude": "14.4008142"
}
},
"publisher": {
"@type": "Organization",
"name": "Název firmy",
"logo": {
"@type": "ImageObject",
"url": "https://vasedomena.com/logo.jpg"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://vas-server.cz/url-tohoto-clanku"
},
"isFamilyFriendly": true,
"hasPart": {
"@type": "ImageGallery",
"url": "https://www.foo.com/bar/gallery/1/",
"image": [
{
"@type": "ImageObject",
"url": "https://www.foo.com/bar/gallery/1/image1.jpg",
"caption": "Titulek obrázku",
"description": "Popis obrázku"
},
...
]
},
"discussionUrl": "https://www.foo.com/bar/comments/1/",
}
</script>