Quando nel corpo di una pagina web vengono incluse le informazioni di una recensione tramite linguaggio di markup, Google è in grado di identificarle e di utilizzarle per comprendere e presentare le informazioni nelle tue pagine. I dati delle recensioni, come valutazioni e descrizioni, possono aiutare gli utenti a identificare meglio le pagine con contenuti validi. Ulteriori informazioni sui rich snippet per la ricerca locale.
Linee guida sull'utilizzo
Lo scopo di un rich snippet di recensione è fornire agli utenti informazioni aggiuntive su un prodotto o servizio specifico, come la classificazione a stelle (da 1 a 5 stelle) e il nome del recensore o dei recensori.
Per gli snippet delle recensioni valgono le seguenti linee guida:
- Quando utilizzi il markup per le recensioni, l'argomento principale della pagina deve riguardare un prodotto o servizio specifico. Ad esempio, l'utilizzo del markup delle recensioni in una pagina contenente più prodotti non è supportato.
- La recensione di prodotti o servizi per adulti non è supportata.
- Se il markup contiene una singola recensione, il nome del recensore deve essere un nome valido (persona oppure organizzazione). Ad esempio, "50% di sconto fino a sabato" non è un nome valido per un recensore.
Puoi eseguire il markup di singole recensioni (ad esempio la recensione di un prodotto aggiunta da un editor) o dei dati aggregati di più recensioni (ad esempio il voto medio attribuito a un'attività commerciale locale o il numero totale di recensioni utente inviate).
Utilizza il formato destinato alle recensioni singole per le pagine contenenti una sola recensione. Per le pagine contenenti un insieme di recensioni, utilizza il formato Review-aggregate. Se la tua pagina contiene entrambi i tipi (ad esempio la recensione di un editor più un insieme di recensioni degli utenti), consigliamo di scegliere un solo formato. Utilizza il formato destinato alle recensioni singole per il markup della recensione dell'editor OPPURE il formato Review-aggregate per riepilogare l'insieme di recensioni degli utenti. Se una pagina contiene entrambi i tipi di markup, Google utilizzerà il markup Review-aggregate per la visualizzazione.
Nota. Esistono molti modi per indicare i voti delle recensioni (ad esempio stelle, percentuali e varie scale di voto). Ulteriori informazioni su come esprimere i voti delle recensioni.
Recensioni singole
Proprietà
Una recensione può contenere varie proprietà a cui è possibile assegnare etichette utilizzando lo standard di markup dei microdati, dei microformati o RDFa. Google riconosce le seguenti proprietà delle recensioni, derivanti dal microformato hReview. In generale, puoi utilizzare gli stessi nomi delle proprietà per microdati, microformati e RDFa; quando i nomi delle proprietà dei microdati/RDFa e dei microformati sono diversi, il nome della proprietà utilizzato dai microformati è visualizzato tra parentesi. Le proprietà in grassetto sono obbligatorie. Inoltre, deve essere presente almeno uno dei seguenti elementi: rating o dtrviewed.
| Proprietà | Descrizione |
itemreviewed (item) |
L'elemento recensito. Nei microformati può includere il nome dell'elemento recensito (fn). |
rating |
Un voto numerico attribuito alla qualità dell'elemento (ad esempio 4). Puoi indicare una scala di voti specificando best (predefinito: 5) e worst (predefinito: 1). Ulteriori informazioni sui voti delle recensioni. |
reviewer |
L'autore della recensione. |
dtreviewed |
La data in cui l'elemento è stato recensito nel formato di data ISO. |
description |
Il corpo della recensione. |
summary |
Un breve riepilogo della recensione. |
Il seguente codice HTML contiene una recensione per la pizzeria L'Amourita.
<div> Pizzeria L'Amourita Recensita da Ulisse Grandi il 6 gennaio. Pizza deliziosa e saporita sulla riviera ligure! L'Amourita serve pizze napoletane tradizionali cotte in forno a legna, con un servizio rapido e in un ambiente tranquillo. Il tipico ristorante sotto casa dove gustare un'ottima pizza. Voto: 4,5 </div>
Le seguenti sezioni descrivono come eseguire il markup di questi contenuti utilizzando i microdati, i microformati o RDFa.
- Per verificare la correttezza del markup e visualizzare in anteprima l'aspetto dei tuoi contenuti nei risultati di ricerca, utilizza lo strumento di test per i dati strutturati.
- Se i rich snippet non vengono visualizzati per il tuo sito, scopri le possibili cause.
Di seguito viene presentato lo stesso codice HTML sottoposto a markup con i microdati:
<div>
<div itemscope itemtype="http://data-vocabulary.org/Review">
<span itemprop="itemreviewed">Pizzeria L'Amourita</span>
Recensita da <span itemprop="reviewer">Ulisse Grandi</span> il
<time itemprop="dtreviewed" datetime="2009-01-06">6 gennaio</time>.
<span itemprop="summary">Pizza deliziosa e saporita sulla riviera ligure!</span>
<span itemprop="description">L'Amourita serve pizze napoletane tradizionali cotte in forno a legna,
con un servizio rapido e in un ambiente tranquillo. Il tipico ristorante sotto casa dove gustare un'ottima pizza.</span>
Voto: <span itemprop="rating">4,5</span>
</div>
</div>
Ecco come funziona questo codice di esempio:
- Nella prima riga,
<itemscope itemtype="http://data-vocabulary.org/Review">indica che il codice HTML racchiuso tra tag<div>rappresenta una recensione.itemscopeindica che i contenuti del tag<div>descrivono un elemento eitemtype="http://data-vocabulary.org/Review"indica che l'elemento è una recensione. - Il codice di esempio descrive le proprietà della recensione, come l'oggetto, l'autore e la data della recensione. Per assegnare un'etichetta alle proprietà della recensione, a ogni elemento contenente una di queste proprietà (come
<div>o<span>) viene assegnato un attributoitempropche indica una proprietà. Ad esempio<span itemprop="reviewer">.
Di seguito vengono presentati gli stessi contenuti HTML sottoposti a markup con il microformato hReview.
<div class="hreview">
<span class="item">
<span class="fn">Pizzeria L'Amourita</span>
</span>
Recensita da <span class="reviewer">Ulisse Grandi</span> il
<span class="dtreviewed">
6 gennaio<span class="value-title" title="2009-01-06"></span>
</span>.
<span class="summary">Pizza deliziosa e saporita sulla riviera ligure!</span>
<span class="description">L'Amourita serve pizze napoletane tradizionali
cotte in forno a legna, con un servizio rapido e in un ambiente tranquillo.
Il tipico ristorante sotto casa dove gustare un'ottima pizza.</span>
Valutazione:
<span class="rating">4,5</span>
</div>
Ecco come funziona questo codice di esempio.
- Nella prima riga,
class="hreview"indica che il codice HTML racchiuso tra i tag<div>descrive una recensione. - I dati strutturati sono espressi dall'attributo
class(comeclass="rating"eclass="reviewer"e dai valori (come4,5,Ulisse Grandi). Puoi cambiare i tag qualispanedivper adattarli alle tue esigenze di formattazione. - Le proprietà possono contenere altre proprietà. Nell'esempio precedente, la proprietà
itemdescrive l'oggetto della recensione e include la sottoproprietàfn(name).
Testo non visibile
Consigliamo di fornire le informazioni sulle date nel formato di data ISO. Ciò garantisce che le informazioni vengano visualizzate correttamente nei risultati di ricerca. Puoi fornire queste informazioni, pur continuando a visualizzare nella pagina stessa una data leggibile dalle persone, grazie al value class pattern dei microformati.
Considera questo snippet estratto dal precedente codice HTML di esempio:
<span class="dtreviewed">
6 gennaio<span class="value-title" title="2009-01-06" />
</span>.
Includendo queste informazioni sulla data nel blocco con l'etichetta class="dtreviewed", indichi che l'analizzatore sintattico di rich snippet deve utilizzare il valore nell'attributo title per trovare la data in cui è stata scritta la recensione.
Entità nidificate
Nella tua recensione, potrebbe essere necessario utilizzare il formato destinato alle persone per fornire informazioni sull'autore della recensione oppure utilizzare il formato destinato alle organizzazioni per descrivere un'azienda recensita. In questo caso, puoi nidificare l'entità persona o azienda nella tua entità recensione. Ulteriori informazioni sulle entità nidificate.
Di seguito vengono presentati gli stessi contenuti HTML sottoposti a markup con RDFa.
<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review">
<span property="v:itemreviewed">Pizzeria L'Amourita</span>
Recensita da
<span property="v:reviewer">Ulisse Grandi</span> il
<span property="v:dtreviewed" content="2009-01-06">6 gennaio</span>.
<span property="v:summary">Pizza deliziosa e saporita sulla riviera ligure!</span>
<span property="v:description">L'Amourita serve pizze napoletane tradizionali
cotte in forno a legna, con un servizio rapido e in un ambiente tranquillo.
Il tipico ristorante sotto casa dove gustare un'ottima pizza.</span>
Valutazione:
<span property="v:rating">4,5</span>
</div>
Ecco come funziona questo codice di esempio.
- L'esempio inizia con una dichiarazione dello spazio dei nomi che utilizza
xmlns. Ciò indica lo spazio dei nomi in cui è specificato il vocabolario (un elenco di entità e i relativi componenti). Puoi utilizzare la dichiarazione dello spazio dei nomixmlns:v="http://rdf.data-vocabulary.org/#"ogni volta che esegui il markup di pagine per dati di persone, recensioni o luoghi. Assicurati di utilizzare una barra finale e # (xmlns:v="http://rdf.data-vocabulary.org/#"). - Sempre nella prima riga,
typeof="v:Review"indica che i contenuti sottoposti a markup sono una recensione. - Ogni proprietà della recensione (come l'oggetto e l'autore della recensione) è associata all'etichetta
property. Il nome della proprietà è preceduto dal prefissov: (<span property="v:rating">).
Testo non visibile
Consigliamo di fornire le informazioni sulle date nel formato di data ISO. Ciò garantisce che le informazioni vengano visualizzate correttamente nei risultati di ricerca. Puoi fornire queste informazioni, pur continuando a visualizzare nella pagina stessa una data leggibile dalle persone, grazie all'attributo "content".
Considera questo snippet estratto dal precedente codice HTML di esempio:
<span property="v:dtreviewed" content="2009-01-06">6 gennaio</span>
Includendo queste informazioni sulla data nell'attributo content, indichi che l'analizzatore sintattico di rich snippet deve utilizzare questo valore per trovare la data in cui è stata scritta la recensione.
Entità nidificate
Nella tua recensione, potrebbe essere necessario utilizzare il formato destinato alle persone per fornire informazioni sull'autore della recensione oppure utilizzare il formato destinato alle organizzazioni per descrivere un'azienda recensita. In questo caso, puoi nidificare l'entità persona o azienda nella tua entità recensione. Ulteriori informazioni sulle entità nidificate.
Recensioni aggregate
Google riconosce anche il markup relativo alle recensioni aggregate. Ad esempio, un ristorante potrebbe avere 24 recensioni, con un voto medio pari a 9 su 10. L'aggregazione delle recensioni ti permette di comunicare queste informazioni.
Proprietà
Google riconosce le seguenti proprietà delle recensioni aggregate, derivanti dal microformato hReview-aggregate. In generale, puoi utilizzare gli stessi nomi delle proprietà per microdati, microformati e RDFa; quando i nomi delle proprietà dei microdati/RDFa e dei microformati sono diversi, il nome della proprietà utilizzato dai microformati è visualizzato tra parentesi. Le proprietà in grassetto sono obbligatorie. Ogni elemento deve contenere almeno count o votes.
Proprietà |
Descrizione |
itemreviewed(item) |
L'elemento recensito. Nei microformati può includere il nome dell'elemento recensito (fn). |
rating |
Un voto numerico attribuito alla qualità dell'elemento (ad esempio 4). Puoi indicare una scala di voti specificando best (predefinito: 5) e worst (predefinito: 1). Ulteriori informazioni sui voti delle recensioni. |
count |
Il numero totale di recensioni per l'elemento sul tuo sito. Nota. Se includi count, la pagina deve contenere anche il markup delle recensioni per ogni elemento recensito. count deve includere solo le recensioni sul tuo sito. |
votes |
Specifica il numero di persone che hanno fornito un voto con o senza una recensione di accompagnamento. Una pagina deve contenere almeno uno dei seguenti elementi: count o votes. |
summary |
Un breve riepilogo dell'insieme di recensioni in corso di aggregazione. |
photo |
La foto o l'immagine dell'elemento recensito. |
Il seguente codice rappresenta una recensione aggregata della pizzeria L'Amourita.
<div> Pizzeria L'Amourita 9 su 10, basata su 24 voti. Recensioni di 5 utenti. </div>
Le sezioni successive spiegano come eseguire il markup di questi contenuti utilizzando i microdati, i microformati o RDFa.
MicrodatiDi seguito viene presentato lo stesso codice HTML sottoposto a markup con i microdati.
<div itemscope itemtype="http://data-vocabulary.org/Review-aggregate">
<span itemprop="itemreviewed">Pizzeria L'Amourita</span>
<img itemprop="photo" src="pizza.jpg" />
<span itemprop="rating" itemscope itemtype="http://data-vocabulary.org/Rating">
<span itemprop="average">9</span>
su <span itemprop="best">10</span>
</span>
basata su <span itemprop="votes">24</span> voti. Recensioni di
<span itemprop="count">5</span> utenti.
</div>
Ecco come funziona questo codice di esempio:
- Nella prima riga,
<itemscope itemtype="http://data-vocabulary.org/Review-aggregate">indica che il codice HTML racchiuso tra tag<div>rappresenta una recensione aggregata.itemscopeindica che i contenuti del tag<div>descrivono un elemento eitemtype="http://data-vocabulary.org/Review"indica che l'elemento è una recensione. - Il codice di esempio descrive le proprietà della recensione aggregata, come l'oggetto e il voto della recensione. Per assegnare un'etichetta alle proprietà della recensione aggregata, a ogni elemento contenente una di queste proprietà (come
<div>o<span>) viene assegnato un attributoitempropche indica una proprietà. Ad esempio<span itemprop="itemreviewed">. - Una proprietà può essere formata da un altro elemento (in altre parole, un elemento può includere altri elementi). Ad esempio, la recensione precedente include un voto (
itemtype="http://data-vocabulary.org/Rating") con le proprietàaverage,bestecount. Ulteriori informazioni sui voti delle recensioni.
Di seguito vengono presentati gli stessi contenuti HTML sottoposti a markup con il microformato hReview-aggregate.
<div class="hreview-aggregate">
<span class="item">
<span class="fn">Pizzeria L'Amourita</span>
<img src="pizza.jpg" class="photo" />
</span>
<span class="rating">
<span class="average">9</span> su
<span class="best">10</span>
</span>
basata su
<span class="votes">24</span> voti. Recensioni di
<span class="count">5</span> utenti.
</div>
Ecco come funziona questo codice di esempio:
- Nella prima riga,
class="hreview-aggregate"indica che il codice HTML racchiuso tra i tag<div>riepiloga le recensioni in una pagina. - I dati strutturati sono espressi dall'attributo
class(comeclass="fn"eclass="rating"e dai valori (comePizzeria L'Amourita,9). Puoi cambiare i tag qualispanedivper adattarli alle tue esigenze di formattazione. - Le proprietà possono contenere altre proprietà. Nell'esempio precedente, la proprietà
ratinginclude le sottoproprietàaverage(il voto medio) ebest(il voto più alto possibile) e la proprietàitemcontienefn. Ulteriori informazioni sulle entità nidificate. votesè utile ogni volta che gli utenti su un sito di recensioni possono votare un elemento senza scrivere recensioni corrispondenti complete. Il loro voto contribuisce al voto medio ma non al numero di recensioni disponibili.
Di seguito vengono presentati gli stessi contenuti HTML sottoposti a markup con RDFa.
<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review-aggregate">
<span property="v:itemreviewed">Pizzeria L'Amourita</span>
<img src="pizza.jpg" rel="v:photo" />
<span rel="v:rating">
<span typeof="v:Rating">
<span property="v:average">9</span>
su
<span property="v:best">10</span>
</span>
</span>
basato su
<span property="v:votes">24</span> voti. Recensioni di
<span property="v:count">5</span> utenti.
</div>
Ecco come funziona questo codice di esempio:
- L'esempio inizia con una dichiarazione dello spazio dei nomi che utilizza
xmlns. Ciò indica lo spazio dei nomi in cui è specificato il vocabolario (un elenco di entità e i relativi componenti). Puoi utilizzare la dichiarazione dello spazio dei nomixmlns:v="http://rdf.data-vocabulary.org/# namespace"ogni volta che esegui il markup di pagine per dati di persone, recensioni o luoghi. Assicurati di utilizzare una barra finale e # (xmlns:v="http://rdf.data-vocabulary.org/#"). - Sempre nella prima riga,
typeof="v:Review-aggregate"indica che i contenuti sottoposti a markup riepilogano le recensioni in una pagina. - Ogni proprietà della recensione (come l'oggetto della recensione e il numero di voti) è associata all'etichetta
property. Il nome della proprietà è preceduto dal prefissov: (<span property="v:itemreviewed">). - Vogliamo includere il voto della recensione (
typeof=v:Rating") nell'entitàtypeof="v:Review-aggregate". Qui, utilizziamorelal posto dipropertyper indicare una relazione tra la recensione aggregata (l'entitàv:Review-aggregate) e questo voto (l'entitàv:Rating). Quindi includiamo<span typeof="v:Rating"></div>per includere l'effettiva entità voto. Ulteriori informazioni sulle entità nidificate. votesè utile ogni volta che gli utenti su un sito di recensioni possono votare un elemento senza scrivere recensioni corrispondenti complete. Il loro voto contribuisce al voto medio ma non al numero di recensioni disponibili.
