Generatore di schema JSON-LD: come creare dati strutturati e convalidarli

In breve: per creare il markup Schema senza bisogno di uno sviluppatore, apri il generatore di markup Schema gratuito di PromoPilot, seleziona un tipo (articolo, prodotto, FAQ, organizzazione, attività locale o breadcrumb) e compila i campi. Un blocco <script type="application/ld+json"> già pronto apparirà immediatamente sulla destra: copialo con un clic, incollalo nella pagina e verifica il link nel test dei risultati avanzati Google. Di seguito troverai il tipo richiesto per la tua pagina, i campi obbligatori e gli errori più comuni.

Da 12 anni mi occupo di creazione di siti web e negozi online e integro dati strutturati in ogni progetto. La cosa più comune che riscontro durante le verifiche è che, pur essendoci un ricarico sui prodotti, il prezzo è rimasto bloccato allo stesso livello di due anni fa.

Che cosa può fare un generatore di markup Schema?

Schema.org è un vocabolario comune utilizzato dai siti web per comunicare ai motori di ricerca informazioni su una pagina: "Questo è un prodotto, costa 89 € ed è disponibile". JSON-LD è un formato in cui queste informazioni vengono scritte come un blocco di codice separato, senza influire sul layout. Il generatore supporta i sei tipi più diffusi.

Ogni tipologia ha il suo set di campi. Ad esempio, per un articolo: titolo (obbligatorio), descrizione, autore, date di pubblicazione e aggiornamento, URL dell'immagine, URL dell'articolo e editore.

Come generare online il markup JSON-LD Schema?

1. Apri il Generatore di markup dello schema e seleziona un tipo dalla riga superiore.
2. Compila i campi obbligatori (contrassegnati da un asterisco) e quelli consigliati che conosci: più complete saranno le informazioni, maggiori saranno le possibilità di ottenere un risultato più dettagliato.
3. Copia il codice utilizzando il pulsante "Copia codice".
4. Inserisci il blocco nella pagina, all'interno <head> o <body>. In WordPress, puoi utilizzare il campo codice nel template o un plugin per l'inserimento del codice; nel builder, puoi utilizzare la sezione di codice personalizzato della pagina.
5. Fai clic su "Verifica nei risultati avanzati Google " sotto il codice e incolla l'indirizzo della pagina pubblicata.

Ecco come si presenta il generatore: riquadri con i tipi di markup, modulo dei campi a sinistra e JSON-LD in tempo reale a destra.

Esempio del risultato per una scheda prodotto:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Рюкзак Nord 20 л из кожи",
  "image": "https://example.com/img/nord-20.jpg",
  "offers": { "@type": "Offer", "price": "89.00", "priceCurrency": "EUR", "availability": "https://schema.org/InStock" }
}

Che tipo di markup è necessario per la tua pagina?

L'errore più comune che commettono i principianti è quello di ammassare tutto in una pagina. Il markup dovrebbe descrivere ciò che è effettivamente presente sulla pagina. Una semplice regola per i tipi di pagina:

• Home: Organizzazione (o Attività Locale se si dispone di un ufficio, un salone o un negozio con un indirizzo).
• Contatti: Attività commerciale locale con indirizzo, numero di telefono e orari di apertura.
• Categoria: Elenco di briciole di pane.
• Scheda prodotto: Prodotto + Elenco di percorsi di navigazione.
• Articolo del blog: Articolo + Elenco di percorsi di navigazione.
• Pagina delle domande: FAQ - solo se le domande e le risposte sono visibili al visitatore sulla pagina.

È bene essere onesti riguardo alle FAQ: dal 2023, Google mostra gli snippet delle FAQ principalmente a siti web governativi e medici affidabili. Per le aziende tradizionali, il markup delle FAQ è ancora utile, in quanto struttura i contenuti per i motori di ricerca e gli assistenti virtuali basati sull'intelligenza artificiale, ma non bisogna aspettarsi che le domande compaiano direttamente nei risultati di ricerca.

Quali sono gli errori di markup più comuni?

1. I dati non corrispondono a quelli della pagina. Il prezzo nel markup è di 79 €, ma sulla pagina è di 89 €: una violazione delle norme Google che potrebbe comportare la perdita dei risultati avanzati.
2. Codice di formattazione per contenuti invisibili. Domande frequenti (FAQ) con quesiti non presenti nella pagina o recensioni non ancora scritte.
3. Formato del valore non valido. Prezzo con simbolo di valuta ( "89 €" invece di "89.00" e "EUR"), data non nel formato 2026-10-12.
4. Indirizzi relativi delle immagini. È richiesto l'indirizzo completo, che inizia con https://.
5. JSON non valido. Basta una virgola in più o delle virgolette a spina di pesce dopo averlo copiato in un editor di testo e l'intero blocco viene ignorato.
6. Duplicati. Il plugin visualizza già "Organizzazione", ma ne hai incollato un secondo con un nome diverso.

Come verificare la formattazione dopo aver incollato il codice?

La verifica richiede un paio di minuti, ma senza di essa è facile lasciare del codice non funzionante sul proprio sito. Il mio procedimento è il seguente:

1. Test dei risultati avanzati per indirizzo di pagina. Lo strumento ti mostrerà i tipi di markup rilevati Google, inclusi errori critici (in rosso) e avvisi (in giallo). Assicurati di correggere gli errori e, se possibile, gli avvisi: si tratta in genere di campi consigliati che non vengono compilati.
2. Confronta con la pagina visibile. Apri la pagina accanto e controllala visivamente: stesso prezzo, stesso nome, stesso indirizzo e stesso numero di telefono.
3. Search Console sarà disponibile tra pochi giorni. La sezione dedicata ai miglioramenti conterrà report sui tipi di markup rilevati, che mostreranno gli errori su tutte le pagine del sito, non solo su una alla volta.

Se lo strumento di verifica degli URL non rileva il markup, anche se il codice è stato inserito, la causa più frequente è la cache del sito o un plugin di ottimizzazione che blocca gli script. Svuota la cache e riprova.

Confronto: Generatore di schemi e alternative

In conclusione: il generatore serve per la creazione, Rich Results Test per i test e il plugin o il template per la formattazione di massa. Nei miei progetti, li utilizzo tutti e tre in diverse fasi.

Il catalogo di PromoPilot contiene 87 strumenti SEO gratuiti. Oltre a questo articolo, la serie include anche approfondimenti su un generatore di meta tag e un debugger Open Graph: insieme a Schema, coprono tutto ciò che un sito web comunica su se stesso ai motori di ricerca e ai social media.

Quali sono i limiti del generatore di markup Schema?

Il generatore crea il codice, ma non ne monitora la pertinenza: se il prezzo o la disponibilità cambiano, è necessario aggiornare manualmente il markup. Non verifica se i dati corrispondono alla pagina: questa è responsabilità dell'utente. E, soprattutto, un markup corretto non garantisce la visualizzazione di un featured snippet. Google decide se mostrarlo, tenendo conto della qualità della pagina e della query di ricerca.

Quando uno strumento gratuito non è sufficiente?

Un generatore è sufficiente per la homepage e la pagina dei contatti. Per un negozio con centinaia di prodotti, non lo è. È necessario uno specialista se:

• Il ricarico del prodotto dovrebbe prelevare prezzo, disponibilità e valutazione dal database del sito e aggiornarsi automaticamente;
• Search Console mostra errori nei dati strutturati su centinaia di pagine;
• È necessario un insieme di markup: Organizzazione, Prodotto, Elenco di breadcrumb e recensioni, coordinati tra loro;
• Desideri che le citazioni siano corrette dagli assistenti virtuali basati sull'intelligenza artificiale, non solo Google.

Cosa posso fare per il tuo sito web?

Sono Valeriy Danyuk, sviluppatore e specialista SEO con 12 anni di esperienza e oltre 200 clienti. Integro dati strutturati nei template in modo che vengano raccolti dal database del sito web anziché essere inseriti manualmente.

SEO, contenuti e geolocalizzazione

• Audit SEO completo del sito web: verifico il markup di tutti i template, correggo gli errori rilevati da Search Console e analizzo i tipi di link.
• Come un hotel è stato messo in evidenza su ChatGPT, Gemini e Perplexity in 5 settimane: promozione GEO, dove è fondamentale che gli assistenti AI comprendano accuratamente i dati aziendali.
• Un blog SEO basato sull'intelligenza artificiale che genera lead organici: il markup degli articoli viene applicato automaticamente a ciascun articolo.

Siti web e negozi online

• Un negozio online realizzato con WooCommerce, con markup dei prodotti e breadcrumb integrati nel template.
• Piattaforma di dropshipping con negozi partner.
• Su 1001site i dati strutturati, le mappe del sito e le anteprime dei social media vengono configurati automaticamente.

Directory di contabilità e intelligenza artificiale

• Contabilità + tenuta dei libri contabili + un negozio con 30.000 prodotti - elaborazione di migliaia di schede da un unico database.
• Guida basata sull'intelligenza artificiale vettoriale per la riparazione di apparecchiature tramite un bot.

Inviami il link al tuo sito web tramite Telegram e ti dirò quali elementi di markup mancano alle tue pagine principali.

Risultato

1. Il generatore di schema crea JSON-LD per sei tipologie: Articolo, Prodotto, FAQ, Organizzazione, Attività Locale e Breadcrumbs.
2. Evidenzia solo ciò che è visibile sulla pagina e mantieni aggiornati i dati (prezzo, disponibilità, date).
3. Dopo aver incollato il codice, controlla sempre la pagina in Rich Results Test.
4. Per un negozio online, il markup è integrato nel template oppure si sceglie una piattaforma che lo includa già, ad esempio 1001site.

Crea il markup dell'organizzazione per la tua homepage con il generatore di schema gratuito: bastano 5 minuti e un solo blocco di codice.

Fonti

• Pagina dello strumento Generatore di schemi PromoPilot: tipologie, campi e domande frequenti.
• Google Search Central - Introduzione ai dati strutturati e FAQ - Linee guida della pagina.
• Google Rich Results Test e Schema Markup Validator sono strumenti di validazione ufficiali.