Dati strutturati Speakable (Article, WebPage) (BETA)

La proprietà speakable di schema.org identifica le sezioni all'interno di un articolo o una pagina web che sono più adatte alla riproduzione audio tramite sintesi vocale (TTS). L'aggiunta di markup consente ai motori di ricerca e ad altre applicazioni di identificare i contenuti da leggere ad alta voce sui dispositivi con l'assistente integrato tramite sintesi vocale. Le pagine web con dati strutturati speakable possono utilizzare l'Assistente Google per distribuire i contenuti attraverso nuovi canali e raggiungere una più ampia base di utenti.

L'Assistente Google utilizza i dati strutturati speakable per rispondere a richieste di notizie di attualità sugli smart speaker. Quando gli utenti chiedono notizie su un argomento specifico, l'Assistente Google restituisce fino a tre articoli da tutto il Web e supporta la riproduzione audio utilizzando la sintesi vocale per le sezioni nell'articolo con dati strutturati speakable. Quando l'Assistente Google legge ad alta voce una sezione speakable, attribuisce la fonte e invia l'URL completo dell'articolo al dispositivo mobile dell'utente tramite l'app Assistente Google.

Esempio

Ecco un esempio di dati strutturati speakable in cui vengono utilizzati il codice JSON-LD e il valore xPath content-locator:

<html>
  <head>
    <title>Speakable markup example</title>
    <meta name="description" content="This page is all about the quick brown fox" />
    <script type="application/ld+json">
    {
     "@context": "https://schema.org/",
     "@type": "WebPage",
     "name": "Quick Brown Fox",
     "speakable":
     {
      "@type": "SpeakableSpecification",
      "xPath": [
        "/html/head/title",
        "/html/head/meta[@name='description']/@content"
        ]
      },
     "url": "https://www.example.com/quick-brown-fox"
     }
    </script>
  </head>
  <body>
  </body>
</html>

Paesi e lingue in cui è disponibile la proprietà

La proprietà speakable funziona per gli utenti negli Stati Uniti che dispongono di dispositivi Google Home impostati in inglese e per gli editori che pubblicano contenuti in inglese. Speriamo di lanciare la proprietà in altri paesi e in altre lingue non appena un numero sufficiente di editori avrà implementato speakable.

Guida introduttiva

Affinché i contenuti di notizie siano idonei come risposte alle query di notizie di attualità, svolgi i seguenti passaggi:

  1. Assicurati di seguire le nostre linee guida.
  2. Aggiungi i dati strutturati speakable alla tua pagina web.

Linee guida

È necessario seguire queste linee guida affinché i contenuti speakable siano idonei a comparire nei risultati di notizie.

Linee guida tecniche

Segui queste linee guida durante l'implementazione del markup speakable per l'Assistente Google.

  • Non aggiungere dati strutturati speakable ai contenuti che possano creare confusione nelle situazioni in cui l'utente utilizza un dispositivo a sola interazione vocale, ad esempio data e luogo in cui è stata riportata una notizia di cronaca, didascalie delle foto o attribuzioni della fonte.
  • Piuttosto che evidenziare un intero articolo con dati strutturati speakable, concentrati sui punti chiave. Ciò consente agli ascoltatori di farsi un'idea della storia e di far sì che la sintesi vocale non escluda dettagli importanti.

Linee guida relative ai contenuti

Segui queste linee guida quando scrivi contenuti di cui intendi eseguire il markup con dati strutturati speakable.

  • I contenuti indicati da dati strutturati speakable devono avere titoli concisi e/o riassunti che forniscano agli utenti informazioni comprensibili e utili.
  • Se includi la parte superiore della notizia in dati strutturati speakable, ti suggeriamo di riscriverla per suddividere le informazioni in singole frasi in modo che siano più chiare per la sintesi vocale.
  • Al fine di offrire esperienze audio ottimali per gli utenti, consigliamo circa 20-30 secondi di contenuti per sezione di dati strutturati speakable o approssimativamente da due a tre frasi.

Definizioni dei tipi di dati strutturati

Speakable è utilizzato dall'oggetto Article o Webpage. La definizione completa di speakable è disponibile all'indirizzo schema.org/speakable. Affinché i tuoi contenuti siano idonei per questa funzionalità, devi includere le proprietà obbligatorie.

La proprietà speakable può essere ripetuta un numero arbitrario di volte, con due tipi di valori content-locator possibili: selettori CSS e xPath. Utilizza una delle seguenti proprietà:

Proprietà obbligatorie
cssSelector

Text

Indirizza i contenuti nelle pagine annotate (come l'attributo classe). Utilizza cssSelector o xPath; non usare entrambi. Ad esempio:


"speakable":
  {
  "@type": "SpeakableSpecification",
  "cssSelector": [
    ".headline",
    ".summary"
  ]
}
xPath

Text

Indirizza i contenuti utilizzando xPath (presupponendo una visualizzazione XML dei contenuti). Utilizza cssSelector o xPath; non usare entrambi. Ad esempio:


"speakable":
  {
  "@type": "SpeakableSpecification",
  "xPath": [
    "/html/head/title",
    "/html/head/meta[@name='description']/@content"
  ]
}

Risoluzione dei problemi

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

Impossibile attivare i contenuti

Problema: non è possibile attivare i contenuti tramite l'Assistente Google utilizzando l'audio di sintesi vocale.

Risoluzione del problema

  1. Prova i seguenti comandi vocali:
    • "Quali sono le ultime notizie su $topic?"
    • "Qual è l'ultima novità in fatto di $topic?"
    • "Fammi ascoltare notizie su $topic."
  2. Se i problemi persistono, è possibile che il ranking sia determinato in modo algoritmico. L'Assistente Google fornisce fino a tre articoli di diversi editori giornalistici attraverso la riproduzione audio di sintesi vocale. Per ulteriori informazioni su come Google classifica gli articoli, vedi Come funziona la Ricerca.

Ulteriori soluzioni audio

Oltre ai dati strutturati speakable, puoi utilizzare altre soluzioni audio dell'Assistente Google per i tuoi contenuti di notizie, come l'integrazione avanzata dell'Assistente Google per le tue applicazioni personalizzate. Ad esempio, per consentire agli utenti di interagire con l'applicazione tramite l'Assistente Google. Per ulteriori informazioni, consulta la guida per gli sviluppatori di Actions on Google.