Ugrás a tartalomra
AVE StudioÜgynökségeknekENHU

Szakácskönyv

Organization schema és sameAs: a minimális helyes gráf

A cél nem a sok mező, hanem egy feloldható identitás: egy node, egy azonosító, és csak olyan sameAs, ami tényleg létezik.

Frissítve ·

Az Organization JSON-LD-t a legtöbb helyen mezőlistaként tanítják: töltsd ki a nevet, a logót, a címet, és kész. A gépi olvasás szempontjából viszont nem a mezők száma számít, hanem hogy a jelölés egyetlen, azonosítható dolgot ír-e le, következetesen, minden oldalon. Egy hiányos, de koherens gráf sokkal többet ér, mint egy gazdag, de önmagával vitatkozó. Ez a recept a minimális helyes alakot viszi végig, aztán azokat a hibákat, amelyek nem egy mezőt rontanak el, hanem az egész entitás megbízhatóságát — mert ezek a drágák. A névválasztás és az off-site megerősítés külön eljárás; ide az tartozik, ami a saját oldalaid kódjában dől el.

Az eljárás

  1. Egy Organization node legyen, egy stabil @id-vel

    Adj a szervezetnek egy `@id`-t — jellemzően a gyökér-URL plusz egy horgony, például `https://pelda.hu/#org` —, és MINDEN oldalon pontosan ezt használd. Az `@id` az, ami a különböző oldalakon lévő jelöléseket egyetlen entitásként fűzi össze. Ha oldalanként más azonosítót adsz, nem egy céget írtál le sokszor, hanem sok céget egyszer. Fontos korlát: a kereszt-dokumentum `@id` nem működik úgy, ahogy sokan remélik — a crawler minden URL-t önmagában olvas, tehát ha egy oldalon csak egy csonk node-ot hagysz azzal, hogy „a részletek a főoldalon vannak”, akkor annak az oldalnak az olvasója számára a csonk MAGA az entitás.

  2. Tedd bele a minimumot, és csak az igazat

    A gyakorlati minimum: `name`, `url`, `logo`, `description`, és ami releváns — `address`, `email`, `foundingDate`, `numberOfEmployees`. Egy mezőt sem kell kitalálni: a hiányzó adatot a gép kihagyja, a valótlan viszont az egész node hitelét viszi. A `name` mezőben a kanonikus forma álljon, ugyanaz, amit a látható szövegben és minden más felületen használsz — a jogi és a márkanév közti eltérést a `legalName` és az `alternateName` kezeli, nem az, hogy hol ezt, hol azt írod.

  3. A sameAs csak létező, hiteles profilokra mutasson

    A `sameAs` azt állítja: „ez a másik URL is ugyanez az entitás”. Ide a hivatalos profiljaid mennek — közösségi oldalak, szakmai adatbázisok, entitás-nyilvántartások. Két szabály. Egy: minden URL legyen élő és a tiéd; egy nemlétező vagy törölt elemre mutató `sameAs` ROSSZABB, mint a hiányzó, mert törött identitás-állítás, ami az egész node-ra visszaüt. Ezt magunkon mértük: egy testvér-domainünk két olyan azonosítót hirdetett, amit közben töröltek, és a javítás azért nem ért el odáig, mert a szabály kódkommentben élt, a hatóköre meg egy repó. Kettő: a kanonikus alakot használd — ha a site `www.`-vel kanonikus, a `sameAs`-ban is az álljon, ne egy átirányításra mutató változat.

  4. Ne szórd szét a gráfot dokumentumok közé

    Minden oldal vigye a TELJES node-ot, amire hivatkozik, ne csak egy azonosító-csonkot. Ez elsőre redundánsnak tűnik, és az is — de az egyetlen alak, ami minden belépési ponton működik. A többi node (cikk, breadcrumb, FAQ) hivatkozhat rá `@id`-vel ugyanazon a dokumentumon belül; a dokumentumok KÖZÖTT viszont ne feltételezz összeolvasztást.

  5. Validálj, de ne a validátornak írj

    Futtasd le a jelölést egy strukturáltadat-ellenőrzőn, és javítsd, amit hibaként jelez. Amit viszont ne csinálj: ne tegyél bele mezőt csak azért, mert a validátor „ajánlottként” jelöli. Az ajánlott mezők egy része rich-result feltétel, nem minőségi mérce, és egy kitalált érték a validátort megnyugtatja, az entitásodat viszont rontja. A validátor a szintaxist ellenőrzi; az igazságtartalmat neked kell.

  6. Kösd egy forráshoz, és őrizd kapuval

    A jelölés egy helyről generálódjon, ne oldalanként kézzel. Utána tegyél mellé egy ellenőrzést, ami a kiszolgált HTML-ből olvassa vissza a node-ot, és bukik, ha a `sameAs` új, ismeretlen URL-t kap, vagy ha az `@id` eltér. A kézzel karbantartott gráf nem attól romlik el, hogy nehéz, hanem attól, hogy három ember három oldalon máshogy javítja.

Gyakori kérdések

Melyik típust használjam: Organization vagy valami konkrétabb?
Használd a legpontosabb altípust, amelyik igaz rád — például `ProfessionalService` vagy `LocalBusiness`, ha helyhez kötött szolgáltatás vagy. Ha bizonytalan, az `Organization` mindig helyes; egy túl konkrét, de pontatlan típus rosszabb, mint egy általános, de igaz. Több típust is megadhatsz tömbként, ha tényleg mindkettő áll.
Hány sameAs kell?
Nincs jó szám, és a mennyiség nem cél. Annyi, ahány valóban a tiéd, él, és hitelesíthető. Öt valódi profil többet ér, mint húsz, amiből tizenöt elhagyott vagy más cégé. A `sameAs` nem linképítés: minden elem egy állítás, amiért helyt kell állni.
Minden oldalra kell Organization?
Ahol a szervezet a kiadó vagy a szerző, oda igen — és teljes node-ként, nem csonkként. A crawler minden URL-t külön olvas, tehát ha valaki egy aloldalon lép be, annak az oldalnak a jelölése az egyetlen, amit lát. Ez redundáns, és pont ezért működik.
A logó és a cím kötelező?
Nem kötelező, de a `logo` és az `address` a leggyakrabban hasznosított mezők közé tartozik, és mindkettő ellenőrizhető tény — tehát olcsó és biztonságos. Ha nincs fizikai címed, ne találj ki egyet: a hiányzó mező semleges, a valótlan viszont az egész node megbízhatóságát rontja.
Mit tegyek, ha egy sameAs cél megszűnt?
Vedd ki, és ne pótold kitalált azonosítóval. Ha egy nyilvántartásban már nincs elemed, akkor a kanonikus URL-ed a horgony — ez a helyes állapot, nem hiányosság. A törölt elemre mutató hivatkozás megtartása a legrosszabb opció: aktívan hamis állítás.

Források

  1. schema.org — Organization típus. https://schema.org/Organization
  2. schema.org — sameAs tulajdonság. https://schema.org/sameAs
  3. Google — strukturált adatok általános irányelvei. https://developers.google.com/search/docs/appearance/structured-data/sd-policies