Структуровані дані для відео (Video, Clip, Broadcast)

Наші алгоритми намагаються автоматично отримати інформацію про ваші ролики, однак ви можете використовувати тип VideoObject, щоб вказати, що має відображатися в результатах пошуку відео: URL значка відео, опис ролика, дані про його тривалість і дату завантаження тощо. Завдяки структурованим даним на сторінках перегляду нашим алгоритмам легше знаходити відео. Відео можуть з’являтися на головній сторінці результатів пошуку, а також у результатах пошуку відео, Google Картках і рекомендаціях Google.

структуровані дані відео

За допомогою спеціальної розмітки ви можете зробити представлення відео в результатах пошуку ще більш зручним та інформативним.

Функції для обробки відео

Позначка «Прямий ефір». Щоб поруч з відео з’являлася позначка «Прямий ефір», достатньо додати для нього властивість BroadcastEvent. Цю позначку можна додати до будь-якої загальнодоступної трансляції, незалежно від її тривалості. Ось деякі приклади відео, до яких можна додати таку позначку:

  • спортивні заходи;
  • церемонії вручення нагород;
  • відео інфлюенсерів;
  • прямі трансляції відеоігор.

Щоб роботи Google своєчасно сканували вашу сторінку, дотримуйтесь спеціальних вимог і використовуйте Indexing API.

структуровані дані відео

Ключові моменти

За допомогою функції ключових моментів глядач може швидко переходити до певних місць у відео, ніби відкриваючи розділ книги. Так відео стає зрозумілішим, а користувачам зручніше його дивитися. Пошук Google може самостійно виявляти основні епізоди у вашому відео та пропонувати їх користувачам. Вам для цього не потрібно нічого робити. Однак ви можете вказати Google на важливі моменти у відео, і вони отримають вищий пріоритет. Це можна зробити за допомогою структурованих даних або опису на YouTube.

  • Якщо відео вбудовано у вашу веб-сторінку або опубліковано на вашій платформі, можна розмітити ключові моменти за допомогою двох типів структурованих даних:
    • Структуровані дані Clip. Дозволяють вказати час початку і закінчення кожного моменту і дати йому назву. Ця можливість доступна для всіх мов, сумісних з Пошуком Google.
    • Структуровані дані SeekToAction. Дозволяють повідомити Google про те, де зазвичай розташовані мітки часу в структурі ваших URL, щоб роботи Google автоматично визначали ключові моменти і вибирали певні епізоди у відео, на які потрібно звернути увагу користувачів. Ця можливість доступна для англійської, іспанської, італійської, китайської, корейської, німецької, нідерландської, португальської, російської, турецької, французької та японської мов.
  • Якщо ролик розміщений на YouTube, ви можете вказати часові мітки та назви епізодів у його описі. Ознайомтеся з рекомендаціями щодо встановлення міток часу в описах відео на YouTube. Ця можливість доступна для всіх мов, сумісних з Пошуком Google. Щоб увімкнути поділ відео YouTube на епізоди, дотримуйтесь цих додаткових рекомендацій.

Щоб не виділяти ключові моменти і заборонити Google їх автоматичний показ, використовуйте тег nosnippet (meta).

структуровані дані відео

Структуровані дані — стандартизований формат, який дозволяє надавати пошуковим системам інформацію про сторінку та класифікувати її вміст. Детальніше про принципи роботи структурованих даних…

Нижче в загальних рисах описано, як створити, перевірити та додати на сайт структуровані дані.

  1. Додайте обов’язкові властивості. Дізнайтеся, в яких частинах сторінки потрібно розміщувати структуровані дані обраного вами формату.
  2. Дотримуйтесь рекомендацій.
  3. Перевірте свій код за допомогою інструменту перевірки розширених результатів. Якщо будуть виявлені критичні помилки, усуньте їх. Ми також рекомендуємо усунути некритичні помилки, зазначені в інструменті. Це може призвести до підвищення якості структурованих даних, хоча сторінки будуть придатні для створення розширених результатів і без цього.
  4. Опублікуйте сторінку й за допомогою інструменту перевірки URL з’ясуйте, як вона виглядає для робота Googlebot. Переконайтеся, що доступ Google до сторінки не заблоковано файлом robots.txt або метатегом noindex і авторизація на ній не потрібна. Якщо все в порядку, то запросіть повторне сканування ваших URL.
  5. Надішліть нам файл Sitemap, щоб інформувати нас про зміни на сайті. Надсилання такого файлу можна автоматизувати за допомогою Search Console Sitemap API.

структуровані дані відео

Натисніть кнопку нижче, щоб побачити приклад однієї властивості VideoObject.

<html>
  <head>
    <title>Introducing the self-driving bicycle in the Netherlands</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "name": "Introducing the self-driving bicycle in the Netherlands",
      "description": "This spring, Google is introducing the self-driving bicycle in Amsterdam, the world's premier cycling city. The Dutch cycle more than any other nation in the world, almost 900 kilometres per year per person, amounting to over 15 billion kilometres annually. The self-driving bicycle enables safe navigation through the city for Amsterdam residents, and furthers Google's ambition to improve urban mobility with technology. Google Netherlands takes enormous pride in the fact that a Dutch team worked on this innovation that will have great impact in their home country.",
      "thumbnailUrl": [
        "https://example.com/photos/1x1/photo.jpg",
        "https://example.com/photos/4x3/photo.jpg",
        "https://example.com/photos/16x9/photo.jpg"
       ],
      "uploadDate": "2024-03-31T08:00:00+08:00",
      "duration": "PT1M54S",
      "contentUrl": "https://www.example.com/video/123/file.mp4",
      "embedUrl": "https://www.example.com/embed/123",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 5647018
      },
      "regionsAllowed": ["US", "NL"]
    }
    </script>
  </head>
  <body>
  </body>
</html>

структуровані дані відео

Приклади елементів VideoObject та BroadcastEvent.

<html>
  <head>
    <title>Bald Eagle at the Park - Livestream</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "contentURL": "https://example.com/bald-eagle-at-the-park.mp4",
      "description": "Bald eagle at the park livestream.",
      "duration": "PT37M14S",
      "embedUrl": "https://example.com/bald-eagle-at-the-park",
      "expires": "2024-10-30T14:37:14+00:00",
      "regionsAllowed": "US",
      "interactionStatistic": {
        "@type": "InteractionCounter",
        "interactionType": { "@type": "WatchAction" },
        "userInteractionCount": 4756
      },
      "name": "Bald eagle nest livestream!",
      "thumbnailUrl": "https://example.com/bald-eagle-at-the-park",
      "uploadDate": "2024-10-27T14:00:00+00:00",
      "publication": [
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T14:00:00+00:00",
          "endDate": "2024-10-27T14:37:14+00:00"
        },
        {
          "@type": "BroadcastEvent",
          "isLiveBroadcast": true,
          "startDate": "2024-10-27T18:00:00+00:00",
          "endDate": "2024-10-27T18:37:14+00:00"
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Приклади елементів VideoObject та Clip.

<html>
  <head>
    <title>Cat jumps over the fence</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "VideoObject",
      "name": "Cat video",
      "duration": "PT10M",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/cat.jpg",
      "description": "Watch this cat jump over a fence!",
      "contentUrl": "https://www.example.com/cat_video_full.mp4",
      "ineligibleRegion": "US",
      "hasPart": [{
        "@type": "Clip",
        "name": "Cat jumps",
        "startOffset": 30,
        "endOffset": 45,
        "url": "https://www.example.com/example?t=30"
      },
      {
        "@type": "Clip",
        "name": "Cat misses the fence",
        "startOffset": 111,
        "endOffset": 150,
        "url": "https://www.example.com/example?t=111"
      }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

Приклад одного елемента VideoObject з додатковими властивостями для розмітки SeekToAction.

<html>
  <head>
    <title>John Smith (@johnsmith123) on VideoApp: My daily workout! #stayingfit</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "VideoObject",
      "potentialAction" : {
        "@type": "SeekToAction",
        "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
        "startOffset-input": "required name=seek_to_second_number"
      },
      "name": "My daily workout!",
      "uploadDate": "2024-07-19T08:00:00+08:00",
      "thumbnailUrl": "https://www.example.com/daily-workout.jpg",
      "description": "My daily workout!",
      "embedUrl": "https://example.com/daily-workout"
    }
    </script>
  </head>
  <body>
  </body>
</html>

Структуровані дані для відео повинні відповідати вимогам, викладеним у посібниках Головне про Пошук, Загальні рекомендації щодо використання структурованих даних та Які відео можна проіндексувати.

Крім того, рекомендуємо ознайомитися з наведеними нижче рекомендаціями, якщо вони застосовні до вашого відеоконтенту:

Якщо ви додаєте властивість BroadcastEvent у відео прямої трансляції, дотримуйтесь наведених нижче правил.

  • У структурованих даних не повинно бути грубих або потенційно образливих виразів.
  • Скористайтеся Indexing API, щоб робот Google своєчасно просканував вашу пряму трансляцію. Викликати API потрібно при наступних подіях:
    • Початок трансляції відео.
    • Припинення трансляції та оновлення розмітки сторінки для вказівки часу закінчення (endDate).
    • Зміна розмітки, про яку необхідно повідомити Google.

Якщо відео розміщено на YouTube, то його ключові моменти можуть бути автоматично показані в Пошуку Google (вони беруться з опису). При цьому немає необхідності встановлювати часові мітки в описі відео на YouTube. Ви також можете чітко вказати на важливі моменти у відео, і ця інформація буде вважатися пріоритетною. У наведеному нижче прикладі показано, як в результатах пошуку можуть виглядати часові мітки та ярлики з опису відео на YouTube.

структуровані дані відео

1. Ярлик. Назва фрагмента.
2. Часова мітка. Час початку фрагмента.

При оформленні часових міток і ярликів в описах до відео на YouTube враховуйте наступне:

  • Часова мітка повинна мати формат [hour]:[minute]:[second]. Для значень менше 1 години вказувати годину не потрібно.
  • Кожен ярлик повинен знаходитися на тому ж рядку, що і мітка часу, до якої він відноситься.
  • Кожна мітка часу повинна бути вказана в окремому рядку опису.
  • Кожна мітка часу повинна бути пов’язана з певним епізодом у відео.
  • У ярлику має бути хоча б одне слово.
  • Часові мітки необхідно перераховувати в хронологічному порядку.

Щоб увімкнути поділ відео YouTube на епізоди, дотримуйтесь цих додаткових рекомендацій.

Якщо ви розмічаєте відеосегменти за допомогою структурованих даних Clip або SeekToAction, дотримуйтесь наведених нижче правил.

  • У URL відео повинна бути передбачена можливість вказувати посилання на його фрагменти, а не тільки на початок ролика. Приклад фрагмента, що починається через 30 секунд після початку відео: https://www.example.com/example?t=30.
  • На сторінку, де користувачі можуть дивитися відео, необхідно додати структуровані дані VideoObject. Не направляйте відвідувачів на сторінку, де відео недоступне.
  • Загальна тривалість відео повинна бути не менше 30 секунд.
  • Для відео потрібно вказати обов’язкові властивості, перераховані в документації з структурованих даних VideoObject.
  • Тільки для структурованих даних Clip. На одній сторінці не повинно бути двох фрагментів одного відео з однаковим часом початку.
  • Тільки для структурованих даних SeekToAction. Google повинен мати доступ до вашого відеоконтенту.

У цьому розділі описані типи структурованих даних, пов’язаних з функціями для відео, які підтримуються в Пошуку Google. Щоб ваш контент міг з’являтися в результатах пошуку Google, необхідно встановити обов’язкові властивості розмітки VideoObject. Для зручності користувачів ми також радимо встановити і рекомендовані властивості VideoObject. Окрім VideoObject, ви також можете додати наступні типи даних, щоб покращити результати, представлені в Пошуку Google:

  • BroadcastEvent: розмітка для показу прямих трансляцій з позначкою «Прямий ефір».
  • Clip: розмітка для відео, яка дозволяє швидко перейти до потрібного фрагмента ролика.
  • SeekToAction: інформація про структуру ваших URL, що дозволяє алгоритмам Google автоматично визначати ключові моменти та направляти глядачів до певних фрагментів відео.

Повний опис типу VideoObject наведено на сторінці schema.org/VideoObject. Якщо не вказати всі обов’язкові властивості, у роботів Google можуть виникнути труднощі з витяганням інформації про відео. Ви також можете додати рекомендовані властивості, щоб надати користувачам повнішу інформацію про ваш контент.

Обов’язкові властивості
name

Text

Назва відео. Намагайтеся, щоб у кожного ролика був унікальний текст у властивості name.

thumbnailUrl

Властивість, що використовується повторно URL

URL файлу з унікальним значком відео. Дотримуйтесь правил щодо таких значків.

uploadDate

DateTime

Дата і час, коли відео було вперше розміщено, у форматі ISO 8601. Ми рекомендуємо вказати інформацію про часовий пояс, інакше за замовчуванням буде встановлено часовий пояс, який використовується роботом Googlebot.

Рекомендовані властивості
contentUrl

URL

URL файлу відео, представленого в одному з підтримуваних типів. Вказуйте не посилання на сторінку, де розміщено відео, а URL самого відеофайлу.

 
 
"contentUrl": "https://www.example.com/video/123/file.mp4"

Дотримуйтесь рекомендацій щодо роботи з відео.

description

Text

Опис відео. Намагайтеся, щоб у кожного ролика був унікальний текст у властивості description. Теги HTML ігноруються.

duration

Duration

Тривалість відео у форматі ISO 8601. Наприклад, значення PT00H30M5S відповідає тривалості 30 хвилин 5 секунд.

embedUrl

URL

URL програвача, призначеного для показу певного відео. Ви повинні навести тут не посилання на сторінку, де розміщено відео, а URL самого відеопрогравача. Зазвичай ця інформація вказується в атрибуті src елемента <embed>.

"embedUrl": "https://www.example.com/embed/123"

Дотримуйтесь рекомендацій щодо роботи з відео.

expires

DateTime

Дата і час, після яких відео буде недоступне, у форматі ISO 8601 (якщо застосовується). Якщо ви не плануєте припиняти показ ролика через певний час, цю інформацію вказувати не потрібно. Ми рекомендуємо вказати інформацію про часовий пояс, інакше за замовчуванням буде встановлено часовий пояс, який використовується роботом Googlebot.

hasPart

Якщо у відео є важливі сегменти, додайте обов’язкові властивості Clip в VideoObject. Приклад:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "hasPart": {
    "@type": "Clip",
    "name": "Cat jumps",
    "startOffset": 30,
    "url": "https://www.example.com/example?t=30"
  }
}
</script>
ineligibleRegion

Place

Регіон, у якому відео заборонено. Якщо регіони не вказано, вважатиметься, що відео дозволено скрізь. Країни необхідно вказувати в дво- або трибуквеному форматі ISO 3166. Якщо значень кілька, використовуйте кілька кодів країни, наприклад масив JSON-LD або кілька тегів meta у форматі мікроданих.

interactionStatistic

InteractionCounter

Кількість переглядів конкретного відео. Приклад:

"interactionStatistic":
  {
    "@type": "InteractionCounter",
    "interactionType": { "@type": "WatchAction" },
    "userInteractionCount": 12345
  }
publication

Якщо ви плануєте провести стрім і хочете використовувати позначку “Прямий ефір”, додайте властивості BroadcastEvent в VideoObject. Приклад:

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "VideoObject",
  "name": "Cat video",
  "publication": {
    "@type": "BroadcastEvent",
    "name": "First scheduled broadcast",
    "isLiveBroadcast": true,
    "startDate": "2018-10-27T14:00:00+00:00",
    "endDate": "2018-10-27T14:37:14+00:00"
  }
}
</script>
regionsAllowed

Place

Регіони, у яких відео дозволено, якщо застосовно. Якщо регіони не вказано, вважатиметься, що відео дозволено скрізь. Країни необхідно вказувати в дво- або трибуквеному форматі ISO 3166. Якщо значень кілька, використовуйте кілька кодів країни, наприклад масив JSON-LD або кілька тегів meta у форматі мікроданих.

Щоб відео можна було показувати з позначкою “Прямий ефір”, необхідно додати в VideoObject вказані нижче властивості. Властивості BroadcastEvent не є обов’язковими, але перераховані нижче властивості необхідно додати, щоб відео показувалося з позначкою “Прямий ефір”.

Повний опис типу BroadcastEvent наведено на сторінці schema.org/BroadcastEvent.

Обов’язкові властивості
publication

BroadcastEvent

Час початку прямої трансляції відео. Можна вказати одне значення або список.

publication.endDate

DateTime

Дата й час відомого або передбачуваного закінчення трансляції у форматі ISO 8601.

Властивість endDate необхідно додати, якщо пряма трансляція вже завершена. Якщо точна дата закінчення endDate невідома заздалегідь, вкажіть орієнтовне значення endDate.

Якщо endDate відповідає минулій або поточній даті, це означає, що пряма трансляція завершилася. Якщо дата endDate ще не настала, це означає, що пряма трансляція має завершитися у вказаний час.

publication.isLiveBroadcast

Булеан

Вкажіть значення true, якщо відео передається як пряма трансляція, транслювалося раніше або транслюватиметься пізніше.

publication.startDate

DateTime

Дата й час відомого або передбачуваного початку прямої трансляції у форматі ISO 8601. Якщо startDate відповідає минулій або поточній даті, це означає, що пряма трансляція вже розпочалася. Якщо дата startDate ще не настала, це означає, що пряма трансляція має розпочатися у вказаний час.

Щоб вручну вказати, які часові мітки та назви використовувати для функції “Ключові моменти”, додайте в об’єкт VideoObject перелічені нижче властивості. Додавати властивості Clip не обов’язково, однак це необхідно, якщо ви хочете, щоб у Google показувалися задані вами часові мітки та їх назви, а не моменти, які були підібрані для вашого відео автоматично.

Повний опис типу Clip наведено на сторінці schema.org/Clip.

Обов’язкові властивості
name

Text

Описова назва, що відображає зміст кліпу.

startOffset

Number

Час початку фрагмента, вказаний у секундах з початку відео.

url

URL

Посилання на час початку фрагмента.

URL фрагмента повинен мати той самий шлях URL, що і відео, і містити параметр, що вказує початок фрагмента.

Наприклад, з цієї URL видно, що фрагмент починається через дві хвилини (120 секунд) після початку відео:

"url": "https://www.example.com/example?t=120"
Рекомендовані властивості
endOffset

Number

Час закінчення фрагмента, вказаний у секундах від початку відео.

Щоб повідомити Google, як інтерпретувати ваші URL (для автоматичного визначення ключових моментів відео), додайте в об’єкт VideoObject перелічені нижче властивості. Додавати властивості SeekToAction не обов’язково, однак це потрібно робити, якщо ви хочете, щоб система Google розуміла структуру ваших URL і направляла глядачів до певних частин відео.

Повний опис типу SeekToAction наведено на сторінці schema.org/SeekToAction.

Обов’язкові властивості
potentialAction

SeekToAction

Позначає можливу дію. Додайте наступні вкладені властивості:

Приклад:

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "potentialAction" : {
    "@type": "SeekToAction",
    "target": "https://video.example.com/watch/videoID?t={seek_to_second_number}",
    "startOffset-input": "required name=seek_to_second_number"
  }
}
potentialAction.startOffset-input

Text

Рядок-плейсхолдер, який Google використовує як часову мітку і замінює на кількість секунд відео, які потрібно пропустити. Вкажіть наступне значення:

"startOffset-input": "required name=seek_to_second_number"

startOffset-input являє собою властивість з анотацією. Більш детальна інформація доступна на сторінці Potential Actions.

potentialAction.target

EntryPoint

URL сторінки з об’єктом VideoObject, що містить плейсхолдер, який визначає, куди Google буде підставляти кількість пропущених секунд відео. Так Google розпізнає структуру ваших URL і формат часових міток. Замініть частину URL, яка виступає в ролі часової мітки, на наступний рядок-плейсхолдер:

{seek_to_second_number}

Припустимо, URL з міткою часу має такий вигляд:

"target": "https://video.example.com/watch/videoID?t=30"

У цьому випадку властивість повинна мати наступне значення:

"target": "https://video.example.com/watch/videoID?t={seek_to_second_number}"

За допомогою Search Console ви можете збирати дані про ефективність сторінок вашого ресурсу в Пошуку Google. Вам не обов’язково реєструватися в цьому сервісі, щоб ваші сторінки потрапили в результати пошуку. Однак це дозволить дізнатися, як роботи Google сприймають сайт, і спростити їм його обробку. Рекомендуємо перевіряти інформацію в Search Console в наступних випадках:

  1. Після першого розміщення структурованих даних
  2. Після випуску нових шаблонів або оновлення коду
  3. При регулярному аналізі трафіку

Коли ваші сторінки будуть проіндексовані, перевірте їх на наявність помилок за допомогою звіту про стан розширених результатів. Бажано, щоб кількість об’єктів з правильною розміткою зросла, а кількість об’єктів з помилками — ні. Якщо в структурованих даних будуть виявлені помилки, вживайте наступних заходів:

  1. Усуньте проблеми в об’єктах.
  2. Перевірте виправлену сторінку, щоб дізнатися, чи виявляються помилки.
  3. Запитайте перевірку ресурсу, використовуючи звіт про стан розширених результатів.

Якщо ви внесли значні зміни на сайт, перевірте, чи не збільшилася кількість недійсних об’єктів, пов’язаних зі структурованими даними.

  • Збільшилася кількість недійсних об’єктів? Можливо, ви створили шаблон, з яким щось не так, або наявний шаблон використовується некоректно.
  • Кількість дійсних елементів зменшилася, але кількість недійсних не збільшилася? Можливо, на ваших сторінках не розміщені структуровані дані. З’ясувати, з чим пов’язані помилки, можна за допомогою інструменту перевірки URL.

Аналізувати трафік сайту з Google Пошуку можна за допомогою звіту про ефективність. З цього звіту ви дізнаєтеся, як часто сторінка з’являється в Пошуку у вигляді розширеного результату, з якою регулярністю користувачі натискають на неї і яка її середня позиція в результатах пошуку. Цю інформацію також можна автоматично отримати за допомогою Search Console API.

Якщо у вас виникли труднощі з додаванням або налагодженням структурованих даних, вам допоможуть ресурси та інформація, доступні за наведеними нижче посиланнями.