Schema.org pre knihy, ktoré spája Product Offer s Book metadátami

Knižné e-shopy ako Martinus, Panta Rhei alebo Megaknihy bežia v špecifickej situácii: predáva sa Product (s cenou, dostupnosťou), ale ide o Book (s autorom, ISBN, počtom strán). Schema.org to rieši cez kombinovaný typ `@type: ['Product', 'Book']` — produkt si drží Offer, Book si drží metadáta. Najčastejšia chyba je dať autora ako string namiesto Person objektu, alebo `inLanguage: 'slovenčina'` namiesto BCP 47 kódu `sk`. Druhý bod: ISBN-10 a ISBN-13 sú dva rôzne identifikátory — `isbn` ich oba akceptuje, ale Google odporúča ISBN-13.

Príklad validného Product JSON-LD

Hybridný typ Product + Book — Offer drží predaj, Book drží metadáta knihy.

{
  "@context": "https://schema.org",
  "@type": [
    "Product",
    "Book"
  ],
  "name": "Majster a Margaréta",
  "image": "https://example.sk/img/majster-margareta.jpg",
  "description": "Kultový román Michaila Bulgakova, satira na sovietsku Moskvu prepletená s biblickým príbehom. Slovenský preklad.",
  "sku": "SLOV-9788055636789",
  "isbn": "9788055636789",
  "gtin13": "9788055636789",
  "author": {
    "@type": "Person",
    "name": "Michail Bulgakov"
  },
  "translator": {
    "@type": "Person",
    "name": "Magda Takáčová"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Slovart"
  },
  "brand": {
    "@type": "Brand",
    "name": "Slovart"
  },
  "datePublished": "2023-09-15",
  "numberOfPages": 432,
  "bookFormat": "https://schema.org/Hardcover",
  "inLanguage": "sk",
  "offers": {
    "@type": "Offer",
    "url": "https://example.sk/kniha/majster-a-margareta",
    "priceCurrency": "EUR",
    "price": "15.99",
    "priceValidUntil": "2026-12-31",
    "itemCondition": "https://schema.org/NewCondition",
    "availability": "https://schema.org/InStock",
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "SK",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 14,
      "returnMethod": "https://schema.org/ReturnByMail",
      "returnFees": "https://schema.org/FreeReturn"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": "2.50",
        "currency": "EUR"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "SK"
      },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": {
          "@type": "QuantitativeValue",
          "minValue": 0,
          "maxValue": 1,
          "unitCode": "DAY"
        },
        "transitTime": {
          "@type": "QuantitativeValue",
          "minValue": 1,
          "maxValue": 3,
          "unitCode": "DAY"
        }
      }
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "256"
  }
}

Časté chyby (Knihy)

1. 1

   Autor ako string namiesto Person objektu

   Hodnota `'author': 'Michail Bulgakov'` je technicky validná, ale stráca štruktúru. Google nevie spárovať autora medzi knihami. Správne: `author: { @type: 'Person', name: '...' }`.

2. 2

   inLanguage: 'slovenčina' namiesto 'sk'

   Schema.org očakáva BCP 47 kód jazyka — 'sk' pre slovenčinu, 'cs' pre češtinu, 'en' pre angličtinu. Plné názvy vyhľadávače ignorujú.

3. 3

   Chýba bookFormat

   Bez `bookFormat` (Hardcover / Paperback / EBook / AudiobookFormat) Google nevie odlíšiť pevnú väzbu od e-knihy. Pri rovnakom ISBN je to úplne mimo.

4. 4

   Vydavateľstvo ako 'Vydavateľstvo XYZ'

   Placeholder texty z generátorov sa občas dostanú do produkcie. Publisher má byť reálne meno vydavateľstva ako Slovart, Tatran, Ikar, Albatros.

5. 5

   ISBN s pomlčkami vs bez

   Obe formy sú akceptované, ale buď konzistentný v rámci celého katalógu. Google odporúča formát bez pomlčiek (čisté 13 číslic) kvôli párovaniu cez Google Books.

Časté otázky