Schema pre marketplaces a multi-vendor weby: koncepcia, návrh a implementačné vzory

Marketplaces a multi-vendor platformy majú z pohľadu štruktúrovaných dát zásadne odlišnú dynamiku než tradičné e-shopy. Namiesto jedného predajcu pracujú s množstvom nezávislých sellerov, paralelnými ponukami k rovnakému produktu, variantmi, rôznymi cenotvorbami a dopravami. Správne navrhnuté schema.org dáta sú kľúčové pre konzistentné zobrazovanie v ekosystéme vyhľadávačov, porovnávačov cien, asistentov a reklamných platforiem. Tento článok ponúka architektonický rámec, odporúčané triedy a vlastnosti, ukážky JSON-LD a kontrolný zoznam kvality pre škálovateľné, audítovateľné a validovateľné nasadenie.

Architektonický rámec štruktúrovaných dát pre marketplace

Graph-first prístup: používajte @graph v JSON-LD a stabilné @id IRI pre každý objekt (produkt, seller, ponuka). Umožní to postupné dopĺňanie uzlov bez kolízie a deduplikáciu.
Oddelenie „master“ produktov a ponúk: Product reprezentuje vlastnosti výrobku (GTIN, značka, názov, technické parametre), zatiaľ čo Offer reprezentuje obchodné podmienky konkrétneho predajcu (cena, dostupnosť, doprava, záruka, vrátenie).
Viac-predajcový model: pre rovnaký Product použite AggregateOffer alebo pole offers s viacerými Offer, pričom každá Offer má vlastnosť seller ukazujúcu na Organization/LocalBusiness konkrétneho vendora.
Variácie & katalógy: produktové varianty modelujte pomocou isVariantOf/hasVariant alebo ProductGroup/ProductModel. Pre kategórie a výpisy použite ItemList resp. OfferCatalog na úrovni vendora.

Kľúčové entity a ich väzby

WebSite, WebPage, BreadcrumbList: základ pre navigačné signály a site-links. WebSite doplňte o potentialAction typu SearchAction (site search).
Organization (marketplace) a Organization/LocalBusiness (seller): marketplace ako prevádzkovateľ platformy, vendor ako poskytovateľ ponuky. Vendor môže mať MerchantReturnPolicy, kontakty a adresy.
Product: identifikátory (gtin13/gtin8/mpn/sku), brand, model, color, size, additionalProperty (páry kľúč–hodnota pre technické parametre).
Offer & AggregateOffer: price, priceCurrency, availability, itemCondition, priceValidUntil, url, seller, voliteľne shippingDetails, eligibleQuantity, hasMerchantReturnPolicy.
Review & AggregateRating: recenzie vendora aj produktu; rozlíšte itemReviewed=Product vs. hodnotenie na Organization vendora (spokojnosť s obchodníkom).

Identifikátory, deduplikácia a normalizácia

Marketplace často prijíma dáta z rôznych feedov. Kvalita identifikátorov je rozhodujúca:

Stabilné @id IRI: konštruujte deterministicky (napr. https://example.com/product/GTIN:5901234123457, …/offer/{sellerId}-{sku}, …/org/{sellerId}).
GTIN/MPN/brand: najlepšie páry na deduplikáciu „master“ produktov. Ak chýbajú, dočasne použite heuristiky, ale vždy smerujte k doplneniu GTIN.
Normalizácia jednotiek a mien: priceCurrency podľa ISO 4217, parametre s unitCode (UN/CEFACT) v PropertyValue.

Produkty, varianty a atribúty

Varianty (farba, veľkosť, kapacita) reprezentujte explicitne, inak prichádzate o presnú indexáciu:

„Parent“ produkt (ProductGroup alebo Product s hasVariant) zhŕňa spoločné vlastnosti.
Variant (Product s isVariantOf) má vlastné sku, niekedy aj gtin a špecifické obrázky.
additionalProperty pre detailné parametre (napr. PropertyValue s name=„Uhlopriečka“, value=„55“, unitCode=„CMT“).

Ponuky: cenotvorba, dostupnosť, logistika

Ceny: price (desatinné číslo), priceCurrency. Ak máte viacero ponúk, použite aj AggregateOffer s lowPrice/highPrice a offerCount.
Dostupnosť: availability (napr. InStock, OutOfStock, PreOrder), inventoryLevel cez QuantitativeValue (ak je vhodné).
Doprava: shippingDetails (OfferShippingDetails) s shippingRate (MonetaryAmount), shippingDestination (DefinedRegion), voliteľne deliveryTime (ShippingDeliveryTime s handling a transit časmi).
Vrátenie a záruky: hasMerchantReturnPolicy pri Offer alebo na úrovni vendora (Organization) a prepojiť cez applicableCountry, returnFees, returnMethod, returnPolicyCategory, returnWindow.

Vendor (seller) profil a reputácia

Každého predajcu reprezentujte ako Organization alebo LocalBusiness (ak má kamennú prevádzku): názov, IČO/DIČ (ako identifier cez PropertyValue), logo, kontakty, adresa (PostalAddress), URL na profil. Doplnkové signály:

AggregateRating predajcu (ratingValue, reviewCount).
Review s reviewRating, atribútom itemReviewed=Organization (nie produkt).
OfferCatalog pre navigáciu v sortimente konkrétneho vendora.

Kategórie, listingy a interné vyhľadávanie

PLP (category/listing): použite CollectionPage/WebPage s mainEntity=ItemList a položkami ListItem s odkazmi na produkty alebo ponuky (podľa UX).
Filtre: voliteľne popíšte populárne filtre cez about/knowsAbout alebo súvisiace „guide“ články.
Site search: WebSite s potentialAction=SearchAction pre autocomplete/snippets.

Obrázky, multimédiá a licencie

Product s image (viac URL), video (VideoObject s thumbnailUrl, embedUrl), license ak ide o vlastný obsah.
Vendor logo ako ImageObject s contentUrl, width, height.

Medzinárodná podpora a mnoho mien

Pri internacionalizácii rešpektujte lokálne meny, dane a dostupnosti:

Oddelené ponuky pre jednotlivé krajiny (shippingDestination), rôzne priceCurrency, odlišné availability.
Jazykové verzie stránok zosúlaďte s inLanguage a hreflang (nie je súčasťou schema.org, ale HTML link rel atributy musia byť konzistentné).

Ukážka: produkt s viacerými predajcami a agregovanou ponukou

Nižšie je zjednodušené JSON-LD (vložené do <script type="application/ld+json"> na produktovej stránke):

Ukážka: vendor stránka s katalógom ponúk

Na stránke profilu predajcu publikujte jeho identitu, reputáciu a výber položiek ako OfferCatalog alebo ItemList:

FAQ, politiky vrátenia a právne stránky

FAQ k marketplace pravidlám: FAQPage s MainEntity=Question/Answer, zamerané na proces nákupu, vrátenia a záruky.
Politiky vrátenia: centrálne pre marketplace a špecifické pre vendora (MerchantReturnPolicy), prepojené z ponúk.
Platobné a prepravné podmienky: môžete sumarizovať cez CreativeWork s about a odkazmi na sekcie webu.

Dátová kvalita a konzistencia naprieč feedmi

Contract testy schémy: pre každý zdroj dát validujte povinné polia (name, brand, identifikátory, price/currency, availability).
Normalizačná pipeline: mapovanie polí z feedov na interný katalóg; jednotné formáty cien, mien, adries a kódov krajín (ISO 3166-1 alpha-2).
Dedup: párovanie produktov podľa GTIN + brand + mpn; heuristiky len dočasne (názov/obrázok).
Verzionovanie: produkty a ponuky majú immutable identifikátory; zmeny sú state updates s timestampami (pomôže pri debugovaní SERP problémov).

Validácia, monitoring a alerting

Validátory: pravidelne kontrolujte JSON-LD proti schema.org a špecifikáciám platforiem (napr. testy pre produkty a ponuky). Sledujte varovania aj nepovinné odporúčania.
In-page integrita: detegujte kolízie viacerých skriptov a nesúlady medzi viditeľným obsahom a štruktúrovanými dátami (napr. cena na stránke vs. v JSON-LD).
Monitoring publikácie: metriky pokrytia (percento PDP s validným Product), chybové kódy, počet ponúk na produkt, latencia aktualizácií cien a skladovosti.
Alerty: prudký pokles offerCount, skok v OutOfStock, anomálie mien alebo duplikáty @id.

Najčastejšie chyby a antipatterny

Mixovanie údajov viacerých predajcov do jednej Offer namiesto separátnych ponúk s vlastným seller.
Chýbajúce stabilné @id pre Product/Offer/Organization, čo vedie k nekonzistentnému „spájaniu“ v indexe.
Používanie len Product bez Offer → vyhľadávače nevidia cenu, dostupnosť a predajcu.
Nesprávne availability a priceCurrency pri medzinárodných stránkach.
Duplicitné varianty bez isVariantOf/hasVariant, čo rozbíja konsolidáciu signálov.

Checklist implementácie pre marketplace

JSON-LD s @graph a stabilnými @id pre všetky entity.
Product s identifikátormi (GTIN/MPN/SKU), brand, obrázkami a aggregateRating (ak existuje).
Viacero Offer pre každého predajcu + AggregateOffer pre sumarizáciu.
seller ako Organization/LocalBusiness s reputačnými signálmi a hasMerchantReturnPolicy.
OfferShippingDetails pre dopravu a regióny, MerchantReturnPolicy pre vrátenie.
Varianty prepojené cez isVariantOf/hasVariant; katalógy vendora cez OfferCatalog.
Listingy ako ItemList, navigácia cez BreadcrumbList, site search cez SearchAction.
Automatická validácia, monitoring konzistencie a alerty na anomálie.

Schéma pre marketplace má byť komponovateľná, stabilná a auditovateľná. Oddeľte produktové fakty od obchodných podmienok, reprezentujte každého predajcu ako samostatnú entitu, prepojte ponuky s dopravou a politikami vrátenia a používajte graph-first JSON-LD s konzistentnými identifikátormi. Takto postavené štruktúrované dáta zvyšujú dátovú konzistenciu naprieč zdrojmi, posilňujú dôveryhodnosť vo vyhľadávaní a umožňujú škálovať marketplace bez degradácie kvality.