Come verificare i dati strutturati JSON-LD in una pagina web
Verifica la presenza di errori e campi mancanti nel JSON-LD di qualsiasi pagina web, visualizza ogni elemento schema.org descritto e leggi il JSON di ogni blocco.
3 min di lettura
Per verificare il JSON-LD di una pagina web, apri il Validatore JSON-LD, incolla l’indirizzo della pagina e fai clic su "Recupera e convalida JSON-LD". Il risultato elenca tutti i problemi, ogni elemento descritto dalla pagina e il JSON di ciascun blocco. Se la pagina non presenta problemi, il riepilogo è verde.
Come verificare una pagina
- Apri la pagina nel browser e copia l’indirizzo dalla barra degli indirizzi.
- Incollalo nel campo URL. Se l’indirizzo non contiene
https://, verrà aggiunto automaticamente. - Fai clic su "Recupera e convalida JSON-LD".
- Leggi il riepilogo sopra le tabelle. Indica il numero di blocchi, errori e avvisi.
- Seleziona un blocco in Origine per visualizzarne il JSON con i numeri di riga.
Come leggere il risultato
- La tabella dei problemi elenca ogni errore e avviso. Viene mostrata solo in presenza di problemi.
- Blocco indica il numero del blocco di script, contando dall’inizio della pagina.
- Posizione indica dove si trova il problema, ad esempio
Product.image. - La tabella degli elementi elenca ogni elemento, con il relativo tipo, ad esempio Article o Product, e il nome.
- Fai clic sull’intestazione di una colonna per ordinare una tabella. I pulsanti sotto ogni tabella consentono di esportarla in CSV o JSON.
Quali problemi correggere per primi
Gli errori compaiono per primi nell’elenco e hanno un’etichetta rossa. Gli avvisi hanno un’etichetta gialla. Un errore indica che qualcosa non funziona o che manca un campo obbligatorio. Gli avvisi contrassegnati con "(facoltativo)" riguardano campi che puoi aggiungere quando hai a disposizione i dati.
Questi messaggi si risolvono facilmente.
| Messaggio | Correzione |
|---|---|
| JSON non valido | Cerca una virgola o una virgoletta mancante, oppure una virgola dopo l’ultimo valore. |
Manca @context, aggiungi "@context": "https://schema.org" |
Aggiungi questa riga al blocco. |
| Manca @type | Aggiungi un tipo, ad esempio "@type": "Product". |
| "@Type" non è una parola chiave JSON-LD | Scrivi le parole chiave in minuscolo: @type. |
| Il tipo "Organisation" non è un tipo schema.org valido | Usa il nome schema.org esatto, in questo caso Organization. |
| Manca l’attributo obbligatorio "image" | Aggiungi il campo indicato nel messaggio. |
Se la verifica non trova nulla o non riesce
"Non sono stati trovati blocchi di script JSON-LD in questa pagina" significa che l’HTML della pagina non contiene JSON-LD. La verifica legge la pagina così come viene inviata dal server. Il JSON-LD aggiunto in seguito da uno script nel browser non viene rilevato.
"Impossibile recuperare la pagina" significa che il sito non ha inviato la pagina. Succede anche quando l’indirizzo reindirizza a un altro indirizzo, perché i reindirizzamenti non vengono seguiti. Copia l’indirizzo finale dalla barra degli indirizzi e riprova.
Vengono verificati solo i primi 3 MB della pagina. Se una pagina è più grande, viene mostrato un messaggio.
Correggi gli errori, aggiorna la pagina e ripeti la verifica.
Vuoi provare lo strumento?
Validatore JSON-LD
Inserisci un URL: il server recupera la pagina, estrae ogni blocco di dati strutturati JSON-LD e verifica la presenza di errori di sintassi JSON, l'assenza di @context e @type, tipi e proprietà schema.org sconosciuti e i campi necessari a Google per i risultati avanzati.