Mikä on JSON-LD?

JSON-LD (JavaScript Object Notation for Linked Data) on muoto, jota hakukoneet suosittelevat jäsenneltyä dataa varten. Sivu lisää <script type="application/ld+json">-lohkon, joka kuvaa sivun sisältöä, kuten tuotetta hintoineen, artikkelia kirjoittajineen tai organisaatiota logoineen, käyttäen schema.org-sanaston tyyppejä ja ominaisuuksia. Google, Bing ja muut hakukoneet lukevat nämä lohkot näyttääkseen rich result -tuloksia, kuten tähtiarvosteluja, hintoja, murupolkuja ja reseptikortteja.

JSON-LD:n virheet eivät yleensä näy käyttäjälle. Sivu latautuu edelleen, mutta puuttuva pilkku, väärin kirjoitettu tyyppi tai puuttuva pakollinen kenttä voi saada hakukoneet ohittamaan merkinnän tai poistaa sivulta rich result -tuloksen.

Työkalun kuvaus

Tämä työkalu noutaa sivun HTML:n palvelimella, etsii kaikki JSON-LD-skriptien lohkot ja tarkistaa jokaisen kahdessa vaiheessa. Ensin se tarkistaa itse JSON-LD:n: että JSON jäsennetään oikein, että jokaisella kohteella on schema.org-osoitteeseen viittaava @context ja @type sekä että avainsanat, kuten @type ja @id, on kirjoitettu oikein ja niiden rakenne on kelvollinen. Sen jälkeen se tarkistaa sisällön schema.org-sanastoa ja Googlen rich result -sääntöjä vasten. Se ilmoittaa tuntemattomista tyypeistä, tyypille kuulumattomista ominaisuuksista sekä puuttuvista tai väärässä muodossa olevista pakollisista tai suositelluista kentistä.

Ominaisuudet

  • Etsii kaikki live-sivun JSON-LD-lohkot sekä <head>- että <body>-osioista
  • Ilmoittaa JSON-syntaksivirheet jäsentimen viestin kanssa
  • Tarkistaa @context-, @type-, @id-, @graph- ja avainsanojen kirjoitusasun
  • Ilmoittaa tuntemattomista schema.org-tyypeistä ja ominaisuuksista, joita tyyppi ei tue
  • Tarkistaa Googlen pakolliset ja suositellut kentät tuotteille, tarjouksille, arvosteluille, arvioinneille, resepteille, työpaikkailmoituksille, videoille, murupoluille ja muille sisältötyypeille
  • Luettelee kaikki jäsennellyn datan kohteet sekä niiden tyypin ja nimen
  • Näyttää jokaisen lohkon muotoiltuna JSON:na

Miten se toimii

Sivu ladataan seuraamatta uudelleenohjauksia, ja siitä luetaan enintään ensimmäiset 3 Mt. Jokainen JSON-LD-lohko jäsennetään erikseen, ja @graph-rakenteen sisällä olevat kohteet tarkistetaan erillisinä kohteina. schema.org-tarkistukset käyttävät kopiota koko schema.org-sanastosta, ja Googlen rich result -tarkistukset käyttävät Adoben avointa structured data validator -työkalua.

Vinkkejä

  • Virheet tarkoittavat, että hakukoneet todennäköisesti ohittavat kohteen tai se ei saa rich result -tulosta, joten korjaa ne ensin. Varoitukset koskevat yleensä suositeltuja kenttiä, ja niiden lisääminen voi parantaa tuloksen ulkoasua.
  • JSON-LD-avainsanojen kirjainkoolla on merkitystä: @type toimii, mutta @Type ei.
  • Käytä url-, image- ja logo-kentissä absoluuttisia URL-osoitteita sekä ISO 8601 -päivämääriä, kuten 2026-09-25 tai 2026-09-25T10:00:00+02:00.
  • Työkalu lukee palvelimen palauttaman HTML:n. JavaScriptin myöhemmin selaimessa lisäämää JSON-LD:tä ei löydetä.