Strukturált adatok Szakszó

@id (entitás-azonosító a sémában)

Szerző: · 8 perc olvasás · Frissítve:
@id (entitás-azonosító a sémában) - Strukturált adatok (szakszó) a tudástárban
@id (entitás-azonosító a sémában) - Strukturált adatok | eClick GEO-audit tudástár

Az @id a JSON-LD-ben egy stabil, egyedi azonosító, amellyel megnevezed a sémában leírt entitást, hogy később és máshonnan is ugyanarra a dologra lehessen hivatkozni. Gyakorlatilag egy URI, ami azt mondja: „ez a szervezet itt ugyanaz, mint amelyik a másik oldal sémájában szerepel”.

Hogyan működik

A JSON-LD gráf-alapú formátum. Minden csomópont egy entitás: egy szervezet, egy termék, egy cikk, egy személy. Ha nem adsz @id-t, a csomópont névtelen marad. Egy névtelen csomópontot a feldolgozó nem tud biztosan összekötni egy másik oldalon lévő csomóponttal.

Az @id értéke egy URI. A gyakorlatban a legtöbben a saját domainjükön lévő horgony-címet használják, például https://pelda.hu/#organization. Ez nem kell, hogy megnyitható oldal legyen. Az a dolga, hogy globálisan egyedi és időben állandó maradjon. Ha ugyanazt az @id-t használod az aloldalakon is, a feldolgozó egyetlen entitásként látja a szervezetet az egész oldalon.

Mire jó a hivatkozás

Az @id másik fele a hivatkozás. Egy Article séma publisher mezőjébe nem kell újra bemásolnod a teljes szervezet-blokkot. Elég egy {"@id": "https://pelda.hu/#organization"} utalás. A @graph blokkon belül így épül fel a séma-hálózat felesleges ismétlés nélkül.

Miért számít a generatív keresőknek

Egy nyelvi modell és egy tudásgráf ugyanazzal a problémával küzd: melyik „Kovács Kft.” melyik. A Knowledge Graph entitás-feloldást végez, és ehhez azonosítókra támaszkodik. Az @id a belső horgony, a sameAs a külső bizonyíték. A kettő együtt adja meg, hogy a márkád egy konkrét, létező entitás, nem egy szövegdarab.

A riportokban ezt látjuk: a magyar KKV-oldalak többségén van Organization séma, de @id nélkül. Ilyenkor minden aloldal új, névtelen szervezetet deklarál. Ez nem hiba a validátorban, de az összekapcsolás elmarad.

Mikor számít igazán

  • Többoldalas site, ahol a szervezet több helyen is szerepel a sémában.
  • Ha cikkeket, termékeket vagy eseményeket kötsz a kiadóhoz.
  • Ha több telephelyed vagy több márkád van ugyanazon a domainen.

Röviden: az @id az a horgony, amivel a gép biztosan tudja, hogy két helyen ugyanarról az entitásról beszélsz.

Miért fontos

SEO-oldalról

A Google strukturált adat dokumentációja több helyen is @id-alapú hivatkozást használ a példáiban. A gazdag találatok megjelenéséhez nem kötelező, de a séma konzisztenciáját erősíti. Egy jól összekötött gráfból kevesebb az ellentmondás, például a kiadó nevében vagy a logóban.

AI-értelmezhetőség

A generatív keresők entitásokban gondolkodnak, nem kulcsszavakban. Ha a szervezeted azonosítható entitás, nagyobb eséllyel kerül be egy összefoglalóba forrásmegjelöléssel. Ha csak névtelen csomópont, a modell a szöveges környezetre hagyatkozik. Az azonos nevű cégek esetén ez összemosódáshoz vezet.

Üzletileg

A hatás alacsony és közvetett. Nem ettől lesz forgalmad. Viszont olcsó: egyszeri kódmunka, utána magától él. Egy hitelesen azonosított márka mellé az AI könnyebben teszi oda a helyes elérhetőséget és a helyes weboldalt.

Kikre vonatkozik

  • Minden oldal, ahol van JSON-LD. Ha nincs séma, előbb az Organization és a WebSite séma a feladat.
  • Többoldalas site-ok, blogok, webshopok. Itt hoz a legtöbbet, mert sok helyen kell ugyanarra a szervezetre hivatkozni.
  • Több telephelyes vagy több márkás cégek. Külön @id kell minden önálló entitásnak.

Kevésbé releváns:

  • Egyoldalas landing. Egy séma-blokk, egy entitás: az @id itt formaság.
  • Staging és fejlesztői környezet. Ott a noindex, meta robots és X-Robots-Tag a fontosabb, és az @id amúgy sem az éles domainre mutatna.
  • Belső, jelszavas felületek. Ezeket a robotok nem látják.

Hogyan ellenőrzöd

  1. Nyisd meg az oldalt, és nézd meg a forrást. Böngészőben Ctrl+U, vagy devtools Elements fül.
  2. Keresd az application/ld+json típusú script blokkokat.
  3. Parancssorból gyorsabb: curl -s https://pelda.hu | grep -A5 'ld+json'.
  4. Nézd meg, van-e @id kulcs a szervezet-csomóponton.
  5. Nyiss meg egy másik aloldalt, és hasonlítsd össze. Ugyanaz az @id érték szerepel?
  6. Futtasd le a Rich Results tesztet és a schema.org validátort. Ezek mutatják a felismert entitásokat.

Jó jel

  • A szervezetnek van @id-ja, és az minden aloldalon azonos.
  • A hivatkozások {"@id": "..."} formában utalnak vissza, nem duplikálják a teljes blokkot.
  • Az @id abszolút URL, HTTPS-sel, a saját domainen.
  • A szervezethez tartozik sameAs tömb is.

Rossz jel

  • Nincs @id sehol, csak névtelen csomópontok.
  • Az @id aloldalanként más, vagy a plugin generálja véletlenszerűen.
  • Az érték relatív út, például #organization önmagában.
  • Az @id HTTP-s, miközben az oldal HTTPS. Két külön azonosítónak számít.

Hogyan javítod

A cél minden CMS-en ugyanaz: a szervezet kapjon állandó @id-t, és mellé sameAs hivatkozásokat a social profilokra és a Wikidata-lapra, ha van.

WordPress

  1. Ha Yoast SEO vagy Rank Math fut, az @id automatikus. Ellenőrizd a forrásban.
  2. Yoast: Beállítások, Oldal ábrázolása. Add meg a cégnevet, a logót és a social URL-eket.
  3. Rank Math: Általános beállítások, Social Meta. Ugyanez.
  4. Ha kézzel írod a sémát, a functions.php-ben vagy egy snippet-pluginban wp_head hookkal add ki a blokkot.
  5. Fontos: ne legyen két séma-forrás. Ha a téma is kiad szervezet-sémát, kapcsold ki az egyiket.

Shopify

  1. A theme.liquid fájlba, a </head> elé tedd a JSON-LD blokkot.
  2. Az @id legyen {{ shop.url }}#organization formában.
  3. A social linkeket a beállításokból vagy a settings_schema.json-ból húzd be.
  4. Ha SEO-app generálja a sémát, előbb nézd meg, mit ad ki, hogy ne duplázz.

Unas

  1. Admin, Kinézet, Szerkeszthető HTML részek. Keresd a fejlécbe illeszthető mezőt.
  2. Ide tedd be a teljes @graph blokkot állandó @id értékkel.
  3. A beépített séma-kimenetet hagyd békén, csak a szervezet-blokkot egészítsd ki.

Shoprenter

  1. Admin, Megjelenés, Sablonkezelő. A head sablonrészbe illeszd a JSON-LD-t.
  2. Ha egyedi sablont használsz, a Twig fájlban helyezd el.
  3. Ellenőrizd, hogy a beépített termék-séma nem ad ki külön, ellentmondó szervezet-adatot.

Egyedi fejlesztés

  1. A séma-generálást tedd egy helyre, egy komponensbe vagy service-be.
  2. Az @id értékét konfigurációból olvasd, ne hardkódold aloldalanként.
  3. Használj @graph szerkezetet, és hivatkozz @id-vel a kiadóra.
  4. Írj egy egyszerű tesztet, ami két különböző oldalon ellenőrzi az azonos @id-t.
  5. Deploy után futtass Rich Results tesztet.

Mit néz ebből a riport

Az audit megnézi, hogy a szervezet-sémában szerepel-e @id, és vannak-e sameAs hivatkozások. A szabály hatása alacsony, hatóköre kód. Az ajánlás egyszerű: adj a szervezet-sémához @id-t és sameAs-hivatkozásokat, hogy az AI biztosabban azonosítsa a márkát.

Gyakori hibák

  • Hiányzó @id a szervezetnél. Minden aloldal új, névtelen entitást hoz létre, semmi nem kapcsolódik össze.
  • Oldalanként változó @id. Néhány plugin az aktuális URL-ből generálja, így ahány oldal, annyi „cég”.
  • Relatív érték. A puszta #organization nem URI, a feldolgozó nem tudja feloldani.
  • HTTP és HTTPS keveredése. A két változat két különböző azonosító, akkor is, ha a kanonikus cím rendben van.
  • Teljes blokk másolása hivatkozás helyett. A szervezet-adatok szétcsúsznak, és egy névváltozás után ellentmondásos séma marad.
  • Domainváltáskor elfelejtett frissítés. A régi domainre mutató @id elvágja az entitást a jelenlegi oldaltól.
  • sameAs nélküli @id. Belső horgony külső bizonyíték nélkül: a Knowledge Graph nem tud mihez kötni.

Technikai példa

Szervezet állandó @id-vel és sameAs hivatkozásokkal, @graph szerkezetben:

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://pelda.hu/#organization",
      "name": "Példa Kft.",
      "url": "https://pelda.hu/",
      "logo": "https://pelda.hu/logo.png",
      "sameAs": [
        "https://www.facebook.com/pelda",
        "https://www.linkedin.com/company/pelda",
        "https://www.wikidata.org/wiki/Q000000"
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://pelda.hu/#website",
      "url": "https://pelda.hu/",
      "name": "Példa Kft.",
      "publisher": { "@id": "https://pelda.hu/#organization" }
    }
  ]
}

A publisher mezőben csak egy hivatkozás áll. A szervezet adatai egyszer szerepelnek, mégis minden csomópont eléri őket.

Gyors ellenőrzés parancssorból, hogy megjelenik-e az @id a kiadott HTML-ben:

curl -s https://pelda.hu/ | grep -o '"@id":"[^"]*"' | sort -u

A kimenetben ugyanazoknak az azonosítóknak kell szerepelniük minden aloldalon. Ha oldalanként mások, a generálás hibás.

Gyakori kérdések

Kell, hogy az @id megnyitható URL legyen?
Nem. Az @id azonosító, nem cím. A horgony-formátum, például https://pelda.hu/#organization, pont azért terjedt el, mert egyedi és nem ütközik valódi oldallal. Az a lényeg, hogy abszolút, egyedi és állandó legyen.
Mi a különbség az @id és a sameAs között?
Az @id a te saját azonosítód az entitásra, a saját domaineden. A sameAs külső hivatkozás: megmutatja, hogy ugyanez az entitás hol szerepel máshol, például a Facebookon vagy a Wikidatán. Az egyik belső horgony, a másik külső bizonyíték. Együtt működnek jól.
Hoz ez több forgalmat?
Közvetlenül nem. A hatása alacsony, és inkább az entitás-felismerést javítja. Ha viszont a márkádat AI-válaszokban is emlegetik, a pontos azonosítás számít. Olcsó, egyszeri munka, ami utána magától működik.
A WordPress SEO-pluginom már kiadja. Kell vele bármit csinálnom?
Ellenőrizd a forrásban, hogy tényleg szerepel-e @id, és két aloldalon azonos-e. Nézd meg azt is, hogy nem ad-e ki a téma egy második, párhuzamos szervezet-sémát. Duplikált séma esetén az egyiket kapcsold ki.
Mi történik, ha domaint váltok?
Az @id értékét frissítened kell az új domainre. A régi azonosító egy másik entitást jelöl, ezért az összekapcsolás megszakad. Érdemes a 301-es átirányítások mellett a sémát is átnézni.

Források

Kapcsolódó fogalmak

A te oldaladon hogy áll a(z) „@id (entitás-azonosító a sémában)”?

Futtass egy GEO-auditot: pontszám, fejlesztői ítélet, a leggyorsabb javítások, és minden tételhez bizonyíték.

Ingyenes GEO-audit indítása