Dati strutturati per domande e risposte (QAPage)

Illustrazione di un risultato avanzato per domande e risposte

Le pagine di domande e risposte sono pagine web che contengono i dati in formato domanda e risposta, ovvero quello in cui una domanda è seguita dalle relative risposte. Per i contenuti che rappresentano una domanda e le relative risposte, puoi eseguire il markup dei dati con i tipi schema.org QAPage, Question e Answer.

Le pagine con markup corretto sono idonee a visualizzare un risultato avanzato nella pagina dei risultati di ricerca. Questi risultati avanzati aiutano il tuo sito a raggiungere gli utenti appropriati nella Ricerca. Ad esempio, potresti vedere un risultato avanzato per la query dell'utente "Come faccio a rimuovere un cavo bloccato in una porta USB?" se alla pagina è stato aggiunto il markup con risposte a questa domanda.

Oltre ad attivare i contenuti per il trattamento dei risultati avanzati, il markup della pagina di domande e risposte aiuta Google a generare uno snippet migliore per la tua pagina. Il contenuto delle risposte potrebbe apparire nel risultato di base se il risultato avanzato non viene mostrato.

Come aggiungere dati strutturati

I dati strutturati sono un formato standardizzato per fornire informazioni su una pagina e classificarne i contenuti. Se non li hai mai utilizzati, scopri di più su come funzionano i dati strutturati.

Ecco una panoramica su come creare, testare e rilasciare i dati strutturati. Per una guida passo per passo su come aggiungere dati strutturati a una pagina web, consulta il codelab sui dati strutturati.

  1. Aggiungi le proprietà obbligatorie. In base al formato che utilizzi, scopri dove inserire i dati strutturati nella pagina.
  2. Segui le linee guida.
  3. Convalida il codice utilizzando lo strumento di Test dei risultati avanzati e correggi eventuali errori critici. Prendi in considerazione anche la possibilità di correggere eventuali problemi non critici che potrebbero essere segnalati nello strumento, in quanto possono contribuire a migliorare la qualità dei tuoi dati strutturati (tuttavia, questo non è necessario per l'idoneità per i risultati avanzati).
  4. Implementa alcune pagine che includono dati strutturati e utilizza lo strumento Controllo URL per verificare come Google vede la pagina. Assicurati che la pagina sia accessibile per Google e che non venga bloccata da file robots.txt, tag noindex o requisiti di accesso. Se la pagina non presenta problemi, puoi chiedere a Google di ripetere la scansione degli URL.
  5. Per tenere Google informata delle future modifiche, ti consigliamo di inviare una Sitemap. Puoi automatizzare questa operazione con l'API Search Console Sitemap.

Esempi

Il seguente esempio di markup include le definizioni del tipo QAPage, Question e Answer nel formato JSON-LD:

JSON-LD

<html>
  <head>
    <title>How many ounces are there in a pound?</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "QAPage",
      "mainEntity": {
        "@type": "Question",
        "name": "How many ounces are there in a pound?",
        "text": "I have taken up a new interest in baking and keep running across directions in ounces and pounds. I have to translate between them and was wondering how many ounces are in a pound?",
        "answerCount": 3,
        "upvoteCount": 26,
        "datePublished": "2024-02-14T15:34-05:00",
        "author": {
          "@type": "Person",
          "name": "Mary Stone",
          "url": "https://example.com/profiles/mary-stone"
        },
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "1 pound (lb) is equal to 16 ounces (oz).",
          "image": "https://example.com/images/conversion-chart.jpg",
          "upvoteCount": 1337,
          "url": "https://example.com/question1#acceptedAnswer",
          "datePublished": "2024-02-14T16:34-05:00",
          "author": {
            "@type": "Person",
            "name": "Julius Fernandez",
            "url": "https://example.com/profiles/julius-fernandez"
          }
        },
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "text": "Are you looking for ounces or fluid ounces? If you are looking for fluid ounces there are 15.34 fluid ounces in a pound of water.",
            "upvoteCount": 42,
            "url": "https://example.com/question1#suggestedAnswer1",
            "datePublished": "2024-02-14T15:39-05:00",
            "author": {
              "@type": "Person",
              "name": "Kara Weber",
              "url": "https://example.com/profiles/kara-weber"
            },
            "comment": {
              "@type": "Comment",
              "text": "I'm looking for ounces, not fluid ounces.",
              "datePublished": "2024-02-14T15:40-05:00",
              "author": {
                "@type": "Person",
                "name": "Mary Stone",
                "url": "https://example.com/profiles/mary-stone"
              }
            }
          }, {
            "@type": "Answer",
            "text": " I can't remember exactly, but I think 18 ounces in a lb. You might want to double check that.",
            "upvoteCount": 0,
            "url": "https://example.com/question1#suggestedAnswer2",
            "datePublished": "2024-02-14T16:02-05:00",
            "author": {
              "@type": "Person",
              "name": "Joe Cobb",
              "url": "https://example.com/profiles/joe-cobb"
            }
          }
        ]
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>
Microdati

<html>
<body itemscope itemtype="https://schema.org/QAPage">
<div itemprop="mainEntity" itemscope itemtype="https://schema.org/Question">
   <h2 itemprop="name">How many ounces are there in a pound?</h2>
   <div itemprop="upvoteCount">52</div>
   <div itemprop="text">I have taken up a new interest in baking and keep running across directions in ounces and pounds. I have to translate between them and was wondering how many ounces are in a pound?</div>
<div>
    <div><span itemprop="answerCount">3</span> answers</div>
    <div><span itemprop="upvoteCount">26</span> votes</div>
    <div itemprop="acceptedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">1337</div>
       <div itemprop="text">
       1 pound (lb) is equal to 16 ounces (oz).
       </div>
      <a itemprop="url" href="https://example.com/question1#acceptedAnswer">Answer Link</a>
      </div>
    <div itemprop="suggestedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">42</div>
       <div itemprop="text">
       Are you looking for ounces or fluid ounces? If you are looking for fluid ounces there are 15.34 fluid ounces in a pound of water.
       </div>
       <a itemprop="url" href="https://example.com/question1#suggestedAnswer1">Answer Link</a>
     </div>
     <div itemprop="suggestedAnswer" itemscope itemtype="https://schema.org/Answer">
       <div itemprop="upvoteCount">0</div>
       <div itemprop="text">
       I can't remember exactly, but I think 18 ounces in a lb. You might want to double check that.
       </div>
       <a itemprop="url" href="https://example.com/question1#suggestedAnswer2">Answer Link</a>
    </div>
</div>
</div>
</body>
</html>

Linee guida

Affinché la tua pagina di domande e risposte sia idonea al trattamento dei risultati avanzati, devi seguire queste linee guida:

Linee guida relative ai contenuti

  • Utilizza il markup QAPage solo se la tua pagina contiene informazioni in formato domanda e risposta, ovvero quello in cui una domanda è seguita dalle relative risposte.
  • Gli utenti devono essere in grado di inviare risposte alla domanda. Non utilizzare il markup QAPage per i contenuti che hanno solo una risposta per una determinata domanda e che non consentono agli utenti di aggiungere risposte alternative; utilizza invece FAQPage. Ecco alcuni esempi:

    Casi d'uso validi:

    • Una pagina di forum in cui gli utenti possono inviare risposte a una singola domanda
    • Una pagina di assistenza prodotti in cui gli utenti possono inviare risposte a una singola domanda

    Casi d'uso non validi:

    • Una pagina di Domande frequenti scritta dal sito stesso, che non consente agli utenti di inviare risposte alternative
    • Una pagina di prodotto in cui gli utenti possono inviare più domande e risposte su un'unica pagina
    • Una guida illustrativa che risponde a una domanda
    • Un post del blog che risponde a una domanda
    • Un saggio che risponde a una domanda
  • Non applicare il markup QAPage a tutte le pagine di un sito o forum se non tutti i contenuti sono idonei. Ad esempio, un forum potrebbe contenere molte domande, che sono individualmente idonee per il markup. Tuttavia, se il forum contiene anche pagine che non sono domande, tali pagine non sono idonee.
  • Non utilizzare il markup QAPage per pagine delle Domande frequenti (FAQ) o pagine in cui sono presenti più domande per pagina. Il markup QAPage è per le pagine incentrate su una singola domanda e sulle sue risposte.
  • Non utilizzare il markup QAPage a scopi pubblicitari.
  • Assicurati che ogni elemento Question includa l'intero testo della domanda e che ogni elemento Answer includa l'intero testo della risposta.
  • Il markup Answer è per le risposte alla domanda, non per i commenti alla domanda o ad altre risposte. Utilizza invece la proprietà comment e il tipo Comment per questo tipo di contenuti.
  • Il contenuto di domande e risposte potrebbe non essere visualizzato come un risultato avanzato se contiene uno dei seguenti tipi di contenuto: osceno, volgare, sessualmente esplicito, esplicitamente violento, di promozione di attività pericolose o illegali o con linguaggio molesto o che incita all'odio.
  • Le pagine di domande e risposte relative all'istruzione il cui obiettivo principale è fornire risposte corrette a domande relative a compiti inviati dagli utenti, possono essere idonee per l'esperienza del carosello di domande e risposte. Queste pagine possono contenere un'unica risposta che viene fornita o selezionata da esperti interni (anziché dagli utenti).
    Esempio: una pagina didattica in cui un utente ha inviato una singola domanda e gli esperti hanno selezionato una risposta principale.

Definizioni dei tipi di dati strutturati

Questa sezione descrive i tipi di dati strutturati relativi a QAPage.

Affinché i tuoi contenuti siano idonei per essere visualizzati come risultato avanzato, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni ai dati strutturati, fornendo un'esperienza utente migliore.

Puoi utilizzare lo strumento di Test dei risultati avanzati di Google per convalidare i tuoi dati strutturati e visualizzarne l'anteprima.

QAPage

Il tipo QAPage indica che la pagina è incentrata su una domanda specifica e sulla sua risposta o le sue risposte. Useremo solo dati strutturati Question da pagine con markup QAPage. Deve esserci solo una definizione del tipo QAPage per pagina.

La definizione completa di QAPage è disponibile all'indirizzo https://schema.org/QAPage.

La tabella seguente descrive le proprietà del tipo QAPage utilizzate dalla Ricerca Google.

Proprietà obbligatorie

mainEntity

Question

L'elemento Question per questa pagina deve essere nidificato all'interno della proprietà mainEntity dell'elemento QAPage.

Question

Il tipo Question definisce la domanda a cui risponde questa pagina e include le eventuali risposte a tale domanda. È previsto un solo tipo Question nella pagina, nidificato all'interno della proprietà mainEntity di schema.org/QAPage. Deve esserci solo una definizione del tipo Question per pagina.

La definizione completa di Question è disponibile all'indirizzo https://schema.org/Question. Le proprietà supportate da Google sono le seguenti:

Proprietà obbligatorie

answerCount

Integer

Il numero totale di risposte alla domanda. Ad esempio, se ci sono 15 risposte, ma solo le prime 10 sono state sottoposte a markup a causa dell'impaginazione, questo valore sarà 15. Potrebbe anche essere 0 per le domande senza risposta.

acceptedAnswer o suggestedAnswer Answer

Affinché una domanda sia idonea per i risultati avanzati, deve avere almeno una risposta acceptedAnswer o suggestedAnswer. Tuttavia, le domande potrebbero non avere risposte appena vengono pubblicate. Per le domande senza risposte, imposta la proprietà answerCount su 0. Le domande senza risposte non sono idonee per i risultati avanzati.

acceptedAnswer

Answer

Una risposta principale alla domanda. Possono esserci zero o più di queste risposte per domanda. Questo elemento deve rappresentare le risposte che sono accettate in qualche modo sul tuo sito, ad esempio come risposta principale dalla persona che ha posto la domanda, da un moderatore o da un sistema di votazione. Per identificare le risposte principali, non devono essere utilizzate altre modalità di ordinamento delle risposte, ad esempio dalle più recenti alle meno recenti.

suggestedAnswer

Answer

Una risposta possibile, ma non accettata come risposta principale (acceptedAnswer). Possono esserci zero o più risposte di questo tipo per domanda.

name

Text

Il testo completo della forma abbreviata della domanda. Ad esempio, "Quanti cucchiaini in una tazza?".

Proprietà consigliate

author

Person o Organization

Informazioni sull'autore della domanda. Per consentire a Google di comprendere meglio gli autori in varie funzionalità, ti consigliamo di seguire le best practice per il markup degli autori.

Includi tutte le proprietà significative per l'autore, utilizzando come guida le proprietà supportate dei dati strutturati per articoli e pagine del profilo.

author.url

URL

Un link a una pagina web che identifica in modo univoco l'autore della domanda, in genere una pagina del profilo del sito web di domande e risposte. Ti consigliamo di eseguire il markup di questa pagina utilizzando i dati strutturati per pagine del profilo.

comment

Comment

Un commento relativo alla domanda, se presente. Idealmente questi contenuti non rappresentano una risposta: di solito sono un chiarimento o una discussione riguardo alla domanda.

dateModified

DateTime

La data e l'ora in cui è stata modificata la risposta, se applicabile, nel formato ISO 8601.

datePublished

DateTime

La data e l'ora in cui la domanda è stata pubblicata, nel formato ISO 8601.

image

ImageObject o URL

Eventuali immagini incorporate nella domanda, se applicabili.

text

Text

Il testo completo della forma estesa della domanda. Ad esempio, "Sto cucinando e ho bisogno di sapere a quanti cucchiaini corrisponde una tazza. Quanti cucchiaini in una tazza?".

upvoteCount

Integer

Il numero totale dei voti ricevuti dalla domanda. Se la pagina supporta voti positivi e negativi, imposta il valore upvoteCount su un singolo valore di aggregazione che rappresenta sia i voti positivi sia quelli negativi. Ad esempio, se ci sono 5 voti positivi e 2 voti negativi, il valore aggregato utilizzato per upvoteCount è 3. Se ci sono 5 voti positivi e i voti negativi non sono supportati, il valore di upvoteCount è 5.

video

VideoObject

Eventuali video incorporati nella domanda, se applicabili.

Answer

Il tipo Answer definisce le risposte suggerite e accettate per Question su questa pagina. Definisci i valori di Answers all'interno di Question come valori per le proprietà suggestedAnswer e acceptedAnswer.

La seguente tabella descrive le proprietà del tipo Answer utilizzato in Question.

La definizione completa di Answer è disponibile all'indirizzo https://schema.org/Answer.

Proprietà obbligatorie

text

Text

Il testo completo della risposta. Se solo una parte viene sottoposta a markup, i tuoi contenuti potrebbero non essere mostrati e Google non potrà determinare il testo migliore da visualizzare.

Proprietà consigliate

author

Person o Organization

Informazioni sull'autore della risposta. Per consentire a Google di comprendere meglio gli autori in varie funzionalità, ti consigliamo di seguire le best practice per il markup degli autori.

Includi tutte le proprietà significative per l'autore, utilizzando come guida le proprietà supportate dei dati strutturati per articoli e pagine del profilo.

author.url

URL

Un link a una pagina web che identifica in modo univoco l'autore della risposta, in genere una pagina del profilo del sito web di domande e risposte. Ti consigliamo di eseguire il markup di questa pagina utilizzando i dati strutturati per pagine del profilo.

comment

Comment

Un commento relativo alla risposta, di solito un chiarimento o una discussione, se applicabile.

dateModified

DateTime

La data e l'ora in cui la risposta è stata modificata, nel formato ISO 8601, se applicabile.

datePublished

DateTime

La data e l'ora in cui è stata fornita la risposta alla domanda, nel formato ISO 8601.

image

ImageObject o URL

Eventuali immagini incorporate nella domanda, se applicabili.

upvoteCount

Integer

Il numero totale di voti ricevuti da questa risposta, se applicabile. Se la pagina supporta voti positivi e negativi, imposta il valore upvoteCount su un singolo valore di aggregazione che rappresenta sia i voti positivi sia quelli negativi. Ad esempio, se ci sono 5 voti positivi e 2 voti negativi, il valore aggregato utilizzato per upvoteCount è 3. Se ci sono 5 voti positivi e i voti negativi non sono supportati, il valore di upvoteCount è 5.

url

URL

Un URL che rimanda direttamente a questa risposta. Ad esempio: https://www.examplesite.com/question#answer1

video

VideoObject o URL

Eventuali video incorporati nella risposta, se applicabili.

Comment

Il tipo Comment può essere utilizzato opzionalmente per descrivere chiarimenti o discussioni sulla domanda o sulla risposta. Definisci Comments all'interno di Question o Answer, come valori per la proprietà comment.

La definizione completa di Comment è disponibile all'indirizzo https://schema.org/Comment.

Proprietà obbligatorie

text

Text

Il testo completo del commento. Se solo una parte viene sottoposta a markup, Google potrebbe non essere in grado di determinare il testo migliore da visualizzare.

Proprietà consigliate

author

Person o Organization

Informazioni sull'autore del commento. Per consentire a Google di comprendere meglio gli autori in varie funzionalità, ti consigliamo di seguire le best practice per il markup degli autori.

Includi tutte le proprietà significative per l'autore, utilizzando come guida le proprietà supportate dei dati strutturati per articoli e pagine del profilo.

author.url

URL

Un link a una pagina web che identifica in modo univoco l'autore del commento, in genere una pagina del profilo del sito web di domande e risposte. Ti consigliamo di eseguire il markup di questa pagina utilizzando i dati strutturati per pagine del profilo.

comment

Comment

Un commento nidificato e in thread che risponde al commento, se applicabile.

dateModified

DateTime

La data e l'ora in cui il commento è stato modificato, nel formato ISO 8601, se applicabile.

datePublished

DateTime

La data e l'ora in cui il commento è stato scritto, nel formato ISO 8601.

image

ImageObject o URL

Eventuali immagini incorporate nel commento, se applicabili.

video

VideoObject o URL

Eventuali video incorporati nel commento, se applicabili.

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.

Risoluzione dei problemi

Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.