Dane strukturalne dla ChatGPT i systemów AI (JSON-LD)

Włączenie modułu w panelu

W panelu administracyjnym wybierz Aplikacje → Dane struktrualne

Dane schema.org wyświetlane na sklepie

Organization

Dane strukturalne @type: "Organization" są generowane głównie na podstawie modułów Informacje o sklepie oraz Open Graph, co zapewnia spójność kluczowych informacji o firmie w całym sklepie. Ten blok jednoznacznie definiuje, kim jest właściciel sklepu, jak można się z nim skontaktować oraz jaką markę reprezentuje - przede wszystkim dla systemów AI, a także dla wyszukiwarek.

• @type: "Organization": Określa, że opisywany obiekt jest firmą lub organizacją prowadzącą sklep internetowy, stanowiącą główny podmiot biznesowy całego serwisu.
• @id: Unikalny identyfikator organizacji w obrębie strony, wykorzystywany do łączenia danych pomiędzy różnymi schematami (np. Product, WebSite, WebPage). Pozwala systemom AI oraz wyszukiwarkom jednoznacznie rozpoznać, że wszystkie dane dotyczą tego samego podmiotu.
• name: Oficjalna nazwa firmy lub sklepu, pod którą marka jest rozpoznawana przez użytkowników, systemy AI oraz wyszukiwarki. Wartość pobierana jest z modułu Informacje o sklepie z pola Nazwa sprzedawcy / Firma. Wypełnienie tego pola jest warunkiem generowania schematu Organization.
• description: Krótki opis działalności firmy, informujący czym zajmuje się sklep i jaką ofertę prezentuje. Opis pobierany jest z modułu Open Graph z pola Opis promujący sklep. Jeśli pole to nie jest wypełnione, system wykorzystuje opis z modułu Pozycjonowanie → Meta tagi (pole Opis).
• url: Główny, kanoniczny adres strony internetowej sklepu, traktowany jako oficjalna strona organizacji. Wartość pobierana jest automatycznie na podstawie adresu sklepu.
• sameAs: Oficjalne adresy profili marki w mediach społecznościowych, wykorzystywane przez systemy AI do potwierdzania tożsamości organizacji oraz łączenia informacji o sklepie pochodzących z różnych źródeł. Dzięki temu AI lepiej rozpoznaje markę jako jeden spójny podmiot, a wyszukiwarki mogą poprawnie prezentować powiązane kanały komunikacji. Bazuje on na module Linki społecznościowe.
• email: Kontaktowy adres e-mail firmy, wykorzystywany jako oficjalny kanał komunikacji. Pobierany z modułu Informacje o sklepie z pola Kontaktowy adres e-mail.
• foundingDate: Rok założenia firmy, budujący wiarygodność oraz historię marki. Informacja pobierana jest z modułu Informacje o sklepie z pola Rok założenia.
• contactPoint: Dane kontaktowe przeznaczone dla klientów sklepu:
  • telephone: Numer telefonu do obsługi klienta, pobierany z modułu Informacje o sklepie z pola Telefon.
  • contactType: Rodzaj kontaktu, ustawiany na stałe jako customer support, zgodnie z zaleceniami schema.org.
  • areaServed: Kraje lub obszary, na których działa sklep. Informacja pobierana jest na podstawie aktywnych stref dostaw w koszyku. Dane prezentowane są w postaci dwuznakowych kodów krajów zgodnych ze standardem ISO 3166-1 alpha-2.
  • availableLanguage: Języki, w których dostępna jest obsługa klienta sklepu. Informacja ustalana jest na podstawie aktywnych wersji językowych sklepu. Dane prezentowane są w postaci angielskich nazw języków, zgodnie z wymaganiami schema.org.
• address: Fizyczny adres siedziby firmy, pobierany z modułu Informacje o sklepie.
  • streetAddress: Ulica i numer.
  • addressLocality: Miejscowość.
  • postalCode: Kod pocztowy.
  • addressCountry: Kraj, prezentowany w postaci dwuznakowego kodu ISO 3166-1 alpha-2.
• logo: Oficjalne logo firmy, wykorzystywane w danych strukturalnych oraz przez systemy AI i wyszukiwarki. Logo pobierane jest z modułu Open Graph z pola Zdjęcie promujące sklep. Jeśli pole to nie jest wypełnione, system automatycznie wykorzystuje logo z konfiguracji grafiki wybranego motywu sklepu.
  • url: Adres pliku graficznego logo.
  • width: Szerokość logo w pikselach.
  • height: Wysokość logo w pikselach.

WebSite

Dane strukturalne @type: "WebSite" opisują cały serwis jako jedną spójną stronę internetową, do której należą wszystkie podstrony sklepu. Ten blok pozwala systemom AI zrozumieć strukturę serwisu jako całości oraz jednoznacznie powiązać go z właścicielem strony, a następnie wykorzystywany jest przez wyszukiwarki do poprawnej interpretacji witryny.

• @type: "WebSite": Określa, że opisywany obiekt reprezentuje całą stronę internetową sklepu jako jeden spójny serwis.
• @id: Unikalny identyfikator serwisu, wykorzystywany do łączenia WebSite z innymi schematami (np. WebPage). Umożliwia systemom AI jednoznaczne rozpoznanie, że wszystkie strony należą do jednego serwisu.
• url: Główny, kanoniczny adres strony internetowej sklepu, traktowany jako punkt odniesienia dla całego serwisu. Wartość pobierana jest automatycznie na podstawie adresu sklepu.
• name: Nazwa serwisu, pod którą strona jest identyfikowana przez systemy AI oraz prezentowana w kontekście całej witryny. Wartość pobierana jest z modułu Informacje o sklepie z pola Nazwa sprzedawcy / Firma.
• publisher: Powiązanie strony internetowej z jej właścicielem (Organization). Informacja ta wskazuje systemom AI i wyszukiwarkom, kto jest odpowiedzialny za publikowane treści.

WebPage

Dane strukturalne @type: "WebPage" opisują konkretną podstronę sklepu, np. kartę produktu, kategorię lub stronę informacyjną. Ten blok pozwala systemom AI zrozumieć, czego dokładnie dotyczy dana strona i jaką pełni rolę w całym serwisie, a następnie umożliwia wyszukiwarkom prawidłowe indeksowanie i prezentowanie jej w wynikach wyszukiwania.

• @type: "WebPage": Określa, że opisywany obiekt jest pojedynczą stroną internetową należącą do serwisu sklepu.
• @id: Unikalny identyfikator strony, umożliwiający systemom AI jednoznaczne rozpoznanie tej konkretnej podstrony i powiązanie jej z innymi schematami (np. Product).
• name: Tytuł strony, który opisuje jej zawartość w sposób zrozumiały dla systemów AI oraz użytkowników. Odpowiada on tytułowi strony ustawionemu w zakładce Pozycjonowanie w panelu sklepu.
• url: Adres URL strony, wskazujący dokładne miejsce jej występowania w strukturze serwisu. Wartość pobierana jest automatycznie na podstawie aktualnego adresu strony.
• inLanguage: Język, w którym prezentowana jest treść strony. Informacja ta pozwala systemom AI poprawnie interpretować treść językowo i kontekstowo oraz pomaga wyszukiwarkom dopasować stronę do użytkowników. Wartość pobierana jest na podstawie aktualnie wybranego języka sklepu.
• isPartOf: Powiązanie strony z nadrzędnym serwisem (WebSite), dzięki czemu systemy AI rozumieją, że dana strona jest częścią większej całości.
• publisher: Wskazuje organizację (Organization), która publikuje i odpowiada za treść strony, co zwiększa wiarygodność informacji dla systemów AI oraz wyszukiwarek.
• description: Krótki opis zawartości strony, streszczający jej temat i wartość. Opis ten jest wykorzystywany przez systemy AI do zrozumienia kontekstu strony oraz przez wyszukiwarki przy prezentacji wyników. Pobierany jest na podstawie opisu strony w Pozycjonowaniu (meta description).
• primaryImageOfPage: Wskazuje główne zdjęcie produktu (ImageObject). Element ten dodawany jest na karcie produktu.

BreadcrumbList

Dane strukturalne @type: "BreadcrumbList" opisują ścieżkę nawigacyjną prowadzącą do aktualnej strony, np. od strony głównej przez kategorię aż do konkretnego produktu. Ten blok pozwala systemom AI zrozumieć kontekst strony w strukturze sklepu oraz relacje pomiędzy poszczególnymi poziomami oferty, a wyszukiwarkom umożliwia poprawne prezentowanie nawigacji w wynikach wyszukiwania.

• @type: "BreadcrumbList": Określa, że opisywany obiekt jest listą elementów nawigacyjnych (tzw. okruszków chleba), przedstawiających hierarchię strony w obrębie sklepu.
• @id: Unikalny identyfikator ścieżki nawigacyjnej powiązanej z konkretną stroną. Umożliwia systemom AI jednoznaczne powiązanie breadcrumb z daną podstroną oraz innymi schematami.
• itemListElement: Lista kolejnych elementów nawigacji, uporządkowanych od poziomu ogólnego do najbardziej szczegółowego. Każdy element opisuje jeden krok w strukturze sklepu:
  • @type: "ListItem": Określa pojedynczy element ścieżki nawigacyjnej.
  • position: Pozycja elementu w kolejności nawigacji, zaczynając od 1. Kolejność ta jest kluczowa dla systemów AI do prawidłowego zrozumienia hierarchii strony.
  • name: Nazwa danego poziomu nawigacji, prezentowana użytkownikom i wykorzystywana przez systemy AI do opisu struktury sklepu. Pobierana jest z systemu nawigacji sklepu.
  • item: Adres URL strony odpowiadającej danemu poziomowi nawigacji. Pozwala systemom AI oraz wyszukiwarkom powiązać nazwę z konkretną podstroną. Pobierany jest z systemu nawigacji sklepu.

ItemList

Dane strukturalne @type: "ItemList" opisują listę produktów wyświetlaną na stronie, np. w kategorii, liście producenta lub grupy. Ten blok pozwala systemom AI zrozumieć, że strona prezentuje zestaw powiązanych produktów w określonej kolejności, a wyszukiwarkom umożliwia poprawną interpretację i indeksowanie list produktowych.

• @type: "ItemList": Określa, że opisywany obiekt jest listą elementów (produktów) prezentowanych na stronie sklepu.
• @id: Unikalny identyfikator listy produktów powiązany z daną stroną (np. kategorią). Pozwala systemom AI jednoznacznie rozpoznać listę jako osobny byt logiczny i powiązać ją z innymi schematami.
• itemListElement: Lista elementów znajdujących się na stronie, uporządkowana w takiej kolejności, w jakiej produkty są prezentowane użytkownikowi. Każdy element listy opisuje jeden produkt:
  • @type: "ListItem": Określa pojedynczy element listy.
  • position: Pozycja produktu na liście, zaczynając od 1. Kolejność ta jest istotna dla systemów AI przy analizie układu i hierarchii prezentowanych produktów.
  • item: Obiekt typu Product, zawierający pełny opis konkretnego produktu (m.in. nazwę, adres URL, cenę, dostępność i markę). Dzięki temu systemy AI mogą analizować produkty zarówno jako elementy listy, jak i niezależne byty.
• numberOfItems: Łączna liczba produktów znajdujących się na oglądanej liście. Informacja ta ułatwia systemom AI oraz wyszukiwarkom zrozumienie skali prezentowanej oferty.

Product

Dane strukturalne @type: "Product" opisują pojedynczy produkt oferowany w sklepie. Ten blok pozwala systemom AI jednoznacznie zrozumieć, czym jest dany produkt, jak go zidentyfikować oraz na jakich warunkach jest sprzedawany, a wyszukiwarkom umożliwia poprawne indeksowanie ofert produktowych.

• @type: "Product": Określa, że opisywany obiekt jest produktem oferowanym do sprzedaży.
• @id: Unikalny identyfikator produktu, pozwalający systemom AI jednoznacznie rozpoznać ten sam produkt we wszystkich schematach (np. Review, Offer, ItemList).
• name: Nazwa produktu prezentowana użytkownikom oraz analizowana przez systemy AI w celu identyfikacji oferty.
• image: Zdjęcia produktu, wykorzystywane przez systemy AI do wizualnej identyfikacji oferty oraz przez wyszukiwarki w wynikach rozszerzonych.
• sku: Wewnętrzny identyfikator produktu w sklepie, umożliwiający jednoznaczne powiązanie oferty z systemem sprzedaży. W systemie jest to kod produktu.
• gtin: Globalny numer identyfikacyjny produktu (np. EAN-13). Jest to jeden z najsilniejszych identyfikatorów wykorzystywanych przez systemy AI i wyszukiwarki do porównywania ofert tego samego produktu. W systemie jest to kod producenta. Wyświetlany jest, jeśli jest wypełnony.
• mpn: Numer katalogowy producenta (Manufacturer Part Number). Ułatwia systemom AI i wyszukiwarkom jednoznaczną identyfikację produktu na tle innych ofert. W systemie jest to kod MPN. Wyświetlany jest, jeśli jest wypełnony.
• mainEntityOfPage: Powiązanie produktu z jego stroną (WebPage), co jasno wskazuje, że dana podstrona jest głównym miejscem prezentacji produktu.
• description: Opis produktu, wykorzystywany przez systemy AI do zrozumienia jego cech i wartości oraz przez wyszukiwarki do analizy treści strony.
• category: Kategoria produktu, pomagająca systemom AI lepiej sklasyfikować ofertę w strukturze sklepu.
• brand: Marka produktu, umożliwiająca systemom AI łączenie ofert tego samego producenta.
• offers: Informacje handlowe dotyczące sprzedaży produktu:
  • name / url Nazwa i url produktu dla sprzedaży
  • price: Cena brutto produktu.
  • priceCurrency: Waluta ceny.
  • availability: Dostępność produktu. Określana na podstawie konfiguracji Google Shopping
  • sku / mpn / gtin: Identyfikatory produktu na poziomie oferty, wykorzystywane do precyzyjnego dopasowania ofert w systemach AI i wyszukiwarkach.
  • priceValidUntil: Określa datę ważności podanej ceny. Wartością jest data 14 dni od aktualnego czasu.
  • seller: Organizacja sprzedająca produkt.

Recenzje (Review + AggregateRating)

Dane strukturalne aggregateRating oraz review są częścią schematu @type: Product" i opisują oceny oraz opinie klientów widoczne na karcie produktu. Dzięki nim systemy AI mogą lepiej ocenić jakość i wiarygodność produktu na podstawie realnych recenzji, a wyszukiwarki mogą poprawnie interpretować oceny i prezentować je w wynikach.

AggregateRating

• @type: "AggregateRating": Określa, że obiekt zawiera zbiorczą ocenę produktu, stanowiącą podsumowanie wszystkich recenzji danej wersji językowej przypisanych do danego produktu.
• ratingValue: Średnia ocena produktu wyliczana na podstawie wszystkich opinii. Pomaga systemom AI ocenić jakość oferty i porównywać produkty.
• reviewCount: Liczba recenzji uwzględnionych w średniej ocenie. Ułatwia systemom AI ocenę wiarygodności wyniku (np. wysoka ocena poparta wieloma opiniami).

Review

• @type: "Review": Określa, że obiekt opisuje pojedynczą opinię użytkownika, która jest bezpośrednio przypisana do produktu.
• reviewBody: Treść recenzji napisana przez klienta. Najważniejszy element dla systemów AI, ponieważ zawiera naturalny opis doświadczeń z produktem.
• reviewRating: Ocena liczbowa przypisana do recenzji:
  • @type: "Rating": Typ obiektu oceny.
  • ratingValue: Ocena przyznana przez użytkownika.
  • bestRating: Maksymalna możliwa ocena (w systemie naszego sklepu 5).
  • worstRating: Minimalna możliwa ocena (w systemie naszego sklepu 1).
• author: Autor recenzji:
  • @type: "Person": Określa, że autorem opinii jest osoba.
  • name: Imię lub nazwa autora recenzji. W przypadku braku danych użytkownika użyto wartości Anonymous.
• datePublished: Data publikacji recenzji, pozwalająca systemom AI ocenić aktualność opinii.
• inLanguage: Język, w którym została napisana recenzja. Ułatwia systemom AI interpretację treści w sklepach wielojęzycznych. Wartość pobierana jest na podstawie języka, w którym została dodana recenzja.
• itemReviewed: Powiązanie recenzji z konkretnym produktem (Product), dzięki czemu systemy AI jednoznacznie wiedzą, czego dotyczy dana opinia.

FAQPage

Dane strukturalne @type: "FAQPage" opisują sekcję pytań i odpowiedzi wyświetlaną bezpośrednio na karcie produktu. Dzięki temu systemy AI mogą jednoznacznie zrozumieć najczęstsze pytania klientów dotyczące produktu, a wyszukiwarki mogą prezentować gotowe odpowiedzi bezpośrednio w wynikach wyszukiwania. Dane te generowane są automatycznie na podstawie informacji wprowadzonych w module FAQ Produktu.

• @type: "FAQPage": Określa, że obiekt reprezentuje stronę lub sekcję zawierającą pytania i odpowiedzi (FAQ) przypisaną do produktu.
• @id: Unikalny identyfikator sekcji FAQ powiązanej z kartą produktu. Umożliwia systemom AI jednoznaczne rozpoznanie tego bloku danych.
• mainEntityOfPage: Wskazuje stronę (WebPage), czyli kartę produktu, do której przypisana jest sekcja FAQ. Dzięki temu systemy AI wiedzą, że pytania dotyczą konkretnej oferty.
• inLanguage: Język, w którym zapisane są pytania i odpowiedzi. Pozwala systemom AI poprawnie interpretować treść w sklepach wielojęzycznych. Wartość pobierana jest na podstawie języka, w którym zostało zadane ptyania klienta.
• mainEntity: Lista pytań i odpowiedzi wyświetlanych na karcie produktu:
  • @type: "Question": Określa pojedyncze pytanie zadawane przez klientów dotyczące produktu.
  • name: Treść pytania sformułowana w sposób naturalny i zrozumiały. Jest to kluczowy element dla systemów AI analizujących intencje użytkowników.
  • acceptedAnswer: Oficjalna odpowiedź przypisana do pytania:
    • @type: "Answer": Określa, że obiekt jest odpowiedzią na pytanie.
    • text: Treść odpowiedzi widoczna na karcie produktu, wykorzystywana przez systemy AI do generowania bezpośrednich odpowiedzi oraz przez wyszukiwarki w rich results.

ImageObject

Dane strukturalne @type: "ImageObject" opisują główne zdjęcie produktu. Pozwalają wyszukiwarkom oraz systemom AI rozpoznać, które zdjęcie najlepiej reprezentuje dany produkt. Informacje te są umieszczane na stronach kart produktów.

• @type: "ImageObject": Określa, że dany obiekt reprezentuje główne zdjęcie produktu.
• @id: Unikalny identyfikator zdjęcia, który pozwala jednoznacznie rozpoznać ten obiekt i odwoływać się do niego w innych blokach danych strukturalnych w WebPage.
• url: Adres url głównego zdjęcia produktu.

BlogPosting

Dane strukturalne @type: "BlogPosting" opisują pojedynczy wpis blogowy publikowany w sklepie. Dzięki temu systemy AI mogą poprawnie zrozumieć treść artykułu, jego temat, aktualność oraz powiązanie z marką, a wyszukiwarki mogą lepiej indeksować wpis i prezentować go w rozszerzonych wynikach wyszukiwania.

• @type: "BlogPosting": Określa, że obiekt reprezentuje pojedynczy wpis blogowy lub artykuł publikowany w ramach sklepu.
• headline: Tytuł wpisu blogowego, który wprost opisuje temat artykułu. Jest to kluczowa informacja dla systemów AI analizujących treść oraz dla wyszukiwarek wyświetlających nagłówek w wynikach wyszukiwania.
• description: Krótki opis lub streszczenie wpisu, wykorzystywane przez systemy AI do zrozumienia kontekstu artykułu oraz przez wyszukiwarki jako opis w wynikach wyszukiwania. Hierarchi pobierania opisu z edycji wpisu jest następująca:
  1. Opis w nagłówku
  2. Opis na liście
  3. Skrót treśći wpisu
• datePublished: Data i godzina publikacji wpisu. Informacja ta pozwala systemom AI oraz wyszukiwarkom ocenić aktualność treści.
• dateModified: Data i godzina ostatniej modyfikacji wpisu. Wskazuje, czy treść była aktualizowana, co zwiększa jej wiarygodność.
• isPartOf: Powiązanie wpisu blogowego z nadrzędnym serwisem (WebSite), dzięki czemu systemy AI rozumieją, że artykuł jest częścią bloga prowadzonego w ramach sklepu.
• image: Obraz główny wpisu blogowego, reprezentujący treść artykułu. Wykorzystywany przez systemy AI do analizy wizualnej oraz przez wyszukiwarki w podglądach i rich results.
  • @type: "ImageObject": Określa, że obiekt jest obrazem.
  • url: Adres pliku graficznego przypisanego do wpisu.
• url: Bezpośredni adres URL wpisu blogowego, wskazujący jego lokalizację w strukturze sklepu.
• publisher: Wskazuje organizację (Organization) odpowiedzialną za publikację wpisu, co wzmacnia wiarygodność treści dla systemów AI i wyszukiwarek.

Jak sprawdzić dane w swoim sklepie?

Dane strukturalne schema.org generowane przez moduł są zapisywane w formacie JSON-LD i umieszczane bezpośrednio w kodzie strony sklepu. Nie są one widoczne dla użytkowników, ale mogą być odczytywane przez systemy AI oraz wyszukiwarki. Aby je zobaczyć, wystarczy wyświetlić źródło strony (np. Ctrl + U - Cmd + U (MAC)) i wyszukać fragment application/ld+json.

Do sprawdzania poprawności danych strukturalnych rekomendowane są następujące narzędzia:

• Schema.org Validator - pokazuje czy kod jest semantycznie poprawny. Narzędzie do pełnej walidacji wszystkich danych schema.org.
• Test wyników rozszerzonych Google - pokazuje, czy Google może pokazać tzw. rich snippets. Pozwala sprawdzić, które elementy danych strukturalnych mogą być wykorzystywane przez Google (np. produkty, opinie, FAQ).