Datos estructurados de Speakable (Article, WebPage) (BETA)

La propiedad speakable de schema.org identifica las secciones de un artículo o una página web más adecuadas para la reproducción de audio con texto a voz (TTS). Si agregas lenguaje de marcado, permitirás a los motores de búsqueda y a otras aplicaciones identificar el contenido para leer en voz alta en los dispositivos compatibles con el Asistente de Google por medio de funciones de TTS. Las páginas web con datos estructurados de speakable podrán usar el Asistente para distribuir contenido mediante canales nuevos y llegar a una mayor cantidad de usuarios.

El Asistente de Google usa datos estructurados de speakable para responder consultas sobre temas del momento en dispositivos con bocinas inteligentes. Cuando los usuarios piden noticias sobre un tema específico, el Asistente muestra hasta tres artículos de la Web y admite la reproducción de audio con TTS para las secciones de artículos con datos estructurados de speakable. Cuando el Asistente lee una sección con speakable en voz alta, hace atribución a la fuente y envía la URL del artículo completo al dispositivo móvil del usuario mediante la app del Asistente de Google.

Ejemplo

El siguiente es un ejemplo de datos estructurados de speakable que usan el 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 de idiomas y países

La propiedad speakable funciona para usuarios de EE.UU. que tienen dispositivos Google Home configurados en inglés, y para editores que publican contenido en ese idioma. Esperamos lanzarla en otros idiomas y países cuando más editores comiencen a implementar speakable.

Cómo comenzar

Para que tu contenido de noticias pueda considerarse como respuesta a búsquedas de noticias temáticas, sigue estos pasos:

  1. Asegúrate de seguir nuestros lineamientos.
  2. Agrega datos estructurados de speakable a tu página web.

Lineamientos

Debes seguir estos lineamientos para que el contenido con speakable pueda aparecer en los resultados de noticias.

Lineamientos técnicos

Sigue estos lineamientos cuando implementes lenguaje de marcado speakable para el Asistente de Google.

  • No agregues datos estructurados de speakable al contenido que pueda sonar confuso en situaciones en las que solo haya voz y de reenvío de voz, como la fecha y la hora (ubicación en donde ocurrió la noticia), las leyendas de fotos o las atribuciones de fuentes.
  • En lugar de destacar un artículo completo con datos estructurados speakable, enfócate en los puntos principales. De esta manera, los usuarios que estén escuchando podrán tener una idea de la noticia y evitarás que la lectura con TTS corte los detalles importantes.

Lineamientos de contenido

Sigue estos lineamientos cuando escribas contenido que quieras marcar con datos estructurados de speakable.

  • El contenido indicado con datos estructurados de speakable debe tener titulares y resúmenes concisos que brinden a los usuarios información útil y comprensible.
  • Si incluyes datos estructurados de speakable en la parte superior de la noticia, te sugerimos que la vuelvas a escribir y dividas la información en oraciones individuales a fin de que sea más fácil de leer para la función TTS.
  • Para brindar experiencias de audio óptimas, se recomienda que el contenido por sección con datos estructurados de speakable sea de alrededor de 20 o 30 segundos, o bien, de aproximadamente dos o tres oraciones.

Definiciones de tipos de datos estructurados

Los objetos Article y Webpage usan Speakable. La definición completa de speakable está disponible en schema.org/speakable. Debes incluir las propiedades obligatorias a fin de que tu contenido sea apto para esta función.

La propiedad speakable se puede repetir una cantidad arbitraria de veces, con dos tipos de valores de content-locator posibles: selectores de CSS y xPaths. Usa una de las siguientes propiedades:

Propiedades obligatorias
cssSelector

Text

Corresponde al contenido de las páginas con anotaciones (como el atributo de clase). Utiliza cssSelector o xPath, pero no ambos. Por ejemplo:

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

Text

Corresponde al contenido que usa xPaths (asumiendo que hay una vista de XML del contenido). Utiliza cssSelector o xPath, pero no ambos. Por ejemplo:

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

Solución de problemas

Si tienes problemas para implementar o depurar datos estructurados, te brindamos algunos recursos que podrían resultarte útiles.

No se puede activar el contenido

Problema: No puedes activar tu contenido a través del Asistente de Google con audio TTS.

Cómo solucionarlo

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

Más soluciones de audio

Además de los datos estructurados de speakable, puedes usar otras soluciones de audio de Asistente de Google para el contenido de noticias, como la integración avanzada de Asistente de Google para tus aplicaciones personalizadas. Por ejemplo, cuando permites que los usuarios interactúen con la app mediante el Asistente. Puedes obtener más información en la guía para desarrolladores de Actions on Google.