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

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

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

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

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

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

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

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

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

Тип видео

Отображение в результатах поиска

Примечание

Матчи

Отображается в виде превью.

Для одного матча можно передать только одно видео такого типа.

Обзоры и яркие моменты

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

Для одного матча можно передать только одно видео такого типа.

Видео данного типа должны быть доступны по моделям FREE или AVOD, видео этих типов по моделям SVOD/TVOD не добавляются в результаты поиска.

Голы

Другие спортивные события

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

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

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

Модель монетизации:

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

Дата обновления страницы: 28.12.2023.




Также вы можете перейти на сервис