Il Generatore di Schema Markup è uno strumento progettato per assistere webmaster, sviluppatori e operatori di contenuti nella creazione manuale di dati strutturati in formato JSON-LD. Attraverso un'interfaccia guidata, lo strumento consente di compilare campi specifici per generare codice conforme agli standard di schema.org, riducendo gli errori di sintassi e formattazione.
I dati inseriti rimangono nel browser dell'utente; nessun dato viene caricato su BroBroGo. Il codice JSON-LD completo viene generato e mostrato solo quando tutti i campi obbligatori risultano validi secondo le regole di validazione integrate.
Introduzione a Schema.org e ai dati strutturati
Schema.org è un'iniziativa collaborativa fondata dai principali motori di ricerca per creare, mantenere e promuovere schemi per dati strutturati su Internet. I dati strutturati sono informazioni organizzate in modo sistematico all'interno del codice HTML di una pagina web.
L'adozione di questo vocabolario comune consente ai motori di ricerca di comprendere il significato semantico degli elementi presenti in una pagina, superando la semplice analisi del testo non strutturato. Implementare lo schema markup aiuta i motori di ricerca a interpretare il contesto dei contenuti, facilitando l'indicizzazione e migliorando la precisione con cui le informazioni vengono classificate.
Il formato JSON-LD per i contenuti web
JSON-LD (JavaScript Object Notation for Linked Data) è il formato raccomandato per l'implementazione dei dati strutturati. A differenza di altri metodi di markup come i Microdati o RDFa, che richiedono l'inserimento di attributi direttamente all'interno dei tag HTML del corpo della pagina, JSON-LD separa la presentazione visiva dai dati strutturati.
Il codice viene inserito all'interno di un blocco <script type="application/ld+json">. Questa separazione semplifica la manutenzione del codice, poiché gli sviluppatori possono aggiornare o generare i metadati senza dover modificare la struttura del layout HTML. Il Generatore di Schema Markup produce questo specifico script pronto per essere copiato e incollato nella pagina web di riferimento.
Struttura dello schema FAQPage
Il tipo di schema FAQPage viene utilizzato quando una pagina presenta una lista di domande e risposte su un determinato argomento. Per generare un markup FAQPage valido, lo strumento applica regole precise di compilazione:
- È necessario inserire almeno una domanda e una risposta complete. In caso contrario, viene mostrato l'errore "Aggiunga almeno una domanda e risposta complete.".
- Se un elemento inserito è incompleto, l'editor segnala "L'elemento
{index}richiede una domanda." o "L'elemento{index}richiede una risposta.".
I campi facoltativi che vengono lasciati vuoti non vengono inclusi nel codice JSON-LD finale.
Struttura dello schema Product con offerte
Lo schema Product consente di descrivere un prodotto fisico o digitale, includendo dettagli commerciali associati a un'offerta di vendita. I campi gestiti dal generatore includono:
- Nome del prodotto: Campo obbligatorio. Se omesso, compare l'errore "Aggiunga il nome del prodotto.".
- Prezzo: Deve essere un numero non negativo composto da cifre e un punto decimale facoltativo. Se non inserito, mostra "Aggiunga il prezzo dell'offerta.". Se non rispetta il formato, mostra "Utilizzi un prezzo non negativo con cifre e un punto decimale facoltativo.".
- Codice valuta: Richiede un codice a tre lettere (ad esempio USD, EUR o CNY). L'inserimento di un formato diverso genera l'errore "Utilizzi un codice valuta a tre lettere come USD, EUR o CNY.".
- URL del prodotto e URL dell'immagine: Devono essere indirizzi completi che iniziano con
http://ohttps://. Errori di formattazione attivano rispettivamente i messaggi "L'URL del prodotto deve essere un indirizzo completo http:// o https://." e "L'URL dell'immagine deve essere un indirizzo completo http:// o https://.". - Campi facoltativi: Descrizione, Marca e SKU vengono omessi dal codice finale se lasciati vuoti.
Struttura dello schema HowTo
Lo schema HowTo descrive una guida passo-passo che spiega come completare un compito specifico. La struttura supportata dal generatore prevede:
- Titolo della guida: Campo obbligatorio. Se mancante, viene visualizzato l'errore "Aggiunga il titolo della guida.".
- Minuti totali: Campo facoltativo per indicare il tempo di esecuzione. Deve essere un numero intero compreso tra 1 e 100.000. Valori fuori da questo intervallo generano l'errore "Il tempo totale deve essere un numero intero compreso tra 1 e 100.000 minuti.".
- Materiali e Strumenti: Campi facoltativi in cui inserire un elemento per riga.
- Passaggi: È richiesto almeno un passaggio completo. Se assente, compare l'errore "Aggiunga almeno un passaggio completo.". Se un passaggio inserito non contiene le istruzioni, viene mostrato l'errore "L'elemento
{index}richiede le istruzioni del passaggio.". Il titolo del passaggio rimane facoltativo.
Relazione tra dati strutturati e risultati di ricerca
L'implementazione dei dati strutturati fornisce ai motori di ricerca le informazioni necessarie per abilitare funzioni di visualizzazione avanzate nei risultati di ricerca, note come risultati multimediali (rich results). Ad esempio, lo schema Product può consentire la visualizzazione del prezzo e della disponibilità direttamente nella pagina dei risultati di ricerca.
Tuttavia, la presenza di un markup schema.org valido e privo di errori non garantisce l'effettiva visualizzazione di queste funzioni speciali. I motori di ricerca decidono in modo autonomo se mostrare o meno i risultati multimediali in base a criteri algoritmici e di pertinenza. Inoltre, le linee guida dei motori di ricerca cambiano nel tempo; ad esempio, Google ha rimosso la visualizzazione dei risultati multimediali per i markup di tipo FAQ e HowTo per la maggior parte dei siti web.
Domande frequenti (FAQ)
Quali tipi di schema posso creare?
I moduli guidati coprono FAQPage, Product con Offer, e HowTo con passaggi ordinati, forniture e strumenti. I campi facoltativi vuoti vengono esclusi dal codice.
Dove devo inserire il codice JSON-LD generato?
Incolli lo script completo all'interno dell'elemento <head> o <body> della pagina di cui descrive il contenuto visibile. Mantenga il markup coerente con ciò che i visitatori possono effettivamente vedere.
Un markup valido garantisce un risultato multimediale nei risultati di ricerca?
No. Un markup schema.org valido aiuta i servizi a comprendere la pagina, ma la visualizzazione di funzioni speciali nei risultati di ricerca non è mai garantita. Google non mostra più i risultati multimediali per FAQ o HowTo.
Cosa succede se supero i limiti di caratteri o di elementi nell'editor?
Se un testo inserito supera la capacità massima consentita, l'interfaccia mostra l'errore "Il campo {field} è troppo lungo per questo editor. Deve contenere meno di {max} caratteri.". Se si tenta di aggiungere troppi elementi, viene visualizzato l'errore "Questo editor supporta fino a {max} elementi alla volta.".