Guide pratiche

Convalida i dati strutturati su un sito web

Il markup valido non può riparare una pagina imprecisa. Inizia con ciò che i visitatori vedono, quindi ispeziona il codice, gli identificatori e l'eventuale idoneità per una presentazione di ricerca.

vedere il metodo

Illustrazione — Convalida i dati strutturati su un sito web
Illustrazione generata dall’IA

Scegli un'entità e uno scopo chiaro

Identifica cosa rappresenta veramente la pagina: un'organizzazione, un articolo, un prodotto, un evento o un elenco. Descrivi la sua entità principale prima di aggiungere le proprietà. Una pagina di servizio non diventa un prodotto a prezzo fisso perché esiste un tipo di schema e la ricerca di Google non visualizza più risultati ricchi di FAQ a partire dal 7 maggio 2026, secondo la sua Aggiornamenti ufficiali.

Consultare Galleria di risultati ricca di Google supportata per il tipo che intendi utilizzare. Schema.org offre un vocabolario più ampio rispetto alle funzionalità di ricerca supportate da Google. La descrizione semantica e l'idoneità al ricco risultato sono domande separate.

Confronta i valori con i contenuti pubblicati

Confronta nomi, descrizioni, immagini, autori, date, indirizzi, prezzi e disponibilità con ciò che un visitatore può vedere. Rimuovi recensioni, valutazioni, importi o luoghi inventati. Norme di Google richiedono contenuti visibili rappresentativi e non garantiscono un risultato ricco.

Per le pagine tradotte, utilizza i valori e gli URL di quella lingua. Le date dovrebbero descrivere la pubblicazione o la modifica effettiva. Evita di presentare una pagina dell'area di servizio come sede di un'attività fisica separata.

  • Valori verificabili sulla pagina.
  • Date e immagini coerenti.
  • Nessun reclamo garantito.

Convalida sintassi e identificatori

Leggi il JSON-LD dalla pagina finale, incluso il risultato renderizzato se JavaScript lo crea. Controlla le proprietà richieste o consigliate per la funzione di destinazione, gli URL assoluti, i duplicati e i valori @ID stabili. Test dei risultati ricchi e Schema.org Validatore Rispondi a diverse domande: supporto di Google e convalida del vocabolario.

Risolvi i problemi di sintassi al modello o all'origine dati, quindi assaggia diverse pagine di quel tipo. Un singolo esempio non rivelerà campi vuoti, errori di fuga o dati di immissione insoliti altrove.

Distinguete identità dell’entità e indirizzo del documento. In JSON-LD @id fornisce un identificatore di nodo; riferimenti relativi vanno letti con base e contesto. Esempio fittizio: due descrizioni con la stessa IRI assoluta https://example.com/#org indicano lo stesso nodo anche con proprietà diverse. Due organizzazioni omonime non diventano per questo un’entità. Non riutilizzate l’ID dell’organizzazione per pagina, autore o sedi distinte.

Un @id con #org non crea automaticamente un elemento HTML id="org". Provate separatamente il bersaglio HTML di eventuali link di navigazione a una sezione. Conservate identificatori tra modelli se descrivono la stessa entità, identificando correttamente pagine linguistiche e contenuti. Confrontate proprietà e pagina visibile: JSON valido, identità coerente ed eleggibilità Google sono controlli distinti. Nessuno garantisce risultati avanzati.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Riferimenti fittizi: identità JSON-LD e destinazione HTML
SituazioneRiferimentoControllo
Due descrizioni della stessa organizzazioneStessa IRI assoluta @id dopo risoluzioneVerificare che sia la stessa entità
Organizzazioni omonimeIl nome uguale non bastaIdentità distinte salvo relazione accertata
Identificatore di entitàhttps://example.com/#orgNon crea da solo una destinazione HTML
Valore diverso dal contenuto visibileJSON valido ma informazione incoerenteCorreggere fonte e ricontrollare contenuto e marcatura

Monitora le modifiche e i limiti

Dopo la pubblicazione, esamina gli errori di Search Console se esiste un rapporto per quel tipo. Confronta diversi URL e date di scansione; L'assenza di un ricco risultato da solo non prova una markup rotto. Le caratteristiche e i criteri possono cambiare.

Includi markup negli assegni editoriali: quando il contenuto, le immagini, i prezzi o i modelli cambiano, ricontrolla la loro rappresentazione strutturata. Le Guida al pre-lancio Inserisci questo controllo in una revisione della versione più ampia.

  • un esempio di ogni modello controllato.
  • Errori tracciati con date.
  • Ricontrolla dopo le modifiche al contenuto o al codice.

Confrontare i dati strutturati

Etichetta vuota e foglio di controllo accanto a un oggetto e un portatile
Illustrazione generata dall’IA · Confronta i valori codificati con le informazioni visibili sulla pagina.

Caso proposto: cambia l’offerta visibile, ma il JSON conserva una vecchia condizione. Il codice valido può descrivere dati superati.

Confronta valori, date e disponibilità con la pagina. Separa validità tecnica, coerenza del contenuto ed eventuali requisiti del motore di ricerca.

  • Leggere l’offerta visibile
  • Confrontare i valori nel JSON
  • Annotare le differenze

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
W3C · JSON-LD 1.1
application/ld+json · @contextJSON-LD descrive dati collegati; sintassi valida e correttezza dei fatti sono verifiche distinte.
RFC 8259 · JSON
application/json · UTF-8JSON standard non ammette commenti né virgole finali; le stringhe usano virgolette doppie.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Il prezzo visibile cambia ma JSON-LD mantiene il vecchio valore.Il markup riflette il prezzo pubblicato sulla stessa base.Registra URL, passaggi, risultati e prove datate.

Domande frequenti

Le recensioni o i prezzi possono esistere solo in JSON-LD?

I dati strutturati dovrebbero corrispondere alle informazioni sulla pagina. Non inventare recensioni, valutazioni, indirizzi o prezzi per i risultati ricchi. Verifica tipi, proprietà e coerenza con il contenuto visibile. Il markup valido non garantisce la visualizzazione del motore di ricerca.