FAQ Schema generátor

A schema leírás strukturált adat: rövid, gépek számára is egyértelmű jelölés arról, hogy egy oldal tartalma mit jelent. FAQ esetén például nemcsak szövegként szerepelnek a kérdések és válaszok, hanem a keresők és más rendszerek számára is felismerhető FAQPage formában.

Előnye, hogy pontosabb kontextust ad a tartalomról, segíti az értelmezést, és csökkenti annak esélyét, hogy egy algoritmus félreolvassa az oldal szerkezetét. Ez főleg keresőoptimalizálásnál, rich result ellenőrzésnél, tartalomfeldolgozásnál és AI-alapú rendszereknél jelentkezik.

Hasonló célt szolgálhat az llms.txt is: iránytűként segíthet a nagy nyelvi modelleknek abban, hogy egy webhely fontos oldalait, dokumentációját vagy ajánlott forrásait könnyebben megtalálják. A schema és az llms.txt együtt tisztább, gépek számára is értelmezhetőbb webes jelenlétet ad.

Ajánlott megoldás: közvetlen beillesztés az oldal HTML-kódjába

A generált FAQ Schema ajánlott formája a JSON-LD tartalom script elembe ágyazva:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage"
}
</script>

Ezt az adott oldal HTML-forrásába kell beilleszteni, lehetőleg a head részbe vagy a body végére.

• A head részbe és a body végére történő beillesztés egyaránt elfogadható.
• A kód nem jelenik meg látható tartalomként az oldalon.
• A strukturált adatnak ugyanazon az oldalon kell szerepelnie, ahol a látható FAQ található.

Beillesztés tartalomkezelő rendszerben

A legtöbb tartalomkezelő rendszer biztosít egyedi HTML-, kód- vagy script-beillesztési lehetőséget. Ilyenkor a teljes <script type="application/ld+json">...</script> blokkot kell beilleszteni. Nem elegendő pusztán a nyers JSON-t látható szövegként elhelyezni az oldalon.

Beillesztés sablonba vagy forráskódba

Fejlesztői hozzáférés esetén a kód bekerülhet az oldal sablonjába, a konkrét oldal forráskódjába, vagy egy olyan komponensbe, amely csak azon az oldalon tölti be a sémát, ahol a FAQ ténylegesen megjelenik.

Külső JSON-fájl használata

Letölthető vagy archiválási célra a külön .json fájl hasznos lehet. A keresőmotorok számára azonban az ajánlott megoldás az oldal HTML-jébe ágyazott JSON-LD, ezért ne csak egy külső fájlra mutató linket helyezz el.

Fontos tartalmi szabályok

• Csak olyan kérdés és válasz kerüljön a sémába, amely az oldalon látható.
• A JSON-LD és a látható FAQ tartalma legyen összhangban.
• Ne legyen ugyanazon az oldalon több, egymással versengő vagy duplikált FAQPage definíció.
• Módosítás esetén a látható FAQ-t és a JSON-LD-t együtt kell frissíteni.

A legegyszerűbb és legbiztosabb megoldás: másold be a teljes script blokkot az adott oldal HTML-kódjába.

Első ellenőrzés: JSON szintaxis

A generátor beépített előnézetében ellenőrizd a kérdések számát és tartalmát. Figyelj a hiányzó vagy üres kérdésekre, arra, hogy a válaszok ne legyenek levágva, és arra is, hogy a JSON szintaktikailag érvényes legyen.

Második ellenőrzés: oldal forráskódja

Publikálás után nyisd meg az oldalt a böngészőben, jelenítsd meg az oldal forráskódját, majd keress rá az application/ld+json vagy FAQPage kifejezésre. Ellenőrizd, hogy a teljes blokk valóban bekerült-e az oldalba, és hogy ugyanaz a FAQ schema csak egyszer szerepel-e.

Harmadik ellenőrzés: Schema.org Validator

A Schema.org Validator az oldal URL-je vagy a teljes kód alapján is tud ellenőrizni. A hibákat javítani kell, a figyelmeztetéseket pedig egyenként érdemes értékelni. Ez az eszköz a Schema.org szerkezeti megfelelőségét vizsgálja.

Negyedik ellenőrzés: Google Rich Results Test

A Google Rich Results Test URL vagy kód alapján tesztelhető. Ellenőrizhető vele, hogy a Google felismeri-e a strukturált adatot. Attól, hogy a jelölés érvényes, még nem garantált különleges keresési megjelenés, de a teszt eredményét ettől függetlenül érdemes hibamentesre javítani.

Ötödik ellenőrzés: látható tartalom és schema összevetése

A kérdések sorrendje lehetőleg egyezzen. Minden schema-kérdés legyen látható az oldalon, minden válasz tartalmilag egyezzen, és rejtett, csak keresőmotornak szánt tartalom ne kerüljön bele.

Hatodik ellenőrzés: gyorsítótár és CDN

Módosítás után szükség lehet az oldal- vagy szervercache ürítésére. CDN használata esetén annak cache-ét is frissíteni kell, ezután pedig újra kell futtatni az ellenőrzést.

Hetedik ellenőrzés: módosítás utáni karbantartás

Új kérdés hozzáadásakor a sémát is újra kell generálni. Törölt kérdést a JSON-LD-ből is el kell távolítani, és időnként érdemes újra validálni az oldalt.

Bevezető

Elementor Pro használata esetén a FAQ JSON-LD kódot célszerű a Custom Code funkcióval beilleszteni. Így a strukturált adat elkülönül az oldal látható tartalmától, és megjelenési feltétellel csak a megfelelő oldalon tölthető be.

• A generátor „beilleszthető script blokk” kimenetét kell használni.
• A teljes <script type="application/ld+json">...</script> blokkot kell bemásolni.
• Nem elegendő kizárólag a kapcsos zárójelek közötti nyers JSON-t látható szövegként elhelyezni.
• A kód nem jelenik meg látható tartalomként az oldalon.

Lépésről lépésre

1. Jelentkezzen be a WordPress adminisztrációs felületére.
2. Nyissa meg az „Elementor” menüt.
3. Válassza a „Custom Code” vagy magyar felületen az „Egyéni kód” menüpontot.
4. Kattintson az új kód létrehozására.
5. Adjon neki könnyen felismerhető nevet, például: „LexVault FAQ Schema”.
6. A kód helyeként válassza: <body> – End, vagy az adott Elementor-verzióban ennek megfelelő „Body End” lehetőséget.
7. Másolja be a generátor által létrehozott teljes script blokkot.
8. Ne tegyen a blokk köré újabb <script> elemet, ha a generált kimenet azt már tartalmazza.
9. Kattintson a közzétételre vagy publikálásra.
10. Állítsa be a megjelenési feltételt úgy, hogy a kód kizárólag azon az oldalon töltődjön be, amelyen a látható FAQ szerepel.
11. Mentse vagy publikálja a beállítást.
12. Ürítse a WordPress-, szerver- és CDN-gyorsítótárat, ha használ ilyet.
13. Nyissa meg a publikus oldalt kijelentkezett vagy inkognitó böngészőablakban.
14. Ellenőrizze az oldal forrásában az FAQPage vagy application/ld+json kifejezést.
15. Futtassa le a Schema.org Validator és a Google Rich Results Test ellenőrzést.

Kódbeillesztési példa

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": []
}
</script>

Ellenőrzés Elementorban

• A Custom Code listában ellenőrizhető, hogy a kód publikált állapotban van-e.
• Ellenőrizni kell, hogy a megfelelő hely van-e kiválasztva.
• Ellenőrizni kell a megjelenési feltételt.
• A kód előnézete vagy szerkesztője nem feltétlenül mutatja a keresőmotor általi felismerést; ezért a publikus URL-t kell validálni.
• A kódnak a forrásban egyszer kell szerepelnie.
• Ha kétszer szerepel, ellenőrizni kell, hogy nincs-e másik Custom Code, plugin vagy sablon által generált FAQPage schema.

Validáláshoz használd a Schema.org Validator és a Google Rich Results Test eszközöket.

Gyakori hibák

• Csak a nyers JSON került beillesztésre, a script elem nélkül.
• A script blokk kétszer lett körbecsomagolva.
• A kód piszkozat állapotban maradt.
• Nem lett beállítva megfelelő megjelenési feltétel.
• A schema az egész webhelyen betöltődik.
• Az oldal gyorsítótára még a régi változatot szolgálja ki.
• A FAQ látható tartalma és a JSON-LD eltér.
• A látható FAQ módosult, de a schema nem lett újragenerálva.
• Ugyanazon az oldalon több FAQPage definíció szerepel.