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, potremmo 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 le seguenti funzionalità:

Snippet recensione sulla Ricerca Google

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

如何添加结构化数据

结构化数据是一种提供网页相关信息并对网页内容进行分类的标准化格式。如果您不熟悉结构化数据，可以详细了解结构化数据的运作方式。

下面概述了如何构建、测试和发布结构化数据。如需获得向网页添加结构化数据的分步指南，请查看结构化数据 Codelab。

  1. 添加必要属性。根据您使用的格式，了解在网页上的什么位置插入结构化数据。
  2. 遵循指南。
  3. 使用富媒体搜索结果测试验证您的代码，并修复所有严重错误。此外，您还可以考虑修正该工具中可能会标记的任何非严重问题，因为这些这样有助于提升结构化数据的质量（不过，要使内容能够显示为富媒体搜索结果，并非必须这么做）。
  4. 部署一些包含您的结构化数据的网页，然后使用网址检查工具测试 Google 看到的网页样貌。请确保您的网页可供 Google 访问，不会因 robots.txt 文件、noindex 标记或登录要求而被屏蔽。如果网页看起来没有问题，您可以请求 Google 重新抓取您的网址。
  5. 为了让 Google 随时了解日后发生的更改，我们建议您提交站点地图。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 di 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 che 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 di 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 di schema.org, come schema.org/Book o schema.org/Recipe oppure usando un tipo di schema.org come valore per la proprietà itemReviewed.
  • Assicurati che i contenuti delle recensioni 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. Ad esempio, se hai eseguito il markup delle recensioni, gli utenti dovrebbero essere in grado di vedere il testo della recensione e la valutazione associata. Se utilizzi AggregateRating, gli utenti dovrebbero essere in grado di vedere la valutazione aggregata nella pagina.
  • Ti consigliamo di accettare solo valutazioni accompagnate da un commento della recensione e dal nome dell'autore. Sebbene non sia obbligatorio, questo approccio può aiutare gli utenti a visualizzare dettagli a supporto che spiegano la valutazione.
  • 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 o 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 di 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 di 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 di 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

La valutazione media della qualità dell'elemento che utilizza una valutazione numerica, sia questa un numero, una frazione o una percentuale (ad esempio 4, 60% o 6 / 10). Google comprende la scala per frazioni e percentuali, poiché è 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 relativi ai 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.

问题排查

如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。

  • 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
  • Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
  • 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
  • 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
  • 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
  • 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
  • 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
  • 在 Google 搜索中心论坛中发帖提问。