ProductGroup és hasVariant jelölés termékváltozatokhoz webshopban

Scheo · 2026-11-04 · olvasási idő ~10 perc · Szerző: Schmidt Péter

Ha a webshopodban egy póló öt színben és négy méretben kapható, a keresőnek el kell döntenie, hogy húsz különálló termékről van-e szó, vagy egyetlen termék húsz változatáról. A ProductGroup jelölés ezt a kérdést válaszolja meg a gép számára. Ez a cikk lépésenként végigmegy a jelölésen két gyakori webshop-felépítésnél, és a végén ellenőrzőlistát is kapsz. Az állításokat jelöljük aszerint, hogy hivatalosan igazolt, saját tapasztalat vagy szakmai feltételezés.

Mire való a ProductGroup típus egy webshopban?

A ProductGroup egy termékcsalád közös adatait írja le, és a hasVariant tulajdonsággal összefogja a hozzá tartozó változatokat, így a kereső egy termékként érti meg a színeket és méreteket.

Hivatalosan igazolt. A Schema.org a ProductGroup típust olyan termékek csoportjára definiálja, amelyek csak néhány jellemzőben (méret, szín, anyag, minta) térnek el egymástól. A Google Search Central 2024 elején tett közzé külön dokumentációt a termékváltozatok strukturált adatáról, és ebben ezt a típust használja. A négy tulajdonság szerepe a következő.

• productGroupID a termékcsalád saját azonosítója, általában a szülőtermék cikkszáma.
• variesBy azt sorolja fel, miben különböznek a változatok. Az értékei Schema.org-tulajdonságok URL-jei, például https://schema.org/color és https://schema.org/size.
• hasVariant a csoporthoz tartozó Product elemek listája.
• isVariantOf vagy inProductGroupWithID a változat felől mutat vissza a csoportra. Ez főleg akkor hasznos, ha a változatoknak külön oldaluk van.

A közös adatok (név, márka, leírás, értékelések) a ProductGroup szintjén vannak. Ami változatonként eltér, tehát az ár, a készlet, a cikkszám, a GTIN, a szín és a méret, az a változat Product elemébe kerül, annak saját Offer blokkjával.

Miben más ez, mint ha minden változat külön Product jelölést kap?

Külön Product jelöléssel a változatok közötti kapcsolat csak a terméknévből és az URL-ből olvasható ki, a ProductGroup ezt a kapcsolatot gépileg is kimondja.

A régebbi gyakorlat az volt, hogy a termékoldal egyetlen Product elemet kapott, benne több Offer elemmel, vagy minden változat egy-egy Product elemet, egymástól függetlenül. Ez a megoldás érvényes, a Google ma is feldolgozza. A különbség az, hogy a kereső ilyenkor csak következtetni tud arra, hogy a fekete M-es és a fehér L-es póló ugyanaz a modell.

Hivatalosan igazolt. A Google variáns-dokumentációja szerint a ProductGroup jelölés segít a Google-nek megérteni, hogy mely termékek egy csoport változatai, és ezt a Merchant Center item_group_id mezőjével is összhangba lehet hozni.

Szakmai feltételezés. A pontosabb csoportosítás jó eséllyel abban segíthet, hogy a találati listában és a vásárlási felületeken a megfelelő változat (például a keresett szín) jelenjen meg, és ne egy véletlenszerű. Ezt a Google nem ígéri, és látványosabb megjelenést vagy jobb helyezést sem garantál.

Hogyan néz ki a jelölés, ha minden változat egy URL-en van?

Ha a színt és a méretet egy oldalon, választóval kezeled, az oldal egy ProductGroup elemet kap, a hasVariant pedig az összes változatot tartalmazza, mindegyiket saját árral és készlettel.

Ez a WooCommerce és a Shopify alapbeállítása is, ahol a változatot legördülő vagy színminta választja ki, és legfeljebb egy URL-paraméter változik.

1. Írd le a csoportot. Add meg a nevet, a márkát, a leírást és a productGroupID-t. Az @id legyen egyedi, például az oldal URL-je egy #csoport végződéssel.
2. Add meg a variesBy értékét. Itt csak azok a tulajdonságok szerepeljenek, amelyekben a változatok tényleg eltérnek.
3. Sorold fel a változatokat a hasVariant listában. Mindegyik kapja meg a saját sku, gtin, color, size, image és offers adatát.
4. Adj minden változatnak saját URL-t, ha lehet. A Google azt javasolja, hogy a változat URL-paraméterrel közvetlenül megnyitható legyen, és az oldal ilyenkor az adott változatot mutassa előre kiválasztva.
5. Egyeztesd az oldallal. A jelölt ár és készlet egyezzen azzal, amit a vásárló a kiválasztott változatnál lát.

Egy rövidített példa (az árat és a GTIN-t helyőrző jelöli, ide a valós értékek kerülnek).

{ "@context": "https://schema.org/", "@type": "ProductGroup", "@id": "https://pelda-webshop.hu/basic-polo#csoport", "name": "Basic pamutpóló", "brand": { "@type": "Brand", "name": "PéldaMárka" }, "productGroupID": "POLO-BASIC", "variesBy": [ "https://schema.org/color", "https://schema.org/size" ], "hasVariant": [ { "@type": "Product", "sku": "POLO-BASIC-FEKETE-M", "gtin13": "GTIN_IDE", "name": "Basic pamutpóló, fekete, M", "color": "fekete", "size": "M", "image": "https://pelda-webshop.hu/kepek/polo-fekete.jpg", "url": "https://pelda-webshop.hu/basic-polo?szin=fekete&meret=m", "offers": { "@type": "Offer", "price": "AR_AZ_OLDALROL", "priceCurrency": "HUF", "availability": "https://schema.org/InStock" } } ] }

A hasVariant listában a többi szín-méret kombináció ugyanígy következik. Saját tapasztalat. Sok változatnál a jelölést a webshop sablonja vagy egy SEO-bővítmény generálja, és gyakran csak a szülőtermék adatait írja ki, változatok nélkül. Érdemes megnézni a forráskódot, mielőtt jónak tekinted.

Hogyan jelöld, ha minden változatnak külön URL-je van?

Ha minden színnek vagy méretnek saját oldala van, minden oldal a saját változatát írja le teljes adattal, és a ProductGroup segítségével jelzi, hogy egy csoporthoz tartozik.

Ez a felépítés ott gyakori, ahol a színek külön indexelhető oldalt kapnak, például /basic-polo-fekete és /basic-polo-feher, mert a vásárlók színre is keresnek.

1. Tedd ki a ProductGroup elemet minden változatoldalra ugyanazzal a productGroupID-vel és ugyanazzal az @id-vel. Így a Google minden oldalon ugyanazt a csoportot azonosítja.
2. Az aktuális oldal változatát írd le teljesen a hasVariant listában, árral, készlettel, GTIN-nel és képpel.
3. A többi változatot elég URL-lel felsorolni. A Google több oldalas példája ilyen rövid hivatkozást használ, például { "@type": "Product", "url": "https://pelda-webshop.hu/basic-polo-feher" }. A teljes adatot a saját oldaluk adja.
4. Kösd vissza a változatot a csoporthoz. A változat Product elemében az isVariantOf az @id-re hivatkozik, vagy az inProductGroupWithID a productGroupID értékét veszi fel.
5. Ellenőrizd a canonicalt. Ha a változatoldalak mind a szülőoldalra canonicalizálnak, a Google jó eséllyel nem indexeli őket külön, és a jelölésük is a háttérbe szorul. Döntsd el előre, hogy a változatok önálló oldalak legyenek-e, és a canonical ezt kövesse.

Szakmai feltételezés. Külön URL-es felépítésnél az a leggyakoribb gond, hogy az oldalak tartalma szinte azonos, csak a szín neve és a kép tér el. A jelölés ezen nem segít. Ha a változatoldalakat külön szeretnéd indexeltetni, legyen rajtuk valódi különbség, például színre jellemző fotók vagy anyagleírás.

Melyik felépítés illik a webshopodhoz?

Ha a változatok csak méretben vagy apró részletben különböznek, az egy URL-es megoldás az egyszerűbb, ha a vásárlók a változatra külön is keresnek, a külön URL-es felépítés lehet indokolt.

A méret szinte soha nem önálló keresési szándék, ezért méretenként külön oldalt ritkán érdemes indítani. A szín, az anyag vagy a kiszerelés viszont lehet az. Vegyes megoldás is működik, ahol a színek külön oldalt kapnak, a méretek pedig az oldalon belüli választóban maradnak. Ilyenkor a variesBy mindkét tulajdonságot felsorolja, a hasVariant pedig az adott szín összes méretét részletesen, a többi szín oldalát pedig URL-lel tartalmazza. Saját tapasztalat. A döntés előtt érdemes megnézni a Search Console teljesítményjelentésében, hogy a meglévő lekérdezésekben előfordulnak-e színnevek, mert ez megmutatja, van-e erre valós keresési igény.

Milyen hibák fordulnak elő a leggyakrabban?

A legtöbb hiba abból adódik, hogy a jelölés, az oldal és a Merchant Center feed más-más adatot mutat ugyanarról a változatról.

• Hiányzó productGroupID. A csoport azonosító nélkül maradt, így nincs mihez kötni a változatokat és a feed item_group_id mezőjét.
• Eltérő productGroupID oldalanként. Külön URL-es felépítésnél az egyik oldal a szülő cikkszámát, a másik a változatét írja be. Az érték minden oldalon azonos legyen.
• Merchant Center item_group_id eltérés. Hivatalosan igazolt. A Google dokumentációja szerint a productGroupID megfelel a Merchant Center item_group_id mezőjének. Ha a feedben más érték áll, a két forrás nem ugyanazt a csoportot írja le.
• Eltérő ár a jelölésben és az oldalon. Gyakori, hogy a jelölésben az alapár áll, az oldalon pedig a kiválasztott változat ára vagy egy akciós ár. A Merchant Center automatikus termékfrissítése a strukturált adatot használhatja az ár és a készlet frissítésére, ezért az eltérés ott is gondot okozhat.
• A teljes ártartomány egyetlen változatnál. Az AggregateOffer a csoport szintjén nem helyettesíti a változatonkénti Offer elemet.
• variesBy szöveggel. A „szín” vagy „méret” szó helyett a Schema.org-tulajdonság URL-je kell.
• Hiányzó color vagy size a változatnál. Ha a variesBy a színt jelöli, minden változatnál legyen color érték.
• Elavult készlet. A gyorsítótárazott oldal kiírja a régi készletállapotot, miközben a változat már elfogyott.
• Változat-URL, ami nem a változatot nyitja meg. A paraméteres URL betöltés után az alapértelmezett színt mutatja, így az oldal és a jelölés nem egyezik.
• Dupla jelölés. A sablon és egy bővítmény is kiír egy-egy Product blokkot, ellentmondó adatokkal.

Hogyan érdemes validálni a Rich Results Testtel?

A Rich Results Test egy URL-en megmutatja, hogy a Google felismeri-e a termékkivonat és a kereskedői listázás jelölést, és listázza a hibákat és figyelmeztetéseket.

1. Futtasd az élő URL-en, mert a kódrészlet beillesztése nem mutatja meg, mit generál a webshop JavaScriptje.
2. Nézd meg mindkét találattípust. A Termékkivonatok és a Kereskedői listázások külön szerepelnek, és más tulajdonságokat várnak.
3. Bontsd ki a ProductGroup elemet, és ellenőrizd, hogy minden változat megjelenik-e a hasVariant alatt, saját Offer elemmel.
4. Teszteld a változat-URL-eket is, különösen paraméteres URL-nél, és nézd meg, hogy a kiválasztott változat ára jelenik-e meg.
5. Hasonlítsd össze a renderelt HTML-t az oldal látható tartalmával. A teszt csak a jelölést ellenőrzi, azt nem, hogy egyezik-e az oldallal.

A Schema Markup Validator (validator.schema.org) jól kiegészíti, mert a Schema.org szerinti szerkezetet nézi, attól függetlenül, hogy a Google melyik részt használja.

Mit mutatnak a Search Console jelentései?

A Search Console Termékkivonatok és Kereskedői listázások jelentése a teljes webshop jelölését összesíti, és oldaltípusonként mutatja az érvényes elemeket, a hibákat és a figyelmeztetéseket.

Hivatalosan igazolt. Mindkét jelentés a Search Console Fejlesztések (vagy Vásárlás) részében található, és csak a már feltérképezett oldalakat mutatja. A javítás után az Ellenőrzés kérése gombbal indíthatsz újraellenőrzést, ami napokig is eltarthat.

• Figyeld az érvényes elemek számát. Ha a ProductGroup bevezetése után hirtelen csökken, a változatok valószínűleg kiestek a jelölésből.
• Csoportosítsd a hibákat. Ha ugyanaz a hiba több száz oldalon jön elő, az szinte mindig sablonhiba, és egy helyen javítható.
• Használd az URL-ellenőrzést egy-egy hibás oldalra, hogy lásd, a Google melyik verziót indexelte.
• Nézd meg a Merchant Center diagnosztikáját is, mert az item_group_id és az ár eltérése ott jelenik meg, a Search Console-ban nem feltétlenül.

Saját tapasztalat. A jelentések csúszással frissülnek, ezért egy nagyobb sablonmódosítás után érdemes több hetet adni, mielőtt bármilyen következtetést levonsz.

Segít-e a változat-jelölés az AI-alapú keresésben?

Nyilvános, hivatalos forrás arról nincs, hogy az AI-asszisztensek külön súllyal kezelnék a ProductGroup jelölést.

Szakmai feltételezés. Az AI-alapú vásárlási válaszok gyakran a Google Shopping adataira és a weboldal szövegére támaszkodnak. Ha a változatok adata a jelölésben, a feedben és az oldalon is egyezik, nagyobb az esélye, hogy egy asszisztens a helyes színt, méretet és készletet idézi. Ehhez a jelölés csak az egyik feltétel, legalább ilyen fontos, hogy a termékoldal szövege is egyértelműen leírja a változatokat.

Források és további olvasnivalók

• Google Search Central, Product variant structured data (ProductGroup, Product)
• Google Search Central, Merchant listing structured data
• Google Search Central, Product snippet structured data
• Google Merchant Center súgó, Item group ID [item_group_id]
• Google Merchant Center súgó, Automatikus termékfrissítések
• Schema.org, ProductGroup, hasVariant, variesBy, isVariantOf
• Google Search Console súgó, Termékkivonatok és Kereskedői listázások jelentés