Видео спортивных событий
Для каких сайтов
Сайты, которые предоставляют легальный видео-контент, относящийся к спортивным событиям.
Что добавляет в результаты поиска
Добавляет блок с превью видео в ответы про матчи, команды и турниры, подходящие под запрос пользователя. Пользователь может перейти на страницу сайта партнера для просмотра видео.
Если несколько партнеров предоставили одинаковое видео, пользователь может выбрать источник.
Пример отображения (дизайн может меняться):
Как настроить
Передавать можно следующие типы видео:
| Тип видео | Отображение в результатах поиска | Примечание |
|---|---|---|
| Матчи | Отображается в виде превью. | Для одного матча можно передать только одно видео такого типа. |
| Обзоры и яркие моменты | Короткий ролик с яркими моментами матча и голами может встраиваться в карусель видео в результатах поиска спортивных событий. | Для одного матча можно передать только одно видео такого типа. Видео данного типа должны быть доступны по моделям FREE или AVOD, видео этих типов по моделям SVOD/TVOD не добавляются в результаты поиска. |
| Голы | ||
| Другие спортивные события | — |
| Тип видео | Отображение в результатах поиска | Примечание |
|---|---|---|
| Матчи | Отображается в виде превью. | Для одного матча можно передать только одно видео такого типа. |
| Обзоры и яркие моменты | Короткий ролик с яркими моментами матча и голами может встраиваться в карусель видео в результатах поиска спортивных событий. | Для одного матча можно передать только одно видео такого типа. Видео данного типа должны быть доступны по моделям FREE или AVOD, видео этих типов по моделям SVOD/TVOD не добавляются в результаты поиска. |
| Голы | ||
| Другие спортивные события | — |
Поиск основан на информации о спортивных событиях, поступающих от партнеров. Партнер может привязать видео-контент своего сайта к событиям, которые представлены в поисковой выдаче Яндекса.
Чтобы подключиться:
- Подготовьте XML-файл в соответствии с форматом. Файл должен быть доступен по HTTP-запросу.
- Убедитесь, что видео, страница, на которой оно размещено, и XML-файл отвечают условиям подключения.
- Отправьте заявку на подключение файла по адресу sport-integrations@yandex-team.ru.
После того как файл пройдет модерацию в течение 30 дней, контент появится в результатах поиска. Если будут обнаружены ошибки, специалисты Яндекса напишут вам письмо. Внесите изменения и отправьте заявку снова.
- Партнер должен присылать в файле события, для которых есть отдельная страница на момент добавления в файл.
- Ссылка должна вести на видео, для которого она указана в файле. Не допускаются ссылки на главную страницу сайта, раздел турнира, рубрику и т. д.
- Стоимость контента должна быть указана без учета акций. Если вы используете бизнес-модель SVOD, укажите стоимость одного месяца подписки.
- Партнер должен следить за актуальностью данных. Если трансляция будет отменена или удалена, укажите эту информацию в файле. Яндекс обновляет данные, полученные из файла, каждые 10 минут.
- В случае нарушения любого пункта Яндекс имеет право приостановить интеграцию данных с уведомлением партнера.
- запись остается доступной несколько дней на сайте партнера;
- запись доступна до окончания текущего контракта партнера с правообладателем видео-контента.
- SVOD — доступно по подписке;
- AVOD — доступно бесплатно с рекламой;
- EST — продажа;
- TVOD — аренда;
- FREE — доступно бесплатно без рекламы.
- not_started — не началась;
- in_progress — транслируется;
- finished — завершилась.
- 1 — да (по умолчанию);
- 0 — нет.
- запись остается доступной несколько дней на сайте партнера;
- запись доступна до окончания текущего контракта партнера с правообладателем видео-контента.
- SVOD — доступно по подписке;
- AVOD — доступно бесплатно с рекламой;
- EST — продажа;
- TVOD — аренда;
- FREE — доступно бесплатно без рекламы.
- not_started — не началась;
- in_progress — транслируется;
- finished — завершилась.
- 1 — да (по умолчанию);
- 0 — нет.
- SVOD — доступно по подписке;
- AVOD — доступно бесплатно с рекламой;
- EST — продажа;
- TVOD — аренда;
- FREE — доступно бесплатно без рекламы.
- SVOD — доступно по подписке;
- AVOD — доступно бесплатно с рекламой;
- EST — продажа;
- TVOD — аренда;
- FREE — доступно бесплатно без рекламы.
Условия подключения
Формат XML-файла
| Общие атрибуты | ||
|---|---|---|
| Атрибут | Описание | Обязательно |
| translations/translation/@id | Идентификатор видео. | Да |
| translations/translation/@competition_id | Идентификатор турнира. Обязателен, если не указан идентификатор матча. См. идентификаторы спортивных событий. | Нет |
| translations/translation/@event_id | Идентификатор матча. Обязателен для видео матчей. См. идентификаторы спортивных событий. | Да |
| translations/translation/title | Название видео. | Да |
| translations/translation/video/@duration | Продолжительность видео в формате [ЧЧ:]ММ:СС. | Да |
| translations/translation/video/@img | URL картинки для превью. | Да |
| translations/translation/video/@priority | Приоритет видео (от 0 до 99). Может использоваться для управления ранжированием видео в рамках одного типа. На ранжирование видео других партнеров этот атрибут не влияет. | Нет |
| translations/translation/video/@restriction_age | Возрастное ограничение. Числовое значение, например 12. | Нет |
| translations/translation/video/@hide_after | Дата, после которой необходимо скрыть видео (UNIX-timestamp в секундах). Атрибут обязателен, если: Не указывайте атрибут, если контракт не предусматривает дату окончания прав. | Нет |
| translations/translation/video/link | URL страницы видео на сайте партнера. | Да |
| translations/translation/video/embedded/@url | URL для вставки в iframe. | Нет |
| translations/translation/video/pricing | Список способов оплаты. Учитываются бизнес-модели SVOD, EST, TVOD. | Да |
| translations/translation/video/pricing/option/@name | Название тарифа. | Нет |
| translations/translation/video/pricing/option/@currency | Код валюты для оплаты. | Нет |
| translations/translation/video/pricing/option/@price | Стоимость. В качестве разделителя используйте точку (.). | Нет |
| translations/translation/video/pricing/option/@url | URL страницы с условиями тарифа. | Нет |
| translations/translation/video/pricing/option/ @monetization_model | Модель монетизации: | Да |
| Атрибуты трансляций матчей (videoevents, paid_videoevents) | ||
| translations/translation/video/@status | Статус трансляции: | Да |
| translations/translation/video/@start_time | Дата начала трансляции (UNIX-timestamp в секундах). | Да |
| translations/translation/video/@finish_time | Дата окончания трансляции (UNIX-timestamp в секундах). | Нет |
| translations/translation/video/@has_record | Признак отображения трансляции после завершения события: Используйте, когда видео недоступно по прямой ссылке на вашем сайте сразу после завершения события. Если в файле одновременно указаны атрибуты has_record и hide_after, приоритет у has_record. | Нет |
| Общие атрибуты | ||
|---|---|---|
| Атрибут | Описание | Обязательно |
| translations/translation/@id | Идентификатор видео. | Да |
| translations/translation/@competition_id | Идентификатор турнира. Обязателен, если не указан идентификатор матча. См. идентификаторы спортивных событий. | Нет |
| translations/translation/@event_id | Идентификатор матча. Обязателен для видео матчей. См. идентификаторы спортивных событий. | Да |
| translations/translation/title | Название видео. | Да |
| translations/translation/video/@duration | Продолжительность видео в формате [ЧЧ:]ММ:СС. | Да |
| translations/translation/video/@img | URL картинки для превью. | Да |
| translations/translation/video/@priority | Приоритет видео (от 0 до 99). Может использоваться для управления ранжированием видео в рамках одного типа. На ранжирование видео других партнеров этот атрибут не влияет. | Нет |
| translations/translation/video/@restriction_age | Возрастное ограничение. Числовое значение, например 12. | Нет |
| translations/translation/video/@hide_after | Дата, после которой необходимо скрыть видео (UNIX-timestamp в секундах). Атрибут обязателен, если: Не указывайте атрибут, если контракт не предусматривает дату окончания прав. | Нет |
| translations/translation/video/link | URL страницы видео на сайте партнера. | Да |
| translations/translation/video/embedded/@url | URL для вставки в iframe. | Нет |
| translations/translation/video/pricing | Список способов оплаты. Учитываются бизнес-модели SVOD, EST, TVOD. | Да |
| translations/translation/video/pricing/option/@name | Название тарифа. | Нет |
| translations/translation/video/pricing/option/@currency | Код валюты для оплаты. | Нет |
| translations/translation/video/pricing/option/@price | Стоимость. В качестве разделителя используйте точку (.). | Нет |
| translations/translation/video/pricing/option/@url | URL страницы с условиями тарифа. | Нет |
| translations/translation/video/pricing/option/ @monetization_model | Модель монетизации: | Да |
| Атрибуты трансляций матчей (videoevents, paid_videoevents) | ||
| translations/translation/video/@status | Статус трансляции: | Да |
| translations/translation/video/@start_time | Дата начала трансляции (UNIX-timestamp в секундах). | Да |
| translations/translation/video/@finish_time | Дата окончания трансляции (UNIX-timestamp в секундах). | Нет |
| translations/translation/video/@has_record | Признак отображения трансляции после завершения события: Используйте, когда видео недоступно по прямой ссылке на вашем сайте сразу после завершения события. Если в файле одновременно указаны атрибуты has_record и hide_after, приоритет у has_record. | Нет |
Пример
<translations>
<translation id="9e45ccf6035b5120ac92b6a328b9378b" competition_id="113475" event_id="m545018">
<title>Коринтианс — Жувентуде</title>
<video duration="02:20:00" img="//avatars.mds.yandex.net/get-ott/223007/90825590902296/orig" status="finished" hidden="0" start_time="1654975500">
<link>https://hd.kinopoisk.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378b</link>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
<pricing>
<option name="Плюс" currency="RUB" price="660.24" url="https://yandex.ru/legal/kinopoisk_vod/" monetization_model="SVOD" />
<option name="Плюс с Амедиатекой" currency="RUB" price="254.00" url="https://yandex.ru/legal/kinopoisk_vod/" monetization_model="SVOD" />
</pricing>
</video>
</translation>
<translation id="9e45ccf6035b5120ac92b6a328b9378b" competition_id="113475" event_id="m545018">
<title>Сент-Этьен - Брест</title>
<video duration="02:25:00" img="//avatars.mds.yandex.net/get-ott/223007/5588372664/orig" status="finished" hidden="0" start_time="1654975500">
<link>https://hd.kinopoisk.ru/sport/event/m545039?uuid=9e45ccf6035b5120ac92b6a328b9378b</link>
<pricing>
<option monetization_model="FREE" />
</pricing>
</video>
</translation>
</translations>| Атрибут | Описание |
|---|---|
| events/event/@id | Идентификатор матча. См. идентификаторы спортивных событий. |
| events/goal/@id | Порядковый номер гола. |
| events/goal/@video | URL страницы видео. |
| events/goal/@img | URL картинки для превью. |
| events/goal/@hide_after | Дата, после которой необходимо скрыть видео (UNIX-timestamp в секундах). |
| events/goal/@restriction_age | Возрастное ограничение. Числовое значение, например 12. |
| events/goal/title | Название видео. |
| events/goal/embedded/@url | URL для вставки в iframe. |
| events/goal/pricing | Список способов оплаты в разрезе моделей монетизации SVOD, EST, TVOD. |
| events/goal/pricing/option/@name | Название тарифа. |
| events/goal/pricing/option/@currency | Код валюты для оплаты. |
| events/goal/pricing/option/@price | Стоимость. В качестве разделителя используйте точку (.). |
| events/goal/pricing/option/@url | URL страницы с условиями тарифа. |
| events/goal/pricing/option/@monetization_model | Модель монетизации: |
| Атрибут | Описание |
|---|---|
| events/event/@id | Идентификатор матча. См. идентификаторы спортивных событий. |
| events/goal/@id | Порядковый номер гола. |
| events/goal/@video | URL страницы видео. |
| events/goal/@img | URL картинки для превью. |
| events/goal/@hide_after | Дата, после которой необходимо скрыть видео (UNIX-timestamp в секундах). |
| events/goal/@restriction_age | Возрастное ограничение. Числовое значение, например 12. |
| events/goal/title | Название видео. |
| events/goal/embedded/@url | URL для вставки в iframe. |
| events/goal/pricing | Список способов оплаты в разрезе моделей монетизации SVOD, EST, TVOD. |
| events/goal/pricing/option/@name | Название тарифа. |
| events/goal/pricing/option/@currency | Код валюты для оплаты. |
| events/goal/pricing/option/@price | Стоимость. В качестве разделителя используйте точку (.). |
| events/goal/pricing/option/@url | URL страницы с условиями тарифа. |
| events/goal/pricing/option/@monetization_model | Модель монетизации: |
Пример
<events>
<event id="m545018">
<goal id="1" video="https://yandex.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378b" img="//avatars.mds.yandex.net/get-ott/223007/908255909022">
<title>Коринтианс — Жувентуде. 1 - 0</title>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
</goal>
<goal id="2" video="https://yandex.ru/sport/event/m545020?uuid=9e45ccf6035b5120ac92b6a328b9378c" img="//avatars.mds.yandex.net/get-ott/223007/908255909023">
<title>Коринтианс — Жувентуде. 1 - 1</title>
<embedded url="https://frontend.vh.yandex.ru/player/9e45ccf6035b5120ac92b6a328b9378b"/>
</goal>
</event>
</events>Идентификаторы спортивных событий
Список доступных идентификаторов можно посмотреть в Справочнике событий.
Удаление видео
Чтобы удалить видео из результатов поиска, добавьте в XML-файл атрибут hidden="1" для конкретного видео (см. translations/translation/video/@hidden).
Дата обновления страницы: 28.12.2023.
- Удалена возможность совместного использования данных с Яндекс Спортом.
История изменений
Подписаться на обновления
