Guida · Dati strutturati
Dati strutturati: ciò che la macchina legge realmente
Un lettore guarda la vostra pagina e capisce a colpo d'occhio chi pubblica, cosa viene venduto, a quale prezzo e a quali condizioni. Una macchina, invece, legge del testo e attende che le si dica cosa esso designa. I dati strutturati colmano esattamente questo scarto: dicono, in un formato che la macchina analizza, ciò che il lettore capisce guardando. Ecco come si scrivono, cosa devono rispettare, e come ci si assicura che dicano il vero.
Il JSON-LD, inserito nella pagina
Il formato consigliato è il JSON-LD. Si inserisce nella pagina, separato dal testo visualizzato, e descrive il significato di quel testo. Il vocabolario proviene da schema.org: ogni blocco dichiara un tipo (« questa è un'organizzazione », « questa è un'offerta ») e poi le proprietà di quel tipo. Descrivete ciò che scegliete di descrivere; ciò che è descritto deve essere corretto.
Ecco, in forma testuale, come si presenta un'offerta. Solo quattro valori, e ciascuno è verificabile sullo schermo.
{
"@context": "https://schema.org",
"@type": "Offer",
"price": "199.00",
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock",
"seller": {
"@type": "Organization",
"name": "SEO Records"
}
}Il prezzo, la valuta, la disponibilità, il venditore. Il blocco dichiara queste quattro informazioni perché il visitatore le vede sulla pagina: è questa visione che le autorizza.
La regola d'oro: il markup riflette il visibile
È l'unica regola dalla quale derivano tutte le altre. Il markup deve riflettere ciò che è visibile sulla pagina. Dichiarare un prezzo, una recensione o una disponibilità che il visitatore non vede significa dichiarare il falso — anche quando il valore è per altro esatto, anche quando figura nel vostro database.
La conseguenza pratica è semplice: ogni valore di un blocco si legge alla sua fonte, nel punto stesso in cui la pagina la prende, ed è questa lettura che riempie il blocco. È così che lavora SEO Records — corregge e completa i dati strutturati nel momento in cui la pagina viene servita, e ogni valore inserito ha la sua fonte nella pagina.
I tipi che sostengono una pagina
Cinque tipi sostengono il nostro sito. Sono quelli che abbiamo selezionato, tra tutto il vocabolario proposto da schema.org, per ciò che le nostre pagine mostrano realmente.
01
Organization · L'editore
Chi pubblica la pagina. Il nome, l'indirizzo del sito, il logo, i punti di contatto. È il blocco che collega tutte le altre dichiarazioni a un'entità, invece di lasciarle fluttuare.
02
BreadcrumbList · Il percorso di navigazione
La collocazione della pagina nel sito, dal primo livello fino a essa. Deve riprendere il percorso che il visitatore vede sullo schermo, nello stesso ordine e con le stesse diciture.
03
SoftwareApplication · Un prodotto software
Ciò che il prodotto fa, per quale uso, su quale piattaforma. Sul nostro sito, questo tipo descrive i moduli che si installano.
04
Service · Una prestazione
Ciò che ti viene reso come prestazione, esclusa l'installazione: un audit, un rilevamento, una verifica. Il tipo indica la natura della prestazione e chi la fornisce.
05
Offer · L'offerta
Il prezzo, la valuta, la disponibilità e il venditore. È il blocco più esigente: ciascuno di questi quattro valori deve ritrovarsi, così com'è, nel testo che il visitatore legge.
Ciò che non rende più va rimosso
Il 2 settembre 2026 abbiamo rimosso il markup FAQPage dal nostro sito. Google riserva ormai questo risultato avanzato alle amministrazioni: il blocco descriveva correttamente la pagina, e il suo rendimento si è fermato lì. Il nostro stesso audit ce l'aveva segnalato, a ragione.
La FAQ, invece, è rimasta visibile. È lì per il lettore, che vi trova le sue risposte: era già la sua ragione d'essere. È la distinzione da tenere a mente: un markup che non rende più restituisce alla pagina i byte che occupava, e il contenuto che descriveva resta, intero, al suo posto.
Le cinque regole da rispettare, sempre
Il markup cita ciò che la pagina mostra
Un prezzo, una recensione o una disponibilità si dichiarano perché sono sullo schermo: è questa presenza che rende vera la dichiarazione. Un valore dichiarato e assente dallo schermo è falso, qualunque sia l'intenzione: la macchina legge il tuo file, ed è il tuo file che fa fede.
Il blocco si analizza, dal primo all'ultimo carattere
Una virgola giusta, una virgoletta chiusa al posto giusto, e l'intero blocco viene letto; una virgola in più, e viene ignorato per intero. Un JSON-LD che si analizza è un JSON-LD che conta, e tutto si decide all'interno del blocco: è lì, e solo lì, che si decide la sua leggibilità.
Il markup parla tutte le lingue del sito
I nostri blocchi sono tradotti nelle otto lingue del sito: le otto pagine sono descritte nella lingua che il loro visitatore legge. Tradurre le altre sette dopo il francese significa guadagnare sette pagine su otto correttamente descritte.
Un prezzo dichiarato è un prezzo mostrato
Quando il prezzo cambia sullo schermo, il blocco cambia con esso: i due dicono allora la stessa cosa. Davanti a uno scostamento, è il markup che risponde, ed è da qui che viene la regola: un valore si legge alla sua fonte.
Il markup che si conserva è quello che rende
Rimuovere un tipo abbandonato ti restituisce i byte, la rilettura e la coerenza che consumava. Ciò che serve resta, il resto va rimosso.
Come verificare
Bastano tre passaggi, in questo ordine.
- Il blocco si analizza? Prendi il contenuto di ogni blocco e fallo analizzare come JSON. Da noi, questo passaggio è automatico: il nostro controllo di pubblicazione analizza ogni blocco, e la pubblicazione parte quando tutti si analizzano.
- Il tipo è valido? Gli strumenti di test ufficiali di Google leggono un indirizzo o un frammento di codice e indicano quali tipi riconoscono, con le proprietà mancanti o mal formate.
- Ogni valore è sullo schermo? È l'unico passaggio che spetta a te in proprio: quello lo gestisci tu stesso. Rileggi il blocco accanto alla pagina resa, valore per valore, e in ciascuna delle lingue servite.
Vedere i tuoi dati strutturati così come vengono forniti
Il Verificatore legge il vostro indirizzo e vi restituisce lo stato dei vostri blocchi, gratuitamente, in una decina di secondi. Lavora dai nostri sistemi: il vostro sito resta esattamente vostro. L'Audit SEO Records va oltre: legge la vostra mappa completa, pagina per pagina, e vi consegna il rilevamento con data.
Correggere, poi mantenere
Una marcatura corretta il giorno della pubblicazione si disallinea poi, al ritmo dei prezzi che cambiano e delle pagine che si aggiungono. SEO Records corregge e completa i blocchi nel momento in cui la pagina viene servita, con ogni valore documentato, a partire da 199 €/anno. SEO Autopilot lavora sul testo visibile che li accompagna: redige descrizioni, FAQ e collegamenti interni partendo dai vostri dati reali e solo da questi, a partire da 199 €/anno. I due rispondono alla stessa esigenza: ogni dichiarazione è ancorata a ciò che la pagina mostra.