Vai al contenuto
megapromotingParliamone

Competenza · AEO

Traduciamo la pagina in dati che una macchina legge senza indovinare, e verifichiamo il risultato con lo strumento del motore.

Dati strutturati, domande e risposte in forma leggibile, breadcrumb, nodo dell'organizzazione. Tra i tre argomenti, questo è quello in cui il risultato si può testare, non solo presumere.

Già costruitoTre implementazioni proprie, tutte aperte su disco e verificabili dall’esterno oggi. La prima: le pagine di prodotto di questo sito servono un grafo di 1.479 byte con `WebPage`, `SoftwareApplication` e `BreadcrumbList` collegati tra loro, generato dagli stessi dati del testo visibile — 23 pagine. La seconda: un modulo di analisi proprio per risposte dirette, 51 righe, otto verifiche con punti scritti esplicitamente nel codice, con peso 0,10 nel punteggio complessivo dell’analizzatore. La terza: un generatore pubblico di dati strutturati sul nostro sito, cinque tipi, che risponde 200. La riserva che diciamo nella stessa frase: lo stesso modulo di analisi dà 30 su 100 alla nostra pagina di prodotto, perché non sa leggere un grafo — il limite è dello strumento, è scritto sotto, ed è da correggere.

Un motore che mostra una risposta diretta non compone testo: estrae un pezzo da una pagina e lo mette sotto la domanda. Per estrarre senza indovinare, ha bisogno di una corrispondenza senza ambiguità tra domanda e risposta, tra prodotto e il suo stato, tra pagina e l’organizzazione che la pubblica. I dati strutturati sono esattamente questo — non una decorazione SEO, ma la pagina scritta una seconda volta, per un lettore che non capisce l’aspetto, solo la struttura.

La differenza rispetto agli altri due soggetti è che qui il risultato si testa. Non si presume e non si spera: si prende l’indirizzo, lo si dà allo strumento di validazione del motore e si vede se il blocco viene letto, quali tipi riconosce e quali campi gli mancano. Per questo questa pagina può citare più di quella sulle risposte generate — e per questo è scritta come lavoro fatto, non come offerta.

Come appare la situazione su questo sito, contata oggi, non stimata: 147 indirizzi nella sitemap. Ventitré pagine prodotto portano un grafo corretto di 1.479 byte. Tutte le altre portano esattamente un blocco, di 265 byte, con sei campi: contesto, tipo, identificatore, nome, indirizzo, descrizione. Senza logo, senza indirizzo postale, senza punto di contatto e senza link ai profili pubblici — sebbene nella configurazione del sito siano scritti sei. La pagina delle domande frequenti ha dieci domande in HTML, nessun blocco di domande leggibile da macchina, e non è nella sitemap.

La parte che cambia la discussione è l’inventario di testo già scritto. Nelle sorgenti dei contenuti di questo sito ci sono 233 coppie domanda-risposta nelle pagine di servizio, 175 in quelle di prodotto e dieci nella pagina delle domande frequenti — 418 in totale, scritte, riviste, con risposte reali. Zero sono oggi in una forma che una macchina legge. Questa è, di solito, la lavorazione: non la produzione di contenuto nuovo, ma la traduzione di quello esistente. Un sito che non ha le domande scritte ha un altro problema, più grande, e lo diciamo prima.

Cosa comprende

Il lavoro, per componenti

Inventariamo ciò che una macchina legge oggi da ogni indirizzo

Richiediamo ogni indirizzo, estraiamo ogni blocco di dati strutturati, lo analizziamo e scriviamo i tipi e la dimensione. Il risultato è una tabella, non un’impressione. Su questo sito: una pagina prodotto restituisce due blocchi, di 265 e 1.479 byte, con quattro tipi tra loro; la homepage, il catalogo, il blog, il contatto, le domande frequenti e le pagine di servizio restituiscono un solo blocco, di 265 byte, con un tipo. Qui si vede anche ciò che è rotto in silenzio: un blocco che non si analizza non dà alcun errore visibile, semplicemente non esiste per il motore.

Traduciamo le domande già scritte, non ne inventiamo altre

418 coppie domanda-risposta esistono già nelle sorgenti dei contenuti di questo sito e nessuna è in una forma leggibile. Il blocco delle domande viene generato esattamente dalla stessa sorgente del testo visibile, non si riscrive a mano una seconda volta. La regola è rigorosa ed è il motivo: se nei dati compaiono domande o risposte che non sono nella pagina, il motore lo tratta come una discrepanza, e il risultato è la perdita della visualizzazione speciale, non un vantaggio.

Un solo grafo per pagina, con nodi che si conoscono tra loro

Invece di blocchi separati che ripetono gli stessi dati, un grafo in cui la pagina, l’entità principale e il breadcrumb si riferiscono l’uno all’altro tramite identificatore, e l’organizzazione è un unico nodo per tutto il sito. Così appaiono le nostre pagine prodotto: la pagina rimanda all’organizzazione come editor, l’entità principale rimanda alla stessa organizzazione come autore, il breadcrumb ha tre livelli reali. Il dettaglio che non si vede: in scrittura, il segno `<` viene sostituito con la sua sequenza di escape, così un testo nei dati non può chiudere il blocco e arrivare come codice nella pagina. È una riga, è nel file.

Verifichiamo con lo strumento del motore, non con la nostra opinione

Ogni tipo di pagina passa attraverso lo strumento di validazione del motore, che dice cosa ha letto e quale campo gli manca. È l’unico punto dei tre soggetti in cui esiste un verdetto esterno, immediato e riproducibile. Ciò che consegniamo è la cattura del verdetto per ogni tipo di pagina, non un’affermazione che “abbiamo implementato lo schema”.

Un modulo di analisi proprio, con i punti scritti nel codice

Il nostro modulo per le risposte dirette esegue otto verifiche con punteggio esplicito: presenza di qualsiasi blocco leggibile 20 punti, domande frequenti 20, istruzioni passo passo 10, sezioni marcate per la lettura vocale 10, breadcrumb 10, valutazioni 10, organizzazione 10, articolo o prodotto 10, con tetto a 100. Pesa 0,10 nel punteggio complessivo dell’analizzatore. I punti non sono nascosti in un algoritmo; sono otto righe che si possono leggere.

Il limite del proprio strumento, detto prima che lo troviate da soli

Lo stesso modulo legge il tipo solo al livello superiore del blocco o in un array. Un grafico non ha tipo al livello superiore, quindi i tipi al suo interno non vengono visti. La conseguenza, misurata sul nostro sito: la pagina di prodotto riceve 30 su 100 dal nostro analizzatore, sebbene riporti tre tipi corretti, due dei quali conteggiati dal modulo. Il numero è sbagliato, la pagina no. L’abbiamo scritto qui perché uno strumento di cui si scopre il difetto dal fornitore è più utile di uno di cui si scopre da soli, alla seconda esecuzione.

Il nodo dell’organizzazione, una volta per tutto il sito

Il nome legale, l’indirizzo, il punto di contatto, il logo e i collegamenti ai profili pubblici, in un unico nodo a cui rimandano tutte le pagine. È il collegamento tra il sito e il resto delle vostre tracce pubbliche. Su questo sito il nodo ha sei campi e nessuno di questi collegamenti, sebbene nella configurazione siano elencati sei profili. È una mancanza, è conteggiata ed è la prima nella lista delle correzioni perché si risolve in un solo punto.

La card di condivisione, generata dal titolo della pagina

L’immagine che appare quando qualcuno condivide l’indirizzo viene generata dal titolo e dalla descrizione della pagina, nei colori del sito, così che l’anteprima mostri la pagina a cui rimanda. Le nostre pagine di prodotto hanno il loro percorso e restituiscono un’immagine reale. La mancanza, scritta come mancanza: le pagine di servizio dichiarano nei metadati un indirizzo immagine per il quale non esiste alcun percorso nel codice — richiesto direttamente, restituisce 404. In produzione viene ancora servita l’immagine generale, quindi il difetto appare solo dopo la pubblicazione, su 25 pagine. È segnalato, non nascosto.

Ciò che non inseriamo mai nei dati strutturati

Note e recensioni che non potete provare con una fonte pubblica. Prezzi che non sono scritti sulla pagina. Termini di consegna come garanzia. Il motivo non è prudenza: una valutazione dichiarata nei dati senza fonte pubblica è esattamente ciò che mira a una sanzione manuale, e un’affermazione falsa in un formato leggibile dalle macchine è una menzogna fatta per circolare — è quella che finisce citata. Abbiamo trovato così qualcosa nel nostro stesso archivio e qui sotto scriviamo cosa era e cosa abbiamo fatto.

Come si presenta

Il percorso, passo dopo passo.

01

L’inventario di oggi, indirizzo per indirizzo

La prima consegna è la tabella: ogni indirizzo, ogni blocco, i tipi riconosciuti, la dimensione in byte e i blocchi che non si analizzano. Da qui in poi ogni affermazione ha una riga alle spalle. È anche il momento in cui compaiono i blocchi rimasti da una versione precedente del sito, che contraddicono la pagina di oggi.

02

Il nodo dell’organizzazione e il breadcrumb

Si fanno una volta e si applicano ovunque: un solo nodo per l’organizzazione, con identificatore, a cui rimandano tutte le pagine, e un breadcrumb che corrisponde alla struttura reale degli indirizzi. L’ordine non è negoziabile — al contrario, riparate cento pagine per qualcosa che si risolve in un file.

03

Le domande esistenti, messe in forma

Il blocco delle domande viene generato dalla stessa fonte dell’elenco visibile sulla pagina. Forniamo anche l’elenco degli indirizzi in cui le domande esistono nel testo ma non erano dichiarate — su questo sito ne sono risultate 418 coppie scritte e nessuna dichiarata.

04

La validazione esterna, per ogni tipo di pagina

Passiamo nello strumento del motore una pagina per ciascun tipo e consegniamo il verdetto: quali tipi sono stati letti, quali campi mancano, quali avvisi sono comparsi. Non dichiariamo nulla concluso solo perché il blocco “è nel codice”.

05

La verifica che rimane dopo di noi

Uno script eseguito dopo ogni pubblicazione, che si arresta se un blocco ha smesso di essere parsato, se un tipo è scomparso da un modello di pagina o se il blocco di domande si è separato dal testo visibile. Senza di esso, il lavoro si erode esattamente come qualsiasi convenzione non scritta: qualcuno aggiunge un nuovo modello e se ne dimentica, e nessuno se ne accorge perché nulla sembra rotto sullo schermo.

1Inventario2traducere3validareciò che legge oggi una macchina da ogni indirizzo, ciò che dichiariamo dal testo giàscris, ce spune unealta motorului despre rezultat.
Il percorso, in 3 passi

I dati

Cosa tocchiamo, dove risiedono e quanto rimangono

Le domande che pone chiunque abbia un responsabile della protezione dei dati — poste qui prima che le ponga lui.

Ciò che leggiamo dal Suo sito
Solo l'HTML pubblico e i blocchi di dati che sono già lì. Per l'inventario non ci serve accesso all'amministrazione. Per la validazione non ci serve nulla in più: lo strumento del motore lavora sull'indirizzo pubblico.
Ciò di cui abbiamo bisogno da Lei, e che non possiamo inventare
I fatti nel nodo dell'organizzazione: la denominazione giuridica esatta, l'indirizzo, l'orario, il numero di contatto e i profili pubblici reali. I dati strutturati che contraddicono la realtà sono peggiori della loro assenza — sono un'affermazione verificabile e sbagliata, pubblicata da Lei, in un formato fatto per essere letto automaticamente.
Ciò che non entra mai nei dati
Dati personali dei dipendenti o dei clienti. Valutazioni senza una fonte pubblica. Prezzi che non compaiono nella pagina. Domande e risposte che il visitatore non vede. Regola pratica: se una persona che apre la pagina non può trovare lì l'informazione, essa non ha posto nel blocco.
Da dove si generano i blocchi
Dalla stessa fonte di dati del testo visibile, non da un file parallelo. È l'unico modo in cui i due non si separano: qualcuno modifica una risposta nella pagina, il blocco si modifica insieme ad essa. Un blocco scritto a mano resta indietro in pochi mesi e nessuno se ne accorge, perché non si vede.
Dove stanno i risultati e per quanto restano
La tabella di inventario, i verdetti dello strumento di validazione e la verifica dopo la pubblicazione restano versionati nel repository del progetto, accanto al codice. Vivono quanto vive il repository. Non contengono nulla che non sia già sul sito: un inventario di dati strutturati è una lettura delle pagine pubbliche, non un'estrazione dai Suoi sistemi.

Un caso

418 domande scritte, nessuna nella forma che legge una macchina

La situazione

Il nostro stesso sito, 147 indirizzi nella mappa del sito, con il testo riscritto di recente domanda per domanda. Tutte le pagine rispondevano 200 e apparivano corrette. La domanda iniziale non era «cosa aggiungiamo ancora», ma «di ciò che c'è nella pagina, cosa arriva a una macchina».

Cosa abbiamo costruito

Abbiamo chiesto le pagine rappresentative per ogni tipo, abbiamo estratto e parsato ogni blocco di dati strutturati, abbiamo contato i tipi e gli ottetti. Abbiamo replicato sull'HTML vivo la logica del nostro stesso modulo di analisi, per vedere quale punteggio si assegna da solo il sito. Abbiamo letto i componenti di dati strutturati nel repository, compresi quelli che non sono usati da nessuna parte. E abbiamo contato le coppie domanda-risposta esistenti nelle fonti di contenuto.

Cosa è emerso

Ventitré pagine di prodotto portano un grafo corretto di 1.479 byte, con tre tipi collegati tra loro. Tutte le altre portano un unico blocco di 265 byte, con sei campi e nessun elemento di identità — senza logo, senza indirizzo, senza punto di contatto, senza collegamenti ai sei profili scritti nella configurazione. La pagina delle domande frequenti ha dieci domande in HTML, nessun blocco dichiarato, ed è assente dalla sitemap. Nei sorgenti sono scritte 418 coppie domanda-risposta: 233 per servizio, 175 per prodotto, dieci sulla pagina delle domande. Zero dichiarate. Il nostro modulo assegna alla pagina di prodotto 30 su 100, perché non legge i tipi da un grafo. E nel repository abbiamo trovato tre componenti non utilizzati che dichiaravano una valutazione aggregata con recensioni firmate, un catalogo prezzi e una guida passo dopo passo con scadenze — verificato in produzione che nessuno viene servito.

Cosa non dice il caso

Niente dell'elenco sopra era riparato nel giorno in cui è stato scritto. L'inventario e le constatazioni sono il deliverable di questa fase; le riparazioni sono la fase successiva, e hanno il loro ordine — prima ciò che si risolve in un file, poi ciò che richiede lavoro su ogni modello. E ancora una volta, perché è importante: un blocco valido non compra una visualizzazione speciale. La rende possibile. La documentazione del motore decide il resto, e si cambia.

Domande

Cosa ci chiedono le persone prima di chiamare

I dati strutturati mi garantiscono un frammento arricchito nei risultati?

No. La visualizzazione speciale la concede il motore, non il markup. I dati validi sono la condizione di accesso, non l’acquisto del risultato. Si vede chiaramente già dal tipo di markup che viene venduto ovunque: la documentazione di Google scrive che il risultato arricchito per le domande frequenti viene mostrato solo per siti governativi e sanitari ben noti e autorevoli — restrizione entrata in vigore nel settembre 2023. Quindi un fornitore che oggi Le vende “snippet arricchiti con FAQ” o non ha letto la documentazione, oppure spera che non l’abbia letta Lei.

Allora perché dichiarare ancora le domande, se non appaiono come snippet?

Perché la visualizzazione speciale è solo uno dei consumatori del formato. Un blocco di domande dichiarato correttamente indica senza ambiguità quale testo è la domanda e quale è la risposta — informazione usata dai motori per l’estrazione di frammenti, dagli assistenti che leggono la pagina su richiesta di un utente e da qualsiasi sistema che preleva il contenuto senza vedere l’aspetto. E c’è anche un effetto meno discusso: l’obbligo di dichiarare le coppie La forza ad avere risposte reali a domande reali. I siti che non riescono a completare il formato di solito non hanno nulla da dichiarare.

A cosa serve questo, rispetto a SEO e alla visibilità nelle risposte generate?

Alla forma, non all’inventario e non alla composizione. Il SEO risponde a «il motore può raggiungere ogni pagina e sa qual è la versione ufficiale». La visibilità nelle risposte generate risponde a «posso essere usato come fonte», dove il risultato non si può promettere. Qui si risponde a «una macchina può prendere l’informazione esatta dalla pagina senza indovinare», ed è l’unica delle tre con un verdetto esterno: Lei fornisce l’indirizzo dello strumento di validazione e riceve subito la risposta.

Posso mettere nei dati domande o informazioni che non sono sulla pagina?

No, ed è un errore che troviamo spesso. Il markup che descrive qualcosa di diverso dal contenuto visibile viene trattato come mancata corrispondenza, e la conseguenza è la perdita della visualizzazione, talvolta una sanzione manuale. La regola che applichiamo è meccanica, non di buon senso: il blocco viene generato dalla stessa fonte del testo della pagina, quindi non può contenere qualcosa che non si vede. Quando qualcuno chiede di aggiungere nei dati una risposta che non vuole scrivere sulla pagina, la discussione si ferma lì.

I concorrenti hanno stelle nei risultati. Perché noi no?

Perché non possiamo dimostrare un punteggio. Una valutazione aggregata dichiarata nei dati deve corrispondere a recensioni reali, verificabili pubblicamente. Senza questo, è un’affermazione falsa in un formato leggibile automaticamente. Siamo categorici qui per un motivo concreto: nel nostro stesso repository abbiamo trovato un componente che dichiarava un punteggio di 4,9 da 87 recensioni e sei recensioni firmate con nomi di persone, e un secondo che dichiarava un catalogo di quattro offerte con prezzi. Nessuno dei due viene renderizzato da nessuna parte — la produzione oggi serve un solo blocco, verificato — ma esistevano a un import di distanza. Li abbiamo segnalati nel registro delle decisioni del team, non li abbiamo cancellati in silenzio.

Quali tipi usate effettivamente?

Quelli che eseguiamo: pagina, entità principale della pagina, breadcrumb, organizzazione e blocco delle domande. Il nostro generatore pubblico copre cinque tipi — attività locale, organizzazione, articolo, prodotto, domande frequenti — ed è disponibile sul sito. Qualsiasi altro tipo si discute su richiesta, dopo una verifica di compatibilità con ciò che il motore mostra effettivamente per il Suo dominio. Cosa non facciamo: non aggiungiamo tipi perché esistono nella specifica. Un blocco che nessun motore usa per il Suo sito è peso, non vantaggio.

Come verificate che funzioni?

In tre punti, perché uno solo mente. Lo strumento di validazione del motore dà il verdetto esterno. Il nostro modulo di analisi dà un punteggio con otto verifiche e punti scritti nel codice, così può confrontare tra esecuzioni. E uno script eseguito dopo ogni pubblicazione fallisce se un blocco ha smesso di essere parsato o un tipo è scomparso. Aggiungiamo anche il limite del nostro modulo, così non Lo scopre da solo: non legge ancora i tipi da un grafo, quindi dà un punteggio più basso della realtà delle pagine costruite correttamente — comprese le nostre.

Cosa si rompe nel tempo?

Il legame tra blocco e pagina. Qualcuno cambia una risposta nel testo, il blocco resta con quella vecchia, e sullo schermo nulla sembra rotto — per questo passa inosservato per mesi. La seconda cosa che si rompe sono i blocchi rimasti da una versione precedente del sito, che descrivono un’offerta che non esiste più. Entrambi hanno lo stesso rimedio: i blocchi vengono generati dalla sorgente del testo, e ciò che non viene generato si elimina.

Cosa consegnate concretamente?

La tabella di inventario con ogni indirizzo, ogni blocco, i tipi e i byte. I blocchi implementati, generati dalla sorgente del contenuto. Il verdetto dello strumento di validazione per ogni tipo di pagina. Lo script di verifica eseguito dopo la pubblicazione. E l’elenco delle lacune rimaste, scritto come lacune — su questo sito, per esempio, il nodo dell’organizzazione senza collegamenti ai profili, la pagina delle domande assente dalla sitemap, e un percorso di immagine di condivisione dichiarato nei metadati che non esiste nel codice.

Su cosa si basano le affermazioni sopra (13 fonti)
  1. La documentazione di Google scrive che il rich result per le domande frequenti viene mostrato solo per siti governativi e sanitari ben noti e autorevoli, restrizione annunciata a settembre 2023https://developers.google.com/search/docs/appearance/structured-data/faqpage · 2026-09-06
  2. La mappa del sito ha 147 indirizzihttps://www.megapromoting.com/sitemap.xml · 2026-09-06

11 di esse sono codice e file dei nostri repository. Non ne pubblichiamo il nome né la riga: insieme, in un'unica pagina, descriverebbero con troppa precisione come sono costruiti sistemi che non sono solo nostri. Le esaminiamo con te, nel repository, su richiesta — la verifica resta possibile, solo che avviene in una discussione.

Cosa vorresti che funzionasse meglio?

Raccontaci il tuo processo. Insieme stabiliamo cosa vale la pena costruire, cosa possiamo collegare e come verifichiamo il risultato.

Parliamone