Dati strutturati per snippet recensione (Review, AggregateRating)

Uno snippet recensione è un breve estratto di una recensione o valutazione proveniente da un sito web di recensioni, in genere una media dei punteggi di valutazione combinati di molti recensori. Quando Google trova markup di valutazioni o recensioni valide, potrebbe mostrare un rich snippet che include stelle e altre informazioni di riepilogo provenienti da recensioni o valutazioni. Oltre al testo della recensione, una valutazione è una classificazione espressa secondo una scala numerica (ad esempio, da 1 a 5). Gli snippet recensione potrebbero essere visualizzati nei risultati avanzati o nelle schede informative di Google. Puoi fornire valutazioni per i seguenti tipi (e sottotipi) di contenuti:

Snippet recensione sulla Ricerca Google

Google supporta anche le recensioni per i seguenti tipi di schema.org (e per i relativi sottotipi):

How to add structured data

Structured data is a standardized format for providing information about a page and classifying the page content. If you're new to structured data, you can learn more about how structured data works.

Here's an overview of how to build, test, and release structured data.

  1. Add the required properties. Based on the format you're using, learn where to insert structured data on the page.
  2. Follow the guidelines.
  3. Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).
  4. Deploy a few pages that include your structured data and use the URL Inspection tool to test how Google sees the page. Be sure that your page is accessible to Google and not blocked by a robots.txt file, the noindex tag, or login requirements. If the page looks okay, you can ask Google to recrawl your URLs.
  5. To keep Google informed of future changes, we recommend that you submit a sitemap. You can automate this with the Search Console Sitemap API.

Esempi

Esistono diversi modi in cui puoi aggiungere dati strutturati Review a una pagina:

  • Aggiungere una recensione semplice.
  • Nidificare una recensione in un altro tipo schema.org utilizzando la relativa proprietà review.
  • Aggiungere valutazioni complessive. Puoi omettere la valutazione di una singola recensione se i tuoi contenuti sottoposti a markup contengono sia un autore sia una data di recensione. Per le recensioni complessive, devi specificare la valutazione media, affinché i rich snippet vengano visualizzati.
  • Nidificare le valutazioni complessive in un altro tipo schema.org utilizzando la relativa proprietà aggregateRating.

Recensione semplice

Ecco un esempio di recensione semplice.

JSON-LD


<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "priceRange": "$$$",
        "telephone": "1234567",
        "address" :{
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "4"
      },
      "author": {
        "@type": "Person",
        "name": "Bob Smith"
      },
      "publisher": {
        "@type": "Organization",
        "name": "Washington Times"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Review">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="priceRange">$$$</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="reviewRating" typeof="Rating">
        <span property="ratingValue">4</span>
      </span> stars -
      <b>"A good seafood place." </b>
      <span property="author" typeof="Person">
        <span property="name">Bob Smith</span>
      </span>
      <div property="publisher" typeof="Organization">
        <meta property="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Microdati


 <html>
  <head>
  <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Review">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="priceRange">$$$</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
        <span itemprop="ratingValue">4</span>
      </span> stars -
      <b>"A good seafood place." </b>
      <span itemprop="author" itemscope itemtype="https://schema.org/Person">
        <span itemprop="name">Bob Smith</span>
      </span>
      <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Recensione nidificata

Ecco un esempio di recensione nidificata in Product. Puoi copiare e incollare l'esempio nella tua pagina HTML.

JSON-LD


<html>
  <head>
    <title>The Catcher in the Rye</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Product",
      "brand": {
        "@type": "Brand",
        "name": "Penguin Books"
      },
      "description": "The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind.",
      "sku": "9780241984758",
      "mpn": "925872",
      "image": "https://www.example.com/catcher-in-the-rye-book-cover.jpg",
      "name": "The Catcher in the Rye",
      "review": [{
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "5"
        },
        "author": {
          "@type": "Person",
          "name": "John Doe"
        }
       },
      {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "1"
        },
        "author": {
          "@type": "Person",
          "name": "Jane Doe"
        }
      }],
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "88",
        "bestRating": "100",
        "ratingCount": "20"
      },
      "offers": {
        "@type": "Offer",
        "url": "https://example.com/offers/catcher-in-the-rye",
        "priceCurrency": "USD",
        "price": "5.99",
        "priceValidUntil": "2024-11-05",
        "itemCondition": "https://schema.org/UsedCondition",
        "availability": "https://schema.org/InStock",
        "seller": {
          "@type": "Organization",
          "name": "eBay"
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
    <body>
      <div vocab="https://schema.org/" typeof="Product">
        <div rel="schema:brand">
          <div typeof="schema:Brand">
            <div property="schema:name" content="Penguin"></div>
          </div>
        </div>
        <div property="schema:description" content="The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind."></div>
        <div property="schema:sku" content="9780241984758"></div>
        <div property="schema:mpn" content="925872"></div>
        <img property="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
        <span property="name">The Catcher in the Rye</span>
        <div property="review" typeof="Review"> Reviews:
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">5</span> -
          </span>
          <b>"A masterpiece of literature" </b> by
          <span property="author" typeof="Person">
            <span property="name">John Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-04">4 May 2006
          <div>I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div>
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div><div property="review" typeof="Review">
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">1</span> -
          </span>
          <b>"The worst thing I've ever read" </b> by
          <span property="author" typeof="Person">
            <span property="name">Jane Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-10">10 May 2006
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div>
        <div rel="schema:aggregateRating">
          <div typeof="schema:AggregateRating">
            <div property="schema:reviewCount" content="89"></div>
            <div property="schema:ratingValue" content="4.4">4,4</div> stars
          </div>
        </div>
        <div rel="schema:offers">
          <div typeof="schema:Offer">
            <div property="schema:price" content="4.99"></div>
            <div property="schema:availability" content="https://schema.org/InStock"></div>
            <div property="schema:priceCurrency" content="GBP"></div>
            <div property="schema:priceValidUntil" datatype="xsd:date" content="2024-11-21"></div>
            <div rel="schema:url" resource="https://example.com/catcher"></div>
            <div property="schema:itemCondition" content="https://schema.org/UsedCondition"></div>
          </div>
        </div>
    </div>
  </body>
</html>

Microdati


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="Penguin" />
      </div>
      <meta itemprop="description" content="The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind." />
      <meta itemprop="sku" content="0446310786" />
      <meta itemprop="mpn" content="925872" />
      <img itemprop="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/>
      <span itemprop="name">The Catcher in the Rye</span>
      <div itemprop="review" itemscope itemtype="https://schema.org/Review"> Reviews:
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
          <span itemprop="ratingValue">5</span> -
        </span>
        <b>"A masterpiece of literature" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">John Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-04">4 May 2006
        <div>I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div>
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div><div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span> -
        </span>
        <b>"The worst thing I've ever read" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">Jane Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-10">10 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
          <meta itemprop="name" content="Washington Times">
        </span>
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <span itemprop="ratingValue" content="4.4">4,4</span> stars
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://example.com/catcher" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="priceCurrency" content="GBP" />
        <meta itemprop="itemCondition" content="https://schema.org/UsedCondition" />
        <meta itemprop="price" content="4.99" />
        <meta itemprop="priceValidUntil" content="2024-11-21" />
      </div>
    </div>
  </body>
</html>

Valutazione complessiva

Ecco un esempio di valutazione complessiva.

JSON-LD


<html>
  <head>
    <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "AggregateRating",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://www.example.com/seafood-restaurant.jpg",
        "name": "Legal Seafood",
        "servesCuisine": "Seafood",
        "telephone": "1234567",
        "address" : {
          "@type": "PostalAddress",
          "streetAddress": "123 William St",
          "addressLocality": "New York",
          "addressRegion": "NY",
          "postalCode": "10038",
          "addressCountry": "US"
        }
      },
      "ratingValue": "88",
      "bestRating": "100",
      "ratingCount": "20"
    }
    </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="AggregateRating">
      <div property="itemReviewed" typeof="Restaurant">
        <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span property="name">Legal Seafood</span>
        <span property="servesCuisine">Seafood</span>
        <span property="telephone">1234567</span>
        <span property="address">123 William St, New York</span>
      </div>
      <span property="ratingValue">4.2</span> out of <span property="bestRating">5</span> stars -
      <span property="ratingCount">123</span> votes
    </div>
  </body>
</html>

Microdati


 <html>
  <head>
    <title>Legal Seafood</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/AggregateRating">
      <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
        <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/>
        <span itemprop="name">Legal Seafood</span>
        <span itemprop="servesCuisine">Seafood</span>
        <span itemprop="telephone">1234567</span>
        <span itemprop="address">123 William St, New York</span>
      </div>
      <span itemprop="ratingValue">4.2</span> out of <span itemprop="bestRating">5</span> stars -
      <span itemprop="ratingCount">123</span> votes
    </div>
  </body>
</html>

Valutazione complessiva nidificata

Ecco un esempio di valutazione complessiva nidificata in Product. Puoi copiare e incollare l'esempio nella tua pagina HTML.

JSON-LD


<html>
  <head>
  <title>Executive Anvil</title>
  <script type="application/ld+json">
  {
    "@context": "https://schema.org/",
    "@type": "Product",
    "name": "Executive Anvil",
    "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
     ],
    "brand": {
      "@type": "Brand",
      "name": "ACME"
    },
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": "4.4",
      "ratingCount": "89"
    },
    "offers": {
      "@type": "AggregateOffer",
      "lowPrice": "119.99",
      "highPrice": "199.99",
      "priceCurrency": "USD"
    }
  }
  </script>
  </head>
  <body>
  </body>
</html>

RDFa


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div vocab="https://schema.org/" typeof="Product">
     <span property="brand" typeof="Brand">ACME</span> <span property="name">Executive Anvil</span>
     <img property="image" src="https://example.com/photos/1x1/anvil_executive.jpg" alt="Executive Anvil logo" />
     <span property="aggregateRating"
           typeof="AggregateRating">
      Average rating: <span property="ratingValue">4.4</span>, based on
      <span property="ratingCount">89</span> reviews
     </span>
     <span property="offers" typeof="AggregateOffer">
      from $<span property="lowPrice">119.99</span> to
      $<span property="highPrice">199.99</span>
      <meta property="priceCurrency" content="USD" />
     </span>
    </div>
  </body>
</html>

Microdati


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <span itemprop="brand" itemtype="https://schema.org/Brand" itemscope>ACME</span> <span itemprop="name">Executive Anvil</span>
      <img itemprop="image" src="https://example.com/photos/1x1/anvil_executive.jpg" />
      <span itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating">
        Average rating: <span itemprop="ratingValue">4.4</span>, based on
        <span itemprop="ratingCount">89</span> reviews
      </span>
      <span itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer">
        from $<span itemprop="lowPrice">119.99</span> to
        $<span itemprop="highPrice">199.99</span>
        <meta itemprop="priceCurrency" content="USD" />
      </span>
    </div>
  </body>
</html>

Linee guida

I tuoi contenuti devono seguire le presenti linee guida per poter comparire come risultato avanzato.

Linee guida tecniche

  • Assicurati di eseguire il markup di una valutazione complessiva di un elemento da parte di molte persone con schema.org/AggregateRating. Google potrebbe mostrare le valutazioni complessive sotto forma di rich snippet o, per determinati tipi di elementi, di risposte nei risultati di ricerca.
  • Fai chiaramente riferimento a un prodotto o servizio specifico nidificando la recensione all'interno del markup di un altro tipo schema.org, come schema.org/Book o schema.org/Recipe oppure usando un tipo schema.org come valore per la proprietà itemReviewed.
  • Assicurati che le recensioni e le valutazioni di cui esegui il markup siano prontamente disponibili per gli utenti dalla pagina con markup. Deve essere subito evidente agli utenti che nella pagina sono presenti contenuti relativi a recensioni.
  • Fornisci informazioni di recensione su un elemento specifico, non su una categoria o un elenco di elementi.
  • Se includi più recensioni singole, includi anche una valutazione complessiva delle singole recensioni.
  • Non aggregare recensioni o valutazioni provenienti da altri siti web.
  • Se lo snippet recensione riguarda un'attività locale o un'organizzazione, devi attenerti alle seguenti linee guida aggiuntive:
    • Se l'entità che viene recensita controlla le recensioni su se stessa, le sue pagine che utilizzano LocalBusiness o qualsiasi altro tipo di dati strutturati Organization non sono idonee per la funzionalità di recensione basata su stelle. Ad esempio, una recensione sull'entità A viene pubblicata sul sito web dell'entità A, direttamente nei dati strutturati o tramite un widget di terze parti incorporato (ad esempio recensioni di attività commerciali di Google o widget di recensioni di Facebook).
    • Le valutazioni devono provenire direttamente dagli utenti.
    • Non fare affidamento su editori umani per creare, curare o compilare informazioni relative alle valutazioni per le attività locali.

Definizioni dei tipi di dati strutturati

Affinché i tuoi dati strutturati vengano visualizzati nei risultati di ricerca, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni ai dati strutturati, fornendo un'esperienza utente migliore.

Review

La definizione completa di Review è disponibile all'indirizzo schema.org/Review.

Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
author

Person oppure Organization

L'autore della recensione. Il nome del recensore deve essere un nome valido. Ad esempio, "50% di sconto fino a sabato" non è un nome valido.

Questo campo deve contenere meno di 100 caratteri. Se è più lungo, la pagina non sarà idonea per uno snippet recensione basato sull'autore.

Per aiutare Google a comprendere meglio gli autori in varie funzionalità, ti consigliamo di seguire le best practice per il markup degli autori.

itemReviewed

Uno dei tipi validi

L'elemento che viene recensito. Tuttavia, se la recensione viene nidificata in un altro tipo schema.org usando la proprietà review, puoi omettere la proprietà itemReviewed.

I tipi validi per l'elemento recensito sono:
itemReviewed.name

Text

Il nome dell'elemento che viene recensito. Se la recensione viene nidificata in un altro tipo schema.org usando la proprietà review, devi comunque fornire il valore name dell'elemento che viene recensito. Ad esempio:


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5"
    },
    "author": {
      "@type": "Person",
      "name": "John Doe"
    }
  }
}
reviewRating

Rating

La valutazione attribuita in questa recensione. La valutazione può essere un tipo Rating nidificato o un sottotipo più specifico. Il sottotipo più comunemente utilizzato è AggregateRating.
reviewRating.ratingValue

Number oppure Text

Una valutazione numerica della qualità dell'elemento, che può essere un numero, una frazione o una percentuale (ad esempio 4, 60% o 6 / 10). Google comprende la scala per frazioni e percentuali, poiché la scala è implicita nella frazione stessa o nella percentuale. Per i numeri viene utilizzata una scala predefinita da 1 a 5, dove 1 è il valore più basso e 5 il valore più alto. Se è prevista un'altra scala, usa bestRating e worstRating.

Per i numeri decimali, utilizza un punto invece di una virgola per specificare il valore (ad esempio 4.4 anziché 4,4). Nei microdati e in RDFa, puoi utilizzare gli attributi content per eseguire l'override dei contenuti visibili. In questo modo, puoi mostrare all'utente la convenzione di stile che preferisci, soddisfacendo al contempo il requisito del punto per i dati strutturati. Ad esempio:


<span itemprop="ratingValue" content="4.4">4,4</span> stars
Proprietà consigliate
datePublished

Date

La data di pubblicazione della recensione, in formato data ISO 8601.

reviewRating.bestRating

Number

Il valore massimo consentito in questo sistema di valutazione. Se bestRating viene omesso, viene usato il valore 5.
reviewRating.worstRating

Number

Il valore minimo consentito in questo sistema di valutazione. Se worstRating viene omesso, viene usato il valore 1.

AggregateRating

La definizione completa di AggregateRating è disponibile all'indirizzo schema.org/AggregateRating.

Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie
itemReviewed

Uno dei tipi validi

L'elemento che viene valutato. Tuttavia, se la valutazione complessiva viene nidificata in un altro tipo schema.org usando la proprietà aggregateRating, puoi omettere la proprietà itemReviewed.

I tipi validi per l'elemento recensito sono:
itemReviewed.name

Text

Il nome dell'elemento che viene recensito. Se la recensione viene nidificata in un altro tipo schema.org usando la proprietà review, devi comunque fornire il valore name dell'elemento che viene recensito. Ad esempio:


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "88",
    "bestRating": "100",
    "ratingCount": "20"
  }
}
ratingCount

Number

Il numero totale di valutazioni per l'elemento sul tuo sito. È obbligatorio specificare almeno un valore per ratingCount o reviewCount.
reviewCount

Number

Specifica il numero di persone che hanno fornito una recensione con o senza una valutazione di accompagnamento. È obbligatorio specificare almeno un valore per ratingCount o reviewCount.

ratingValue

Number oppure Text

Una valutazione numerica della qualità dell'elemento, che può essere un numero, una frazione o una percentuale (ad esempio 4, 60% o 6 / 10). Google comprende la scala per frazioni e percentuali, poiché la scala è implicita nella frazione stessa o nella percentuale. Per i numeri viene utilizzata una scala predefinita da 1 a 5, dove 1 è il valore più basso e 5 il valore più alto. Se è prevista un'altra scala, usa bestRating e worstRating.

Per i numeri decimali, utilizza un punto invece di una virgola per specificare il valore (ad esempio 4.4 anziché 4,4). Nei microdati e in RDFa, puoi utilizzare gli attributi content per eseguire l'override dei contenuti visibili. In questo modo, puoi mostrare all'utente la convenzione di stile che preferisci, soddisfacendo al contempo il requisito del punto per i dati strutturati. Ad esempio:


<span itemprop="ratingValue" content="4.4">4,4</span> stars
Proprietà consigliate
bestRating

Number

Il valore massimo consentito in questo sistema di valutazione. Se bestRating viene omesso, viene usato il valore 5.

worstRating

Number

Il valore minimo consentito in questo sistema di valutazione. Se worstRating viene omesso, viene usato il valore 1.

Monitorare i risultati avanzati con Search Console

Search Console è uno strumento che consente di monitorare il rendimento delle tue pagine in Ricerca Google. Registrarsi in Search Console non è obbligatorio per essere inclusi nei risultati di Ricerca Google, ma può aiutarti a capire e migliorare il modo in cui Google vede il tuo sito. Ti consigliamo di controllare Search Console nei seguenti casi:

  1. Dopo aver effettuato il deployment dei dati strutturati per la prima volta
  2. Dopo aver rilasciato nuovi modelli o aggiornato il codice
  3. Analisi periodica del traffico

Dopo aver effettuato il deployment dei dati strutturati per la prima volta

Dopo che Google ha indicizzato le tue pagine, cerca i problemi utilizzando il report sullo stato dei risultati avanzati pertinente. L'ideale sarebbe un aumento degli elementi validi e nessun aumento di quelli non validi. Se riscontri problemi nei dati strutturati:

  1. Correggi gli elementi non validi.
  2. Controlla un URL pubblicato per verificare se il problema persiste.
  3. Richiedi la convalida utilizzando il report sullo stato.

Dopo aver rilasciato nuovi modelli o aggiornato il codice

Quando apporti modifiche significative al tuo sito web, monitora l'aumento degli elementi non validi dei dati strutturati.
  • Se vedi un aumento di errori, forse hai reso disponibile un nuovo modello non funzionante oppure il tuo sito interagisce con il modello esistente in modo nuovo, ma non corretto.
  • Se noti una diminuzione degli elementi validi (non associata a un aumento di quelli non validi), forse non stai più incorporando dati strutturati nelle tue pagine. Utilizza lo strumento Controllo URL per scoprire la causa del problema.

Analisi periodica del traffico

Analizza il traffico di Ricerca Google utilizzando il rapporto sul rendimento. I dati mostrano la frequenza con cui la pagina viene visualizzata nei risultati multimediali nella Ricerca, la frequenza con cui gli utenti fanno clic e qual è la posizione media che visualizzi nei risultati di ricerca. Puoi anche estrarre automaticamente questi risultati con l'API Search Console.

Troubleshooting

If you're having trouble implementing or debugging structured data, here are some resources that may help you.

  • If you're using a content management system (CMS) or someone else is taking care of your site, ask them to help you. Make sure to forward any Search Console message that details the issue to them.
  • Google does not guarantee that features that consume structured data will show up in search results. For a list of common reasons why Google may not show your content in a rich result, see the General Structured Data Guidelines.
  • You might have an error in your structured data. Check the list of structured data errors and the Unparsable structured data report.
  • If you received a structured data manual action against your page, the structured data on the page will be ignored (although the page can still appear in Google Search results). To fix structured data issues, use the Manual Actions report.
  • Review the guidelines again to identify if your content isn't compliant with the guidelines. The problem can be caused by either spammy content or spammy markup usage. However, the issue may not be a syntax issue, and so the Rich Results Test won't be able to identify these issues.
  • Troubleshoot missing rich results / drop in total rich results.
  • Allow time for re-crawling and re-indexing. Remember that it may take several days after publishing a page for Google to find and crawl it. For general questions about crawling and indexing, check the Google Search crawling and indexing FAQ.
  • Post a question in the Google Search Central forum.