“Dati strutturati non analizzabili” in Search Console: come individuare e correggere l’errore

Distingui un errore di sintassi da un’informazione mancante

Il report Google sui dati strutturati non analizzabili riguarda errori gravi che impediscono di interpretare il markup. Il report compare quando Google ne ha rilevati; non è un elenco di tutti i dati strutturati del sito. Una parentesi mancante è un problema diverso dall’assenza di una proprietà richiesta per un risultato avanzato.

Immagina una pagina di un corso: il codice potrebbe essere leggibile ma non specificare il luogo. Aggiungere il luogo non risolve invece un JSON interrotto. Copia il messaggio esatto prima di intervenire e assegna al lavoro una descrizione precisa: “correggere la sintassi del modello corsi”, anziché “sistemare la SEO”. Mantieni distinti anche gli errori del sito da quelli della scheda Google: sono strumenti e percorsi differenti.

Raccogli esempi e riconosci il modello comune

Apri una segnalazione e annota alcuni URL interessati. Confronta il tipo di pagina, il tema grafico, i blocchi aggiunti e l’eventuale presenza dello stesso modulo. Una segnalazione su molti articoli può dipendere da un componente condiviso; una sola pagina può contenere un valore particolare che il modello non gestisce correttamente.

• Due pagine segnalate: cerca gli elementi che hanno in comune.
• Una pagina simile senza segnalazione: verifica se usa lo stesso generatore.
• Il messaggio completo: conserva anche il punto del codice indicato.
• Le modifiche recenti al sito: chiedi quali moduli o campi sono cambiati.

Non limitarti alla prima pagina dell’elenco. Prepara una piccola selezione rappresentativa, soprattutto se il sito contiene servizi, prodotti e articoli prodotti da sistemi diversi.

Controlla il codice effettivamente pubblicato

Il Test dei risultati avanzati consente di esaminare un URL o un frammento di codice. Per il tecnico è utile confrontare il contenuto pubblicato con quello generato dal tema o dal plugin. Un testo corretto nel pannello di gestione può essere trasformato in modo errato quando viene inserito nel JSON.

Un esempio minimo di sintassi errata è {"name": "Officina Esempio",}: la virgola finale non è ammessa. La forma {"name": "Officina Esempio"} risolve quel singolo problema. Questi frammenti illustrano soltanto la sintassi; non sono un markup completo da copiare sul sito.

Presta attenzione a virgolette presenti nei titoli, caratteri speciali e valori vuoti. Chi sviluppa dovrebbe generare il JSON con strumenti di serializzazione, evitando concatenazioni manuali fragili.

Correggi il generatore e conserva i dati utili

Chiedi quale componente è responsabile: un plugin SEO, il tema, un blocco personalizzato o un’integrazione commerciale. Se due componenti producono lo stesso tipo di dato, chiarisci prima quale deve gestirlo. Disattivare tutto il markup può far sparire l’errore nascondendo anche informazioni corrette.

Prepara una copia del file o della configurazione da modificare e prova il cambiamento in un ambiente di test, quando disponibile. Controlla anche titoli con apostrofi e virgolette, campi facoltativi assenti e nomi lunghi. Sono casi utili per scoprire se la correzione funziona soltanto sull’esempio iniziale.

Il contenuto descritto deve restare fedele a quello mostrato ai visitatori. Le linee guida Google sui dati strutturati richiedono coerenza e correttezza: una sintassi valida non giustifica recensioni, prezzi o servizi inventati.

Verifica la pubblicazione prima di convalidare

Dopo l’intervento riapri gli URL pubblici e ripeti il controllo. Se il sito usa una cache, verifica che venga distribuita la versione corretta. La verifica del solo frammento modificato non dimostra che tutte le pagine utilizzino già quel codice.

Nel report Google puoi avviare “Convalida correzione” dopo aver risolto il problema. La riparazione della sintassi può rendere visibili altre anomalie prima non interpretabili. Leggile separatamente: non significano necessariamente che la prima correzione sia fallita.

Conserva un registro con URL controllati, componente modificato ed esito del test. Per la consegna chiedi sia una pagina breve sia una pagina con molti dati. Se il problema ricompare soltanto quando si crea un nuovo articolo, il modello o la procedura di inserimento meritano un ulteriore controllo.

Definisci un risultato verificabile per la manutenzione

Una richiesta utile al tecnico può essere: “Correggere il generatore JSON delle pagine servizio, mantenere i dati già corretti e controllare tre pagine rappresentative dopo la pubblicazione”. Indica chi si occupa del codice e chi segue la convalida, così la verifica non resta senza un responsabile.

L’introduzione Google ai dati strutturati spiega come questi descrivano il contenuto delle pagine. Non costituiscono però una promessa di posizionamento. Anche con markup corretto, Google non garantisce la comparsa di un risultato avanzato.

Se il sito non è indicizzato o restituisce errori di accesso, apri un’attività distinta. Il risultato di questo intervento è un codice interpretabile e coerente, accompagnato da una verifica ripetibile; traffico e richieste dei clienti vanno valutati con altri dati.