Рекомендации событий β

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

Это старая версия документа, которая прекратила свое действие 20.11.2023 г. Действующая версия размещена по адресу: https://yandex.ru/support/webmaster/search-appearance/activities.html

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

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

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

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

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

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

  • Фида в формате YML (приоритетный тип интеграции). Стандарт YML разработан Яндексом и основан на стандарте XML. Фид — это файл, в котором вы передаете информацию о событиях.
  • вашего API.

Чтобы передать фид, обсудить порядок подключения вашего сайта к ответам и возможность использования API, напишите по адресу partner-features-planned@yandex-team.ru.

Условия могут быть уточнены по итогам эксперимента.

Формат фида

Элемент

Тип

Описание

Обязательно

id

String

Уникальный идентификатор события. Используется для построения рекомендаций.

Да

title

String

Название события на русском языке. Отображается на превью события в сервисе и в подробной информации.

Да

title_short

String

Короткое название события на русском языке. Для отображается на превью события в сервисе.

Нет

description

String

Полное описание события с HTML-разметкой. Отображается в подробной информации о событии.

Да

description_short

String

Короткое описание события с HTML-разметкой. Временно не используется.

Нет

url

String

Ссылка на страницу события.

Например: https://kudago.com/msk/event/teatr-vernuvshiesya-inaya-realnost/.

Да

offer_url

String

Ссылка для покупки билетов на событие. Используется для перехода на покупку билетов. Если поле не задано, то используется ссылка на страницу события (url).

Нет

tags

List[String]

Используется для фильтрации событий и построения персональных рекомендаций.

Да

images

List[String]

Список ссылок на оригинальные изображения события. Первое изображение используется в качестве превью в карточке события. Остальные изображения доступны в подробном описании события.

Да

videos

List[String]

Список ссылок на видео о событии. Первое видео используется в качестве превью в карточке события. Остальные видео доступны в подробном описании события.

Нет

participants

List[Struct]

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

Нет

Элементы внутри participants

Тип

Описание

Обязательно

name

String

Фамилия и имя участника события. Используется для построения персональных рекомендаций.

Да

id

String

Уникальный идентификатор участника события. Используется для того, чтобы отличать полных тезок.

Нет

role

String

Роль участника события. Используется для построения персональных рекомендаций.

Список поддерживаемых значений
  • actor;
  • artist;
  • director;
  • writer;
  • performer;
  • author;
  • composer;
  • choreographer;
  • screenwriter;
  • musician;
  • conductor;
  • operator;
  • other.

Незнакомые роли интерпретируются как other.

Нет

slug

String

Часть пути URL, уникальная для каждого участника события.

Нет

url

String

Ссылка на страницу участника события на сервисе.

Нет

Элемент

Тип

Описание

Обязательно

is_free

Boolean

Признак бесплатного события. Используется для фильтрации событий и для построения рекомендаций.

Да

is_online

Boolean

Признак онлайн-события. Используется для фильтрации событий и для построения рекомендаций.

Да

age_restriction

String

Возрастное ограничение. Отображается в превью и подробной информации о событии. Возможные значения: 0+, 6+, 12+, 16+, 18+.

Да

schedule

List[Struct]

Расписание события, например для спектаклей или концертов.

Время расписания для офлайн-событий — местное, для онлайн — UTC. Используется для навигации по событиям.

Пример структуры
{
    "start_date": "2023-02-28",
    "start_time": "16:00:00",
    "end_date": "2023-02-28",
    "end_time": "18:00:00",
    "has_tickets": true,
    "prices": [
        1000
    ]
 }

Да

Элементы внутри schedule

Тип

Описание

Обязательно

start_date

String

Используется для выбора событий за конкретную дату или интервал. Дата начала события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-17.

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

Нет

start_time

String

Используется для выбора событий за конкретную дату или интервал. Время начала события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00.

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

Нет

end_date

String

Используется для выбора событий за конкретную дату или интервал. Дата конца события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-17.

Может быть пустым для непродолжительных событий, например для спектаклей.

Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок.

Нет

end_time

String

Используется для выбора событий за конкретную дату или интервал. Время конца события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00.

Может быть пустым для непродолжительных событий, например для спектаклей.

Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок.

Нет

prices

List[Float]

Используется для выбора событий по цене и для построения рекомендаций.

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

Цены — это дробные числа, с точностью до двух знаков, после запятой.

Нет

has_tickets

Boolean

Есть ли еще билеты на данное событие. Используется для навигации по событиям.

По умолчанию true.

Нет

Элемент

Тип

Описание

Обязательно

place

Struct

Информация о месте проведения.

Пример
"place": {
    "id": "32159",
    "title": "Особняк Дашков, 5",
    "lon": 37.5858781,
    "lat": 55.7375514,
    "city": "Москва",
    "address": "Москва, Дашков пер., д. 5.",
    "timezone": "Europe/Moscow",
    "currency": "RUB",
    "urls": [
        "https://kudago.com/msk/place/dostoprimechatelnost-osobnyak-dashkov-5/"
    ],
    "phones": [
        "212-85-06"
    ]
 }

Да

Элементы внутри place

Тип

Описание

Обязательно

id

String

Уникальный идентификатор места проведения. Используется для построения персональных рекомендаций.

Нет

title

String

Название места проведения. Отображается в подробной информации о событии.

Да

currency

String

Валюта места проведения в формате ISO-4217. По умолчанию RUB.

Нет

timezone

String

Временная зона места проведения в формате IANA. По умолчанию Europe/Moscow.

Нет

lon

Float

Долгота места проведения.

Нет

lat

Float

Широта места проведения.

Нет

city

String

Город места проведения.

Да

address

String

Полный адрес места проведения: населенный пункт, улица, дом. Отображается в подробном описании события.

Да

urls

List[String]

Список ссылок на сайты места проведения. В список можно добавить, например, ссылку на место проведения на вашем сервисе, ссылку на страницу места проведения в социальной сети, на собственный сайт места проведения.

Нет

phones

List[String]

Список телефонов организаторов события.

Нет

Условия

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

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




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