JSON-LD

A JSON-LD a legolcsóbb módja annak, hogy a gép ne találgasson az oldaladról.

• Rich result esély: az értékelés-csillag, az ár, a GYIK-harmonika és a morzsamenü a találati oldalon mind strukturált adatból jön.
• Entitás-felismerés: a cégnév, a logó és a profiloldalak összekapcsolása ezen múlik, lásd sameAs.
• AI-válaszok pontossága: a modellnek nem kell a lábléc szövegéből visszafejtenie a telefonszámot.
• Hibatűrés: ha a JSON szintaktikailag hibás, a feldolgozó az egész blokkot eldobja. Nincs részleges pontszám.

A magyar KKV-oldalak többségén vagy egyáltalán nincs JSON-LD, vagy csak egy üres WebSite blokk van, tényleges adat nélkül. Ez ugyanannyit ér, mint a semmi.

Mit néz ebből a riport

Az audit megnézi, van-e egyáltalán application/ld+json blokk a HTML-ben, és lefut-e rajta a JSON-értelmezés. Ellenőrzi a @context és a @type meglétét, és azt, hogy a fontos típusok szerepelnek-e. Ha a blokk hibás szintaxisú, azt külön jelzi, mert az a keresőnél is teljes kiesést jelent.

Minden nyilvános oldalra vonatkozik, de nem mindegyikre ugyanúgy.

• Webshop: kötelező szint. Termékoldalon Product és Offer, a bolt adataira Organization.
• Szolgáltató KKV: Organization vagy LocalBusiness, plusz a kapcsolati adatok.
• Blog, hírportál: Article a szerzővel és a dátummal.
• Egyoldalas bemutatkozó: itt is elég egy jó Organization blokk.

Nem vonatkozik staging- és fejlesztői környezetre, ott a noindex, meta robots és X-Robots-Tag a fontosabb. Zárt, bejelentkezés mögötti felületeken sincs értelme. A kosár- és pénztár-oldalakra sem kell séma.

1. Nyisd meg az oldalt, és nézd meg a forrást a Ctrl+U billentyűvel.
2. Keress rá az application/ld+json szövegre.
3. Másold ki a blokk tartalmát, és futtasd le egy JSON-validátoron.
4. Futtasd le az oldalt a Rich Results teszt eszközzel, ez a renderelt változatot nézi.
5. Nézd meg a Search Console „Fejlesztések” menüpontját, ott látod az élő hibákat és a figyelmeztetéseket.

Jó jel:

• Van legalább egy blokk, és hibátlanul értelmezhető JSON.
• A @type valódi schema.org-típus, nem kitalált szó.
• Az adatok egyeznek a látható tartalommal.
• Egy oldalon nem ismétlődik ugyanaz az entitás többször.

Rossz jel:

• A blokkban PHP- vagy JS-változó maradt, például {{ product.price }}.
• A forrásban nincs semmi, csak a renderelt DOM-ban. Ezt a curl és a devtools összehasonlításával látod.
• Több plugin is kiír Organization blokkot, eltérő adattal.
• Csillagos értékelés van a sémában, de az oldalon nincs vélemény.

WordPress

1. Nézd meg, melyik bővítményed generál sémát. A Yoast, a Rank Math és a SEOPress is ír ki JSON-LD-t.
2. Egyszerre csak egy forrást hagyj aktívan, különben duplikálódik az entitás.
3. Töltsd ki a bővítmény oldalán a cég adatait, a logót és a profil-linkeket.
4. Egyedi típushoz használd a wp_head horgot, és wp_json_encode függvénnyel írd ki az adatot.

Shopify

1. A legtöbb téma alapból kiír Product sémát a termékoldalon.
2. A theme.liquid és a termék-sablon fájljaiban keresd az ld+json blokkot.
3. Ha appot is használsz sémára, kapcsold ki a téma saját kiírását.
4. Az árat és a készletet mindig Liquid-változóból töltsd, ne kézzel.

Unas

1. Ellenőrizd, mit generál a rendszer alapértelmezetten a termékoldalakon.
2. A hiányzó cégadatokat a sablonszerkesztőben, saját HTML-blokkban told be.
3. A blokk a </head> elé vagy a <body> végére is kerülhet, mindkettő érvényes.

Shoprenter

1. A sablonszerkesztőben keresd meg a fejléc-sablont.
2. Illessz be egy saját ld+json blokkot a bolt adataival.
3. Termékoldalon a sablonváltozókat használd, hogy az ár mindig szinkronban legyen.

Egyedi fejlesztés

1. Egyetlen szerveroldali helyen állítsd elő a sémát, ne szórd szét a sablonokban.
2. Használj @graph (több séma egy blokkban) szerkezetet, és kösd össze az entitásokat @id (entitás-azonosító a sémában) értékekkel.
3. Az értékeket ugyanabból az adatforrásból vedd, amiből a látható tartalom jön.
4. Tegyél a CI-be egy egyszerű JSON-parse ellenőrzést a generált oldalakra.

• Hibás JSON szintaxis: egy felesleges vessző miatt az egész blokkot eldobja a feldolgozó.
• Kitöltetlen sablonváltozó: a {{ price }} maradvány a forrásban azt jelenti, hogy soha nem nézte meg senki.
• Duplikált entitás: két bővítmény két különböző cégnevet ír ki, a kereső nem tudja, melyik az igaz.
• Látható tartalom nélküli adat: ha a sémában szereplő ár az oldalon nem jelenik meg, az irányelvsértés.
• Kitalált típusnevek: a @type csak schema.org-ban létező típus lehet, különben figyelmen kívül marad.
• Csak JS-ből beszúrt blokk: a kliensoldali séma késve vagy egyáltalán nem jut el minden feldolgozóhoz.
• Relatív URL-ek: az @id és a url mezőben mindig teljes, abszolút cím kell.

Egy minimális, de használható cégblokk. A @id teszi lehetővé, hogy más entitások hivatkozzanak rá.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://pelda.hu/#organization",
  "name": "Példa Kft.",
  "url": "https://pelda.hu/",
  "logo": "https://pelda.hu/logo.png",
  "telephone": "+36 1 234 5678",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Fő utca 1.",
    "addressLocality": "Budapest",
    "postalCode": "1011",
    "addressCountry": "HU"
  },
  "sameAs": [
    "https://www.facebook.com/pelda",
    "https://www.linkedin.com/company/pelda"
  ]
}
</script>

Így nézed meg, hogy a blokk a nyers HTML-ben is benne van-e, nem csak a renderelt DOM-ban:

curl -s https://pelda.hu/ | grep -c 'application/ld+json'

Ha az eredmény 0, de a devtools Elements fülén látod a blokkot, akkor JavaScript szúrja be. Ez a legtöbb feldolgozónál kockázatos.