Schema-merkintä kertoo koneille, mitä sisältösi tarkoittaa. Käyttämälläsi muodolla on kuitenkin väliä. Schema-merkinnän voi kirjoittaa kolmella eri kielellä: Microdata, RDFa ja JSON-LD. Suurin osa verkosta käyttää Microdataa, koska se on vanha ja helppo. Tekoäly suosii JSON-LD:tä, koska se on siisti, jäsennelty ja yksiselitteinen.
JSON-LD tulee sanoista JSON for Linking Data. Se on muoto, joka keksittiin nimenomaan tekemään jäsennelty data koneluettavaksi sotkematta HTML:ääsi. Kirjoitat sen erilliseen script-tagiin. Näkyvä sisältösi pysyy siistinä. Koneluettava data on omassa lohkossaan. Tekoälyn hakurobotit jäsentävät JSON-LD:n nopeammin ja luotettavammin kuin muut muodot. Jos haluat sisältösi olevan tekoälylle siteerattavaa, JSON-LD on tapa saada se aikaan.
Miksi JSON-LD voittaa muut schema-muodot
Microdata näyttää tältä. Lisäät attribuutit suoraan HTML-tageihisi:
<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>
Se toimii. Google lukee sen. Mutta HTML:säsi täyttyy schema-attribuuteista. Sisältö ja metadata sotkeutuvat yhteen.
JSON-LD erottaa ne kokonaan:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>
HTML pysyy siistinä. Koneluettava data on omassa script-tagissaan. Tekoälyn hakurobotit pitävät tästä erottelusta. Se on selkeämpi. Siinä on pienempi virheiden todennäköisyys. Se jäsentyy nopeammin.
RDFa on kolmas muoto, mutta sitä käytetään harvoin. Se on monimutkaisempi kuin Microdata ja JSON-LD. Ei Google eikä tekoäly suosi sitä. Jätä RDFa väliin.
Miten tekoäly lukee JSON-LD:tä
Kun tekoälyn hakurobotti vierailee sivullasi, se tekee kaksi asiaa. Se lukee näkyvän HTML-sisältösi. Ja se jäsentää kaikki löytämänsä JSON-LD-script-tagit.
JSON-LD kertoo sille: tämä sivu on Article. Se julkaistiin tänä päivänä. Sen on kirjoittanut tämä kirjoittaja. Pääaihe on tämä. Kuva löytyy tästä osoitteesta. Sanamäärä on tämä. Kaikki tämä metadata auttaa tekoälyä ymmärtämään sisällön syvemmin kuin pelkästä tekstistä.
Kun tekoäly myöhemmin päättää, viittaako se sinuun, se käyttää tätä metadataa. Oikein muotoiltuun JSON-LD Article -schemaan, jossa on julkaisupäivä, kirjoittaja ja kuva, viitataan useammin kuin samaan sisältöön ilman schemaa. Metadata todistaa, että olet alkuperäinen lähde.
JSON-LD:n olennainen rakenne
Jokaisessa JSON-LD-lohkossa on kolme ydinosaa. @context kertoo jäsentäjälle, mitä sanastoa käytät (lähes aina schema.org). @type kertoo, minkä tyyppistä asiaa kuvaat. Ominaisuudet kuvaavat tarkat attribuutit.
Perus-Article-schema näyttää tältä:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Your article summary",
"image": "https://yoursite.com/image.jpg",
"datePublished": "2026-04-17",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Brand",
"logo": {
"@type": "ImageObject",
"url": "https://yoursite.com/logo.jpg"
}
}
}
</script>
Tämä JSON-LD-lohko sijaitsee sivusi head-osiossa (tai missä tahansa bodyssa). Se kertoo hakurobotille kaiken, mitä sen tarvitsee tietää artikkelista.
Mihin JSON-LD sijoitetaan sivulla
Paras käytäntö on sijoittaa JSON-LD HTML:si head-osioon näkyvän sisällön yläpuolelle. Hakurobotti lukee headin ensin, joten se saa schema-metadatan ennen kuin se edes aloittaa bodyn jäsentämisen.
JSON-LD toimii kuitenkin missä tahansa sivulla. Headissa. Bodyssa. Ennen sisältöä. Sisällön jälkeen. Sillä ei ole väliä. Kunhan JSON on kelvollista, hakurobotit löytävät ja jäsentävät sen.
Monet sisältöalustat sijoittavat JSON-LD:n automaattisesti headiin, kun täytät metatietokentät. Kirjoitat otsikon, kuvauksen ja julkaisupäivän sisällönhallintajärjestelmääsi. Alusta luo JSON-LD:n automaattisesti. Sinun ei tarvitse kirjoittaa sitä käsin.
JSON-LD eri sisältötyypeille
Article on yleisin schema-tyyppi, mutta JSON-LD tukee monia tyyppejä. Jokaisella tyypillä on omat pakolliset ja valinnaiset ominaisuutensa.
FAQPage-schema
Jos sivullasi on UKK-osio, käytä FAQPage-schemaa. Se kertoo tekoälyn hakuroboteille tarkalleen, missä kysymyksesi ja vastauksesi ovat:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "JSON-LD is a structured data format that AI systems prefer."
}
},
{
"@type": "Question",
"name": "Where do I put JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In the head or body of your HTML page."
}
}
]
}
</script>
FAQPage-schema parantaa todennäköisyyttä, että tekoäly poimii kysymyksesi ja vastauksesi oikein.
Product-schema
Verkkokauppaa varten käytä Product-schemaa:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Product Name",
"description": "Product description",
"image": "https://yoursite.com/product.jpg",
"brand": {
"@type": "Brand",
"name": "Your Brand"
},
"offers": {
"@type": "Offer",
"url": "https://yoursite.com/product",
"priceCurrency": "USD",
"price": "99.99"
}
}
</script>
Product-schema kertoo tekoälyn ostoagenteille tuotteesi tarkan hinnan, saatavuuden ja ominaisuudet.
HowTo-schema
Vaiheittaisia oppaita varten käytä HowTo-schemaa:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Set Up JSON-LD",
"step": [
{
"@type": "HowToStep",
"name": "Step 1",
"text": "Add a script tag to your page head."
},
{
"@type": "HowToStep",
"name": "Step 2",
"text": "Write valid JSON inside the script tag."
}
]
}
</script>
HowTo-schema auttaa tekoälyä ymmärtämään vaiheiden järjestyksen ja poimimaan vaiheet oikeassa järjestyksessä.
JSON-LD:n yleiset virheet
Yleisin virhe on virheellinen JSON. JSON:lla on tiukat syntaksisäännöt. Jokaisen merkkijonon pitää olla lainausmerkeissä. Jokaista ominaisuutta pitää seurata kaksoispiste. Jokaisen objektin tai taulukon alkion pitää olla erotettu pilkulla. Jos unohdat yhden pilkun, koko JSON hajoaa.
Testaa JSON ennen käyttöönottoa. Käytä JSON-validaattoria. Liitä JSON-LD validaattoriin, niin se kertoo, onko syntaksivirheitä.
Toinen virhe on väärän @type-arvon käyttö. Jos sivusi on blogikirjoitus, käytä Articlea, ei BlogPostingia. Jos se on tuote, käytä Productia, ei Itemia. Tyypillä on väliä, koska hakurobotit ymmärtävät rakenteen eri tavoin tyypin mukaan.
Kolmas virhe on pakollisten ominaisuuksien puuttuminen. Article-schema vaatii otsikon. Product-schema vaatii hinnan. HowTo vaatii vähintään yhden vaiheen. Tarkista kunkin tyypin schema.org-dokumentaatiosta, mikä on pakollista ja mikä valinnaista.
JSON-LD:n validointi ja testaus
Googlella on Rich Results Test -työkalu. Liität URL-osoitteesi, ja se näyttää kaiken sivulta löytämänsä JSON-LD:n. Se kertoo, onko JSON kelvollista. Se kertoo, puuttuuko pakollisia ominaisuuksia. Se kertoo, miltä jäsennetty data näyttää.
Myös Schema.orgilla on validointityökalu. Liitä JSON-LD, niin se validoi syntaksin ja schema-yhteensopivuuden.
Useimmissa sisällönhallintajärjestelmissä on sisäänrakennettu validointi. Jos julkaiset sisältöä, josta puuttuu pakollisia schema-ominaisuuksia, järjestelmä varoittaa sinua ennen julkaisua.
Usein kysyttyä
Tarvitsenko JSON-LD:tä, jos käytän jo Microdataa?
Et. Käytä jompaakumpaa muotoa, älä molempia. Jos käytät Microdataa ja se toimii, pidä se. Mutta jos otat schema-merkintää käyttöön alusta alkaen, JSON-LD on parempi valinta. Se on siistimpi, helpompi ylläpitää ja tekoäly suosii sitä. WEMASYn Sivustonrakentajalla voit tehdä tämän suoraan verkkosivustollesi.
Voiko samalla sivulla olla useita JSON-LD-lohkoja?
Voi. Voit pitää Article-schemaa yhdessä lohkossa ja Organization-schemaa toisessa. Schemoja voi myös sisäkkäistää. Esimerkiksi Article-schema voi sisältää Person-schemän kirjoittajalle. Useat lohkot ovat sopivia, kunhan jokainen on kelvollista JSON:ia.
Vaikuttaako JSON-LD sivustoni nopeuteen?
Ei. JSON-LD on pelkkää tekstiä. Palvelimesi ei tarvitse jäsentää sitä. Hakurobotti jäsentää sen vieraillessaan. Verkkosivustosi suorituskykyyn ei tule vaikutusta. Se on näkymätöntä kävijöillesi.
Entä jos päivitän sisältöä mutta unohdan päivittää JSON-LD:n?
Tekoälyn hakurobotit lukevat vanhan JSON-LD-metadatan ja nykyisen näkyvän sisältösi. Ne voivat huomata ristiriidan. JSON-LD:n otsikon pitäisi vastata näkyvää otsikkoasi. Julkaisupäivän pitäisi olla oikea. Jos ne poikkeavat merkittävästi, hakurobotit voivat luottaa näkyvään sisältöön metadataa enemmän.
Pitäisikö JSON-LD:tä käyttää sisäisille linkeille vai vain pääsisällölle?
Käytä JSON-LD:tä kaikelle sisällölle, jonka haluat tekoälyn ymmärtävän syvällisesti. Pääartikkelit hyötyvät eniten. Tuotesivut hyötyvät. UKK-sivut hyötyvät. Yksinkertaiset navigointilinkit eivät tarvitse JSON-LD:tä. Keskitä vaivasi sisältöön, johon tekoäly voisi viitata tai jota se voisi suositella.
Näkeekö tekoäly CSS:llä display:none piilotetun JSON-LD:n?
Näkee. Tekoälyn hakurobotit jäsentävät JSON-LD:n riippumatta siitä, näkyykö se käyttäjille. Sitä ei tarvitse piilottaa tai näyttää. Useimmat alustat sijoittavat JSON-LD:n headiin, jossa se ei muutenkaan näy. Hakurobotti näkee sen. Se on olennaista.