Eseguire il markup delle domande frequenti (FAQ) con i dati strutturati

Una pagina di domande frequenti (FAQ) contiene un elenco di domande e risposte relative a un determinato argomento. Le pagine di domande frequenti (FAQ) con markup corretto potrebbero essere idonee alla visualizzazione come risultato avanzato nella Ricerca e a un'azione per l'Assistente Google, funzionalità che possono aiutare il tuo sito a raggiungere gli utenti giusti. Di seguito è riportato un esempio di risultato avanzato relativo a domande frequenti:

Risultato avanzato relativo a domande frequenti nella Ricerca Google — **Nota**: l'aspetto effettivo nei risultati di ricerca potrebbe essere diverso. Puoi visualizzare l'anteprima della maggior parte delle funzionalità con il test dei risultati multimediali.

Disponibilità della funzionalità

I risultati avanzati di domande frequenti sono disponibili in tutti i paesi e in tutte le lingue in cui è disponibile la Ricerca Google. La funzionalità è disponibile su dispositivi desktop e mobili.

Esempi

JSON-LD

Ecco un esempio di FAQPage in formato JSON-LD:

<html>
  <head>
    <title>Example Site - Frequently Asked Questions(FAQ)</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [{
        "@type": "Question",
        "name": "What is the return policy?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Most unopened items in new condition and returned within <b>90 days</b> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.</p><p>Online purchases may be returned via a major parcel carrier. <a href=https://example.com/returns> Click here </a> to initiate a return.</p>"
        }
      }, {
        "@type": "Question",
        "name": "How long does it take to process a refund?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time."
        }
      }, {
        "@type": "Question",
        "name": "What is the policy for late/non-delivery of items ordered online?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Our local teams work diligently to make sure that your order arrives on time, within our normaldelivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.</p><p><a href=https://example.com/orders/>Click here</a> to complete the form with your order-related question(s).</p>"
        }
      }, {
        "@type": "Question",
        "name": "When will my credit card be charged?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours."
        }
      }, {
        "@type": "Question",
        "name": "Will I be charged sales tax for online orders?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text":"Local and State sales tax will be collected if your recipient's mailing address is in: <ul><li>Arizona</li><li>California</li><li>Colorado</li></ul>"}
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

<html>
  <head>
    <title>Example Site - Frequently Asked Questions(FAQ)</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "FAQPage",
      "mainEntity": [{
        "@type": "Question",
        "name": "What is the return policy?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Most unopened items in new condition and returned within <b>90 days</b> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.</p><p>Online purchases may be returned via a major parcel carrier. <a href=https://example.com/returns> Click here </a> to initiate a return.</p>"
        }
      }, {
        "@type": "Question",
        "name": "How long does it take to process a refund?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time."
        }
      }, {
        "@type": "Question",
        "name": "What is the policy for late/non-delivery of items ordered online?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "<p>Our local teams work diligently to make sure that your order arrives on time, within our normaldelivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.</p><p><a href=https://example.com/orders/>Click here</a> to complete the form with your order-related question(s).</p>"
        }
      }, {
        "@type": "Question",
        "name": "When will my credit card be charged?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours."
        }
      }, {
        "@type": "Question",
        "name": "Will I be charged sales tax for online orders?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text":"Local and State sales tax will be collected if your recipient's mailing address is in: <ul><li>Arizona</li><li>California</li><li>Colorado</li></ul>"}
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Microdati

Ecco un esempio di FAQPage in formato Microdati:

<html itemscope itemtype="https://schema.org/FAQPage">
<head>
    </head>
<body>
  <h1>
    Frequently Asked Questions(FAQ)
  </h1>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">What is the return policy?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        Most unopened items in new condition and returned within <b>90 days</b> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.
        <br /><p>Online purchases may be returned via a major parcel carrier. <a href="https://example.com/returns"> Click here </a> to initiate a return.</p>
      </div>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">How long does it take to process a refund?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">What is the policy for late/non-delivery of items ordered online?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Our local teams work diligently to make sure that your order arrives on time, within our normal delivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.
      <br/> <p><a href="https://example.com/orders/">Click here</a> to complete the form with your order-related question(s).</p>
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">When will my credit card be charged?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">Will I be charged sales tax for online orders?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Local and State sales tax will be collected if your recipient's mailing address is in:
      <ul>
        <li>Arizona</li>
        <li>California</li>
        <li>Colorado</li>
      </ul>
    </div>
  </div>
</div>
  </body>
</html>

<html itemscope itemtype="https://schema.org/FAQPage">
<head>
    </head>
<body>
  <h1>
    Frequently Asked Questions(FAQ)
  </h1>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">What is the return policy?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        Most unopened items in new condition and returned within <b>90 days</b> will receive a refund or exchange. Some items have a modified return policy noted on the receipt or packing slip. Items that are opened or damaged or do not have a receipt may be denied a refund or exchange. Items purchased online or in-store may be returned to any store.
        <br /><p>Online purchases may be returned via a major parcel carrier. <a href="https://example.com/returns"> Click here </a> to initiate a return.</p>
      </div>
    </div>
  </div>
  <div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
    <h2 itemprop="name">How long does it take to process a refund?</h2>
    <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
      <div itemprop="text">
        We will reimburse you for returned items in the same way you paid for them. For example, any amounts deducted from a gift card will be credited back to a gift card. For returns by mail, once we receive your return, we will process it within 4–5 business days. It may take up to 7 days after we process the return to reflect in your account, depending on your financial institution's processing time.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">What is the policy for late/non-delivery of items ordered online?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Our local teams work diligently to make sure that your order arrives on time, within our normal delivery hours of 9AM to 8PM in the recipient's time zone. During  busy holiday periods like Christmas, Valentine's and Mother's Day, we may extend our delivery hours before 9AM and after 8PM to ensure that all gifts are delivered on time. If for any reason your gift does not arrive on time, our dedicated Customer Service agents will do everything they can to help successfully resolve your issue.
      <br/> <p><a href="https://example.com/orders/">Click here</a> to complete the form with your order-related question(s).</p>
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">When will my credit card be charged?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      We'll attempt to securely charge your credit card at the point of purchase online. If there's a problem, you'll be notified on the spot and prompted to use another card. Once we receive verification of sufficient funds, your payment will be completed and transferred securely to us. Your account will be charged in 24 to 48 hours.
    </div>
  </div>
</div>
<div itemscope itemprop="mainEntity" itemtype="https://schema.org/Question">
  <h2 itemprop="name">Will I be charged sales tax for online orders?</h2>
  <div itemscope itemprop="acceptedAnswer" itemtype="https://schema.org/Answer">
    <div itemprop="text">
      Local and State sales tax will be collected if your recipient's mailing address is in:
      <ul>
        <li>Arizona</li>
        <li>California</li>
        <li>Colorado</li>
      </ul>
    </div>
  </div>
</div>
  </body>
</html>

Linee guida

Affinché la tua pagina delle domande frequenti sia idonea per i risultati avanzati relativi, devi seguire queste linee guida:

Linee guida relative ai contenuti

Usa FAQPage soltanto se la tua pagina contiene Domande frequenti per le quali esiste una sola risposta a ogni domanda. Se la tua pagina ha una sola domanda e gli utenti possono inviare risposte alternative, usa invece QAPage. Ecco alcuni esempi:
Casi d'uso validi:
- Una pagina delle domande frequenti scritta dal sito stesso, che non consente agli utenti di inviare risposte alternative
- Una pagina di assistenza prodotti che elenca le domande frequenti, in cui gli utenti non hanno la possibilità di inviare risposte alternative
Casi d'uso non validi:
- Una pagina del forum in cui gli utenti possono inviare risposte a una singola domanda
- Una pagina di assistenza prodotti in cui gli utenti possono inviare le risposte a una singola domanda.
- Una pagina di prodotto in cui gli utenti possono inviare più domande e risposte su un'unica pagina
Non usare FAQPage a scopo pubblicitario.
Assicurati che ogni elemento Question includa l'intero testo della domanda e che ogni elemento Answer includa l'intero testo della risposta. Potrebbe essere visualizzato il testo completo delle domande e delle risposte.
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.
Tutti i contenuti FAQ devono essere visibili all'utente nella pagina di origine. Ecco alcuni esempi:
Casi d'uso validi:
- Sia la domanda che la risposta sono visibili nella pagina.
- La domanda è visibile nella pagina e la risposta è nascosta dietro a una sezione espandibile. L'utente può accedere alla risposta facendo clic sulla sezione espandibile.
Caso d'uso non valido: l'utente non riesce a trovare contenuti di Domande frequenti (FAQ) nella pagina.
Se nel tuo sito sono presenti contenuti di Domande frequenti (FAQ) ripetitivi (vale a dire che la stessa domanda e la stessa risposta vengono visualizzate in più pagine del tuo sito), effettua il markup di una sola istanza di questi contenuti per l'intero sito.

Definizioni dei tipi di dati strutturati

Affinché i tuoi contenuti siano idonei per la visualizzazione 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.

`FAQPage`

La definizione completa di FAQPage è disponibile su schema.org.

Il tipo FAQPage indica che si tratta di una pagina di domande frequenti (FAQ) con domande e relative risposte. Ci deve essere una definizione di tipo FAQPage per pagina.

Proprietà obbligatorie
`mainEntity`	`Question` Un array di elementi `Question` che comprendono l'elenco delle domande e relative risposte a cui si riferisce questo elemento `FAQPage`. Devi specificare almeno un elemento `Question` valido. Un elemento `Question` include sia la domanda che la risposta.

`Question`

La definizione completa di Question è disponibile su schema.org.

Il tipo Question definisce una singola domanda con risposta all'interno della pagina di domande frequenti (FAQ). Ogni istanza Question deve essere contenuta all'interno dell'array della proprietà mainEntity di schema.org/FAQPage.

Proprietà obbligatorie
`acceptedAnswer`	`Answer` La risposta alla domanda. Deve essere presente una risposta per ogni domanda.
`name`	`Text` Il testo completo della domanda. Ad esempio, "Quanto tempo ci vuole per elaborare un rimborso?".

`Answer`

La definizione completa di Answer è disponibile su schema.org.

Il tipo Answer definisce il valore acceptedAnswer per ogni elemento Question nella pagina.

Proprietà obbligatorie
`text`	`Text` La risposta completa alla domanda. La risposta potrebbe includere contenuti HTML come link ed elenchi. La Ricerca Google visualizza i seguenti tag HTML; tutti gli altri tag vengono ignorati: da `<h1>` a `<h6>`, `<br>`, `<ol>`, `<ul>`, `<li>`, `<a>`, `<p>`, `<div>`, `<b>`, `<strong>`, `<i>` e `<em>`.

Risoluzione dei problemi

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

Se utilizzi un sistema di gestione dei contenuti (CMS) o un'altra persona si sta occupando del tuo sito, chiedile di aiutarti. Assicurati di inoltrarle gli eventuali messaggi di Search Console che illustrano il problema.
Google non garantisce che le funzionalità che utilizzano dati strutturati vengano visualizzate nei risultati di ricerca. Per un elenco delle cause comuni per cui i tuoi contenuti potrebbero non essere mostrati da Google in un risultato avanzato consulta le linee guida generali sui dati strutturati.
I tuoi dati strutturati potrebbero contenere un errore. Consulta l'elenco di errori nei dati strutturati.
Se i dati strutturati della tua pagina sono interessati da un'azione manuale, i dati strutturati sulla pagina verranno ignorati (sebbene la pagina possa ancora essere visualizzata nei risultati della Ricerca Google). Per risolvere i problemi relativi ai dati strutturati, utilizza il report Azioni manuali.
Consulta nuovamente le linee guida per verificare se i tuoi contenuti non sono conformi. Il problema può essere causato dall'utilizzo di contenuti di spam o di markup di spam. Tuttavia, il problema potrebbe non riguardare la sintassi e perciò non essere identificato dal Test dei risultati avanzati.
Consulta informazioni su come risolvere i problemi relativi a risultati avanzatimancanti/calo del numero totale di risultati avanzati.
Lascia del tempo per le nuove operazioni di scansione e indicizzazione. Ricorda che possono passare diversi giorni dopo la pubblicazione di una pagina prima che Google la rilevi e la sottoponga a scansione. Per domande generali sulla scansione e sull'indicizzazione, consulta le Domande frequenti (FAQ) relative alla scansione e all'indicizzazione della Ricerca Google.
Pubblica una domanda nel forum di Google Search Central.