24 sierpnia, 2025
Headlines

JSON-LD – co to jest?

JSON-LD – co to jest?

Krótka definicja

JSON-LD (JavaScript Object Notation for Linked Data) to format zapisu danych strukturalnych osadzanych na stronie w znaczniku <script type="application/ld+json">. Najczęściej wykorzystuje słownik Schema.org, aby wyszukiwarki i modele AI (LLM) mogły zrozumieć encje: kto jesteś (Organization), co oferujesz (Service/Product), o czym piszesz (Article/FAQ/HowTo).

TL;DR

  • JSON-LD = format danych strukturalnych dla ludzi i AI (LLM) – najwygodniejszy w implementacji i utrzymaniu.
  • Osadzaj w <script type="application/ld+json">, używaj typów Schema.org zgodnych z widoczną treścią.
  • Dla GEO/AEO kluczowe są: Organization, WebSite/SearchAction, Service, FAQPage, HowTo, Article/TechArticle, BreadcrumbList.
  • Dodawaj @id (kanoniczne identyfikatory), sameAs, inLanguage, dateModified; łącz encje relacjami (provider, isPartOf).
  • JSON-LD nie gwarantuje rich results, ale podnosi szansę cytowania i poprawia zrozumienie treści przez AI Overviews i wyszukiwarki LLM.

Dlaczego JSON-LD jest ważny dla GEO/AEO

  • AEO (Answer Engine Optimization): ułatwia wydobycie krótkich, samodzielnych odpowiedzi (FAQ/HowTo), które silniki odpowiedzi mogą cytować w całości.
  • GEO (Generative Engine Optimization): porządkuje graf encji marki, usług i treści eksperckich – modele generatywne łatwiej rozpoznają wiarygodne źródło.
  • E-E-A-T: jawne wskazanie organizacji, autorów, aktualności (np. dateModified) wzmacnia sygnały zaufania.

Jak działa (w praktyce, krok po kroku)

  1. Dobierz typ Schema.org do treści strony (np. Service dla oferty, FAQPage dla FAQ).
  2. Zbuduj JSON-LD, który odzwierciedla to, co widać (bez „wymyślania” danych).
  3. Nadaj @id (stały kanoniczny URL z fragmentem #…) i powiąż encje (provider, isPartOf, about).
  4. Dodaj sameAs (profile firmy), inLanguage, dateModified.
  5. Osadź skrypt na stronie (najczęściej w <head> lub przed </body>).
  6. Waliduj i aktualizuj przy każdej edycji treści.

Starter pack JSON-LD dla GEOknows (kopiuj–wklej, dopasuj)

1) Organization (marka + kontakt)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://geoknows.pl/#org",
  "name": "GEOknows",
  "url": "https://geoknows.pl/",
  "logo": "https://geoknows.pl/assets/logo.png",
  "sameAs": [
    "https://www.linkedin.com/company/geoknows"
  ],
  "contactPoint": [{
    "@type": "ContactPoint",
    "contactType": "sales",
    "email": "kontakt@geoknows.pl",
    "areaServed": "PL",
    "availableLanguage": ["pl","en"]
  }]
}

2) WebSite z wewnętrzną wyszukiwarką (SearchAction)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "@id": "https://geoknows.pl/#website",
  "url": "https://geoknows.pl/",
  "name": "GEOknows",
  "inLanguage": "pl",
  "potentialAction": {
    "@type": "SearchAction",
    "target": "https://geoknows.pl/?s={query}",
    "query-input": "required name=query"
  }
}

3) Service (np. „Audyt obecności w AI”)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "Service",
  "@id": "https://geoknows.pl/uslugi/audyt-ai/#service",
  "serviceType": "Audyt obecności w AI (GEO/AEO)",
  "provider": { "@id": "https://geoknows.pl/#org" },
  "areaServed": "PL",
  "inLanguage": "pl"
}

4) FAQPage (AEO-ready)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "inLanguage": "pl",
  "dateModified": "2025-08-13",
  "mainEntity": [{
    "@type": "Question",
    "name": "Co to jest JSON-LD?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "JSON-LD to format danych strukturalnych umieszczany w znaczniku <script>, zwykle z użyciem Schema.org, który pomaga wyszukiwarkom i AI zrozumieć encje i kontekst strony."
    }
  },{
    "@type": "Question",
    "name": "Czy JSON-LD pomaga w AEO?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Tak. Dzięki typom FAQPage i HowTo silniki odpowiedzi mogą łatwiej cytować Twoje krótkie, samodzielne odpowiedzi."
    }
  }]
}

5) HowTo (np. „Jak wdrożyć JSON-LD na stronie?”)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "@id": "https://geoknows.pl/geopedia/json-ld/#howto",
  "name": "Jak wdrożyć JSON-LD na stronie?",
  "inLanguage": "pl",
  "step": [
    { "@type": "HowToStep", "name": "Dobierz typ Schema.org", "text": "Wybierz typ odpowiadający treści: Organization, Service, FAQPage, HowTo, Article." },
    { "@type": "HowToStep", "name": "Zbuduj JSON-LD", "text": "Opisuj wyłącznie informacje widoczne na stronie; dodaj @id, sameAs, inLanguage, dateModified." },
    { "@type": "HowToStep", "name": "Osadź skrypt", "text": "Wstaw <script type='application/ld+json'> w szablonie strony." },
    { "@type": "HowToStep", "name": "Waliduj i utrzymuj", "text": "Sprawdzaj poprawność i aktualizuj przy zmianach treści." }
  ]
}

6) BreadcrumbList (okruszki – nawigacja semantyczna)

jsonKopiujEdytuj{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    { "@type": "ListItem", "position": 1, "name": "Strona główna", "item": "https://geoknows.pl/" },
    { "@type": "ListItem", "position": 2, "name": "GEOpedia", "item": "https://geoknows.pl/geopedia/" },
    { "@type": "ListItem", "position": 3, "name": "JSON-LD – co to jest?", "item": "https://geoknows.pl/geopedia/json-ld/" }
  ]
}

Dobre praktyki wdrożeniowe

  • Zgodność z treścią: JSON-LD musi opisywać to, co faktycznie jest na stronie (teksty, FAQ, HowTo).
  • @id i relacje: każdy typ z własnym stabilnym @id; łącz encje (provider, isPartOf, about), by tworzyć graf wiedzy.
  • Aktualność: uzupełniaj dateModified przy edycji, dodaj inLanguage.
  • Spójność marki: jedna kanoniczna Organization z sameAs (np. LinkedIn).
  • JSON-LD > Microdata: trzymaj się jednego podejścia (preferuj JSON-LD).
  • Bez „upiększania”: nie używaj AggregateRating/Review bez realnych recenzji na stronie.

Najczęstsze błędy

  • Duplikowanie identycznych FAQ na wielu URL-ach (lepiej: jeden hub + skróty z linkiem).
  • Sprzeczne @id dla tej samej encji na różnych podstronach.
  • Markup informacji niewidocznych dla użytkownika.
  • Mieszanie Microdata i JSON-LD na tej samej stronie (trudne w utrzymaniu).
  • Brak powiązań między encjami (luźne, niepołączone bloki).

Mini-HowTo: wdrożenie w 15 minut (checklista)

  • Dodać globalnie Organization + WebSite/SearchAction.
  • W sekcji GEOpedia/poradniki wdrożyć FAQPage lub HowTo.
  • Na stronach ofertowych dodać Service + połączenie provider → Organization.
  • Ustawić BreadcrumbList w szablonie.
  • Sprawdzić @id, sameAs, inLanguage, dateModified.
  • Przetestować w walidatorze i zautomatyzować aktualizacje w CMS.

FAQ (AEO-friendly)

Czym JSON-LD różni się od Schema.org?
Schema.org to słownik/ontologia typów, a JSON-LD to format, w którym te typy zapisujesz i osadzasz na stronie.

Czy JSON-LD gwarantuje rich results i obecność w AI Overviews?
Nie, ale zwiększa szansę, bo ułatwia zrozumienie encji i wyciągnięcie krótkich odpowiedzi (FAQ/HowTo).

Gdzie umieszczać skrypt JSON-LD – w <head> czy w <body>?
Możesz w obu, praktycznie najczęściej w <head> lub tuż przed </body>. Ważna jest poprawność i spójność.

Czy mogę mieć kilka skryptów JSON-LD na stronie?
Tak, jeśli każdy opisuje konkretną encję i spójnie łączysz je @id/relacjami.

Powiązane hasła GEOpedia

[Co to jest Schema.org?] • [Jak pisać sekcje FAQ pod AEO] • [AI Overviews – co to jest?] • [Czym jest GEO?] • [Czym jest AEO?]

Wejdź do świata widoczności w AI

📧 kontakt@geoknows.pl | 🌍 GEOknows.pl
📄 Zamów audyt obecności w AI

GEOknows Generative Engine Optimization. AI Overviews, wyszukiwarki LLM, optymalizacja dla Silników Generatywnych GEO, Optymalizacja dla Silników Odpowiedzi AEO