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

  1. Для каких сайтов
  2. Что добавляет в результаты поиска
  3. Как настроить
  4. Условия

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

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

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

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

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

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



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

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

Чтобы передать фид, обсудить порядок подключения вашего сайта к ответам и возможность использования API, напишите по адресу [email protected].

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

Формат фида
Элемент Тип Описание Обязательно
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 Ссылка на страницу участника события на сервисе. Нет
Элемент Тип Описание Обязательно
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 .

 Нет
Элемент Тип Описание Обязательно
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] Список телефонов организаторов события. Нет
Элемент Тип Описание Обязательно
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.