Datos estructurados Speakable (Article, WebPage) (BETA)

La propiedad speakable de schema.org identifica secciones dentro de un artículo o una página web que son más adecuadas para la reproducción de audio con conversión de texto a voz (TTS). Si se añaden etiquetas, los buscadores y otras aplicaciones pueden identificar el contenido para leer en voz alta mediante TTS en dispositivos con el Asistente de Google integrado. Las páginas web con datos estructurados speakable pueden aprovechar el Asistente de Google para distribuir su contenido por canales nuevos y llegar a una base más amplia de usuarios.

El Asistente de Google utiliza datos estructurados speakable para responder a consultas de noticias de actualidad en altavoces inteligentes. Cuando los usuarios solicitan noticias sobre un tema específico, el Asistente de Google devuelve hasta tres artículos de la Web y admite la reproducción de audio mediante TTS de las secciones del artículo con datos estructurados speakable. Cuando el Asistente de Google lee en voz alta una sección speakable, cita la fuente y envía la URL completa del artículo al dispositivo móvil del usuario mediante la aplicación Asistente de Google.

Ejemplo

A continuación se proporciona un ejemplo de datos estructurados speakable mediante código JSON-LD y el valor content-locator de xPath:

<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>

Disponibilidad por países e idiomas

La propiedad speakable funciona para usuarios de EE. UU. que tienen dispositivos Google Home configurados en inglés y editores que publican contenido en inglés. Esperamos lanzarla en otros países e idiomas tan pronto como un número suficiente de editores hayan implementado speakable.

Primeros pasos

Para que tu contenido de noticias pueda incluirse como respuesta a consultas sobre noticias de actualidad, sigue estos pasos:

  1. Asegúrate de seguir nuestras directrices.
  2. Añade datos estructuradosspeakable a tu página web.

Directrices

Debes seguir estas directrices para que el contenido speakable sea apto para aparecer en los resultados de noticias.

Directrices técnicas

Sigue estas directrices al implementar etiquetas speakable en el Asistente de Google.

  • No añadas datos estructurados speakable al contenido que pueda sonar confuso en situaciones de solo voz o basadas en la voz, como fechas y lugares (ubicación en la que ocurrió la historia), pies de foto o menciones de fuentes.
  • En lugar de destacar un artículo completo con datos estructurados speakable, céntrate en los puntos clave. De este modo, los oyentes se hacen una idea de la historia y el TTS no omite detalles importantes.

Directrices de contenido

Sigue estas directrices cuando redactes contenido que quieras marcar con datos estructurados de speakable.

  • El contenido marcado con datos estructurados de speakable debe tener títulos concisos o resúmenes que proporcionen a los usuarios información comprensible y útil.
  • Si incluyes la parte más importante del artículo en datos estructurados de speakable, es recomendable que vuelvas a redactar esa parte para dividir la información en oraciones independientes para que su lectura sea más clara en TTS.
  • Para una experiencia óptima del usuario de audio, recomendamos alrededor de 20 o 30 segundos de contenido por sección de datos estructurados speakable o, aproximadamente, dos o tres oraciones.

Definiciones de tipos de datos estructurados

Speakable lo utilizan los objetos Article o Webpage. Puedes consultar la definición completa de speakable en schema.org/speakable. Debes incluir las propiedades obligatorias para que el contenido pueda aprovechar esta función.

La propiedad speakable puede repetirse un número arbitrario de veces, con dos tipos de posibles valores de content-locator: selectores de CSS y xPaths. Usa una de las siguientes propiedades:

Propiedades obligatorias
cssSelector

Text

Aborda el contenido de las páginas anotadas (como el atributo de clase). Usa cssSelector o xPath; no uses ambos. Por ejemplo:


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

Text

Aborda el contenido con xPaths (si se trata de una vista XML del contenido). Usa cssSelector o xPath; no uses ambos. Por ejemplo:


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

Solucionar problemas

Si tienes problemas para implementar o depurar datos estructurados, a continuación se incluyen algunos recursos que pueden serte útiles.

No se puede activar el contenido

Problema: No se puede activar el contenido a través del Asistente de Google con audio TTS.

Corrige el problema

  1. Prueba los siguientes comandos de voz:
    • "¿Cuáles son las últimas noticias sobre $topic?"
    • "¿Cuáles son las novedades de $topic?"
    • "Reproducir noticias sobre $topic".
  2. Si los problemas persisten, pueden deberse a que la clasificación se determina mediante algoritmos. El Asistente de Google proporciona hasta tres artículos de diferentes publicaciones de noticias a través de la reproducción de audio TTS. Para obtener más información sobre cómo clasificamos los artículos, consulta Cómo funciona la Búsqueda de Google.

Más soluciones de audio

Además de los datos estructurados speakable, hay otras soluciones de audio del Asistente de Google que puedes usar con tu contenido de noticias, como la integración avanzada del Asistente de Google con tus propias aplicaciones personalizadas. Por ejemplo, puedes permitir a los usuarios que interactúen con la aplicación a través del Asistente de Google. Para obtener más información, consulta la guía para desarrolladores sobre Actions on Google.