JSON-LD to rekomendowany przez Google sposób podawania danych strukturalnych w e-commerce. Poniżej znajdziesz skondensowany przewodnik w stylu Marka: priorytety, checklisty i gotowe, wielolinijkowe fragmenty kodu do wklejenia.

Dlaczego JSON-LD?

Na początek najważniejsze argumenty za JSON-LD, które wpływają na skalowalność wdrożeń i stabilność w SERP-ach:

• Wstrzykiwanie poza HTML: <script type="application/ld+json"> nie miesza się z layoutem.
• Rekomendacja Google: prostsze wersjonowanie i automatyzacja niż Microdata/RDFa.
• Efekt biznesowy: format sam nie podnosi pozycji, ale kwalifikuje do rich results, co zwykle zwiększa CTR.

Schemy, które realnie robią robotę w e-commerce

Skupiamy się na elementach, które najczęściej przynoszą mierzalny efekt (+CTR, lepsza prezentacja produktu, większa zgodność z Merchant Center):

1) Product (+ Offer / AggregateOffer)

To fundament kart produktu i merchant listings — bez tego nie pokażesz w wynikach ceny, dostępności ani zwrotów.

• Efekt: product snippets + merchant listings (cena, dostępność, opinie, warianty).
• Kluczowe pola: offers.price, priceCurrency, availability, GTIN (gtin13/gtin14).
• Logistyka: shippingDetails (koszt i kraj) oraz hasMerchantReturnPolicy (kraj + warunki).
• Aktualizacja 2025: w zwrotach wskaż kraje (applicableCountry) — to wymaganie doprecyzowane przez Google.
• Spójność: dane w JSON-LD muszą zgadzać się 1:1 z Merchant Center i tym, co widzi użytkownik.

2) Review / AggregateRating

Opinie poprawiają wiarygodność i CTR, ale wymagają zgodności z wytycznymi Google.

• Efekt: gwiazdki w SERP dla produktów i treści o produktach.
• Ograniczenie: brak ocen własnej firmy w LocalBusiness/Organization na własnej stronie.

3) BreadcrumbList

Okruszkowanie porządkuje hierarchię i poprawia czytelność wyników, zwłaszcza na desktopie.

• Efekt: klarowna ścieżka w SERP.
• Status: Google na mobile bywa oszczędniejsze, ale markup nadal warto utrzymywać.

4) Organization / LocalBusiness

Silne dane o marce wspierają Knowledge Panel i spójność profilu brandu w ekosystemie Google.

• Zakres: logo, NAP, identyfikatory, profile społecznościowe.
• Sklep stacjonarny: użyj LocalBusiness (godziny, adres, telefon).
• Nazwa witryny: na stronie głównej dodaj WebSite dla kontroli site name w SERP.

5) FAQPage (mocno ograniczone)

Rich results z FAQ pojawiają się dziś głównie w domenach rządowych i zdrowotnych — w e-commerce traktuj to jako „nice to have”.

• Widoczność: marginalna poza rząd/health.
• Wdrożenie: możesz zachować dla innych wyszukiwarek; w Google nie oczekuj stabilnej ekspozycji.

6) ItemList (opcjonalnie)

Przy listingach produktów warto jawnie wskazać, że strona jest listą — to sygnał pomocniczy dla robotów.

• Efekt: lepsze zrozumienie typu strony.
• Priorytet: niższy niż Product/Breadcrumb/Organization — wdrażaj, jeśli masz stabilny templating.

Checklista wdrożeniowa

Przed publikacją przejdź przez tę listę — minimalizuje typowe błędy i przyspiesza indeksację zmian:

• Spójność danych: cena/dostępność/wysyłka/zwroty = JSON-LD = front sklepu = Merchant Center.
• Identyfikatory: stosuj @id dla produktu i marki — ułatwia łączenie encji i unikanie duplikatów.
• GTIN/SKU: podaj GTIN, jeśli dostępny; w przeciwnym razie przynajmniej SKU + brand.
• Warianty: rozważ osobne @id dla koloru/rozmiaru zgodnie z wytycznymi listingów handlowych.
• Walidacja: użyj Rich Results Test (co Google może pokazać) i Schema Markup Validator (składnia) oraz monitoruj raporty w Search Console.

Minimalne wzorce (copy-paste)

Poniższe bloki są zapisane wielolinijkowo — wklej je w WordPress jako „Kod” lub „HTML niestandardowy”, zachowując złamania linii.

Product z ofertą, wysyłką i zwrotami

Ten przykład pokrywa najczęstsze wymagania merchant listings (w tym politykę zwrotów z krajem obowiązywania):

{
  "@context": "https://schema.org",
  "@type": "Product",
  "@id": "https://example.com/p/sku-123#product",
  "name": "Drewniana układanka Epinokio",
  "image": [
    "https://example.com/img/sku-123.jpg"
  ],
  "sku": "SKU-123",
  "gtin13": "5901234567890",
  "brand": {
    "@type": "Brand",
    "name": "Epinokio"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/p/sku-123",
    "price": "39.99",
    "priceCurrency": "PLN",
    "availability": "https://schema.org/InStock",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": "12.99",
        "currency": "PLN"
      },
      "shippingDestination": {
        "@type": "DefinedRegion",
        "addressCountry": "PL"
      }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "PL",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 30,
      "returnFees": "https://schema.org/FreeReturn"
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "128"
  }
}

BreadcrumbList (kategoria)

Użyj okruszków, aby wprost komunikować hierarchię kategorii w wynikach wyszukiwania:

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Zabawki",
      "item": "https://example.com/zabawki"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Układanki",
      "item": "https://example.com/zabawki/ukladanki"
    }
  ]
}

Organization (+ logo) na stronie głównej

Podstawowe dane marki wspierają budowę profilu brandu i spójność sygnałów w grafie wiedzy:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Epinokio",
  "url": "https://example.com/",
  "logo": "https://example.com/static/logo.png",
  "sameAs": [
    "https://www.facebook.com/epinokio",
    "https://www.instagram.com/epinokio"
  ]
}

WebSite (Site name)

Deklaracja nazwy witryny pomaga kontrolować prezentację brandu przy wynikach domenowych:

{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "url": "https://example.com/",
  "name": "Epinokio",
  "alternateName": "Epinokio – zabawki drewniane"
}

Co dziś nie daje efektu w Google SERP

Na koniec dwie rzeczy, które nie powinny być priorytetem — oszczędzasz czas wdrożeniowy bez utraty widoczności:

• Sitelinks Search Box: wycofane z SERP; pozostawienie w kodzie nie szkodzi, ale nie daje ekspozycji.
• FAQPage: widoczność realnie ograniczona do rząd/health; w e-commerce wpływ marginalny.