Schema.org pro marketplace a multivendorové platformy

Schema.org pre Marketplace a multi-vendor platformy

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

Marketplaces a multi-vendor platformy mají z hlediska strukturovaných dat zásadně odlišnou dynamiku než tradiční e-shopy. Namísto jednoho prodejce pracují s množstvím nezávislých sellerů, paralelními nabídkami stejného produktu, variantami, různými cenotvorbami a způsoby dopravy. Správně navržená data schema.org jsou klíčová pro konzistentní zobrazování v ekosystému vyhledávačů, srovná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

  • Přístup založený na grafu: používejte @graph v JSON-LD a stabilní @id IRI pro každý objekt (produkt, seller, nabídka). Umožňuje to postupně doplňovat uzly bez kolizí a deduplikovat.
  • 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í).
  • Model pro více prodejců: pro stejný Product použijte AggregateOffer nebo pole offers s více objekty Offer, přičemž každý objekt Offer má vlastnost seller odkazující na Organization/LocalBusiness konkrétního prodejce.
  • Varianty & katalogy: varianty produktů modelujte pomocí isVariantOf/hasVariant nebo ProductGroup/ProductModel. Pro kategorie a výpisy použijte ItemList, případně OfferCatalog na úrovni prodejce.

Klíčové entity a jejich vazby

  • WebSite, WebPage, BreadcrumbList: základ pro navigační signály a odkazy na podstránky ve výsledcích vyhledávání. WebSite doplňte o potentialAction typu SearchAction (vyhledávání na webu).
  • Organization (marketplace) a Organization/LocalBusiness (seller): marketplace jako provozovatel platformy, prodejce jako poskytovatel nabídky. Prodejce 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 prodejce i produktu; rozlišujte itemReviewed=Product oproti hodnocení entity Organization prodejce (spokojenost s obchodníkem).

Identifikátory, deduplikace a normalizace

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

  • Stabilní @id IRI: vytvářejte je deterministicky (např. https://example.com/product/GTIN:5901234123457, …/offer/{sellerId}-{sku}, …/org/{sellerId}).
  • GTIN/MPN/brand: nejlepší kombinace pro 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:

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

Nabídky: cenotvorba, dostupnost, logistika

  • Ceny: price (desetinné číslo), priceCurrency. Pokud máte více nabídek, použijte také AggregateOffer s lowPrice/highPrice a offerCount.
  • Dostupnost: availability (např. InStock, OutOfStock, PreOrder), inventoryLevel prostřednictvím QuantitativeValue (pokud je to vhodné).
  • Doprava: shippingDetails (OfferShippingDetails) s shippingRate (MonetaryAmount), shippingDestination (DefinedRegion), případně deliveryTime (ShippingDeliveryTime s časy zpracování a přepravy).
  • Vrácení a záruky: hasMerchantReturnPolicy u Offer nebo na úrovni prodejce (Organization) a propojte ji prostřednictvím vlastností applicableCountry, returnFees, returnMethod, returnPolicyCategory, returnWindow.

Profil prodejce (seller) a reputace

Každého prodejce reprezentujte jako Organization nebo LocalBusiness (pokud má kamennou provozovnu): název, IČO/DIČ (jako identifier prostřednictvím PropertyValue), logo, kontakty, adresa (PostalAddress), URL profilu. Další signály:

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

Kategorie, výpisy a interní vyhledávání

  • PLP (kategorie/výpis): použijte CollectionPage/WebPage s mainEntity=ItemList a položkami ListItem s odkazy na produkty nebo nabídky (podle UX).
  • Filtry: případně popište oblíbené filtry prostřednictvím about/knowsAbout nebo souvisejících „průvodců“.
  • Vyhledávání na webu: WebSite s potentialAction=SearchAction pro našeptávání/náhledy.

Obrázky, multimédia a licence

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

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

Při internacionalizaci respektujte místní měny, daně a dostupnost:

  • Oddělené nabídky pro jednotlivé země (shippingDestination), různé hodnoty priceCurrency a odlišná availability.
  • Jazykové verze stránek slaďte s inLanguage a hreflang (není součástí schema.org, atributy HTML link rel však 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 stránce produktu):

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

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

FAQ, zásady vrácení a právní stránky

  • FAQ k pravidlům marketplace: FAQPage s MainEntity=Question/Answer, zaměřené na proces nákupu, vrácení a záruky.
  • Zásady vrácení: centrální pro marketplace a specifické pro prodejce (MerchantReturnPolicy), propojené z nabídek.
  • Platební a přepravní podmínky: můžete shrnout pomocí CreativeWork s about a odkazy na části webu.

Kvalita dat a konzistence napříč feedy

  • Testy schématu: pro každý zdroj dat validujte povinná pole (name, brand, identifikátory, price/currency, availability).
  • Normalizační pipeline: mapování polí z feedů do interního katalogu; jednotné formáty cen, měn, adres a kódů zemí (ISO 3166-1 alpha-2).
  • Deduplikace: párování produktů podle GTIN + brand + mpn; heuristiky používejte pouze dočasně (název/obrázek).
  • Verzování: produkty a nabídky mají neměnné identifikátory; změny jsou aktualizace stavu s časovými značkami (pomůže to při ladění problémů ve výsledcích vyhledávání).

Validace, monitoring a upozornění

  • Validátory: pravidelně kontrolujte JSON-LD vůči schema.org a specifikacím platforem (např. testy pro produkty a nabídky). Sledujte upozornění i nezávazná doporučení.
  • Integrita na stránce: detekujte kolize více skriptů a nesoulad mezi viditelným obsahem a strukturovanými daty (např. cena na stránce oproti ceně v JSON-LD).
  • Monitoring publikace: metriky pokrytí (procento PDP s validním Product), chybové kódy, počet nabídek na produkt, latence aktualizací cen a skladových zásob.
  • Upozornění: prudký pokles offerCount, nárůst hodnoty OutOfStock, anomálie měn nebo duplicitní @id.

Nejčastější chyby a antipatterny

  • Míchání údajů více prodejců do jednoho objektu Offer namísto samostatných nabídek s vlastním seller.
  • Chybějící stabilní @id pro Product/Offer/Organization, což vede k nekonzistentnímu „propojování“ v indexu.
  • Používání pouze Product bez Offer → vyhledávače nevidí cenu, dostupnost ani prodejce.
  • Nesprávné availability a priceCurrency na mezinárodních stránkách.
  • Duplicitní varianty bez isVariantOf/hasVariant, což narušuje konsolidaci signálů.

Kontrolní seznam implementace pro marketplace

  • JSON-LD s @graph a stabilními @id pro všechny entity.
  • Product s identifikátory (GTIN/MPN/SKU), brand, obrázky a aggregateRating (pokud existuje).
  • Více objektů Offer pro každého prodejce + AggregateOffer pro shrnutí.
  • seller jako Organization/LocalBusiness se signály reputace a hasMerchantReturnPolicy.
  • OfferShippingDetails pro dopravu a regiony, MerchantReturnPolicy pro vrácení.
  • Varianty propojené prostřednictvím isVariantOf/hasVariant; katalogy prodejců prostřednictvím OfferCatalog.
  • Výpisy jako ItemList, navigace prostřednictvím BreadcrumbList, vyhledávání na webu prostřednictvím SearchAction.
  • Automatická validace, monitoring konzistence a upozornění na anomálie.

Schéma pro marketplace má být komponovatelná, stabilní a auditovatelná. Oddělte produktová fakta od obchodních podmínek, každého prodejce reprezentujte jako samostatnou entitu, propojte nabídky s dopravou a zásadami vrácení a používejte JSON-LD založené na grafu s konzistentními identifikátory. Takto vytvořená strukturovaná data zvyšují konzistenci dat napříč zdroji, posilují důvěryhodnost ve vyhledávání a umožňují škálovat marketplace bez zhoršování kvality.