Schemat AggregateRating

TL;DR — AggregateRating to kod dodawany do strony, który mówi: „średnia ocena tego elementu wynosi 4,6 gwiazdki na podstawie tylu a tylu ocen”. To on zasila fragment z gwiazdkami widoczny pod niektórymi wynikami wyszukiwania. Najczęściej zagnieżdżasz go wewnątrz oznaczeń tego, co jest oceniane (produktu, przepisu lub firmy) — Google dopuszcza też samodzielną wersję, która bezpośrednio wskazuje oceniany element, ale częściej stosuje się zagnieżdżenie. Nie możesz po prostu ocenić własnej firmy i oczekiwać gwiazdek — Google to blokuje.

Czym jest schemat AggregateRating

Gdy strona pokazuje coś w rodzaju „4,6 ★ (218 ocen)”, człowiek odczytuje to na pierwszy rzut oka. Wyszukiwarka widzi zwykły tekst i musi zgadnąć, co oznaczają te liczby. AggregateRating zapisuje to w kodzie, korzystając ze wspólnego słownika schema.org: oznacza średni wynik, liczbę ocen, na których go oparto, oraz skalę.

Kluczowe jest słowo aggregate — chodzi o średnią z wielu ocen. To coś innego niż Review schema, które opisuje pisemną opinię jednej osoby. Wiele stron, które mają oba typy danych, używa ich razem: jednego AggregateRating dla średniej ogólnej oraz kilku pojedynczych obiektów Review.

Prawie zawsze zapisuje się go jako JSON-LD — niewielki blok kodu umieszczony na stronie bez zmiany jej wyglądu.

Dlaczego warto to wdrożyć

Korzyścią jest fragment wyników z oceną w gwiazdkach: złote gwiazdki i liczba ocen pod wynikiem wyszukiwania. Wynik z gwiazdkami wyróżnia się i może przyciągnąć więcej kliknięć. Aby go uzyskać, Google potrzebuje kilku elementów:

• ratingValue — średni wynik, na przykład 4.6.
• co najmniej jednej liczby — ratingCount (łączna liczba ocen) albo reviewCount (liczba osób, które zostawiły recenzję, z oceną gwiazdkową lub bez niej). Jedna z tych właściwości jest wymagana.
• itemReviewed — to, co jest oceniane. Jeśli zagnieździsz AggregateRating w produkcie, przepisie itd., zagnieżdżenie już to określa i możesz pominąć tę właściwość — jednak w każdym przypadku oceniany element musi mieć nazwę. Evidence for this claim Google supports aggregate ratings in review snippets only for eligible item types and qualifying content. Scope: Google Search review snippet requirements; stars are not guaranteed. Confidence: high · Verified: 2026-07-14 Google: Review snippet structured data

Opcjonalnie bestRating i worstRating opisują skalę (Google przyjmuje 1–5, jeśli ich nie podasz).

Najczęstszy błąd

Nie możesz dodać AggregateRating do własnej firmy i uzyskać gwiazdek. Jeśli prowadzisz firmę lokalną albo stronę przedsiębiorstwa i oznaczysz „nasi klienci oceniają nas na 4,9 gwiazdki”, Google nie pokaże tych gwiazdek. Nazywa to oceną self-serving — firma ocenia samą siebie — i blokuje takie dane konkretnie dla oznaczeń LocalBusiness i Organization.

Ale — i to właśnie wprowadza wiele osób w błąd — nie jest to ogólna zasada „nie możesz oceniać własnych rzeczy”. Sklep internetowy może zgodnie z zasadami pokazywać gwiazdki na własnych stronach produktów. Blokada dotyczy firmy oceniającej siebie jako firmę, a nie sklepu pokazującego prawdziwe oceny klientów dotyczące sprzedawanych przez niego produktów.

Dwie kolejne pułapki dla początkujących:

• Zawsze potrzebujesz liczby ocen, nie tylko średniej. Samo „4,6 gwiazdki” bez liczby ocen, na których oparto wynik, nie wystarczy.
• Oceny muszą być prawdziwe. Fałszowanie lub kupowanie ocen nie tylko łamie zasady — może doprowadzić do ręcznego działania, które usunie wyniki z elementami rozszerzonymi z Twojej strony.

Chcesz poznać dokładne wymagane właściwości, różnicę między ratingCount a reviewCount, pełny zakres zasady dotyczącej ocen self-serving oraz sposób naprawy częstych błędów w Search Console? Przejdź do karty Advanced.

TL;DR — AggregateRating zwykle zagnieżdża się we właściwości aggregateRating typu nadrzędnego (Product, LocalBusiness, Recipe, Book, Course, Event, Movie, SoftwareApplication i innych), dlatego przykłady zagnieżdżone pomijają itemReviewed — specyfikacja Google dopuszcza jednak także niezagnieżdżony AggregateRating, który wskazuje itemReviewed bezpośrednio. W obu przypadkach oceniany element potrzebuje nazwy. Wymagane właściwości Google dla wyniku rozszerzonego z gwiazdkami to ratingValue, co najmniej jedna z ratingCount/reviewCount oraz itemReviewed, gdy dane nie są zagnieżdżone; bestRating/worstRating są zalecane (niezbędne dla skal innych niż 1–5). Zasadę kwalifikacji trzeba rozumieć dokładnie: oceny self-serving nie kwalifikują do funkcji gwiazdek konkretnie dla LocalBusiness/Organization — gdy firma ocenia samą siebie — podczas gdy Product, Recipe, Movie i większość innych obsługiwanych typów pozostają kwalifikowane dla prawdziwych ocen. ratingCount (wszystkie oceny, także same gwiazdki) i reviewCount (osoby, które zostawiły recenzję, z oceną lub bez) to różne liczby. Prawidłowe oznaczenie daje kwalifikację do gwiazdek, nie wyższą pozycję, a fałszywe oceny mogą wywołać ręczne działanie dotyczące danych strukturalnych. Temat jest powiązany zarówno z hubem danych strukturalnych, jak i z SEO e-commerce, bo oznaczenia ocen regularnie pojawiają się w audytach sklepów.

AggregateRating a Review — różnica, od której zależy wszystko

Większość poradników konkurencji miesza te dwa typy w jedną płaską listę wymagań. Są odrębne:

• Review opisuje opinię jednej osoby o elemencie — pojedynczego autora, pojedyncze reviewRating i treść recenzji.
• AggregateRating opisuje statystyczną średnią wielu ocen — ratingValue oraz liczbę ocen.

Wiele rzeczywistych wdrożeń używa obu typów naraz, zagnieżdżonych w tym samym typie nadrzędnym: aggregateRating dla wyniku ogólnego i tablicy obiektów review dla pojedynczych opinii. Wskazówka Google działa w jedną stronę, nie w obie: jeśli już oznaczasz wiele pojedynczych recenzji, dodaj obok nich ocenę zbiorczą. Nie oznacza to, że samodzielny AggregateRating wymaga wymyślonych obiektów Review — strona z samą oceną zbiorczą, bez pojedynczych recenzji, jest prawidłową i kompletną implementacją. Jeśli zapamiętasz tylko jedno: Review = jedna opinia, AggregateRating = średnia z wielu. Po stronie pojedynczej recenzji zobacz siostrzany artykuł o Review schema.

Zagnieżdżenie i brak zagnieżdżenia — dwa prawidłowe sposoby podłączenia

AggregateRating nie ma niezależnego znaczenia na własnej stronie, ale nie obowiązuje też zasada „zagnieźdź albo nic”. Google obsługuje dwa kształty:

• Zagnieżdżony (częsty wzorzec) — AggregateRating znajduje się we właściwości aggregateRating innego typu (Product, LocalBusiness, Recipe i pozostałych obsługiwanych typów z poniższej listy). Ponieważ typ nadrzędny już identyfikuje element, zagnieżdżony AggregateRating pomija itemReviewed — element nadrzędny nadal potrzebuje jednak name.
• Niezagnieżdżony — AggregateRating może też występować samodzielnie, jeśli dostarcza itemReviewed z nazwą ocenianego elementu. W praktyce jest to rzadsze, ale stanowi udokumentowaną, prawidłową ścieżkę, a nie obejście.

W obu kształtach nazwa ocenianego elementu musi pojawić się w którymś miejscu — w typie nadrzędnym przy zagnieżdżeniu albo wewnątrz itemReviewed bez zagnieżdżenia. Typy hostów obsługiwane przez Google dla wyniku rozszerzonego recenzji/gwiazdek to zamknięta lista: Book, Course, Event, LocalBusiness, Movie, Product, Recipe, Software App, a także dodatkowe typy do zagnieżdżania (CreativeWorkSeason, CreativeWorkSeries, Episode, Game, MediaObject, MusicPlaylist, MusicRecording i Organization).

Praktyczny wniosek: umieszczenie aggregateRating na nieobsługiwanym typie nie wyświetli gwiazdek, nawet jeśli oznaczenie przejdzie walidację. Walidacja i kwalifikacja do wyniku rozszerzonego to dwa różne progi.

Właściwości wymagane i zalecane

Specyfikacja Google (bardziej rygorystyczna niż samo schema.org) dla wyniku rozszerzonego z gwiazdkami. Wiersz itemReviewed zależy od użytego kształtu:

Dwie reguły formatowania z własnych uwag schema.org, które powodują możliwe do uniknięcia błędy walidacji: używaj prawdziwych cyfr (0–9), a nie podobnych do nich symboli Unicode, oraz kropki jako separatora dziesiętnego, nie przecinka. "4,6" to częsty błąd w lokalizacjach używających przecinka dziesiętnego.

ratingCount a reviewCount — prawdziwa różnica

Wiele poradników używa tych właściwości zamiennie albo zawęża reviewCount do „recenzji pisemnych”. Aktualne definicje właściwości Google są dokładniejsze:

• ratingCount — łączna liczba ocen, w tym zgłoszeń zawierających wyłącznie gwiazdki, bez dodatkowej treści recenzji.
• reviewCount — liczba osób, które przekazały recenzję, z towarzyszącą oceną lub bez niej. Nie oznacza wyłącznie „recenzji pisemnych” — liczą się osoby, które dokonały recenzji, niezależnie od tego, czy dodały także ocenę liczbową.

W praktyce na większości platform ocen i recenzji te liczby nadal są różne, bo nie każdy, kto wystawia gwiazdki, pisze recenzję, i nie każdy autor recenzji dodaje gwiazdkę. Sklep może pokazywać 4,6 gwiazdki z ratingCount równym 1 200, podczas gdy 340 osób (reviewCount) rzeczywiście zostawiło treść recenzji. Odnieś powyższe definicje do sposobu, w jaki Twoja platforma rozdziela „ocenione” od „zrecenzowanych”, zamiast zakładać, że podział platformy dokładnie odpowiada temu przykładowi. Google wymaga co najmniej jednej z tych dwóch właściwości; podaj tę, która odpowiada temu, co faktycznie śledzi platforma, i nie zawyżaj żadnej liczby ponad to, co może potwierdzić strona.

bestRating / worstRating — dodaj je poza domyślną skalą

Google zakłada skalę 1–5, gdy tych właściwości brakuje. Jeśli oceniasz w skali 1–10, do 100 albo w dowolnym innym zakresie, musisz ustawić bestRating/worstRating, bo Google może źle odczytać skalę — nieopatrzone 9.2 w skali dziesięciopunktowej zostanie zinterpretowane jako 9,2 z 5, co nie ma sensu.

Zasada ocen self-serving — dokładnie określony zakres

To najbardziej zniekształcany punkt tego tematu, więc podam go dokładnie.

Brzmienie Google: „Jeśli podmiot, którego dotyczą recenzje, kontroluje recenzje na swój temat, jego strony używające danych strukturalnych LocalBusiness lub dowolnego innego typu Organization nie kwalifikują się do funkcji recenzji z gwiazdkami.” Uważnie przeczytaj zakres — wymienione są LocalBusiness i Organization (oraz ich podtypy). Chodzi o firmę oceniającą siebie jako firmę. Evidence for this claim Google requires ratings represented in structured data to be visible to users and prohibits misleading or fabricated review markup. Scope: Google Search structured-data and review snippet policies; violations can remove feature eligibility. Confidence: high · Verified: 2026-07-14 Google: Review snippet structured data

Nie dotyczy to Product. Sklep internetowy może zgodnie z zasadami pokazywać gwiazdki na własnych stronach produktów — to średnia prawdziwych ocen klientów produktu, który sprzedaje, a nie ocena firmy przez nią samą. Recipe, Movie, Book, SoftwareApplication i pozostałe obsługiwane typy również pozostają kwalifikowane, o ile oceny są prawdziwe.

Ta zasada pochodzi ze zmiany zasad Google z września 2019 r. („Making Review Rich Results more helpful”), która wprowadziła ujęcie „self-serving” — także dla recenzji własnej firmy osadzonych bezpośrednio albo pobranych przez widget strony trzeciej. (Parafrazuję rozumowanie tego ogłoszenia, zamiast je cytować; aktualne, cytowalne sformułowanie zasady znajduje się w przytoczonej wyżej dokumentacji Review snippet). Wniosek: widget recenzji strony trzeciej na własnej stronie LocalBusiness/Organization nadal jest self-serving i nadal nie kwalifikuje do gwiazdek.

Właśnie dlatego siostrzany artykuł o Organization schema jest tu istotny — to jeden z dwóch typów hosta, na których oceny utrzymywane przez samą firmę nie dają gwiazdek.

Tylko prawdziwe oceny — zasady dotyczące spamu i ręcznych działań

Dwie proste zasady z wytycznych Google:

• Nie agreguj z innych stron. Google mówi: „Nie agreguj recenzji ani ocen z innych stron internetowych.” Zeskrobywanie ocen z innych miejsc do własnych oznaczeń jest niedozwolone.
• Oceny muszą pochodzić od prawdziwych użytkowników. Zasady Google dotyczące danych strukturalnych traktują prawdziwe oceny jako wymóg egzekwowany, a nie życzenie — przykład dotyczący przepisów wskazuje, że “reviews or ratings not by actual users may result in manual action.” (tłumaczenie) recenzje lub oceny, które nie pochodzą od rzeczywistych użytkowników, mogą skutkować ręcznym działaniem. Ta zasada rozciąga się na politykę recenzji dla różnych typów.

Ręczne działanie dotyczące danych strukturalnych za wprowadzające w błąd lub fałszywe oceny odbiera stronie kwalifikację do wyniku rozszerzonego. To wymóg egzekwowany, nie teoretyczny. Zadbaj też, by treść recenzji rzeczywiście była na stronie — Google oczekuje, że oznaczone oceny będą łatwo dostępne użytkownikom na tej samej stronie i będą dotyczyć konkretnego elementu, a nie kategorii ani listy.

Miejsce AggregateRating w szerszym obrazie

Jak wszystkie dane strukturalne, AggregateRating wpływa na kwalifikację do wyniku rozszerzonego, nie na ranking — szersze huby Schema Markup i Structured Data wyjaśniają to dokładnie, więc nie będę powtarzać całej argumentacji. aggregateRating jest zalecaną właściwością dla Product (najczęstszego hosta w praktyce) oraz ProductGroup przy zbiorczych ocenach wariantów — oba artykuły są naturalnymi następnymi lekturami. Używaj JSON-LD; to format zalecany przez Google i ten, którego używa każdy przykład w tym artykule.

Bing i inne wyszukiwarki: schema.org to wspólny słownik Google/Microsoft/Yahoo/ Yandex, a ogólna dokumentacja danych strukturalnych Binga potwierdza obsługę oznaczeń schema.org/JSON-LD. Obecnie nie da się potwierdzić w dokumentacji Microsoftu z pierwszej ręki tezy o zgodności wymagań Binga dla AggregateRating z Google — Bing nie publikuje porównywalnego podziału wymagań i zaleceń dla poszczególnych typów ani polityki ocen self-serving w sposób, w jaki robi to Google, a jego powierzchnia wyników rozszerzonych dla ocen jest węższa i słabiej opisana. Nie zakładaj, że zasady kwalifikacji Binga odzwierciedlają zasady Google punkt po punkcie; traktuj to jako otwarte pytanie do czasu opublikowania przez Binga własnych wytycznych dotyczących AggregateRating.

Podsumowanie AI

Skrócona wersja sekcji Advanced:

• Czym jest: oznaczenie schema.org/AggregateRating (zwykle JSON-LD) dla średniej z wielu ocen/recenzji elementu — w odróżnieniu od Review, które opisuje opinię jednego recenzenta. Wiele stron używa obu typów razem; Google wymaga oceny zbiorczej, gdy oznaczasz już wiele pojedynczych recenzji, a nie odwrotnie.
• Zagnieżdżone czy niezagnieżdżone: AggregateRating zwykle znajduje się we właściwości aggregateRating typu nadrzędnego (Product, LocalBusiness, Recipe, Book, Course, Event, Movie, SoftwareApplication i innych), dlatego przykłady zagnieżdżone pomijają itemReviewed — Google obsługuje jednak również niezagnieżdżony AggregateRating, który bezpośrednio wskazuje itemReviewed. W obu przypadkach oceniany element potrzebuje nazwy.
• Wymagane do wyniku z gwiazdkami: ratingValue, co najmniej jedna z ratingCount/reviewCount oraz itemReviewed, gdy dane nie są zagnieżdżone. Zalecane: bestRating/worstRating (niezbędne poza domyślną skalą 1–5).
• ratingCount a reviewCount: ratingCount = wszystkie oceny, w tym same gwiazdki; reviewCount = osoby, które zostawiły recenzję, z oceną lub bez. To różne liczby; jedna z nich jest potrzebna.
• Zasada self-serving (główne źródło pomyłek), z dokładnym zakresem: oceny self-serving nie kwalifikują do gwiazdek tylko dla LocalBusiness/Organization — gdy firma ocenia siebie — i zasada ta została wprowadzona we wrześniu 2019 r. Product, Recipe, Movie itd. pozostają kwalifikowane dla prawdziwych ocen. Widget strony trzeciej z recenzjami własnej firmy nadal jest self-serving.
• Obsługiwane typy hosta są określone: Book, Course, Event, LocalBusiness, Movie, Product, Recipe, Software App oraz dodatkowe typy do zagnieżdżania. Na nieobsługiwanym typie gwiazdki się nie wyświetlą, nawet jeśli oznaczenie przejdzie walidację.
• Tylko prawdziwe oceny: „Nie agreguj recenzji ani ocen z innych stron”, a fałszywe lub motywowane oceny mogą wywołać ręczne działanie dotyczące danych strukturalnych, które odbierze kwalifikację do wyniku rozszerzonego.
• Formatowanie: prawdziwe cyfry (0–9), separator dziesiętny w postaci kropki (nie przecinka).
• Kwalifikacja ≠ ranking: prawidłowe oznaczenie tylko kwalifikuje stronę do gwiazdek; nie jest czynnikiem rankingowym. Bing używa tego samego słownika, ale nie ma porównywalnej dokumentacji kwalifikacji.

Oficjalna dokumentacja

Dokumentacja źródłowa dotycząca AggregateRating.

schema.org (słownik)

• Typ AggregateRating — podstawowa definicja typu, lista właściwości (itemReviewed, ratingCount, reviewCount, dziedziczone ratingValue/bestRating/worstRating) oraz uwagi o zapisie cyfr i separatora dziesiętnego.

Google — kwalifikacja i wymagania

• Review snippet (dane strukturalne Review i AggregateRating) — autorytatywna specyfikacja: wymagane właściwości, lista obsługiwanych typów hosta, zakres zasady ocen self-serving (LocalBusiness/Organization) oraz reguła „nie agreguj z innych stron”.
• Ogólne wytyczne dotyczące danych strukturalnych — zasady dotyczące spamu, język dotyczący ręcznych działań i wymóg prawdziwych ocen.
• Making Review Rich Results more helpful (wrzesień 2019 r.) — źródło zasady ocen self-serving, przywołane dla kontekstu czasu i przyczyny zmiany.
• Rich Results Test — waliduje oznaczenie i sprawdza kwalifikację do gwiazdek.

Bing / Microsoft

• Oznaczanie witryny danymi strukturalnymi — ogólna obsługa danych strukturalnych przez Binga (schema.org, JSON-LD).

Cytaty ze źródeł

Dosłowne wypowiedzi z schema.org i dokumentacji Google. Gdy strona źródłowa udostępnia tekst, odsyłacz prowadzi bezpośrednio do cytowanego fragmentu.

schema.org — definicja typu

• “The average rating based on multiple ratings or reviews.” (tłumaczenie) Średnia ocena oparta na wielu ocenach lub recenzjach. Przejdź do cytatu

Dokumentacja Google — oznaczanie oceny zbiorczej

• “Make sure to mark up an aggregate evaluation of an item by many people with schema.org/AggregateRating.” (tłumaczenie) Pamiętaj, aby ocenę elementu dokonaną zbiorczo przez wiele osób oznaczyć za pomocą schema.org/AggregateRating. Przejdź do cytatu

Dokumentacja Google — zasada ocen self-serving (zakres ograniczony do LocalBusiness/Organization)

• “If the entity that’s being reviewed controls the reviews about itself, their pages that use LocalBusiness or any other type of Organization structured data are ineligible for star review feature.” (tłumaczenie) Jeśli podmiot, którego dotyczą recenzje, kontroluje recenzje na swój temat, jego strony używające danych strukturalnych LocalBusiness lub dowolnego innego typu Organization nie kwalifikują się do funkcji recenzji z gwiazdkami. Przejdź do cytatu

Dokumentacja Google — nie agreguj z innych stron

• “Don’t aggregate reviews or ratings from other websites.” (tłumaczenie) Nie agreguj recenzji ani ocen z innych stron internetowych. Przejdź do cytatu

Google — zasady dotyczące danych strukturalnych (wprowadzanie w błąd i ręczne działanie)

• “Don’t use structured data to deceive or mislead users. Don’t impersonate any person or organization.” (tłumaczenie) Nie używaj danych strukturalnych do oszukiwania ani wprowadzania użytkowników w błąd. Nie podszywaj się pod żadną osobę ani organizację. Przejdź do cytatu
• W sprawie prawdziwych ocen (przykład dotyczący przepisów, możliwy do uogólnienia na zasady recenzji): “reviews or ratings not by actual users may result in manual action.” (tłumaczenie) recenzje lub oceny, które nie pochodzą od rzeczywistych użytkowników, mogą skutkować ręcznym działaniem. Ogólne wytyczne dotyczące danych strukturalnych

AggregateRating a Review — czego potrzebuję?

Przejdź kolejno przez te pytania:

1. Oznaczasz opinię jednej osoby czy średnią z wielu?

• Opinia jednego recenzenta (pojedyncza ocena i treść recenzji) → potrzebujesz schematu Review, nie AggregateRating.
• Średnia z wielu ocen → AggregateRating. Przejdź dalej.
• Oba przypadki (wynik ogólny i pojedyncze opinie) → użyj obu typów, zagnieżdżonych w tym samym typie nadrzędnym: jedno aggregateRating oraz tablica obiektów review.

2. Zagnieżdżasz dane czy występują samodzielnie?

• Zagnieżdżenie w Product (lub ProductGroup), Recipe, Movie, Book, Course, Event albo SoftwareApplication → obsługiwany host; prawdziwe oceny zwykle kwalifikują do gwiazdek, a itemReviewed można pominąć, bo typ nadrzędny już wskazuje element. Przejdź dalej.
• Ocena samego LocalBusiness albo Organization → zatrzymaj się. Oceny self-serving w tych typach nie kwalifikują do gwiazdek. Nie oczekuj gwiazdek, nawet jeśli oznaczenie przechodzi walidację.
• Brak zagnieżdżenia → to również jest poprawne, jeśli AggregateRating dostarcza itemReviewed z bezpośrednią nazwą ocenianego elementu.
• Inny typ nadrzędny, którego nie ma na obsługiwanej liście Google → oznaczenie może przejść walidację, ale gwiazdki się nie wyświetlą — host jest nieobsługiwany.

3. Czy masz wymagane właściwości?

• Potwierdź ratingValue oraz co najmniej jedną z właściwości ratingCount/reviewCount. Jeśli nie stosujesz zagnieżdżenia, ustaw także itemReviewed — w każdym przypadku oceniany element musi mieć nazwę. Brak liczby ocen to najczęstszy błąd.
• Skala inna niż 1–5? Dodaj bestRating/worstRating, bo Google może ją źle odczytać.

4. Czy oceny są prawdziwe i widoczne na stronie?

• Prawdziwe, pochodzące od użytkowników, dotyczące tego konkretnego elementu i widoczne na tej samej stronie → dobrze.
• Zebrane z innych stron, sfałszowane albo motywowane → nie — grozi to ręcznym działaniem dotyczącym danych strukturalnych, nie tylko brakiem fragmentu.

Zasada praktyczna: Review to jedna opinia; AggregateRating to średnia z wielu. Produkty i pokrewne typy mogą pokazywać prawdziwe gwiazdki; firma nie może oceniać samej siebie.

Mity i błędy dotyczące AggregateRating

Mit: „Mogę dodać AggregateRating do mojego schematu Organization/LocalBusiness i uzyskać gwiazdki jak produkt”. Nie. Google wyraźnie wyklucza oceny self-serving dla LocalBusiness/Organization z funkcji recenzji z gwiazdkami — strony używające danych strukturalnych LocalBusiness lub dowolnego typu Organization nie kwalifikują się, gdy podmiot kontroluje recenzje na swój temat. Tak jest od zmiany zasad z września 2019 r. Ocena firmy przez samą firmę nie daje gwiazdek; sklep nadal może oceniać swoje produkty.

Mit: „AggregateRating i Review to to samo”. Review opisuje opinię jednego recenzenta; AggregateRating opisuje średnią z wielu. To różne typy i różne wymagane właściwości. Wiele stron używa obu zagnieżdżonych razem — nie są jednak wymienne, a użycie oceny zbiorczej nie nakłada obowiązku wymyślania pojedynczych obiektów Review.

Mit: „Potrzebuję tylko ratingValue — liczba ocen nie ma znaczenia”. Google wymaga obok ratingValue co najmniej jednej z właściwości ratingCount lub reviewCount. Sama średnia bez liczebności próby nie kwalifikuje do wyniku.

Mit: „ratingCount i reviewCount to ta sama liczba”. To różne wartości. ratingCount obejmuje oceny zawierające tylko gwiazdki, bez treści recenzji; reviewCount to liczba osób, które zostawiły recenzję, z dołączoną oceną lub bez — nie ogranicza się wyłącznie do „recenzji pisemnych”. Strona może mieć 1 200 ocen, ale tylko 340 osób, które zostawiły recenzję. Podaj wartość faktycznie śledzoną przez platformę — nie zawyżaj żadnej z nich.

Mit: „Widget recenzji strony trzeciej na mojej stronie firmy automatycznie kwalifikuje do gwiazdek”. Jeśli widget pokazuje recenzje Twojej własnej firmy/organizacji — nawet pobrane z platformy zewnętrznej — nadal są self-serving i nie kwalifikują do wyświetlania gwiazdek dla LocalBusiness/Organization.

Mit: „Fałszywe lub motywowane oceny pięciogwiazdkowe najwyżej sprawią, że fragment się nie pokaże”. Google traktuje wymóg prawdziwych ocen jako egzekwowany — sfałszowane oceny mogą wywołać ręczne działanie dotyczące danych strukturalnych, które odbierze stronie kwalifikację do wyniku rozszerzonego, a nie tylko ukryje fragment.

Mit: „Schemat AggregateRating poprawia ranking”. Jak wszystkie oznaczenia schematu, wpływa na kwalifikację do wyniku rozszerzonego, nie na ranking — daje kwalifikację do gwiazdek, nie pozycję. Hub Structured Data wyjaśnia to szerzej.

Błąd: agregowanie ocen z innych stron internetowych. Wytyczne Google są jasne: „Nie agreguj recenzji ani ocen z innych stron internetowych.” Używaj wyłącznie ocen, które Twoja strona rzeczywiście zebrała.

Błąd: nieprawidłowe ratingValue. Użyj prawdziwych cyfr i kropki jako separatora dziesiętnego (4.6, nie 4,6 ani podobnych cyfr Unicode). Przecinek dziesiętny to częsty i możliwy do uniknięcia błąd walidacji.

Błąd: aggregateRating na nieobsługiwanym typie hosta. Samodzielny AggregateRating z itemReviewed jest poprawny, a zagnieżdżenie w obsługiwanym typie to częsty wzorzec — w obu przypadkach typ elementu musi znajdować się na obsługiwanej przez Google liście. Na nieobsługiwanym typie oznaczenie może przejść walidację, ale gwiazdki się nie wyświetlą.

Czysty i uszkodzony JSON-LD AggregateRating

Czysta, zagnieżdżona ocena zbiorcza

AggregateRating jest prawidłowo zagnieżdżony w Product, ma poprawną średnią, liczbę ocen i określoną skalę — obok znajduje się też pojedyncza review (częsty wzorzec z praktyki):

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Hiking Backpack",
  "image": "https://example.com/img/backpack.jpg",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "bestRating": "5",
    "worstRating": "1",
    "ratingCount": "1200",
    "reviewCount": "340"
  },
  "review": [
    {
      "@type": "Review",
      "author": { "@type": "Person", "name": "James Smith" },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5",
        "bestRating": "5"
      },
      "reviewBody": "Comfortable on long days, great ventilation."
    }
  ]
}

Zwróć uwagę, że ratingCount (1 200 wszystkich ocen) i reviewCount (340 osób, które zostawiły recenzję) to różne liczby — tak jak zwykle wygląda to w praktyce.

Forma niezagnieżdżona

Zagnieżdżenie jest częstym wzorcem, ale AggregateRating wcale nie musi znajdować się w Product (ani w innym hoście). Może występować samodzielnie, pod warunkiem że podaje itemReviewed z nazwą ocenianego elementu — to udokumentowany, prawidłowy kształt, a nie obejście:

{
  "@context": "https://schema.org/",
  "@type": "AggregateRating",
  "itemReviewed": {
    "@type": "Product",
    "name": "Trailhead 30L Hiking Backpack"
  },
  "ratingValue": "4.6",
  "bestRating": "5",
  "worstRating": "1",
  "ratingCount": "1200",
  "reviewCount": "340"
}

Te same właściwości i te same zasady kwalifikacji — różnica dotyczy wyłącznie miejsca, w którym znajduje się itemReviewed. Przy zagnieżdżeniu wynika ono z typu nadrzędnego i zwykle się je pomija; bez zagnieżdżenia trzeba je podać jawnie.

Ta sama ocena zbiorcza, ale uszkodzona

Każda zaznaczona niżej linia przedstawia prawdziwy, częsty błąd walidacji:

{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Trailhead 30L Hiking Backpack",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4,6"
  }
}

Co jest nie tak:

• Brak ratingCount lub reviewCount — pojawia się klasyczny błąd „Either ‘ratingCount’ or ‘reviewCount’ should be specified”. Ocena zbiorcza potrzebuje liczebności próby.
• ratingValue: "4,6" — przecinek jako separator dziesiętny. Użyj kropki: "4.6".
• Brak bestRating/worstRating — przy skali 1–5 jest to dopuszczalne, ale pominięcie ich przy innej skali sprawi, że Google źle ją odczyta.

I błąd, który przechodzi walidację, ale nadal nie pokazuje gwiazdek: umieszczenie tego dokładnego aggregateRating na LocalBusiness albo Organization oceniającym siebie — to ocena self-serving i nie kwalifikuje do gwiazdek, niezależnie od czystości oznaczenia.

Częste błędy Search Console / Rich Results Test → naprawy

Narzędzia do tworzenia i sprawdzania oznaczeń AggregateRating

Mój Schema Markup Validator to dobre miejsce na start po napisaniu JSON-LD. Wklej blok (albo całą stronę), a narzędzie uruchomi sprawdzenia warstwowe według ważności dla słownika AggregateRating schema.org i wymagań Google dla wyników rozszerzonych — wykryje brak liczby ocen, błąd przecinka dziesiętnego oraz problemy ze skalą bestRating/worstRating, a następnie zwróci poprawiony blok JSON-LD gotowy do skopiowania.

Mój Rich-Result Eligibility Checker odpowiada na inne pytanie: nie „czy to jest poprawny JSON-LD”, lecz „czy ta konkretna strona kwalifikuje się do wyniku Google z gwiazdkami”. Wklej JSON-LD, stronę HTML albo pobierz aktywny URL, a narzędzie pokaże dla każdego typu, które wymagane pola (itemReviewed, ratingValue, ratingCount/reviewCount) są obecne, a których brakuje, oraz które zalecane pola (bestRating, worstRating) pomijasz poza domyślną skalą.

Jeśli zaczynasz od pustej strony, zamiast naprawiać istniejące oznaczenie, mój Schema Markup Generator ma ukierunkowany formularz do tworzenia aggregateRating zagnieżdżonego w Product (albo innym obsługiwanym typie) bez ręcznego pisania JSON-LD i sygnalizuje podczas wypełniania, czy każda właściwość jest wymagana przez Google, zalecana przez Google czy dostępna tylko w schema.org.

Gdy oznaczenie przejdzie oba sprawdzenia, uruchom stronę w oficjalnym narzędziu Google Rich Results Test — to narzędzie, z którego Google faktycznie korzysta do ustalania kwalifikacji, więc jest ostatecznym sprawdzianem przed publikacją.

Typowe problemy z AggregateRating i sposoby naprawy

Oznaczenie przechodzi walidację, ale w wynikach nigdy nie pojawiają się gwiazdki

Najbardziej prawdopodobna przyczyna to zasada ocen self-serving: aggregateRating jest zagnieżdżone w LocalBusiness albo Organization, a firma ocenia samą siebie. Google całkowicie wyklucza tę kombinację z funkcji gwiazdek, niezależnie od tego, jak czysty jest JSON-LD. Najpierw sprawdź typ nadrzędny — jeśli to LocalBusiness lub Organization, przenieś rozmowę o ocenach do prawdziwych recenzji produktów, bo firma nie może zdobyć gwiazdek, oceniając samą siebie, ale sklep może oceniać swoje produkty. Drugą najbardziej prawdopodobną przyczyną jest nieobsługiwany typ hosta — aggregateRating zagnieżdżone w typie spoza obsługiwanej listy Google (Book, Course, Event, LocalBusiness, Movie, Product, Recipe, SoftwareApplication i krótsza lista dodatkowa) przejdzie walidację, ale nigdy nie wyświetli gwiazdek.

Rich Results Test albo Search Console zgłasza „Either ‘ratingCount’ or ‘reviewCount’ should be specified”

Obiekt aggregateRating nie ma właściwości określającej liczebność próby. Samo ratingValue nie wystarczy — Google wymaga obok niego co najmniej jednej z ratingCount lub reviewCount. Dodaj tę, która odpowiada temu, co faktycznie śledzi Twoja platforma (łączną liczbę ocen, w tym same gwiazdki, albo liczbę osób, które zostawiły recenzję), a następnie wykonaj test ponownie.

ratingValue nie przechodzi walidacji, mimo że liczba wygląda poprawnie

Sprawdź, czy nie użyto przecinka jako separatora dziesiętnego ("4,6" zamiast "4.6") albo podobnej do cyfry liczby Unicode zamiast prawdziwego znaku 0–9 — oba błędy są częste w lokalizacjach formatujących ułamki przecinkiem i pozostają niezauważalne, dopóki walidator ich nie zgłosi.

Błąd walidatora: “The best rating value must be greater than the worst rating value” (tłumaczenie) „Wartość najlepszego wyniku musi być większa niż wartość najgorszego wyniku”

bestRating i worstRating ustawiono odwrotnie albo brakuje worstRating, a domyślna skala Google 1–5 nie odpowiada Twojej rzeczywistej skali (ocena 1–10 lub do 100 bez kwalifikatora zostanie źle odczytana względem domyślnego zakresu 1–5). Ustaw obie właściwości jawnie — na przykład worstRating: 1, bestRating: 5 — gdy skala nie jest domyślna.

Search Console pokazuje prawidłowe elementy, ale gwiazdek nadal nie ma w aktywnym SERP-ie

Przejście walidacji i status „prawidłowe” w Search Console oznaczają tylko, że strona kwalifikuje się do wyniku rozszerzonego z gwiazdkami — nie gwarantują, że Google go wyświetli. To oczekiwane zachowanie, a nie błąd do usunięcia: kwalifikacja do wyniku rozszerzonego nie jest obietnicą wyświetlenia ani rankingu. Jeśli oznaczenie jest rzeczywiście poprawne i kwalifikowane, po stronie kodu nie ma już nic do naprawy.

Wyniki rozszerzone zniknęły po wcześniejszym wyświetlaniu

Ręczne działanie dotyczące sfałszowanych albo zagregowanych z innych miejsc ocen odbiera stronie kwalifikację do wyniku rozszerzonego. Najpierw sprawdź raport Ręczne działania w Search Console. Jeśli nie ma takiego działania, zwaliduj aktualne oznaczenie ponownie — zmiana szablonu albo CMS-u mogła po cichu usunąć właściwość (brak liczby ocen, przepisana skala), która wcześniej była poprawna.

Jak potwierdzić, że zmiana AggregateRating zadziałała

Test 1: składnia JSON-LD i walidacja wymaganych właściwości

Test: Wklej zaktualizowany JSON-LD do mojego Schema Markup Validator albo uruchom aktywną stronę w Rich Results Test. Oczekiwany wynik: Brak błędów w bloku AggregateRating — obecne ratingValue z prawdziwą cyfrą i separatorem dziesiętnym w postaci kropki oraz co najmniej jedna z właściwości ratingCount lub reviewCount. Interpretacja niepowodzenia: Zgłoszona brakująca właściwość oznacza, że naprawdę nie ma jej w opublikowanym oznaczeniu, a nie problem z cache’em lub renderowaniem — sprawdź źródło JSON-LD. Okno monitorowania: Natychmiast — oba narzędzia czytają oznaczenie bezpośrednio i nie czekają na crawl. Wyzwalacz wycofania: Jeśli walidacja nadal nie przechodzi po bezpośredniej poprawce, wycofaj zmianę szablonu i porównaj ją z ostatnim znanym poprawnym JSON-LD.

Test 2: kwalifikacja do wyniku rozszerzonego dla konkretnego typu hosta

Test: Uruchom mój Rich-Result Eligibility Checker dla aktywnego URL-a. Oczekiwany wynik: Typ nadrzędny strony (np. Product) jest oznaczony jako kwalifikowany do wyniku recenzji/gwiazdek, a itemReviewed poprawnie wskazuje element. Interpretacja niepowodzenia: Jeśli typ nadrzędny to LocalBusiness lub Organization, status „niekwalifikowany” jest oczekiwanym zachowaniem (zasada self-serving), a nie błędem — przed uznaniem wyniku za niepowodzenie potwierdź typ hosta. Okno monitorowania: Natychmiast. Wyzwalacz wycofania: Jeśli strona z kwalifikowanym typem (Product, Recipe itd.) nadal pokazuje błędy brakujących wymaganych pól, wdrożenie nie zaktualizowało oznaczenia widzianego przez Google; sprawdź cache lub krok budowania nadpisujący zmianę.

Test 3: raport Ulepszenia Search Console odzwierciedla naprawę

Test: Search Console → odpowiedni raport Ulepszenia (fragmenty produktów / listy sprzedawców, zależnie od typu hosta) dla dotkniętych URL-i. Oczekiwany wynik: Strona przechodzi z „Nieprawidłowe” lub „Niekwalifikowane” do grupy „Prawidłowe”, a liczba błędów dla URL-a spada do zera. Interpretacja niepowodzenia: Jeśli po ponownym crawlowaniu Google nadal zgłasza błąd, poprawka nie trafiła na aktywną stronę albo brakuje innej wymaganej właściwości — wykonaj Test 1 dla aktywnego URL-a, nie dla kopii stagingowej. Okno monitorowania: Od kilku dni do mniej więcej tygodnia na ponowne crawlowanie i odświeżenie raportu przez Google — dane Search Console są opóźnione względem aktywnej strony. Wyzwalacz wycofania: Jeśli po wdrożeniu liczba nieprawidłowych elementów rośnie zamiast maleć, zmiana prawdopodobnie zepsuła oznaczenia innych stron używających tego samego szablonu; wstrzymaj wdrożenie.

Test 4: fragment z gwiazdkami rzeczywiście pojawia się w aktywnym SERP-ie

Test: Wykonaj ręczne wyszukiwanie zapytania, dla którego strona rankuje, i sprawdź, czy pod wynikiem pojawia się ocena w gwiazdkach (prywatne okno/incognito ogranicza wpływ personalizacji). Oczekiwany wynik: Pod wynikiem pojawiają się gwiazdki i liczba ocen. Interpretacja niepowodzenia: Brak gwiazdek przy statusie „Prawidłowe” w Search Console nie jest problemem do naprawienia — wyświetlenie zależy od decyzji Google i nie jest gwarantowane przez kwalifikację. Brak połączony ze statusem „Niekwalifikowane” albo ręcznym działaniem oznacza powrót do Testu 1 lub 3. Okno monitorowania: Google nie podaje stałego czasu wyświetlania; sprawdzaj okresowo przez kolejne tygodnie, zamiast oczekiwać wyniku od razu po walidacji. Wyzwalacz wycofania: Brak po stronie oznaczenia — nie ma czego wycofywać w sprawie decyzji o wyświetleniu należącej do Google. Wycofaj tylko wtedy, gdy Ręczne działania oznaczą stronę.

Bieżące KPI dla oznaczeń AggregateRating

Metryka: liczba prawidłowych elementów (raport Ulepszenia Search Console) Co pokazuje: ile kwalifikowanych stron ma obecnie bezbłędne oznaczenie AggregateRating — to część KPI dotycząca pokrycia. Jak pobrać: Search Console → Ulepszenia → odpowiedni raport (fragmenty produktów / listy sprzedawców) dla witryny. Benchmark / realistyczny zakres: nie ma uniwersalnego celu — ustal własną bazę na podstawie liczby stron, które powinny mieć oznaczenie (łączna liczba stron z kwalifikowanym typem), i obserwuj zbliżanie się liczby prawidłowych elementów do tej wartości. Częstotliwość: co miesiąc albo natychmiast po zmianie szablonu/CMS-u dotykającej oznaczeń recenzji.

Metryka: liczba nieprawidłowych elementów/błędów (ten sam raport) Co pokazuje: ile stron ma uszkodzone wymagane właściwości — część KPI dotycząca jakości, niezależna od pokrycia. Jak pobrać: ten sam raport Ulepszenia, grupa błędów/elementów nieprawidłowych. Benchmark / realistyczny zakres: jedynym uczciwym celem jest zero; każda wartość większa od zera oznacza rzeczywiście uszkodzoną stronę, a nie szum statystyczny. Częstotliwość: co miesiąc i zawsze po wdrożeniu dotykającym szablonu oznaczenia.

Metryka: zmiana CTR na stronach, które uzyskały kwalifikację do gwiazdek Co pokazuje: czy fragment z gwiazdkami rzeczywiście przekłada się na więcej kliknięć na stronach, które go uzyskały, a nie tylko na samą kwalifikację. Jak pobrać: raport Skuteczność w Search Console, filtrowany do dotkniętych stron; porównaj CTR z tygodni przed i po wdrożeniu oznaczenia (Search Console nie izoluje dokładnie „kliknięć z fragmentu z gwiazdkami”, więc to porównanie przed/po jest przybliżeniem, nie dokładną atrybucją). Benchmark / realistyczny zakres: nie ma uzasadnionej stałej wartości wzrostu do podania — ustal własny bazowy CTR przed wdrożeniem na tych samych stronach i obserwuj różnicę, bo silnie zależy ona od zapytania, pozycji i konkurencyjnych wyników rozszerzonych. Częstotliwość: co miesiąc przez pierwszy kwartał po wdrożeniu, potem co kwartał.

Metryka: wzrost ratingCount/reviewCount w czasie Co pokazuje: czy liczebność próby stojącej za średnią rzeczywiście rośnie — płaska albo malejąca liczba na stronie deklarującej aktywną bazę recenzji wymaga sprawdzenia, zanim oznaczenie będzie uzasadnione. Jak pobrać: własna platforma recenzji, CMS albo baza danych — system będący źródłem prawdy, z którego oznaczenie pobiera dane. Benchmark / realistyczny zakres: śledź wzrost surowej wartości względem własnej historii; nie ma zewnętrznego benchmarku mówiącego, ile ocen powinna mieć strona. Częstotliwość: co miesiąc.

Sprawdź się: AggregateRating Schema

Pięć krótkich pytań o schema.org/AggregateRating, wymagane właściwości i zasadę ocen self-serving. Wybierz odpowiedź na każde, a potem sprawdź wynik.

Dziennik zmian