Jak dodać dane strukturalne do Shopify (bez psucia motywu)

Co to są dane strukturalne i co Shopify już ma w standardzie?

Schema markup to dane strukturalne w formacie JSON-LD, które oznaczają zawartość strony tak, by wyszukiwarki i silniki odpowiedzi AI mogły ją odczytać bez domysłów. Na stronie produktu mówią: to jest Product, tu jest jego cena, tu ocena w gwiazdkach, tu opinie klientów. Google korzysta z tych informacji, by wyświetlić gwiazdki, cenę i dostępność bezpośrednio pod wynikiem wyszukiwania.

Motywy Shopify zawierają pewne dane strukturalne od razu po instalacji, zazwyczaj podstawowy blok Product, ale rzadko obejmują Review ani aggregateRating, bo motyw sam w sobie nie ma opinii do opisania. Na tym polega luka do wypełnienia: połączenie danych z twoich opinii z blokiem Product, żeby gwiazdki mogły się pojawić.

Jakich danych strukturalnych wymagają opinie o produktach?

Żeby Google mógł wyświetlić rich result, potrzebuje Product zawierającego Review, aggregateRating albo oba. Blok Product przekazuje nazwę, zdjęcie i ofertę. aggregateRating przekazuje średnią ocenę i liczbę opinii. Każdy Review przekazuje autora, ocenę i treść opinii.

Zasada, która zaskakuje najczęściej: opinie i ocena w znaczniku muszą być widoczne na stronie. Nie możesz oznakować aggregateRating 4,8 z 200 opinii, jeśli strona nie wyświetla żadnych opinii. Google traktuje to jako wprowadzające w błąd i usuwa rich result dla całej strony.

• Product: nazwa, zdjęcie i oferta (cena, waluta, dostępność).
• aggregateRating: ratingValue i reviewCount, zgodne z tym, co pokazuje strona.
• Review: autor, reviewRating i treść opinii dla poszczególnych opinii widocznych na stronie.

Edytować JSON-LD w motywie, użyć aplikacji czy generatora schema?

Są trzy uczciwe podejścia, które różnią się poziomem kontroli i ryzyka. Edycja JSON-LD w motywie daje pełną kontrolę, ale wymaga pracy w Liquid, gdzie jeden błędny przecinek po cichu psuje cały blok. Aplikacja do opinii, która sama wstrzykuje schema, wymaga najmniej pracy, ale dziedziczysz kształt, jaki aplikacja emituje, a niektóre aplikacje wstrzykują schema po stronie klienta, gdzie crawler może tego nie zobaczyć. Generator schema jest pośrodku: wklejasz swoje rzeczywiste wartości, dostajesz poprawny JSON-LD i wstawiasz jeden czysty blok na stronę.

Jeśli nie czujesz się pewnie w kodzie motywu, zacznij od generatora. To najniższe ryzyko, żeby umieścić poprawny blok na stronie, a wynik możesz wkleić bezpośrednio do sekcji Custom Liquid bez przerabiania motywu.

• JSON-LD w motywie: największa kontrola, największe ryzyko cichego błędu składni.
• Aplikacja: najmniej pracy, ale sprawdź, czy schema jest w źródle strony, nie tylko w przeglądarce.
• Generator: wklejasz rzeczywiste wartości, dostajesz zwalidowany JSON-LD, wstawiasz jeden blok.

Jak dodać znaczniki bez psucia motywu?

Nie wklejaj schema w środek istniejącego bloku JSON-LD. Dodaj go jako osobny, samodzielny skrypt. W edytorze motywu dodaj sekcję Custom Liquid (lub edytuj szablon produktu) i umieść nowy skrypt typu application/ld+json zawierający blok Product. Dzięki temu błąd w twoim bloku nie może uszkodzić bloku motywu i odwrotnie.

Zanim zapiszesz, zduplikuj motyw, żeby mieć czysty punkt przywrócenia. Następnie dodaj blok, zapisz i sprawdź źródło strony produktu na żywo, żeby potwierdzić, że JSON-LD jest w surowym HTML, a nie tylko po uruchomieniu skryptów. Jeśli twoje opinie są wstrzykiwane przez aplikację po załadowaniu strony, najbezpieczniejszy wzorzec to renderowanie po stronie serwera albo powiązanie wyniku generatora z wartościami, które są już wydrukowane na stronie.

Jak zwalidować schema i jak wygląda błąd?

Sprawdź każdy szablon produktu za pomocą dwóch narzędzi: Rich Results Test Google pod kątem kwalifikowalności i walidatora Schema.org pod kątem składni. Rich Results Test informuje, czy Product kwalifikuje się do wyświetlenia gwiazdek, i wskazuje brakujące wymagane pola. Walidator Schema.org wyłapuje zniekształcony JSON, który test rich results czasem przepuszcza.

Błąd, który pojawia się najczęściej, to nie błąd składni. To ostrzeżenie, że ocena nie ma widocznych opinii albo że oznakowane wartości nie zgadzają się ze stroną. To znowu zasada niezgodności. Napraw to, dopasowując znacznik dokładnie do tego, co kupujący może zobaczyć, i zwaliduj ponownie przed przejściem dalej.

• Rich Results Test: potwierdza kwalifikowalność Product i wyświetla brakujące pola.
• Walidator Schema.org: wyłapuje zniekształcony JSON, który test rich results może przeoczyć.
• Źródło strony na żywo: potwierdź, że blok jest w surowym HTML.

Jakie błędy najczęściej unieważniają schema?

Większość unieważnionych schema jest technicznie poprawna, ale odrzucona, bo opisuje coś, czego strona nie pokazuje. Typowe przypadki: aggregateRating bez opinii wyświetlonych na stronie, liczba opinii w znaczniku niezgodna z liczbą na ekranie albo znacznik Review na stronie kategorii lub stronie głównej zamiast na stronie konkretnego produktu.

Głębszy wariant tego problemu to czytelność. Wiele aplikacji do opinii zostało zaprojektowanych dla kupującego na stronie i na tym poprzestaje: gwiazdki wyglądają dobrze w przeglądarce, ale treść opinii i ocena są zamknięte w widgecie, którego crawlery i silniki odpowiedzi AI nie mogą odczytać. W efekcie znacznik opisuje treść, której maszyna nigdy nie widzi. Sprawienie, żeby opinie były czytelne, potwierdzone i cytowalne w wyszukiwarce oraz AI, to luka, którą BeyondReviews ma zamknąć.

• aggregateRating obecny, ale żadne opinie nie są renderowane na stronie.
• Liczba opinii lub średnia w znaczniku niezgodna z widocznymi liczbami.
• Znacznik Product lub Review na stronie, która nie jest stroną pojedynczego produktu.
• Opinie zamknięte w widgecie po stronie klienta, którego crawler nie może odczytać.

Na czym to wszystko polega

Poprawna konfiguracja schema w Shopify to trzy elementy: samodzielny blok Product, prawdziwe opinie widoczne na stronie i znacznik, którego każda wartość zgadza się z tym, co widzi kupujący. Dodaj go jako osobny skrypt, żeby nie mógł uszkodzić motywu, generuj go na podstawie rzeczywistych danych zamiast wpisywać ręcznie i zwaliduj każdy szablon przed uznaniem pracy za skończoną.

Zrób to, a gwiazdki, cena i liczba opinii staną się kwalifikowalne do wyświetlenia w wynikach Google. Pomiń zasadę niezgodności, a znacznik będzie poprawny i ignorowany, co jest najgorszym z obu światów: praca wykonana, nic nie wyświetlone.