Рекомендации событий β
Для каких сайтов
Это старая версия документа, которая прекратила свое действие 20.11.2023 г. Действующая версия размещена по адресу: https://yandex.ru/support/webmaster/search-appearance/activities.html
Для сайтов-агрегаторов развлекательных услуг с возможностью покупки билетов на сервисе.
Что добавляет в результаты поиска
Ответ с информацией о рекомендуемых пользователю местах и событиях, включая дату и время проведения, а также стоимость билетов.
Пример отображения (дизайн может меняться):
Как настроить
- Фида в формате YML (приоритетный тип интеграции). Стандарт YML разработан Яндексом и основан на стандарте XML. Фид — это файл, в котором вы передаете информацию о событиях.
- вашего API.
Чтобы передать фид, обсудить порядок подключения вашего сайта к ответам и возможность использования API, напишите по адресу partner-features-planned@yandex-team.ru.
Условия могут быть уточнены по итогам эксперимента.
- actor;
- artist;
- director;
- writer;
- performer;
- author;
- composer;
- choreographer;
- screenwriter;
- musician;
- conductor;
- operator;
- other.
- actor;
- artist;
- director;
- writer;
- performer;
- author;
- composer;
- choreographer;
- screenwriter;
- musician;
- conductor;
- operator;
- other.
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
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 | Роль участника события. Используется для построения персональных рекомендаций. Список поддерживаемых значений Незнакомые роли интерпретируются как other. | Нет |
slug | String | Часть пути URL, уникальная для каждого участника события. | Нет |
url | String | Ссылка на страницу участника события на сервисе. | Нет |
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
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 | Роль участника события. Используется для построения персональных рекомендаций. Список поддерживаемых значений Незнакомые роли интерпретируются как other. | Нет |
slug | String | Часть пути URL, уникальная для каждого участника события. | Нет |
url | String | Ссылка на страницу участника события на сервисе. | Нет |
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
is_free | Boolean | Признак бесплатного события. Используется для фильтрации событий и для построения рекомендаций. | Да |
is_online | Boolean | Признак онлайн-события. Используется для фильтрации событий и для построения рекомендаций. | Да |
age_restriction | String | Возрастное ограничение. Отображается в превью и подробной информации о событии. Возможные значения: 0+, 6+, 12+, 16+, 18+. | Да |
schedule | List[Struct] | Расписание события, например для спектаклей или концертов. Время расписания для офлайн-событий — местное, для онлайн — UTC. Используется для навигации по событиям. Пример структуры | Да |
Элементы внутри schedule | Тип | Описание | Обязательно |
start_date | String | Используется для выбора событий за конкретную дату или интервал. Дата начала события по местному времени, в формате Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
start_time | String | Используется для выбора событий за конкретную дату или интервал. Время начала события по местному времени, в формате Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
end_date | String | Используется для выбора событий за конкретную дату или интервал. Дата конца события по местному времени, в формате Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
end_time | String | Используется для выбора событий за конкретную дату или интервал. Время конца события по местному времени, в формате Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
prices | List[Float] | Используется для выбора событий по цене и для построения рекомендаций. Список цен на билеты на выбранное расписание. Для продолжительных событий достаточно указать список всех цен, без уточнения в разные дни недели. Цены — это дробные числа, с точностью до двух знаков, после запятой. | Нет |
has_tickets | Boolean | Есть ли еще билеты на данное событие. Используется для навигации по событиям. По умолчанию | Нет |
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
is_free | Boolean | Признак бесплатного события. Используется для фильтрации событий и для построения рекомендаций. | Да |
is_online | Boolean | Признак онлайн-события. Используется для фильтрации событий и для построения рекомендаций. | Да |
age_restriction | String | Возрастное ограничение. Отображается в превью и подробной информации о событии. Возможные значения: 0+, 6+, 12+, 16+, 18+. | Да |
schedule | List[Struct] | Расписание события, например для спектаклей или концертов. Время расписания для офлайн-событий — местное, для онлайн — UTC. Используется для навигации по событиям. Пример структуры | Да |
Элементы внутри schedule | Тип | Описание | Обязательно |
start_date | String | Используется для выбора событий за конкретную дату или интервал. Дата начала события по местному времени, в формате Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
start_time | String | Используется для выбора событий за конкретную дату или интервал. Время начала события по местному времени, в формате Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
end_date | String | Используется для выбора событий за конкретную дату или интервал. Дата конца события по местному времени, в формате Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
end_time | String | Используется для выбора событий за конкретную дату или интервал. Время конца события по местному времени, в формате Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
prices | List[Float] | Используется для выбора событий по цене и для построения рекомендаций. Список цен на билеты на выбранное расписание. Для продолжительных событий достаточно указать список всех цен, без уточнения в разные дни недели. Цены — это дробные числа, с точностью до двух знаков, после запятой. | Нет |
has_tickets | Boolean | Есть ли еще билеты на данное событие. Используется для навигации по событиям. По умолчанию | Нет |
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
place | Struct | Информация о месте проведения. Пример | Да |
Элементы внутри 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] | Список телефонов организаторов события. | Нет |
Элемент | Тип | Описание | Обязательно |
---|---|---|---|
place | Struct | Информация о месте проведения. Пример | Да |
Элементы внутри 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.