Vai al contenuto
IT · ₺
Accesso al pannello Acquista pacchetto
SEO tecnica

Dati strutturati (schema.org, JSON-LD): guida all'implementazione

6 minuti di lettura

I dati strutturati (markup schema.org) sono un modo per descrivere esplicitamente il contenuto di una pagina ai motori di ricerca con un vocabolario standard: questo è un articolo, quello un prodotto, quest'altro i dati di indirizzo di un'attività. Google usa i dati strutturati per comprendere meglio la pagina e, quando è appropriato, per mostrarla nei risultati in forma arricchita (ad esempio breadcrumb, prezzo del prodotto, stelle di valutazione). In questa guida spieghiamo passo passo che cosa sono schema.org e JSON-LD, quali tipi sono davvero utili, come aggiungerli e come testarli.

Cosa sono i dati strutturati?

Una persona che vede “199,90 €” capisce che si tratta di un prezzo; un bot può soltanto dedurlo dal contesto. I dati strutturati eliminano questa deduzione. schema.org è il vocabolario comune sviluppato da Google, Microsoft e altri motori di ricerca; definisce centinaia di tipi (Article, Product, Organization, Event, Recipe...) e le proprietà di ciascun tipo (name, price, author...).

Un fatto importante: i dati strutturati non sono un fattore di posizionamento diretto. Non portano la pagina più in alto. Il loro contributo passa per due strade: una migliore comprensione del contenuto e la possibilità di ottenere un risultato arricchito. Un risultato più visibile può far aumentare il tasso di clic, e questo è un guadagno indiretto (sul tema del CTR può consultare la nostra guida per aumentare il CTR).

Perché JSON-LD?

I dati strutturati si possono scrivere in tre formati: JSON-LD, Microdata e RDFa. Google consiglia JSON-LD. Il motivo è semplice: JSON-LD non viene mescolato con il contenuto della pagina, ma sta in un blocco separato <script type="application/ld+json">. Così è gestibile indipendentemente dal design, è facile da mantenere e presenta un rischio di errore minore. Il blocco può essere inserito nella sezione <head> o nel <body> della pagina.

Quali tipi sono utili?

Non serve aggiungere ogni tipo a ogni pagina. L'importante è scegliere il tipo che corrisponde a ciò che la pagina è davvero. La tabella seguente riassume i casi più comuni:

TipoIn quale pagina?Che cosa offre?
OrganizationHome page / chi siamoNome del marchio, logo, profili ufficiali; definizione chiara dell'organizzazione
Article / BlogPostingArticoli del blog e notizieMaggiore chiarezza su titolo, autore e data
BreadcrumbListPagine interneNel risultato compare il percorso (categoria > sottocategoria) invece dell'indirizzo
Product + OfferPagine prodottoRisultati arricchiti del prodotto con prezzo, disponibilità, valutazioni
LocalBusinessPagina di un'attività localeIndirizzo, orari, telefono; supporto alla visibilità locale
Event, Recipe, JobPostingPagine di contenuto specificoRisultati arricchiti dedicati a eventi, ricette, offerte di lavoro

Il supporto ai risultati arricchiti cambia nel tempo. Nel 2023 Google ha limitato il risultato arricchito FAQ (domande frequenti) ai siti governativi e sanitari riconosciuti, e ha rimosso del tutto il risultato arricchito HowTo. Aggiungere questi markup non fa danni, ma nella maggior parte dei siti non cambia l'aspetto del risultato. Controlli sempre l'elenco aggiornato dei tipi supportati nella galleria di Google Search Central.

Se è un'attività locale, il markup LocalBusiness va considerato insieme al Profilo dell'attività su Google Business Profile e alla visibilità su Google Maps; per l'intero argomento consulti la nostra guida alla SEO locale.

Esempio: markup Article e Organization

Per un articolo del blog si può scrivere un blocco JSON-LD di base come questo. Modifichi i nomi dei campi e i valori in base alla Sua pagina:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Cos'è il tag canonical?",
  "datePublished": "2026-11-06",
  "dateModified": "2026-11-06",
  "author": {
    "@type": "Person",
    "name": "Anna Rossi"
  },
  "publisher": {
    "@type": "Organization",
    "name": "Esempio S.r.l.",
    "logo": {
      "@type": "ImageObject",
      "url": "https://www.esempio.it/logo.png"
    }
  },
  "mainEntityOfPage": "https://www.esempio.it/blog/canonical-etiketi-nedir"
}
</script>

In questo blocco @context indica che il vocabolario è schema.org, mentre @type indica il tipo dell'oggetto. Tutti i campi devono corrispondere alle informazioni visibili nella pagina: se nella pagina non compare un autore, non inventi un autore nel blocco. Nella home page di un sito aziendale si può allo stesso modo indicare con il tipo Organization il nome, il logo e i profili ufficiali sui social (sameAs). Per rendere visibili anche in pagina l'autore e l'affidabilità dell'azienda, consulti la nostra guida E-E-A-T.

Il markup BreadcrumbList, usato per il percorso di navigazione (breadcrumb), è un elenco ordinato di elementi:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Blog",
      "item": "https://www.esempio.it/blog"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "SEO tecnica"
    }
  ]
}
</script>

Per l'ultimo elemento (la pagina in cui ci si trova) l'indirizzo item è facoltativo. Ogni elemento deve comparire nello stesso ordine e con gli stessi nomi del percorso visibile nella pagina.

Nelle pagine prodotto, al tipo Product si aggiungono offers (prezzo, valuta, stato della disponibilità) e, se esistono recensioni reali degli utenti, aggregateRating. La regola qui è molto chiara: prezzo e disponibilità devono coincidere con ciò che è visibile nella pagina, e il punteggio deve derivare da recensioni reali e verificabili. Un markup che mostra un prezzo vecchio inganna l'utente e diventa un avviso in Search Console.

Piano di implementazione passo passo

  1. Individui i tipi di pagina. Quanti template diversi ha il sito? Home page, categoria, prodotto, articolo, contatti e così via. Per ogni template basta un piano di markup.
  2. Associ a ogni template il tipo adatto. Usi la tabella sopra; non aggiunga un tipo di cui non è sicuro.
  3. Generi il markup dinamicamente nel codice del template. Titolo, data, prezzo e gli altri campi devono essere compilati dal database; i valori scritti a mano si invecchiano nel tempo.
  4. Testi tre o cinque pagine di esempio. Se non ci sono errori, estenda la modifica a tutto il sito.
  5. Monitori in Search Console. Dopo la pubblicazione controlli il numero di pagine valide ed errate, e metta in ordine di priorità gli avvisi.

Le regole fondamentali di Google

  1. Il markup deve corrispondere al contenuto visibile. Aggiungere un prezzo, un punteggio o una recensione non presenti nella pagina viola le politiche antispam di Google e comporta il rischio di un'azione manuale.
  2. Usi il tipo corretto. Non aggiunga Product a una pagina che non è un prodotto, né AggregateRating senza recensioni reali.
  3. Compili le proprietà richieste. Ogni tipo di risultato arricchito ha campi obbligatori e consigliati; se manca un campo obbligatorio, il risultato non viene mostrato.
  4. La pagina deve poter essere scansionata. Non si usa il markup di una pagina bloccata dal robots.txt o con noindex.
  5. I dati strutturati non garantiscono nulla. Un markup valido non significa che il risultato arricchito comparirà; sarà Google a decidere se mostrarlo.

Quanto dettagliato debba essere il markup è una sua decisione, ma non serve andare oltre il necessario. Per un articolo, titolo, autore, data di pubblicazione e di aggiornamento, immagine ed editore sono spesso sufficienti. Prima di aggiungere una nuova proprietà, verifichi nella documentazione di Google che esista un riscontro per essa; se non c'è, aggiungerla non ha effetti sul risultato.

Test e verifica

Prima e dopo la pubblicazione esegua un controllo in due fasi:

  • Test dei risultati multimediali di Google (Rich Results Test): incollando un indirizzo o del codice, vede a quali risultati arricchiti la pagina è idonea, con errori e avvisi.
  • Schema Markup Validator (validator.schema.org): convalida la sintassi generale di schema.org, non specifica di Google.
  • Search Console → Miglioramenti: monitora il numero di pagine valide, con avvisi ed errori per i tipi trovati nel sito. Dopo aver aggiunto un nuovo tipo, attenda qualche giorno prima che il rapporto lo mostri.
  • Ispezione URL: conferma che il markup è presente nella versione della pagina elaborata da Google; è utile soprattutto per i blocchi aggiunti con JavaScript.

Se non ha ancora configurato Search Console, segua la nostra guida introduttiva. I dati strutturati fanno parte del controllo dello stato tecnico; per le altre voci usi la nostra checklist SEO tecnica.

Errori comuni

  • Marcare contenuti invisibili. Un'informazione che l'utente non può vedere non deve comparire nemmeno nel markup.
  • Aggiungere recensioni o punteggi falsi. Marcare valutazioni non provenienti da utenti reali, scritte da Lei, viola le politiche.
  • Blocchi duplicati generati dai plugin. Se il tema e il plugin SEO generano due volte lo stesso markup Article, si crea un conflitto; ne tenga solo uno.
  • JSON non valido. Una virgola, un apice o una parentesi graffa mancante rendono non valido l'intero blocco. Non pubblichi senza averlo verificato con uno strumento di convalida.
  • Informazioni superate. Se cambiano prezzo, disponibilità o data di un evento e il markup non viene aggiornato, Search Console segnala un avviso e la fiducia dell'utente ne risente.
  • Eccesso. Riempire la pagina di tipi che non producono risultati arricchiti è una perdita di tempo; si concentri prima su tre o cinque tipi davvero utili per il sito.

Domande frequenti

I dati strutturati migliorano il posizionamento?

Non direttamente. Aiutano a comprendere il contenuto e possono aumentare la probabilità di un risultato arricchito, il che può incidere indirettamente sul tasso di clic.

Quale plugin o strumento devo usare?

Il plugin SEO del Suo CMS genera automaticamente i tipi di base; per la maggior parte dei siti è sufficiente. Per i tipi specifici aggiunga il JSON-LD a mano o con il codice del template, e lo convalidi sempre.

Aggiungere JSON-LD con JavaScript crea problemi?

Google può elaborare il JSON-LD inserito con JavaScript, ma, quando è possibile, è più affidabile inserirlo lato server nella prima risposta HTML.

Se ho un errore, il risultato arricchito scompare subito?

Un markup non valido o non conforme alle politiche può far perdere il risultato arricchito. Correggi l'errore e avvii la convalida da Search Console; la rivalutazione richiede tempo.

Conclusione

I dati strutturati non sono un trucco che promette risultati rapidi, ma un modo regolare per presentare correttamente i Suoi contenuti. Usi JSON-LD, segni solo le informazioni realmente presenti nella pagina, verifichi con gli strumenti di convalida e controlli con regolarità in Search Console. Per iniziare, alla home page basta Organization, agli articoli Article, alle pagine interne BreadcrumbList, ai prodotti Product: per la maggior parte dei siti è sufficiente. Il tempo che resta lo dedichi alla qualità dei contenuti e alla velocità.

Mancano clic sulla Sua parola chiave?

HitBot genera sessioni reali che effettuano la ricerca sulla parola chiave di destinazione, trovano il Suo sito e lo cliccano. Il risultato si accumula in Search Console come impressioni e clic.

Altri articoli