Dati strutturati prodotto: offerte, recensioni, errori

A cosa serve il markup di prodotto

I dati strutturati di prodotto descrivono un prodotto in una forma che i programmi possono leggere: nome, immagine, prezzo, valuta, disponibilità e recensioni. Il vocabolario viene da schema.org, e un formato diffuso è JSON-LD, un blocco di dati nella pagina che i visitatori non vedono. Google può usare questi dati per mostrare informazioni sul prodotto nei risultati di ricerca, per esempio un prezzo o le stelle delle recensioni. Google chiarisce anche che i dati strutturati non sono una promessa di risultato multimediale.

Due tipi di pagine prodotto

Google distingue due casi. Le schede del commerciante sono per le pagine in cui un acquirente può comprare il prodotto da te. Gli snippet prodotto sono per le altre pagine prodotto, come recensioni, test e pagine di confronto. I requisiti sono diversi, quindi decidi prima in quale caso rientra la tua pagina.

Secondo Google, i risultati multimediali per i prodotti supportano solo pagine dedicate a un singolo prodotto, o a più varianti dello stesso prodotto. Google consiglia di aggiungere il markup alle pagine prodotto, non alle pagine di categoria o agli elenchi di prodotti.

Gli elementi di base

• Product: l’articolo stesso, con name, image, description, brand, sku e, se ne hai uno, un GTIN.
• Offer: le condizioni di vendita, con price, priceCurrency, availability, l’url dell’offerta e, se il prezzo scade, priceValidUntil.
• AggregateRating: la media di molte valutazioni, con ratingValue e ratingCount oppure reviewCount.
• Review: una singola recensione. Google richiede che il nome dell’autore sia un nome valido di una persona o di un team.

Un esempio minimo

Questo blocco descrive una tazza in vendita. Va nell’HTML della pagina prodotto, di solito nell’head o alla fine del body.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Tazza in ceramica blu, 0.3 l",
  "image": "https://example.com/img/mug-blue.jpg",
  "sku": "MUG-BL-03",
  "brand": { "@type": "Brand", "name": "Ceramiche Esempio" },
  "offers": {
    "@type": "Offer",
    "price": "12.90",
    "priceCurrency": "EUR",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/mug-blue"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.6",
    "reviewCount": "38"
  }
}
</script>

Tre dettagli causano molti errori. schema.org chiede il punto come separatore decimale e nessun simbolo di valuta nel prezzo, quindi scrivi 12.90, non 12,90 né €12.90. La valuta va in priceCurrency come codice ISO 4217, per esempio EUR o PLN. La disponibilità è un valore di schema.org, come InStock o OutOfStock.

Valutazioni e recensioni

Un AggregateRating ha bisogno di ratingValue e di almeno uno tra ratingCount e reviewCount. All’interno di un prodotto, itemReviewed non serve. Se ometti bestRating e worstRating, Google presuppone una scala da 1 a 5. Se il tuo negozio usa un’altra scala, per esempio da 1 a 10, indicala.

Prezzo, disponibilità e aggiornamento

• Marca solo ciò che i visitatori possono vedere. Google scrive che i dati strutturati devono rappresentare fedelmente il contenuto della pagina.
• Modifica il markup quando cambiano il prezzo o le scorte. Un buon sistema di negozio lo fa automaticamente, un blocco scritto a mano no.
• Imposta priceValidUntil solo se il prezzo scade davvero. Secondo Google, una data passata può impedire la visualizzazione dello snippet prodotto.
• Usa una sola valuta per indirizzo. Google chiede un URL separato per ogni valuta.
• Descrivi spedizione e resi una sola volta per tutto il negozio. Google consiglia una politica di reso e una politica di spedizione globali nel markup Organization.

Errori tipici

• Il prezzo è scritto con la virgola, con un simbolo di valuta o come 0 su una pagina in cui il prodotto è in vendita.
• priceCurrency contiene € o $ invece di un codice come EUR o USD.
• Manca l’immagine, anche se le schede del commerciante la richiedono.
• Una pagina di negozio usa AggregateOffer. Le schede del commerciante richiedono un Offer, perché il commerciante deve essere il venditore.
• Il nome o il prezzo nel markup è diverso da quello della pagina, spesso dopo una modifica del prezzo.
• Due blocchi descrivono lo stesso prodotto con valori diversi, per esempio uno dal tema e uno da un plugin.

Come controllare il markup

Google indica il Test dei risultati multimediali e lo strumento Controllo URL, che trovano la maggior parte degli errori tecnici. Alcuni problemi restano invisibili a questi test, per esempio una valutazione che non è presente sulla pagina. Google può anche applicare un’azione manuale ai dati strutturati che violano le sue regole. La pagina perde allora l’idoneità ai risultati multimediali e i dati strutturati vengono ignorati.

Lavorare con Do4U

Il Controllo dati strutturati legge una pagina dal suo indirizzo, oppure l’HTML o il blocco JSON-LD che incolli. Legge tutti i blocchi JSON-LD, anche @graph ed elementi annidati, oltre a microdati e RDFa. Il codice trova errori di sintassi con riga e colonna, tipi sconosciuti o scritti male e le proprietà che Google richiede o consiglia per snippet prodotto, schede del commerciante, offerte e valutazioni. Controlla la forma di prezzi, valute, date e valutazioni e avvisa quando un nome o un prezzo del markup non compare nel testo visibile. Ricevi un albero degli elementi con errori, avvisi e la fonte di ogni regola. La pagina viene letta come la consegna il server, senza JavaScript. Non si usa l’AI, e il controllo è gratuito, con un limite giornaliero.

Do4U trova indicazioni, tu controlli e decidi. Se compare un risultato multimediale lo decide Google, e solo tu sai se un prezzo, una disponibilità o una valutazione è corretta.