Video schema: teljes útmutató

A video schema a VideoObject típusú strukturált adat, amellyel géppel olvasható formában adod meg a keresőnek a videód címét, leírását, bélyegképét, feltöltési dátumát, hosszát és elérési útját. Nem garantál videós találatot, de segít a Google-nek felismerni, indexelni és gazdagabb formában megjeleníteni a videót. A jelölésnek pontosan egyeznie kell az oldalon látható tartalommal.

Alapfogalmak

Mielőtt kódot írnál, érdemes tisztázni, miről beszélünk pontosan. A "video schema" köznapi kifejezés, a valóságban a schema.org szókincs VideoObject típusát jelenti, amelyet leggyakrabban JSON-LD formátumban helyezel el az oldal HTML-jében. A Google ezt az adatot a videó feltérképezésénél és megjelenítésénél használja fel, de mindig összeveti azzal, amit az oldalon ténylegesen lát.

A video schema egy nagyobb témakör része: a Kép és videó SEO területén belül a videók gépi értelmezhetőségéért felel. Ahogy a képeknél az alt szöveg és a képtérkép segít, a videóknál a strukturált adat és a videós oldaltérkép tölti be ezt a szerepet.

Mi az a VideoObject?

A VideoObject egy schema.org típus, amely egyetlen videót ír le. Egy oldalon lehet több is, ha több videó szerepel rajta, de minden egyes jelölésnek egy konkrét, az oldalon látható videóhoz kell tartoznia. A típus a MediaObject leszármazottja, ezért olyan általános médiamezőket is örököl, mint a contentUrl, az embedUrl vagy a duration.

Kötelező és ajánlott tulajdonságok

A Google dokumentációja kötelező és ajánlott mezőket különböztet meg. Kötelező mezők nélkül a jelölés nem jogosult a videós kiemelésekre, az ajánlott mezők pedig a megjelenés minőségét és a funkciók elérhetőségét befolyásolják.

Tulajdonság	Státusz	Mit adsz meg
name	Kötelező	A videó címe, egyezzen a látható címmel
thumbnailUrl	Kötelező	Feltérképezhető bélyegkép URL-je
uploadDate	Kötelező	Első közzététel dátuma ISO 8601 formában, lehetőleg időzónával
description	Ajánlott	Egyedi, a videóra jellemző leírás
duration	Ajánlott	Hossz ISO 8601 formában, például PT4M30S
contentUrl	Ajánlott	A videófájl közvetlen URL-je
embedUrl	Ajánlott	A lejátszó URL-je
expires	Ajánlott	Ha a videó egy időpont után nem lesz elérhető
interactionStatistic	Ajánlott	Megtekintések száma
regionsAllowed	Ajánlott	Mely országokban nézhető

Kapcsolódó típusok

• Clip: a videó egy kézzel megadott szakasza (kezdő és záró másodperc, címke, URL), ebből lesznek a kulcsmomentumok.
• SeekToAction: azt mondja meg a Google-nek, milyen URL-mintával lehet a videó adott pontjára ugrani, így a kereső maga jelölheti ki a szakaszokat.
• BroadcastEvent: élő közvetítés jelzésére, az isLiveBroadcast, startDate és endDate mezőkkel.

Mi nem a video schema?

Gyakori tévhit, hogy a strukturált adat rangsorolási faktor, és ettől előrébb kerül az oldal. A jelölés értelmezést segít, és jogosulttá tesz bizonyos megjelenési formákra, de egy gyenge oldalt nem emel fel. Az sem igaz, hogy YouTube-videó beágyazásakor felesleges: a YouTube a saját oldalát jelöli, a te oldaladon lévő beágyazásról viszont a te jelölésed mond el többet.

Hogyan működik?

A folyamat három szakaszra bontható: a Google megtalálja az oldalt, felismeri rajta a videót, majd eldönti, hogy videós találatként kezeli-e. A strukturált adat mindhárom lépésnél segít, de egyiknél sem helyettesíti a jó alapokat.

1. Feltérképezés és videófelismerés

A Googlebot letölti az oldalt, és megpróbálja azonosítani rajta a videót. Ezt megteheti a HTML-ből (video, iframe, object elem), a strukturált adatból vagy a videós oldaltérképből. Ha a lejátszó csak felhasználói interakció után töltődik be, vagy egy olyan JavaScript hozza létre, amelyet a renderelés nem futtat le, a videó láthatatlan maradhat. Ilyenkor a VideoObject jelölés legalább egyértelműen jelzi, hogy van videó, és hol éri el.

2. A jelölés összevetése a tartalommal

A Google nem vakon hisz a jelölésnek. Ha a name mást mond, mint az oldalon látható cím, ha a bélyegkép nem tölthető le, vagy ha a jelölt videó nincs is az oldalon, a jelölés figyelmen kívül maradhat, súlyosabb esetben kézi intézkedést is kockáztatsz. Az alapelv: csak azt jelöld, amit a látogató is lát.

3. Videóoldal-e az oldal?

A Google az utóbbi időben egyre inkább azokat az oldalakat kezeli videós találatként, ahol a videó a fő tartalom, nem pedig egy blogbejegyzés aljára tett kiegészítés. Ez gyakorlati döntési szabályt ad:

• Ha a videó az oldal célja (oktatóvideó, termékbemutató saját oldalon, webinárfelvétel), jelöld, és helyezd jól látható pozícióba a hajtás felett.
• Ha a videó csak illusztráció egy hosszú szöveg közepén, a jelölés továbbra is helyes, de ne számíts arra, hogy videós találatként jelenik meg.
• Ha egy oldalon tíz videó van egyformán, valószínűleg egyik sem lesz "fő videó"; érdemes inkább külön videóoldalakat készíteni.

4. Megjelenítés

Ha minden stimmel, a videó megjelenhet a fő találati oldalon bélyegképpel és hosszal, a Videók fülön, a Google Képekben, illetve kulcsmomentumokkal. Hogy melyik formában, azt a Google dönti el a lekérdezés és az eszköz alapján. A jelölés tehát jogosultságot ad, nem garanciát.

Szemléltető példa egy teljes jelölésre

Tegyük fel, hogy egy kerékpárszervized van, és készítettél egy 6 perc 12 másodperces videót a lánc tisztításáról. A videót saját szerveren tárolod, a lejátszót beágyazod. A jelölés vázlata (szemléltető, a URL-ek kitaláltak):

• @type: VideoObject
• name: Kerékpárlánc tisztítása otthon, lépésről lépésre
• description: Hogyan tisztítsd és kend meg a láncot 10 perc alatt, alap szerszámokkal
• thumbnailUrl: https://pelda.hu/kepek/lanc-tisztitas.jpg
• uploadDate: 2026-09-14T08:00:00+02:00
• duration: PT6M12S
• contentUrl: https://pelda.hu/video/lanc-tisztitas.mp4
• embedUrl: https://pelda.hu/lejatszo/lanc-tisztitas

Ezt JSON-LD script blokkba írod az oldal head vagy body részébe. A sorrend nem számít, a pontosság igen.

Fő módszerek

A video schema bevezetésére több út létezik, és a választás attól függ, hol tárolod a videót, milyen rendszeren fut az oldal, és mennyi videód van. Az alábbiakban a gyakorlatban használt módszereket veszem sorra, a végén egy döntési táblázattal.

Kézi JSON-LD

Kevés videónál a legegyszerűbb, ha minden videóoldalra kézzel írod meg a jelölést. Előnye a teljes kontroll: minden mezőt pontosan a videóhoz igazítasz. Hátránya, hogy minden módosításnál (új bélyegkép, átnevezett videó) neked kell frissíteni. Tíz videó alatt jól működik, efölött könnyen elcsúszik a jelölés és a tartalom.

Sablonból generált jelölés

Ha a videók egy adatbázisban vagy CMS-ben vannak (cím, leírás, hossz, fájl URL mezőkkel), a jelölést a sablon tölti ki automatikusan. Ez skálázható és következetes, mert a látható cím és a jelölt cím ugyanabból a mezőből jön. A hiba itt rendszerszintű: ha a sablon rossz, minden oldal rossz, ezért az első néhány generált oldalt mindenképp ellenőrizd tesztelővel.

Bővítmények és lejátszók beépített jelölése

Sok CMS-bővítmény és videóplatform ad saját jelölést. Ez kényelmes, de két kockázata van: egyrészt duplikált VideoObject keletkezhet, ha a bővítmény és a lejátszó is jelöl, másrészt a generált mezők hiányosak lehetnek (például hiányzik a duration vagy a description üres). Bekapcsolás után nézd meg a forráskódot, hány VideoObject szerepel az oldalon.

Videós oldaltérkép mint kiegészítés

A videós sitemap nem helyettesíti a strukturált adatot, hanem kiegészíti: segít, hogy a Google megtalálja a videóoldalakat, különösen ha sok van belőlük, vagy nehezen elérhetők belső linkekkel. A logika ugyanaz, mint a képeknél, ezt részletesen az Image sitemap: teljes útmutató írja le.

Kulcsmomentumok: Clip vagy SeekToAction

Ha azt szeretnéd, hogy a videód szakaszai külön megjelenhessenek, két út van:

1. Clip: te adod meg a szakaszokat (például "Lánc lemosása, 0:45-től 2:10-ig"). Akkor jó, ha pontos, emberi címkéket akarsz, és kevés videód van.
2. SeekToAction: megadod az URL-mintát (például ?t={seek_to_second_number}), és a Google maga azonosítja a szakaszokat. Akkor jó, ha sok videód van, és a lejátszó támogatja az időpontra ugrást URL-paraméterrel.

A kettőt egy videón belül ne keverd; válassz egyet. Mindkettőnek feltétele, hogy a lejátszó ténylegesen a megadott pontra ugorjon.

Döntési táblázat

Helyzet	Javasolt módszer
1-10 videó, egyedi oldalak	Kézi JSON-LD, szükség esetén Clip
Videótár CMS-ben, tucatnyi vagy több videó	Sablonból generált jelölés, videós sitemap, SeekToAction
Csak YouTube-beágyazás	Saját VideoObject az embedUrl megadásával, egyedi leírással
Élő közvetítés	VideoObject + BroadcastEvent
Időkorlátos videó (pl. kampány)	expires mező, lejárat után a jelölés eltávolítása

A bélyegkép mint külön feladat

A thumbnailUrl kötelező, és a megjelenés első benyomása is ezen múlik. Legyen feltérképezhető (ne tiltsa robots.txt), legyen jó felbontású, és támogatott formátumú. A képoptimalizálás általános szabályai itt is érvényesek, ezekről a Kép SEO: teljes útmutató és a formátumválasztásnál a WebP: teljes útmutató ad részletes fogódzót.

Gyakori hibák

A video schema hibáinak nagy része nem szintaktikai, hanem tartalmi: a kód formailag hibátlan, mégsem hoz eredményt. Az alábbi lista azokat a buktatókat gyűjti, amelyekkel a leggyakrabban találkozni, mindegyikhez megadva a javítás módját.

1. A jelölt videó nincs az oldalon

Előfordul, hogy egy sablon minden kategóriaoldalra beteszi ugyanazt a VideoObjectet, pedig a videó csak egy aloldalon szerepel. Ez félrevezető jelölés. Javítás: a jelölés csak ott jelenjen meg, ahol a lejátszó ténylegesen betöltődik.

2. Elérhetetlen bélyegkép

A thumbnailUrl relatív útvonal, lejárt aláírású CDN-link, vagy egy robots.txt által tiltott mappában van. A Search Console ilyenkor jellemzően jelzi, hogy a bélyegkép nem érhető el. Javítás: abszolút, stabil, feltérképezhető URL.

3. Rossz dátum- és időformátum

A "2026.09.14" vagy a "6:12" formátum nem érvényes. Az uploadDate ISO 8601 dátum legyen, lehetőleg időzónával, a duration pedig PT6M12S alakú. Apró hiba, de érdemes sablonszinten ellenőrizni, mert minden oldalt érint.

4. Másolt vagy üres leírás

Ha minden videó leírása "Nézd meg legújabb videónkat!", a mező nem ad információt. Írj egyedi, egy-két mondatos leírást, amely a videó tényleges tartalmát foglalja össze. Ugyanez a gondolkodás érvényes, mint egy jó képleírásnál, erről az Alt text: teljes útmutató részletesebben szól.

5. Duplikált jelölés

Bővítmény, téma és beágyazott lejátszó egyszerre jelöli ugyanazt a videót, eltérő adatokkal. A Google nem fogja tudni, melyik a hiteles. Javítás: egy forrás maradjon, a többit kapcsold ki.

6. A videó a hajtás alatt, rejtve

Fülre kattintva előjövő, harmonikába rejtett vagy csak görgetés után lusta betöltéssel megjelenő videó esetén a Google nehezen tekinti az oldalt videóoldalnak. Ha a videó a fő tartalom, legyen azonnal látható.

7. Kulcsmomentumok működő ugrás nélkül

SeekToAction van megadva, de a lejátszó figyelmen kívül hagyja a ?t= paramétert, vagy a Clip időpontjai nem egyeznek a videóval. Ilyenkor a felhasználó rossz helyre érkezik. Javítás: kézzel nyiss meg három-négy ugrós URL-t, és nézd meg, jó helyen indul-e.

Ellenőrzőlista élesítés előtt

• A name egyezik a látható címmel.
• A description egyedi, nem marketingszlogen.
• A thumbnailUrl abszolút, letölthető, nem tiltott.
• Az uploadDate és a duration ISO 8601 formátumú.
• Legalább a contentUrl vagy az embedUrl meg van adva.
• Oldalanként videónként pontosan egy VideoObject van.
• A videó betöltődik JavaScript-renderelés után is, felhasználói kattintás nélkül.
• Lejáró videónál ki van töltve az expires.
• Kulcsmomentumoknál az ugrás ténylegesen működik.

Határeset: ugyanaz a videó több oldalon

Ha egy termékbemutató videó a termékoldalon és egy blogcikkben is szerepel, mindkét helyen jelölheted. Ha azonban azt szeretnéd, hogy egy konkrét oldal legyen a videó "otthona", azon tedd a videót fő tartalommá, a másik helyen pedig maradjon kiegészítés. Így világosabb jelzést adsz arról, melyik oldal való videós találatnak.

Mérés

A jelölés bevezetése csak az első lépés; mérés nélkül nem tudod, hogy a Google felismerte-e a videót, és hoz-e forgalmat. A mérés két szintű: technikai (érvényes-e, indexelték-e) és üzleti (megjelenik-e, kattintanak-e rá).

Technikai ellenőrzés

1. Kiemelt találatok tesztje: élesítés előtt és után futtasd le az oldal URL-jére. Megmutatja, hogy a VideoObject érvényes-e, és milyen figyelmeztetések vannak.
2. Schema Markup Validator: a schema.org szintű helyességet nézi, akkor is, ha a Google-specifikus jogosultságról nem mond semmit.
3. URL-ellenőrzés a Search Console-ban: a renderelt HTML-ben látszik-e a lejátszó és a jelölés. Ha a renderelt változatban nincs videó, a probléma a betöltésnél van, nem a jelölésnél.

A videóindexelési jelentés

A Search Console külön jelentést ad a videóoldalakról, amely megmutatja, hány oldalon talált videót a Google, és ezek közül hányat indexelt videóként. A nem indexelt videóknál indokot is ad, például hogy a videó nem fő tartalom, nem található, vagy a bélyegkép nem érhető el. Ez a legfontosabb diagnosztikai felület: a javításokat itt tudod visszaigazoltatni.

Teljesítmény a keresési megjelenés szerint

A Teljesítmény jelentésben a keresési megjelenés és a keresési típus szűrőivel külön láthatod a videós találatok és a Videók fül megjelenéseit, kattintásait. Érdemes egy előtte-utána összehasonlítást csinálni: rögzítsd az élesítés előtti négy hét adatait, majd nézd meg a következő négy-nyolc hetet.

Saját mérési workflow

Az alábbi menet egy kisebb videótárnál (mondjuk 20-40 videó) jól használható:

1. Nulladik hét: lista készítése minden videóoldalról egy táblázatban (URL, videó címe, jelölés megvan-e, fő tartalom-e).
2. Első hét: jelölés élesítése, tesztelés mintavétellel (minden ötödik oldal), indexelés kérése a legfontosabbakra.
3. Második-negyedik hét: a videóindexelési jelentés hetente, a felmerülő okok csoportosítása a táblázatban.
4. Hatodik-nyolcadik hét: összevetés a kiinduló adatokkal: videós megjelenések, kattintások, CTR.
5. Folyamatosan: minden új videónál ugyanaz az ellenőrzőlista.

Szemléltető értékelés

Képzelj el egy 30 videós tárat, ahol a jelentés szerint a Google 30 oldalon talált videót, de csak 12-t indexelt. Ha a fennmaradó 18-ból 15-nél az ok "a videó nem az oldal fő tartalma", akkor a teendő nem a jelölés javítása, hanem az oldalszerkezet átalakítása: a videót feljebb kell hozni, vagy külön videóoldalt kell neki adni. A számok kitaláltak, a logika viszont valós: a jelentés okai mondják meg, hol kell beavatkozni.

Mit ne várj a méréstől?

Az indexelt videó nem jelenti, hogy minden lekérdezésnél videós találat lesz. A megjelenés lekérdezésfüggő, ezért ingadozó számokra számíts. Rangsorolási ugrást se várj a jelöléstől önmagában; az eredményt a jobb megjelenés és a magasabb kattintási arány jelentheti, ha egyáltalán.

Kapcsolódó részletes útmutatók

A video schema ritkán áll magában: a bélyegkép optimalizálása, a képek leírása és az oldaltérképek mind hatnak arra, hogy a vizuális tartalmaid mennyire érthetők a keresőnek. Az alábbi útmutatók ezeket a területeket részletezik.

Ahol érdemes folytatni

• Kép és videó SEO: a teljes témakör áttekintése, innen minden részterület elérhető.
• Kép SEO: teljes útmutató: képméret, fájlnév, betöltés és megjelenés a képkeresőben, ami a bélyegképeidre is vonatkozik.
• Alt text: teljes útmutató: hogyan írj leíró, hasznos szöveget vizuális tartalomhoz, ami a videóleírásoknál is jó kiindulópont.
• Image sitemap: teljes útmutató: az oldaltérképek logikája, amely a videós sitemap felépítésénél is visszaköszön.
• WebP: teljes útmutató: modern képformátum, amellyel könnyebb és gyorsabb bélyegképeket készíthetsz.

Javasolt sorrend

Ha most kezded, előbb a bélyegképeket hozd rendbe (formátum, méret, elérhetőség), utána írd meg a VideoObject jelölést, végül állítsd be a mérést. Így a jelölés első napjától olyan adatokra hivatkozik, amelyek valóban működnek, és a Search Console-jelentésben a valós problémák látszanak, nem a könnyen elkerülhető alaphibák.