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

Szakácskönyv

Organization schema és sameAs: mi a helyes minimum

A cél nem a sok mező, hanem az egyértelműen azonosítható identitás: egy node — vagyis a jelölés egyetlen összefüggő egysége —, 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 a külső forrásokból jövő megerősítés külön eljárás; ide az tartozik, ami a saját oldalaid kódjában dől el.

Organization schema és sameAs — az eljárás

Az AVE Studio eljárása: 6 lépés, sorrendben — mindegyik önmagában is ellenőrizhető. Utoljára frissítve: 2026. augusztus 9..

  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 dokumentumok közti `@id`-hivatkozás 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 rád igaz: `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 név és a márkanév közötti 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 nem létező vagy törölt elemre mutató `sameAs` rosszabb, mint a hiányzó: megszakadt identitás-állítás, ami az egész node-ra visszaüt. Ezt magunkon mértük: az egyik testvéroldalunk két olyan azonosítót tüntetett fel, amelyet közben töröltek, és a javítás azért nem ért el odáig, mert a szabály csak egy kódba írt megjegyzésben létezett, és csak egyetlen kódtárra vonatkozott.

    Kettő: a kanonikus alakot használd. Ha a webhelyed kanonikus alakja `www.`-vel van, 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, amelyre hivatkozik, ne csak egy azonosítócsonkot. Ez elsőre feleslegesnek tűnik, és az is — de ez az egyetlen alak, ami akkor is működik, ha az olvasó egy aloldalon lép be. A többi node (cikk, breadcrumb, FAQ) hivatkozhat rá `@id`-vel ugyanazon a dokumentumon belül; a dokumentumok között viszont ne számíts rá, hogy a gép összefűzi őket.

  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 csak a keresőben megjelenő bővített találat feltétele, 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ágtartalmát neked kell ellenőrizned.

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

    A jelölést egy helyről generáld, 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 jelez, 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.

Organization schema és sameAs — gyakori kérdések

5 kérdés, ami a recept alkalmazása közben a leggyakrabban felmerül. A válaszok ugyanazt a hatókört tartják, mint a lépések: amit az AVE Studio nem tud, azt kimondja.

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 vagy, az `Organization` mindig helyes: a túl konkrét, de pontatlan típus rosszabb, mint az á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 felhasznált 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: 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ást megtartani a legrosszabb megoldás: az már nem hiány, hanem hamis állítás.

Organization schema és sameAs — 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