Generatore JSON-LD Schema.org

Cos'è questo strumento

Il generatore Schema.org JSON-LD è una piccola applicazione web che aiuta a creare dati strutturati per le pagine del sito. Se hai mai visto nei risultati di ricerca di Google stelle di valutazione, il prezzo di un prodotto o un blocco con l'immagine di una ricetta, è proprio il risultato della marcatura Schema.org. Lo strumento si occupa della parte ripetitiva: non serve scrivere JSON a mano, basta compilare alcuni campi.

Più spesso lo utilizzano esperti SEO, webmaster e proprietari di negozi online che vogliono migliorare l'aspetto del loro sito nei risultati di ricerca. Inoltre lo strumento sarà utile anche agli sviluppatori che integrano la marcatura nei modelli HTML o nei sistemi di gestione dei contenuti. Invece di tenere in testa la struttura di ogni tipo di dato, basta scegliere l'opzione necessaria, inserire le informazioni e ottenere un frammento di codice pronto all'uso.

Funzionalità

Lo strumento copre quattro tipi di marcatura tra i più comuni, ma è in grado di fare qualcosa di più che generare semplice codice di base. Ecco cosa è utile sapere:

• Supporta i tipi Product, Article, Organization e LocalBusiness. Questo è sufficiente per la maggior parte dei compiti tipici di marcatura delle pagine.
• Aggiunta automatica di oggetti annidati. Per un prodotto si ottiene un blocco Offer con prezzo e valuta; per un articolo l'autore è rappresentato come Person, e per l'organizzazione l'indirizzo fisico è PostalAddress.
• Output pulito del codice. I campi opzionali vuoti non compaiono nel risultato, quindi nel JSON non ci sarà spazzatura come righe vuote o valori null.
• Copiare il risultato con un solo clic. Il pulsante «Copia» trasferisce immediatamente tutto il codice negli appunti, così puoi incollarlo nel tuo HTML.
• Elaborazione completamente locale dei dati. Tutta la generazione avviene nel tuo browser, senza invio di informazioni al server. È utile se lavori con dati sensibili dei clienti.
• Chiarezza nell'indicare i campi obbligatori. Nei moduli i campi contrassegnati da un asterisco sono immediatamente visibili, e lo strumento non permetterà di generare una marcatura non valida senza le informazioni chiave.

È importante sottolineare che il risultato è sempre un JSON-LD valido con i campi obbligatori @context e @type. Ciò significa che il codice può essere usato immediatamente e i motori di ricerca lo riconosceranno correttamente.

Come usarlo

Il processo di utilizzo del generatore è estremamente semplice e si compone di quattro passaggi. Prima di iniziare, prepara le informazioni essenziali sull'oggetto che vuoi marcare. Per un prodotto: nome, descrizione e prezzo; per un articolo: titolo e autore; per un'organizzazione: nome e contatti. Così non ti distrarrai durante la compilazione del modulo.

Primo passo: scegli il tipo Schema.org dall'elenco a discesa. Sono disponibili Product, Article, Organization e LocalBusiness. La scelta determina quali campi appariranno nel modulo. Se devi marcare un prodotto, scegli Product, per una notizia o un blog Article, per l'azienda Organization, e per un caffè, negozio o salone di bellezza LocalBusiness.

Secondo passo: compila i campi del modulo. I campi obbligatori sono contrassegnati da un asterisco e non possono restare vuoti. Gli altri campi sono facoltativi, ma vale la pena completarli se l'informazione è disponibile. Ad esempio, per un Product il campo immagine non è obbligatorio, ma aiuta Google a mostrare la foto del prodotto nei risultati. Se un campo non è compilato, non verrà incluso nel codice generato.

Terzo passo: premi il pulsante «Genera». A destra apparirà un JSON-LD pronto all'uso. Per Product verrà aggiunto automaticamente un oggetto annidato Offer con prezzo e disponibilità. Per Article verrà aggiunto un oggetto Person con i dati dell'autore. E per Organization o LocalBusiness apparirà un blocco PostalAddress con via, città e CAP. Il codice si aggiorna ogni volta che modifichi i dati nel modulo e premi nuovamente.

Quarto passo: premi «Copia», per copiare JSON-LD negli appunti. Poi apri il file del tuo sito e incolla il codice all'interno del tag <script type=\"application/ld+json\">...</script>. Questo tag va posizionato nella sezione <head> o <body> della pagina. Dopo aver salvato e pubblicato la pagina, puoi verificare la marcatura usando Google Rich Results Test. Per questo basta incollare l'URL della pagina o il codice di marcatura nel campo corrispondente.

Scenari tipici

Lo scenario più comune è la marcatura di una scheda prodotto in un negozio online. Sei proprietario di un piccolo negozio di abbigliamento e vuoi che nei risultati di ricerca, accanto al nome del prodotto, compaia anche il prezzo. Scegli il tipo Product, compila nome, descrizione, prezzo, valuta e immagine. Il generatore aggiunge automaticamente un blocco Offer, e incolli il codice ottenuto nel modello della pagina prodotto. Così Google vede il prezzo senza dover aprire il sito.

Secondo scenario è un blog o sito di notizie. Pubblicate articoli e desiderate che accanto al titolo compaia il nome dell'autore e la data di pubblicazione. Selezionate Article, inserite il titolo dell'articolo, l'autore, la data e la descrizione. Lo strumento creerà un JSON-LD con un oggetto Person all'interno. Basta inserire il codice in ogni pagina dell'articolo.

Terzo scenario è un business locale, ad esempio una caffetteria o una barberia. Usando LocalBusiness puoi marcare l'indirizzo, gli orari di apertura e il numero di contatto. È particolarmente utile se hai un punto fisico che i clienti cercano su Google o Google Maps. In modo analogo puoi usare Organization per un'azienda senza indirizzo fisico, ma con logo e profili social.

Consigli e errori comuni

L'errore più comune quando si lavora con generatori Schema.org è incollare il codice nel posto sbagliato o creare duplicazioni di marcatura. Ricorda che la marcatura deve essere presente solo sulla pagina in cui è effettivamente posizionato l'oggetto. Non inserire il codice di un prodotto nella pagina principale del negozio se quel prodotto non è mostrato lì. Questo può creare confusione per i motori di ricerca e portare a penalizzazioni.

Un altro problema comune è ignorare i campi obbligatori. Se Google non trova un campo obbligatorio nella marcatura, potrebbe non mostrare i tuoi Rich Snippet. Perciò fai attenzione agli asterischi nel modulo. Per Product i campi obbligatori sono nome e prezzo, per Article titolo e autore, per LocalBusiness nome e indirizzo. Se manca uno dei campi obbligatori potrebbe valere la pena scegliere un altro tipo di dato o rivedere la specifica.

Terzo consiglio riguarda la verifica del risultato. Dopo aver inserito JSON-LD nella pagina, controlla obbligatoriamente l'URL con Google Rich Results Test. Questo strumento ti mostrerà se Google legge correttamente la tua marcatura e se ci sono avvisi. Se compaiono errori, correggili nel modulo generatore e genera di nuovo.

Un'altra cosa. Lo strumento funziona localmente, che è positivo per la riservatezza. Ma significa anche che non otterrai suggerimenti sulla validità dei dati, oltre a quelli presenti nel modulo stesso. Quindi verifica sempre che prezzo, valuta e URL dell'immagine siano corretti. Un errore nell'URL dell'immagine può far sì che Google non mostri l'immagine nei risultati, anche se la marcatura è tecnicamente valida.

Infine, non cercare di marcare tutto in una volta. Generatore JSON-LD di Schema.org è un aiuto pratico, ma non sostituisce l'analisi. Usa la marcatura dove davvero migliora l'aspetto della pagina nei risultati di ricerca. Questo riguarda soprattutto prodotti, articoli e servizi locali. Se il tuo sito è semplice e non richiede snippet avanzati, un markup in eccesso può solo creare ulteriori problemi di manutenzione.