Видео спортивных событий

Для каких сайтов

Сайты, которые предоставляют легальный видео-контент, относящийся к спортивным событиям.

Что добавляет в результаты поиска

Добавляет блок с превью видео в ответы про матчи, команды и турниры, подходящие под запрос пользователя. Пользователь может перейти на страницу сайта партнера для просмотра видео.

Если несколько партнеров предоставили одинаковое видео, пользователь может выбрать источник.

Пример отображения (дизайн может меняться):

Как настроить

Передавать можно следующие типы видео:

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

Чтобы подключиться:

1. Подготовьте XML-файл в соответствии с форматом. Файл должен быть доступен по HTTP-запросу.
2. Убедитесь, что видео, страница, на которой оно размещено, и XML-файл отвечают условиям подключения.
3. Отправьте заявку на подключение файла по адресу sport-integrations@yandex-team.ru.

После того как файл пройдет модерацию в течение 30 дней, контент появится в результатах поиска. Если будут обнаружены ошибки, специалисты Яндекса напишут вам письмо. Внесите изменения и отправьте заявку снова.

Условия подключения

1. Партнер должен присылать в файле события, для которых есть отдельная страница на момент добавления в файл.
2. Ссылка должна вести на видео, для которого она указана в файле. Не допускаются ссылки на главную страницу сайта, раздел турнира, рубрику и т. д.
3. Стоимость контента должна быть указана без учета акций. Если вы используете бизнес-модель SVOD, укажите стоимость одного месяца подписки.
4. Партнет должен следить за актуальностью данных. Если трансляция будет отменена или удалена, укажите эту информацию в файле. Яндекс обновляет данные, полученные из файла, каждые 10 минут.
5. В случае нарушения любого пункта Яндекс имеет право приостановить интеграцию данных с уведомлением партнера.

Формат 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/@hidden	Признак удаления видео из результатов поиска и Яндекс Спорта.
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	Модель монетизации: SVOD — доступно по подписке; AVOD — доступно бесплатно с рекламой; EST — продажа; TVOD — аренда; FREE — доступно бесплатно без рекламы.
Атрибуты трансляций матчей (videoevents, paid_videoevents)
translations/translation/video/@status	Статус трансляции: not_started — не началась; in_progress — транслируется; finished — завершилась.
translations/translation/video/@start_time	Дата начала трансляции (UNIX-timestamp в секундах).
translations/translation/video/@finish_time	Дата окончания трансляции (UNIX-timestamp в секундах).
translations/translation/video/@has_record	Признак отображения трансляции после завершения события: 1 — да (по умолчанию); 0 — нет. Используйте, когда видео недоступно по прямой ссылке на вашем сайте сразу после завершения события. Если в файле одновременно указаны атрибуты 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/@hidden	Признак удаления видео из результатов поиска и Яндекс Спорта.
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	Модель монетизации: SVOD — доступно по подписке; AVOD — доступно бесплатно с рекламой; EST — продажа; TVOD — аренда; FREE — доступно бесплатно без рекламы.
Атрибуты трансляций матчей (videoevents, paid_videoevents)
translations/translation/video/@status	Статус трансляции: not_started — не началась; in_progress — транслируется; finished — завершилась.
translations/translation/video/@start_time	Дата начала трансляции (UNIX-timestamp в секундах).
translations/translation/video/@finish_time	Дата окончания трансляции (UNIX-timestamp в секундах).
translations/translation/video/@has_record	Признак отображения трансляции после завершения события: 1 — да (по умолчанию); 0 — нет. Используйте, когда видео недоступно по прямой ссылке на вашем сайте сразу после завершения события. Если в файле одновременно указаны атрибуты 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://yandex.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://yandex.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	Модель монетизации: SVOD — доступно по подписке; AVOD — доступно бесплатно с рекламой; EST — продажа; TVOD — аренда; FREE — доступно бесплатно без рекламы.

Атрибут	Описание
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	Модель монетизации: SVOD — доступно по подписке; AVOD — доступно бесплатно с рекламой; EST — продажа; TVOD — аренда; FREE — доступно бесплатно без рекламы.

Пример

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