La prima volta che ho aggiunto il markup dello schema a un sito client, ho digitato a mano a Product blocca l'intestazione del tema, distribuiscilo e continua a sentirti intelligente Due settimane dopo il Rich Results Test mi ha detto che l'oggetto dell'offerta non aveva la sua @type, il prezzo era un numero in cui Google voleva una stringa, e una virgola vagante finale aveva silenziosamente invalidato l'intero blocco Google l'aveva ignorato per tutto il tempo Questa è la cosa di cui nessuno ti avverte con i dati strutturati: JSON-LD non valido non genera errori né trasforma nulla di rosso. Semplicemente non fa nulla in silenzio, e scopri mesi dopo quando il ricco risultato su cui contavi non si presenta mai.
Il vocabolario stesso è pubblicato su schema.orge ciò per cui Google mostrerà effettivamente un risultato ricco è un elenco più ristretto documentazione strutturata dei dati.
Costruisco strumenti per vivere - Toolz.dev, il plugin WP Adminify, uno stack di app Laravel e React - e i dati strutturati sono uno di quei compiti che faccio abbastanza spesso da risentirmi nel farlo a mano e raramente abbastanza da dimenticare i nomi esatti delle proprietà ogni volta Così ho costruito il Generatore di markup dello schema per rimuovere le due modalità di guasto che mi costano di più: nidificazione sbagliata e invalidità silenziosa Questa guida attraversa ciò che fa effettivamente il markup dello schema, come il generatore lo costruisce e gli errori specifici che impediscono al markup dall'aspetto valido di ottenere risultati ricchi.
tl; dr: Il markup dello schema è un dato strutturato (utilizzando il vocabolario schema.org) che indica ai motori di ricerca esattamente di cosa tratta una pagina, rendendola idonea a risultati ricchi come fisarmoniche FAQ, prezzi dei prodotti e breadcrumb. Google consiglia il formato JSON-LD - un formato autonomo
<script type="application/ld+json">blocco. Il generatore costruisce JSON-LD valido per nove tipi comuni, annida sottooggetti comePostalAddresseOffercorrettamente, i flag mancano campi obbligatori e consigliati, e viene eseguito al 100% nel browser in modo che nulla di ciò che digiti venga caricato.
Cos'è il markup dello schema e perché è importante?
Il markup dello schema è un modo standardizzato di descrivere il contenuto di una pagina in modo che le macchine possano capirlo, non solo renderlo Il vocabolario proviene da schema.org, un progetto condiviso supportato da Google, Microsoft, Yahoo e Yandex Quando si contrassegna una pagina come un Article, stai dicendo a un motore di ricerca & quot; questa è una notizia o un articolo di blog, ecco il suo titolo, ecco chi l'ha scritto, ecco quando è stato pubblicato.& quot; Quella descrizione strutturata è ciò che rende una pagina idonea per risultati ricchi: gli elenchi migliorati con valutazioni a stelle, prezzi, dropdown FAQ, date degli eventi e percorsi breadcrumb che occupano più spazio e guadagnano più clic di un semplice collegamento blu.
Il motivo per cui conta è cambiato negli ultimi anni Una volta riguardava esclusivamente i risultati ricchi in Google Ora i dati strutturati alimentano anche i motori di risposta AI e le panoramiche AI di Google' Quando ChatGPT, Perplexity o Gemini cercano di riassumere ciò che fa la tua azienda o quale prodotto corrisponde a una query, i dati strutturati puliti sono uno dei segnali che li aiutano a ottenere i fatti giusti Una pagina che si dichiara chiaramente un Organization con un nome, un logo e profili social è molto più facile per qualsiasi macchina ragionare rispetto a una che lascia tutto implicito nell'HTML.
Il problema è che i dati strutturati non perdonano. È codice e il codice deve essere esattamente corretto. Una proprietà scritta datePublish invece di datePublished viene semplicemente ignorato. Un Offer senza un @type non è riconosciuto come un'offerta E poiché nessuno di questi errori rompe la pagina visibile, si nascondono in produzione indefinitamente Questo è il divario che un generatore colma - non scrivendo i concetti per te, ma ottenendo la sintassi e la struttura giusta ogni singola volta.
Perché JSON-LD invece di Microdata o RDFa?
Esistono tre modi per aggiungere dati di schema.org a una pagina e aiuta a capire perché il generatore ne produce solo uno.
Microdati e RDFa intreccia i dati strutturati direttamente nel tuo HTML visibile utilizzando attributi extra - itemscope, itemprop, propertye così via. Il tuo <div> per una recensione del prodotto si ottengono attributi che etichettano ogni pezzo di testo visibile Funziona, ma accoppia strettamente il tuo markup alla struttura della tua pagina Cambia il layout e rischi di rompere lo schema È anche prolisso e difficile da leggere.
JSON-LD adotta l'approccio opposto Mette tutti i dati strutturati in un unico autonomo <script type="application/ld+json"> blocco, solitamente nel <head>, completamente separato dall'HTML visibile Google ha consigliato JSON-LD per anni proprio a causa di questa separazione: puoi aggiungerlo, aggiornarlo o iniettarlo attraverso un tag manager senza toccare i tuoi modelli È il formato che ogni moderno tutorial di schema insegna, ed è ciò che il generatore emette.
| formato | Dove vive | Facilità di manutenzione | Posizione di Google's |
|---|---|---|---|
| JSON-LD | Singolo <script> blocco, separato dall'HTML |
Più facile - modifica un blocco | raccomandato |
| Microdati | Attributi all'interno di HTML visibile | Più difficile - accoppiato al layout | supportato |
| RDFa | Attributi all'interno di HTML visibile | Più difficile - accoppiato al layout | supportato |
Se stai lavorando in WordPress, JSON-LD è anche ciò che la maggior parte dei plugin SEO inietta, e ciò a cui uno strumento come WP Adminify si affianca in modo pulito Poiché si tratta di un blocco autonomo, puoi generarlo qui e incollarlo in un campo HTML personalizzato, un tag manager o un layout Laravel Blade senza alcuna ginnastica specifica del framework.
Come faccio a utilizzare il generatore di markup Schema?
Il flusso di lavoro è costruito attorno alla scelta di un tipo e alla compilazione di un breve modulo, con un'anteprima live in modo da vedere il JSON-LD assemblare durante la digitazione.
Passo 1 - Scegli un tipo di schema. Scegli tra Organizzazione, LocalBusiness, Sito Web, Articolo, Prodotto, FAQPage, BreadcrumbList, Persona o Evento Il modulo passa immediatamente ai campi di cui il tipo ha bisogno Questi nove coprono la stragrande maggioranza di ciò per cui i siti di piccole e medie dimensioni hanno effettivamente bisogno di markup.
Passo 2 - Compila i campi. I campi obbligatori sono contrassegnati da un asterisco, mentre digiti, lo strumento assembla il JSON-LD e lascia cadere qualsiasi campo che lasci vuoto, in modo da non finire mai con vuoto "" proprietà che inquinano l'output Per i tipi basati su indirizzi come LocalBusiness ed Event, i singoli campi degli indirizzi vengono piegati in un formato digitato correttamente PostalAddress oggetto automaticamente.
Passaggio 3: guarda la convalida. Il generatore segnala due tipi di problemi Gli errori (campi obbligatori mancanti, URL non validi) bloccano un risultato pulito e vengono visualizzati in rosso Avvertenze (campi consigliati da Google mancanti come image oppure datePublished, o un modello di URL di ricerca mancante del segnaposto) sono mostrati in ambra - il markup è ancora valido, ma stai lasciando potenziale di risultato ricco sul tavolo.
Passaggio 4: copia e distribuisci. Passa da un punto all'altro <script> tag (pronto per incollare nel vostro <head>) e il JSON grezzo (per i tag manager e i campi CMS) L'output dello script sfugge ai caratteri che altrimenti lascerebbero andare un randagio </script> nel tuo break dati la pagina Quindi convalida la pagina live con Google' s Rich Results Test.
Poiché tutto funziona lato client, questo è sicuro da usare su pagine di prodotti non pubblicate, ambienti di staging e lavoro del client sotto NDA I tuoi prezzi, dettagli dell'evento e URL interni non lasciano mai il browser - la stessa posizione sulla privacy dietro ogni strumento sul sito, di cui ho scritto nel Guida alla privacy dei dati.
Quali tipi di schema dovrei effettivamente utilizzare?
Non tutte le pagine hanno bisogno di markup, e accumulare sui tipi che non puoi supportare è peggio di nessuno Ecco come penso ai nove coperti dal generatore.
Organizzazione appartiene alla tua home page o a una pagina about: è lo schema che alimenta i pannelli di conoscenza e aiuta Google a collegare il tuo marchio ai suoi profili social tramite sameAs. Sito Web si accoppia con esso e può dichiarare una casella di ricerca Sitelinks tramite a SearchAction, lasciando che gli utenti cerchino il tuo sito direttamente dalla pagina dei risultati. Affari locali è essenziale se hai una posizione fisica: trasporta il tuo indirizzo, telefono, fascia di prezzo e orari di apertura e è alla base dei risultati dei pacchetti locali e delle mappe.
Articolo (con cui il generatore emette Article type, ugualmente valido per i post del blog) contrassegna il contenuto editoriale con un titolo, un autore, un editore e date di pubblicazione. Prodotto descrive qualcosa in vendita, con un annidato Offer prezzo di trasporto, valuta e disponibilità: questo è ciò che alimenta i frammenti di prezzo e disponibilità. Evento copre qualsiasi cosa con una data e un luogo, da una conferenza a un webinar.
Pagina FAQ e BreadcrumbList sono strutturali piuttosto che su un & quot;thing." FAQPage contrassegna il contenuto di domande e risposte; tieni presente che Google ha ristretto i risultati ricchi di domande frequenti a siti governativi e sanitari autorevoli, ma il markup aiuta comunque altri motori di ricerca e motori di risposta AI ad analizzare le tue domande e amp; A. BreadcrumbList produce la traccia breadcrumb mostrata sotto il tuo titolo nei risultati, che migliora il modo in cui si legge la struttura dell'URL. Persona contrassegna un individuo - un autore, un fondatore o un personaggio pubblico - ed è utile per le biografie degli autori e i segnali EEAT.
La regola che seguo: contrassegna ciò di cui tratta realmente la pagina e rivendica solo proprietà che riflettono contenuti effettivamente visibili sulla pagina Le linee guida di Google's sono esplicite sul fatto che i dati strutturati devono descrivere contenuti reali e visibili: contrassegnare un prezzo che non appare sulla pagina è una violazione, non una scorciatoia.
Come fa il generatore a mantenere valido il markup?
Il valore è nei dettagli che sono facili da sbagliare a mano Alcuni vale la pena di chiamare.
Corretta nidificazione con @type. In JSON-LD, gli oggetti nidificati non sono semplici sottooggetti: ognuno ha bisogno dei propri @type. Un indirizzo è un PostalAddress, un'offerta è un Offerun articolo's autore è un Person, il suo editore è un Organization il cui logo è un ImageObject. Il generatore costruisce ognuno di questi con il tipo giusto in modo che il parser li riconosca invece di trattarli come blob anonimi.
Svuota potatura. Lasciare vuoto un campo dovrebbe rimuovere la proprietà, non emettere "telephone": "". Le stringhe vuote e gli array vuoti vengono eliminati automaticamente dall'output, quindi ciò che copi è sempre pulito.
Fuga sicura per la sceneggiatura. Il singolo personaggio più pericoloso in linea JSON-LD è un < - in particolare la sequenza </script> apparire all'interno dei tuoi dati (diciamo, in una descrizione), che terminerebbe il blocco di script in anticipo e interromperebbe la pagina Il generatore evade <, >, e & nell'output del tag script che utilizza l'escape unicode, che è esattamente ciò che fanno Google' gli esempi propri.
Consapevolezza richiesta e consigliata. Ogni tipo porta il proprio elenco di ciò che Google richiede rispetto a quello che consiglia. L'articolo vuole davvero un image e datePublished; Il prodotto vuole un price; L'evento ha bisogno di un startDate. Lo strumento distingue i requisiti rigidi (che tratta come errori) dalle raccomandazioni (avvertenze), quindi conosci la differenza tra & quot;questo non funzionerà& quot; e & quot;questo potrebbe funzionare meglio.& quot;
Se stai assemblando un flusso di lavoro tecnico più ampio, il generatore di schemi si trova naturalmente accanto alle altre utilità SEO: il Generatore di meta tag per il titolo, la descrizione e i tag Open Graph e il Generatore di mappe del sito XML per l'invio dei tuoi URL Insieme coprono la maggior parte della superficie SEO tecnica on-page, e li ho raggruppati per questo motivo nel panoramica del toolkit per sviluppatori web.
Come faccio a testare e distribuire i dati strutturati?
Generare JSON-LD valido è metà del lavoro; l'altra metà conferma che Google lo legge nel modo in cui intendi.
Inizia con Google's Test dei risultati ricchi, che recupera un URL o accetta codice incollato e segnala quali tipi di risultato ricco la pagina si qualifica, più eventuali errori o avvisi Quindi eseguire lo stesso markup attraverso il Convalidatore del markup dello schema a validator.schema.org, che controlla la conformità al vocabolario stesso di schema.org piuttosto che a Google's rich-result requirements I due catturano cose diverse: il Rich Results Test ti dice se sei idoneo per una specifica funzionalità di Google, mentre il validatore ti dice se il markup è strutturalmente sound schema.org.
Una volta che la pagina è attiva, il miglioramento riporta in Google Search Console tieni traccia delle prestazioni nel tempo e segnala gli errori che Google trova durante la scansione È qui che rilevi i problemi che appaiono solo su larga scala: un modello che emette posizioni di breadcrumb duplicate, ad esempio, o un feed di prodotto che occasionalmente omette un campo richiesto.
Per la distribuzione, incolla il file <script> bloccare nel <head> della pagina specifica che descrive Non mettere un singolo blocco Prodotto in un modello globale che viene eseguito su ogni pagina - il markup deve corrispondere alla pagina su cui vive In un CMS, utilizzare qualsiasi campo personalizzato-HTML o SEO la piattaforma ti dà In un tag manager, utilizzare un tag HTML personalizzato e copiare il JSON In un React o Laravel app, inserire il blocco lato server in modo che i crawler lo vedano nell'HTML iniziale piuttosto che dopo l'idratazione.
Errori comuni che vedo ancora
Una manciata di errori si manifestano ancora e ancora e ognuno di essi produce un markup che sembra a posto ma non fa nulla.
Il classico è contrassegnare i contenuti invisibili - l'aggiunta di una valutazione di recensione o di un prezzo che non appare in nessuna parte della pagina Google lo vieta esplicitamente e può emettere un'azione manuale per esso Il secondo è il tipo sbagliato su un oggetto annidato, di solito manca @type su un indirizzo o un'offerta Il terzo è conflating tipi simili, come usare Product markup su una pagina di elenco delle categorie piuttosto che su un singolo prodotto E il quarto, la mia nemesi personale, è un errore di sintassi derivante dalla modifica manuale - una virgola finale o una citazione senza escape che invalida l'intero blocco.
Ognuno di questi è il motivo per cui un generatore guadagna il suo mantenimento Non può sapere se il tuo prezzo è visibile sulla pagina - che è su di te - ma non emetterà mai una virgola finale, una mancante @type, o una proprietà vuota Quello da solo rimuove la maggior parte dei modi in cui i dati strutturati falliscono silenziosamente Per un background più approfondito sui flussi di lavoro degli sviluppatori attorno a questo tipo di strumenti, il Guida agli strumenti di codifica è una buona lettura da compagno.
Domande frequenti
Cos'è il markup dello schema?
Il markup dello schema è un dato strutturato che descrive un contenuto page's ai motori di ricerca utilizzando il vocabolario condiviso schema.org Aggiungendolo si può rendere una pagina idonea per risultati ricchi come fisarmoniche FAQ, prezzi dei prodotti, stelle di recensione e breadcrumb. JSON-LD, il formato prodotto da questo strumento, è la sintassi consigliata da Google perché vive in un singolo tag script separato dal tuo HTML visibile.
Qual è la differenza tra JSON-LD, Microdata e RDFA?
Tutti e tre sono modi per aggiungere dati strutturati a Schema.org a una pagina. I microdati e RDFA sono attributi intessuti nel tuo HTML visibile, mentre JSON-LD è un blocco di JSON autonomo in un tag di script. Google consiglia JSON-LD perché è più facile aggiungere, aggiornare e mantenere separati dal markup della pagina. Questo strumento emette JSON-LD per questo motivo.
dove metto il JSON-LD generato?
Incolla il pieno <script type="application/ld+json"> tag nel <head> della pagina che descrive, o in qualsiasi punto del <body> - Google lo legge in entrambe le posizioni Se si utilizza Google Tag Manager, copiare il JSON e aggiungerlo attraverso un tag HTML personalizzato Posizionare sempre il markup sulla stessa pagina di cui descrive il contenuto, non un modello che lo applica ovunque.
L'aggiunta di markup dello schema garantisce risultati ricchi?
no I dati strutturati validi rendono una pagina idonea per i risultati ricchi, ma Google decide se mostrarli in base alla qualità, alla pertinenza e alle proprie linee guida. Il tuo markup deve anche riflettere il contenuto che è effettivamente visibile sulla pagina. Pensa allo schema come a un requisito per i risultati ricchi, non a un interruttore che li accende.
Come posso testare i miei dati strutturati?
Esegui il markup generato tramite Google's Rich Results Test e Schema Markup Validator (schema.org' s validator) Sia analizza il tuo JSON-LD che segnala i campi obbligatori mancanti o gli errori di sintassi Dopo che la pagina è attiva, i report sui miglioramenti di Google Search Console tengono traccia delle prestazioni dei tuoi dati strutturati nel tempo.
Quali campi sono necessari per ogni tipo?
I requisiti variano in base al tipo: l'articolo ha bisogno di un titolo, il prodotto ha bisogno di un nome, l'evento ha bisogno di un nome e di un inizio e delle domande frequenti hanno bisogno di almeno una domanda e risposta. Questo strumento contrassegna i campi richiesti e blocca l'output fino a quando non vengono riempiti, avvisando anche i campi consigliati che migliorano le tue possibilità di ottenere un risultato ricco.
Posso generare lo schema delle FAQ per la mia pagina?
si. Scegli il tipo di pagina delle FAQ, aggiungi ogni domanda con la sua risposta e lo strumento costruisce automaticamente l'array di MaineEntity di oggetti di domande e risposte. Si noti che Google ora mostra risultati ricchi di FAQ principalmente per i siti di governo e salute autorevoli, ma il markup rimane valido e utile per altri motori di ricerca e motori di risposta AI.
I miei dati sono mantenuti privati?
Sì. Il JSON-LD è assemblato interamente nel browser con JavaScript semplice. Niente di ciò che digiti, inclusi prezzi non pubblicati, dettagli di eventi o URL privati, viene trasmesso, registrato o archiviato e il generatore continua a funzionare senza connessione di rete una volta caricato.
