Dane strukturalne: przewodnik po Schema.org i JSON-LD dla firm w Polsce

JSON-LD (zalecany przez Google)

JSON-LD trafia jako osobny blok <script type="application/ld+json"> do <head> lub <body>. Nie przeplata się z widocznymi tagami HTML, a Google odczytuje także kod wstrzykiwany przez JavaScript lub CMS.

Mikrodane (Microdata)

Mikrodane dopisują atrybuty itemscope, itemtype i itemprop bezpośrednio do tagów HTML, przez co łatwo je utracić przy zmianie szablonu.

RDFa (Resource Description Framework in Attributes)

Rozszerzenie HTML5 z atrybutami vocab, typeof i property. W nowych wdrożeniach JSON-LD jest prostszy w utrzymaniu.

1. LocalBusiness i branżowe podtypy (adres, telefon i godziny otwarcia)

Dla punktu stacjonarnego podstawowym typem jest Lokalna firma (LocalBusiness). Wybierz najdokładniejszy podtyp: Dentist, Optician, Restaurant, Bakery, HairSalon, AutoRepair, Plumber, LegalService, AccountingService lub Store. Pola wymagane to name i address (PostalAddress z ulicą, kodem 00-000, miastem i PL); zalecane są telephone (+48), url, image, geo (GeoCoordinates), openingHoursSpecification i priceRange.

2. Organization (tożsamość firmy, logo i profile)

Typ Organizacja (Organization) opisuje podmiot przez name, url, logo, address, contactPoint, taxID, vatID oraz listę sameAs z linkami do profili i publikacji; zasady wysyłki do mediów omawia nasz przewodnik po materiałach prasowych dla firm.

3. Product z Offer (produkty, ceny i dostępność)

Dla towarów łączy się Produkt (Product) z Offer. Obok pola name w offers podaje się widoczną na stronie cenę (price), walutę (priceCurrency: "PLN" lub "EUR") i dostępność (availability, np. https://schema.org/InStock), a opcjonalnie shippingDetails i hasMerchantReturnPolicy.

4. BreadcrumbList (ścieżka nawigacyjna w wynikach Google)

Znacznik Menu nawigacyjne (BreadcrumbList) zapisuje hierarchię podstrony jako listę ListItem (position, name, item) nad tytułem wyniku.

5. Article, BlogPosting i NewsArticle (poradniki i aktualności)

Dla publikacji Google zaleca Artykuł (Article, NewsArticle, BlogPosting) z polami headline, image, datePublished, dateModified oraz author.

6. Event (szkolenia, webinary i dni otwarte)

Przy wydarzeniach Wydarzenie (Event) wymaga pól name, startDate oraz location (Place z PostalAddress).

7. Ograniczenia dla Review i AggregateRating (zakaz ocen własnej firmy)

Według dokumentacji Fragment opinii (Review, AggregateRating) strony z typem LocalBusiness lub Organization nie kwalifikują się do gwiazdek z oceną, gdy oceniany podmiot sam kontroluje witrynę (self-serving reviews). Na własnej stronie gwiazdki są dostępne m.in. dla Product, Book, Course, Event lub SoftwareApplication. Jak zbierać recenzje klientów, opisuje nasz przewodnik o pozyskiwaniu ocen i odpowiadaniu klientom.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Optician",
  "@id": "https://www.optyk-kaczmarek-warszawa.pl/#localbusiness",
  "name": "Salon Optyczny Oko-Wzrok Kaczmarek sp. z o.o.",
  "url": "https://www.optyk-kaczmarek-warszawa.pl/",
  "telephone": "+48 22 628 45 10",
  "priceRange": "$$",
  "image": [
    "https://www.optyk-kaczmarek-warszawa.pl/zdjecia/salon-mokotowska.jpg"
  ],
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "ul. Mokotowska 48",
    "postalCode": "00-543",
    "addressLocality": "Warszawa",
    "addressRegion": "mazowieckie",
    "addressCountry": "PL"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 52.2242,
    "longitude": 21.0218
  },
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "09:00",
      "closes": "18:30"
    },
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": "Saturday",
      "opens": "10:00",
      "closes": "15:00"
    }
  ],
  "sameAs": [
    "https://panoramafirm.pl/mazowieckie,,warszawa,mokotowska,48/salon_optyczny_oko_wzrok_kaczmarek",
    "https://www.oferteo.pl/salon-optyczny-oko-wzrok-kaczmarek/firma/482190"
  ]
}
</script>

1. Test wyników z elementami rozszerzonymi (Google Rich Results Test)

Oficjalny Test wyników z elementami rozszerzonymi sprawdza adres URL lub kod i oddziela błędy krytyczne od ostrzeżeń.

2. Walidator znaczników Schema (validator.schema.org)

Narzędzie Schema Markup Validator na validator.schema.org weryfikuje cały słownik schema.org.

3. Google Search Console: Narzędzie do sprawdzania adresów URL i raporty stanu

Po publikacji użyj funkcji Narzędzie do sprawdzania adresów URL (Test wersji opublikowanej, Poproś o zindeksowanie) oraz sekcji Ulepszenia i wygoda użytkowników. W raportach o wynikach z elementami rozszerzonymi elementy dzielą się na Nieprawidłowe i Prawidłowe z ostrzeżeniami, a naprawę potwierdza przycisk Sprawdź poprawkę.

Oznaczanie treści niewidocznych dla czytelników strony

Nie oznaczaj treści niewidocznych dla czytelników. Ceny, godziny otwarcia i pytania w JSON-LD muszą być widoczne w tekście podstrony.

Znaczniki niepasujące do podstrony lub powielone w stopce

Kod musi opisywać główną treść danego URL; nie wklejaj schematu Product w stopce wszystkich podstron.

Zablokowane podstrony lub obrazy

Strony i obrazy (logo, image) nie mogą być blokowane przez robots.txt ani noindex.

Raport Ręczne działania w Google Search Console

Naruszenie zasad może skutkować wpisem w raporcie Ręczne działania w Search Console (Stan i bezpieczeństwo > Ręczne działania). Ręczne działanie odbiera kwalifikację do wyników rozszerzonych, ale nie obniża pozycji strony w ogólnych wynikach wyszukiwania Google.

Znaczniki schema.org na maksymalnie 20 podstronach i 5 stron odpowiedzi

Dopasowany JSON-LD na maksymalnie 20 podstronach (firma, usługi, produkty, artykuły, widoczne FAQ, BreadcrumbList, sameAs) oraz 5 nowych stron odpowiedzi w języku witryny. Oznaczamy tylko widoczną treść.

Harmonogram z akceptacją (2 + 10 + 2 dni robocze)

Plan w 2 dni robocze od odpowiedzi; nic nie powstaje bez Twojej akceptacji. Dostarczenie 5 stron odpowiedzi i znaczników w 10 dni roboczych od akceptacji z dwiema rundami poprawek.

Instalacja przez konto redaktora lub przekazanie kodu z walidacją

Wdrożenie na WordPress, Shopify, Wix, Squarespace lub Webflow przez konto redaktora (bez głównego hasła) albo kod dla programisty, plus raport z Testu wyników z elementami rozszerzonymi i walidatora Schema.org w 2 dni robocze.

Jasne granice usługi i gwarancja zwrotu wpłaty

Usługa nie obiecuje wyniku rozszerzonego, wyższej pozycji ani wzmianki w asystencie AI. Pełny zwrot w razie niedostarczenia zamówienia zgodnie z opisem lub rezygnacji przed startem prac.