Gestructureerde productgegevens: vertelt uw JSON-LD hetzelfde als uw pagina?

Waarom een afwijking ertoe doet

De meeste Shopify-productpagina's bevatten een blok JSON-LD (<script type="application/ld+json">) dat het product beschrijft met schema.org-termen: Product (of ProductGroup bij varianten) en een of meer Offer-objecten met price, priceCurrency en availability.

Machines lezen dit blok omdat het makkelijker is dan uw ontwerp ontleden. Google Merchant Center documenteert bijvoorbeeld dat automatische artikelupdates de schema.org-prijs, -valuta en -beschikbaarheid op uw landingspagina's lezen om tijdelijke afwijkingen in de feed te corrigeren, en dat het de annotaties van een site niet meer vertrouwt als ze onjuist zijn. AI-shoppingagenten die uw pagina's ophalen, kunnen op dezelfde gegevens leunen. Zegt de JSON-LD 39,00 en de pagina 29,00, dan krijgt iemand verderop het verkeerde bedrag.

In de documentatie van Google voor verkopersvermeldingen zijn price (groter dan nul) en priceCurrency verplicht in de Offer, en wordt availability aanbevolen.

Hoe een kloppende Offer eruitziet

Voor een product dat op de pagina 29,00 euro kost en op voorraad is, bevat de Offer precies dezelfde feiten:

• "@type": "Offer"
• "price": "29.00" (de prijs die de klant nu betaalt, niet de vergelijkingsprijs; met een punt als decimaalteken)
• "priceCurrency": "EUR" (de valuta die op de pagina voor die markt wordt getoond)
• "availability": "https://schema.org/InStock" (of OutOfStock als de pagina „uitverkocht” zegt)
• "url" naar de product- of variant-URL waar het te koop is

Bij een product met varianten heeft elke variant een eigen Offer met eigen prijs, beschikbaarheid en SKU. Is de ene variant uitverkocht en de andere niet, dan moet het schema dat ook zeggen.

Een productpagina met de hand controleren

1. Kies testpagina's. Een product in de sale, een product met varianten tegen verschillende prijzen en een uitverkocht product. Daar zitten de afwijkingen, niet in de simpele gevallen.
2. Bekijk de bron. Open de pagina, druk op Ctrl+U (Cmd+Option+U op een Mac) en zoek op ld+json. Tel de blokken: meer dan één Product-blok is een waarschuwing.
3. Lees de Offer. Noteer per blok price, priceCurrency, availability en de sku of url van de variant.
4. Vergelijk met de pagina. Zelfde zichtbare prijs, ook bij een saleprijs? Zelfde valuta? Zegt de pagina „uitverkocht” terwijl het schema InStock zegt?
5. Gebruik de Rich Results Test van Google op search.google.com/test/rich-results. Die toont welke gestructureerde gegevens Google uitleest en markeert ontbrekende verplichte velden. Of de waarde klopt met de zichtbare prijs, vergelijkt u zelf.
6. Wissel van variant en markt. Kies een andere variant en bekijk de pagina, als u in meerdere landen verkoopt, als klant uit een andere markt. Controleer opnieuw.

Gebruikelijke oorzaken in Shopify

Hard gecodeerde of oude themablokken

Sommige thema's, of snippets die een ontwikkelaar jaren geleden toevoegde, zetten een vaste prijs, vaste valuta of altijd InStock neer, ongeacht de variant. Bij een thema-update kan zo'n oud snippet blijven staan en een tweede, verouderd blok uitvoeren.

SEO-, review- en feedapps met een eigen schema

Schema- en review-apps voegen vaak eigen Product-markup toe. Doet het thema dat ook, dan hebt u twee Product-blokken die elkaar kunnen tegenspreken, bijvoorbeeld een met de saleprijs en een met de vergelijkingsprijs. Een app verwijderen haalt niet altijd weg wat die in de themabestanden heeft gezet.

Varianten

Een schemasnippet dat altijd de eerste variant leest, zit fout zodra de klant op een variant-URL met een andere prijs of voorraad terechtkomt.

Meerdere valuta en Shopify Markets

Met Shopify Markets kan de zichtbare prijs in de lokale valuta van de klant staan. Staat in de JSON-LD de standaardvaluta van de winkel vast, of wordt shop.currency gebruikt, dan lopen bedrag en valutacode buiten uw thuismarkt uit elkaar.

Sales, kortingen en caching

Prijzen die een app of script na het laden van de pagina aanpast, kunnen afwijken van de prijs in de server-gerenderde JSON-LD.

Checklist voor afwijkingen

Oplossen zonder iets te breken

• Eén bron van waarheid. Kies of het thema of een app het Product-schema uitvoert, en zet de andere uit.
• Gebruik het filter van Shopify. Actuele Shopify-thema's gebruiken {{ product | structured_data }}, dat live productdata leest. Breidt u het uit, lees dan waarden van de gekozen variant, geen vaste tekst.
• Test op een duplicaatthema via Online winkel > Thema's (Online Store > Themes) voordat u publiceert, en herhaal de handcontrole.
• Controleer opnieuw na wijzigingen. Een review-app installeren, van thema wisselen of een markt toevoegen kan maanden later een afwijking terugbrengen.

Elk product automatisch controleren

De handcontrole werkt voor een paar pagina's, niet voor een hele catalogus, en zegt alleen iets over vandaag. AI Sales Assurance voert deze vergelijking uit voor al uw producten: het signaleert ontbrekende JSON-LD en JSON-LD die afwijkt van de pagina, plus afwijkingen in prijs, valuta, beschikbaarheid en varianten, en legt uit welk themablok of welke app de waarschijnlijke bron is. Alleen-lezen, uw webshop blijft onaangeroerd. Doe een gratis check.

Veelgestelde vragen

Gerelateerde gidsen

Bronnen

• Google Search Central — Gestructureerde gegevens voor verkopersvermeldingen (Product, Offer)
• Google Merchant Center Help — Automatische artikelupdates
• Google — Test voor uitgebreide resultaten (Rich Results Test)
• Anglera — Shopify Product JSON-LD
• Shopify Community — Dawn theme duplicate structured data with a review app