Структурированные данные для озвучиваемого текста (Article, WebPage) (БЕТА)

Если вы добавите в разметку статьи или веб-страницы свойство speakable, описанное на сайте schema.org, поисковые системы и другие приложения будут распознавать контент, который лучше всего подойдет для озвучивания на устройствах с Google Ассистентом. Благодаря Ассистенту информация на страницах со структурированными данными speakable станет доступна для более широкой аудитории.

Структурированные данные speakable используются для озвучивания новостей на устройствах с умными колонками. Когда пользователь просит рассказать новости на определенную тему, Google Ассистент предлагает статьи из интернета (не более трех), в которых есть озвучиваемые разделы с разметкой speakable. Когда Ассистент зачитывает раздел со структурированными данными, помеченными с помощью свойства speakable, он указывает источник контента и отправляет полный URL статьи на мобильное устройство пользователя через приложение "Google Ассистент".

Пример

Ниже приведен пример кода JSON-LD и значения xPath content-locator для структурированных данных speakable.

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

Какие регионы и языки поддерживает эта функция

Разметка speakable доступна пользователям из США с устройствами Google Home на английском, а также издателям, публикующим контент на этом языке. Мы планируем запустить функцию для других стран и языков, как только издатели начнут активно использовать свойство speakable.

Начало работы

Чтобы ваши материалы могли использоваться для озвучивания новостей, выполните следующие действия:

  1. Проверьте, не нарушает ли контент наши правила.
  2. Добавьте на веб-страницу структурированные данные speakable.

Правила

Чтобы ваш контент с разметкой speakable появлялся в результатах поиска новостей, необходимо соблюдать следующие правила:

Технические требования

При использовании разметки speakable для Google Ассистента следуйте перечисленным ниже правилам.

  • Не добавляйте структурированные данные speakable для контента, который может прозвучать неразборчиво (например, для выходных данных, авторов публикации и подписей к фотографиям).
  • Не стоит использовать разметку speakable для всей статьи. Вместо этого выделите основные моменты. Так пользователи смогут вникнуть в суть материала и не упустят важную информацию во время озвучивания.

Требования к контенту

Контент со структурированными данными типа speakable должен соответствовать следующим требованиям:

  • У контента с разметкой speakable должен быть короткий заголовок и/или аннотация с исчерпывающей и полезной информацией о нем.
  • Если вы используете структурированные данные типа speakable для начальной части материала, то желательно разбить ее на короткие предложения. Так информация будет лучше восприниматься на слух.
  • Оптимальная длина озвучиваемого отрывка с разметкой speakable – 20–30 секунд (или два-три предложения).

Типы структурированных данных

Свойство Speakable используется в объекте Article или Webpage. Полное описание типа speakable приведено на странице schema.org/speakable. Чтобы контент мог появиться в результатах поиска новостей, необходимо задать все обязательные свойства.

Свойство speakable может повторяться произвольное число раз с двумя возможными значениями content-locator: cssSelector и xPath. Используйте одно из свойств, приведенных ниже.

Обязательные свойства
cssSelector

Text

Применяется для контента на аннотированных страницах (например, для атрибута класса). Используйте значение cssSelector или xPath, но не оба. Пример:

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

Text

Обращается к контенту через xPath (если выбрана разметка XML). Используйте значение cssSelector или xPath, но не оба. Пример:

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

Устранение неполадок

Если у вас возникли трудности с добавлением или отладкой структурированных данных, вам помогут ресурсы и сведения, доступные по приведенным ниже ссылкам.

Контент не озвучивается

Проблема: Google Ассистент не может озвучить ваш текст.

Как устранить проблему

  1. Попробуйте следующие голосовые команды:
    • "Последние новости по теме (название темы)".
    • "Что нового в (название темы)?"
    • "Расскажи новости (название темы)".
  2. Если проблема не решена, возможно, алгоритм не присвоил вашему сайту высокий рейтинг. Google Ассистент предлагает для озвучивания до трех статей из разных новостных источников. Подробнее о том, как Google формирует рейтинг сайтов

Другие способы озвучивания контента

Помимо структурированных данных speakable вам доступны другие способы озвучивания новостного контента. Например, вы можете интегрировать Google Ассистента в конкретные приложения. Подробные сведения об этом доступны в руководстве по Actions on Google для разработчиков.