Verifica dei dati strutturati

Una seconda copia della pagina, scritta per le macchine

Mostra una pagina prodotto a una persona e capisce subito quale numero è il prezzo e quale la quantità in magazzino. Un programma vede solo testo. I dati strutturati gli evitano di tirare a indovinare. Accanto alla pagina visibile pubblichi gli stessi fatti sotto forma di campi etichettati, con i nomi del vocabolario condiviso di schema.org. Questa cosa è un Product, il suo name è questo, le sue offers contengono un price di 49.00 in USD.

Ci sono tre modi di scriverli. JSON-LD mette tutto in un solo tag script, separato dall’impaginazione, ed è la forma consigliata da Google. Microdata e RDFa distribuiscono le etichette sui tag HTML sotto forma di attributi.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How tides work",
  "datePublished": "2026-03-14T09:30:00+00:00",
  "author": { "@type": "Person", "name": "Jane Doe" }
}
</script>

I motori di ricerca usano questi campi per costruire risultati più ricchi, con le stelline delle recensioni, un prezzo, la foto di una ricetta o la data di un evento. Si chiamano risultati multimediali (rich results).

Cosa legge questa verifica

Il nostro server scarica la pagina una volta, fino a 3 MB, e non esegue i suoi script. Poi lavora in quattro passaggi.

1. Sintassi. Ogni blocco JSON-LD passa per un lettore JSON rigoroso. Al primo errore indica la riga, il carattere e la causa probabile: una virgola prima di una graffa di chiusura, delle virgolette dentro un testo non precedute dal carattere di escape, virgolette curve incollate da un programma di videoscrittura, un commento HTML, un a capo grezzo. Basta un solo errore perché un parser scarti l’intero blocco.
2. Elementi. Le liste @graph vengono aperte, così ogni elemento appare separato, con il suo tipo e lo schema delle sue proprietà. Una proprietà che rimanda a un altro elemento con @id viene seguita quando la destinazione è nella pagina.
3. Proprietà. Per i tipi che alimentano un risultato multimediale, l’elemento viene confrontato con un elenco di proprietà obbligatorie e consigliate tratto dalla documentazione di Google.
4. Valori. In ogni elemento gli indirizzi devono essere assoluti, date e durate devono seguire la ISO 8601, @context deve essere schema.org e ogni rimando @id deve portare da qualche parte.

Microdata (itemscope, itemtype) e RDFa (typeof) vengono contati e nominati per tipo. Le loro proprietà non vengono convalidate.

I tipi che confrontiamo e cosa richiedono

Gli altri tipi vengono mostrati in schema e i loro valori verificati, senza un elenco di proprietà obbligatorie.

Riparare quello che mostra il rapporto

Un errore di sintassi

I blocchi scritti a mano si rompono su virgole e virgolette. Genera il blocco con un encoder JSON (json_encode in PHP, JSON.stringify in JavaScript) e tutta quella famiglia di errori sparisce. In un CMS, incolla il JSON-LD in un campo per il codice. Non usare mai l’editor visuale per farlo, perché trasforma le virgolette in virgolette curve.

Manca una proprietà obbligatoria

Aggiungila, con il valore che un visitatore vede sulla pagina. I motori di ricerca confrontano le due cose, e un markup che descrive qualcosa che la pagina non mostra può costarti un’azione manuale.

Un indirizzo relativo

Scrivi https://www.example.com/img/cover.jpg per intero, non /img/cover.jpg.

Una data che non è ISO 8601

Prima l’anno, poi T, poi l’ora e lo scarto da UTC: 2026-03-14T09:30:00+00:00. Anche il solo giorno, 2026-03-14, è valido.

Un rimando che non porta da nessuna parte

"author": {"@id": "…/#jane"} funziona solo se un elemento con esattamente quell’@id si trova nella stessa pagina. Aggiungi l’elemento, oppure scrivi l’autore lì dove serve.

Cosa questa verifica non può dirti

Legge l’HTML così come viene consegnato. I dati strutturati aggiunti dopo da JavaScript o da un tag manager qui sono invisibili, anche se Google potrebbe vederli dopo il rendering. Le immagini non vengono scaricate, quindi un’immagine rotta o troppo piccola passa inosservata. Gli elenchi di proprietà coprono i tipi di risultato più comuni. Non coprono ogni tipo né ogni campo facoltativo.