Schéma pro tržiště a multi-vendor platformy

Daniel

Schema pro marketplaces a multi-vendor weby: koncepce, návrh a implementační vzory

Marketplaces a multi-vendor platformy mají z pohledu strukturovaných dat zásadně odlišnou dynamiku než tradiční e-shopy. Místo jednoho prodejce pracují s množstvím nezávislých sellerů, paralelními nabídkami ke stejnému produktu, variantami, různými cenotvorbami a dopravami. Správně navržená schema.org data jsou klíčová pro konzistentní zobrazování v ekosystému vyhledávačů, porovnávačů cen, asistentů a reklamních platforem. Tento článek nabízí architektonický rámec, doporučené třídy a vlastnosti, ukázky JSON-LD a kontrolní seznam kvality pro škálovatelné, auditovatelné a validovatelné nasazení.

Architektonický rámec strukturovaných dat pro marketplace

  • Graph-first přístup: používejte @graph v JSON-LD a stabilní @id IRI pro každý objekt (produkt, seller, nabídka). Umožní to postupné doplňování uzlů bez kolize a deduplikaci.
  • Oddělení „master“ produktů a nabídek: Product reprezentuje vlastnosti výrobku (GTIN, značka, název, technické parametry), zatímco Offer reprezentuje obchodní podmínky konkrétního prodejce (cena, dostupnost, doprava, záruka, vrácení).
  • Více-prodejcový model: pro stejný Product použijte AggregateOffer nebo pole offers s více Offer, přičemž každá Offer má vlastnost seller ukazující na Organization/LocalBusiness konkrétního vendora.
  • Variace & katalogy: produktové varianty modelujte pomocí isVariantOf/hasVariant nebo ProductGroup/ProductModel. Pro kategorie a výpisy použijte ItemList resp. OfferCatalog na úrovni vendora.

Klíčové entity a jejich vazby

  • WebSite, WebPage, BreadcrumbList: základ pro navigační signály a site-links. WebSite doplňte o potentialAction typu SearchAction (site search).
  • Organization (marketplace) a Organization/LocalBusiness (seller): marketplace jako provozovatel platformy, vendor jako poskytovatel nabídky. Vendor může mít MerchantReturnPolicy, kontakty a adresy.
  • Product: identifikátory (gtin13/gtin8/mpn/sku), brand, model, color, size, additionalProperty (páry klíč–hodnota pro technické parametry).
  • Offer & AggregateOffer: price, priceCurrency, availability, itemCondition, priceValidUntil, url, seller, volitelně shippingDetails, eligibleQuantity, hasMerchantReturnPolicy.
  • Review & AggregateRating: recenze vendora i produktu; rozlište itemReviewed=Product vs. hodnocení na Organization vendora (spokojenost s obchodníkem).

Identifikátory, deduplikace a normalizace

Marketplace často přijímá data z různých feedů. Kvalita identifikátorů je rozhodující:

  • Stabilní @id IRI: konstruujte deterministicky (např. https://example.com/product/GTIN:5901234123457, …/offer/{sellerId}-{sku}, …/org/{sellerId}).
  • GTIN/MPN/brand: nejlepší páry na deduplikaci „master“ produktů. Pokud chybí, dočasně použijte heuristiky, ale vždy směřujte k doplnění GTIN.
  • Normalizace jednotek a měn: priceCurrency podle ISO 4217, parametry s unitCode (UN/CEFACT) v PropertyValue.

Produkty, varianty a atributy

Varianty (barva, velikost, kapacita) reprezentujte explicitně, jinak přicházíte o přesnou indexaci:

  • „Parent“ produkt (ProductGroup nebo Product s hasVariant) shrnuje společné vlastnosti.
  • Varianta (Product s isVariantOf) má vlastní sku, někdy i gtin a specifické obrázky.
  • additionalProperty pro detailní parametry (např. PropertyValue s name=„Úhlopříčka“, value=„55“, unitCode=„CMT“).

Nabídky: cenotvorba, dostupnost, logistika

  • Ceny: price (desetinné číslo), priceCurrency. Máte-li více nabídek, použijte i AggregateOffer s lowPrice/highPrice a offerCount.
  • Dostupnost: availability (např. InStock, OutOfStock, PreOrder), inventoryLevel přes QuantitativeValue (pokud je vhodné).
  • Doprava: shippingDetails (OfferShippingDetails) s shippingRate (MonetaryAmount), shippingDestination (DefinedRegion), volitelně deliveryTime (ShippingDeliveryTime s handling a transit časy).
  • Vrácení a záruky: hasMerchantReturnPolicy u Offer nebo na úrovni vendora (Organization) a propojit přes applicableCountry, returnFees, returnMethod, returnPolicyCategory, returnWindow.

Vendor (seller) profil a reputace

Každého prodejce reprezentujte jako Organization nebo LocalBusiness (pokud má kamennou provozovnu): název, IČO/DIČ (jako identifier přes PropertyValue), logo, kontakty, adresa (PostalAddress), URL na profil. Doplnkové signály:

  • AggregateRating prodejce (ratingValue, reviewCount).
  • Review s reviewRating, atributem itemReviewed=Organization (nikoli produkt).
  • OfferCatalog pro navigaci v sortimentu konkrétního vendora.

Kategorie, listingy a interní vyhledávání

  • PLP (category/listing): použijte CollectionPage/WebPage s mainEntity=ItemList a položkami ListItem s odkazy na produkty nebo nabídky (podle UX).
  • Filtry: volitelně popište populární filtry přes about/knowsAbout nebo související „guide“ články.
  • Site search: WebSite s potentialAction=SearchAction pro autocomplete/snippety.

Obrázky, multimédia a licence

  • Product s image (více URL), video (VideoObject s thumbnailUrl, embedUrl), license pokud jde o vlastní obsah.
  • Vendor logo jako ImageObject s contentUrl, width, height.

Mezinárodní podpora a více měn

Při internacionalizaci respektujte lokální měny, daně a dostupnosti:

  • Oddělené nabídky pro jednotlivé země (shippingDestination), různé priceCurrency, odlišné availability.
  • Jazykové verze stránek slaďte s inLanguage a hreflang (není součástí schema.org, ale HTML link rel atributy musí být konzistentní).

Ukázka: produkt s více prodejci a agregovanou nabídkou

Níže je zjednodušené JSON-LD (vložené do <script type="application/ld+json"> na produktové stránce):

Ukázka: vendor stránka s katalogem nabídek

Na stránce profilu prodejce publikujte jeho identitu, reputaci a výběr položek jako OfferCatalog nebo ItemList: