Рекомендации событий β
Для каких сайтов
Для сайтов, продающих билеты на развлекательные услуги: сайты, которые продают билеты на собственные события, и сайты-агрегаторы с возможностью покупки билетов на сервисе.
Что добавляет в результаты поиска
Ответ с информацией о рекомендуемых пользователю местах и событиях, включая дату и время проведения.
Пример отображения (дизайн может меняться):
Как настроить
Чтобы ваши предложения попадали в такие ответы, необходимо передавать Яндексу актуальную информацию о них. Для этого нужно подготовить и разместить на своем сайте фид в формате YML и передать ссылку на него в Вебмастере. Стандарт YML разработан Яндексом и основан на стандарте XML.
Названия элементов shop и offer нужны для обратной совместимости с YML-фидами и не несут дополнительной смысловой нагрузки.
| Размер YML-файла | 200 МБ |
| Общее количество изображений | 50 000 |
| Количество изображений в одном элементе offer | 200 |
| Количество элементов offer | 30 000. Данные из фида, который содержит больше предложений, для дополнительного представления использованы не будут. Сам фид загрузится с ошибкой. Чтобы предложения участвовали в поиске, разбейте фид на несколько частей. Не дублируйте предложения с одним и тем же URL-адресом в нескольких фидах, а также не переносите предложения из одного фида в другой — данные из перенесенного предложения могут временно пропасть из поиска. |
| Количество элементов set | 1 млн |
| Количество всех YML-файлов (фиды услуг и предложений, RSS для контентных Турбо-страниц) суммарно для сайта и его поддоменов | 1000 |
| Размер YML-файла | 200 МБ |
| Общее количество изображений | 50 000 |
| Количество изображений в одном элементе offer | 200 |
| Количество элементов offer | 30 000. Данные из фида, который содержит больше предложений, для дополнительного представления использованы не будут. Сам фид загрузится с ошибкой. Чтобы предложения участвовали в поиске, разбейте фид на несколько частей. Не дублируйте предложения с одним и тем же URL-адресом в нескольких фидах, а также не переносите предложения из одного фида в другой — данные из перенесенного предложения могут временно пропасть из поиска. |
| Количество элементов set | 1 млн |
| Количество всех YML-файлов (фиды услуг и предложений, RSS для контентных Турбо-страниц) суммарно для сайта и его поддоменов | 1000 |
- Перейдите в Вебмастер на страницу .
- Нажмите кнопку Загрузить фид.
- Выберите категорию бизнеса Чем заняться.
- Укажите регион. Например, если предложения в фиде доступны на одинаковых условиях во всех регионах, выберите Россия.
В поле Ссылка на файл с предложениями укажите URL вида https://example.com/feed.yml.
Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: http://yandex:WE9h4FfBml@example.com/feed.yml.
- Нажмите Готово.
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<yml_catalog date="2023-11-02T15:30">
<shop>
<name>MyActivities</name>
<url>https://activities.s3.yandex.net</url>
<picture>https://activities.s3.yandex.net/logo.png</picture>
<categories>
<category id= "1">Другое</category>
<category id= "2">Концерт</category>
<category id= "3">Театр</category>
<category id= "4">Встреча</category>
<category id= "5">Выставка</category>
<category id= "6">Спектакль</category>
<category id= "7">Кино</category>
<category id= "8">мастер-класс</category>
<category id= "9">Лекция</category>
<category id="10">Вечеринка</category>
<category id="11">Шоу</category>
<category id="12">Фестиваль</category>
<category id="13">Кинопоказ</category>
<category id="14">Экскурсия</category>
<category id="15">Игры</category>
<category id="16">Спорт</category>
<category id="17">Стендап</category>
<category id="18">Кукольный спектакль</category>
<category id="19">Балет</category>
<category id="20">Конкурс</category>
<category id="21">Музыкальный спектакль</category>
<category id="22">Опера</category>
<category id="23">Творческий вечер</category>
<category id="24">Литературные чтения</category>
<category id="25">Квест</category>
<category id="26">Курс</category>
<category id="27">Мюзикл</category>
<category id="28">Тренинг</category>
<category id="29">Дискуссия</category>
<category id="30">Моноспектакль</category>
<category id="31">Ёлки</category>
<category id="32">Семинар</category>
<category id="33">Ярмарка</category>
<category id="34">Пластический спектакль</category>
<category id="35">Презентация</category>
<category id="36">Перформанс</category>
<category id="37">Цирк</category>
<category id="38">Литературный вечер</category>
<category id="39">Конференция</category>
<category id="40">Оперетта</category>
<category id="41">Дегустация</category>
<category id="42">Читка пьесы</category>
<category id="43">Иммерсивный театр</category>
<category id="44">Водные прогулки</category>
<category id="45">Квест-игра</category>
<category id="46">Флешмоб</category>
<category id="47">Бал</category>
<category id="48">соревнование</category>
<category id="49">Онлайн-трансляции</category>
<category id="50">Аудиоспектакль</category>
<category id="51">Аттракционы</category>
<category id="52">Катки</category>
<category id="53">Кастинг</category>
<category id="54">Городские праздники</category>
</categories>
<offers>
<!-- Valid offer expample -->
<offer id="unique-offer-id">
<categoryId>7</categoryId>
<currencyId>RUB</currencyId>
<price>100</price>
<name>Семь психопатов</name>
<description>Криминальная комедия режиссёра Мартина Макдоны, известного по фильмам «Залечь на дно в Брюгге» и «Однажды в Ирландии».</description>
<url>https://activities.s3.yandex.net/movie/sem-psihopatov?utm_source=yandex-what-to-do&utm_medium=msk</url>
<picture>https://activities.s3.yandex.net/images/movie/poster/c9/98/poster1.jpg</picture>
<picture>https://activities.s3.yandex.net/images/movie/8c/bc/screenshot1.jpg</picture>
<picture>https://activities.s3.yandex.net/images/movie/c6/48/screenshot2.jpg</picture>
<param name="short_name"></param>
<param name="short_descritpion"></param>
<param name="event_id">2934</param>
<param name="tags">кино;комедия</param>
<param name="participants">Колин Фаррелл,actor;Вуди Харрельсон,actor;Мартин Макдона,director</param>
<param name="age_restriction">18+</param>
<param name="videos"></param>
<param name="is_free">false</param>
<param name="is_online">false</param>
<param name="has_tickets">true</param>
<param name="place_name">кинотеатр «Пять звёзд» на Новокузнецкой</param>
<param name="place_address">Москва, пер. Большой Овчинниковский, д. 16</param>
<param name="place_city">Москва</param>
<param name="place_country_code">RU</param>
<param name="place_lon">37.63013889999958</param>
<param name="place_lat">55.74446700000007</param>
<param name="place_timezone">Europe/Moscow</param>
<param name="place_phones">8(495)212-85-06;8(495)212-85-07</param>
<param name="place_urls">https://5zvezd.ru/;https://activities.s3.yandex.net/cinemas/123</param>
<param name="start_date">2023-11-02</param>
<param name="start_time">21:55:00</param>
<param name="prices">100;200;300</param>
<param name="duration_min">110</param>
</offer>
</offers>
</shop>
</yml_catalog>| Элемент | Тип | Описание | Обязательно |
|---|---|---|---|
| name | String | Название источника. Отображается в списке цен и в подписи описания события. | Да |
| url | String | Ссылка на сайт источника. Домен должен совпадать с доменом события (offer). | Да |
| picture | String | Ссылка на логотип источника. Отображается рядом с именем источника в списке цен. Рекомендуемый размер — 32 × 32 пикселей, рекомендуемый формат — PNG. Размер влияет на качество отображения в поиске. | Да |
| categories | List[String] | Список категорий в фиде. Категория — это общее описание события, формат его проведения. Примерами категории могут быть: Кино, Спектакль, Концерт, Мастер-класс. Категория определяет раздел, в который попадет событие, и влияет на качество рекомендаций. Для события может быть только одна категория. С помощью тегов можно дать более точную характеристику события. Можно взять категории и их categoryId из примера фида. Категории, для которых отсутствуют события в вашем фиде, добавлять не надо. | Да |
| Элемент | Тип | Описание | Обязательно |
|---|---|---|---|
| name | String | Название источника. Отображается в списке цен и в подписи описания события. | Да |
| url | String | Ссылка на сайт источника. Домен должен совпадать с доменом события (offer). | Да |
| picture | String | Ссылка на логотип источника. Отображается рядом с именем источника в списке цен. Рекомендуемый размер — 32 × 32 пикселей, рекомендуемый формат — PNG. Размер влияет на качество отображения в поиске. | Да |
| categories | List[String] | Список категорий в фиде. Категория — это общее описание события, формат его проведения. Примерами категории могут быть: Кино, Спектакль, Концерт, Мастер-класс. Категория определяет раздел, в который попадет событие, и влияет на качество рекомендаций. Для события может быть только одна категория. С помощью тегов можно дать более точную характеристику события. Можно взять категории и их categoryId из примера фида. Категории, для которых отсутствуют события в вашем фиде, добавлять не надо. | Да |
Предложение — это отдельный элемент расписания. Он должен содержать информацию о событии, о месте и времени проведения. Если это длительное событие, например, выставка, то достаточно указать время окончания события: param name="end_date" . Если событие неоднократное, то следует создать несколько предложений с одинаковым param name="event_id" и другими полями, но с отличающимся расписанием.
| Элемент | Тип | Описание | Обязательно |
|---|---|---|---|
| categoryId | Int | Идентификатор категории события. Берется из списка categories в описании shop. Используется для категоризации, фильтрации и релевантных рекомендаций событий. | Да |
| currencyId | String | Символьный код валюты в формате ISO 4217. Например: USD, RUB, EUR. | Да |
| price | Float | Минимальная цена билетов на событие. Если вход бесплатный, укажите 0 и в значение param name="is_free" укажите true. Если указан только 0, цена считается неопределенной. | Да |
| name | String | Название события на русском языке. Отображается в превью события и в подробной информации. | Да |
| description | String | Полное описание события с HTML-разметкой. Отображается в подробной информации о событии. | Да |
| url | String | Ссылка на страницу события. Например: https://kudago.com/msk/event/teatr-vernuvshiesya-inaya-realnost/. | Да |
| picture | String | Ссылки на оригинальные изображения события. | Да |
| param name="short_name" | String | Короткое название события на русском языке. Отображается на превью события в поиске. | Нет |
| param name="short_description" | String | Короткое описание события с HTML-разметкой. Пока не используется. | Нет |
| param name="event_id" | String | Уникальный идентификатор события. Используется для построения рекомендаций. | Да |
| param name="tags" | String | Список тегов события, разделенных точкой с запятой, например: мелодрама;комедия. Используется для фильтрации событий и построения персональных рекомендаций. Теги влияют на качество рекомендаций. Событие с большим количеством общих тегов может проиграть более специфичным событиям в выбранной пользователем категории. Событие с очень специфичными тегами может не найти свою аудиторию. | Нет |
| param name="participants" | String | Список участников события в формате: Имя участника 1,Роль участника 1;Имя участника 2,Роль участника 2. Например: Колин Фаррелл,actor;Вуди Харрельсон,actor;Мартин Макдона,director. | Нет |
| param name="age_restriction" | String | Возрастное ограничение. Отображается в превью и подробной информации о событии. Возможные значения: 0+, 6+, 12+, 16+, 18+. | Да |
| param name="videos" | String | Список ссылок на видео о событии. Первое видео используется в качестве превью в карточке события. Остальные видео доступны в подробном описании события. | Нет |
| param name="is_free" | Boolean | Признак бесплатного события. Используется для фильтрации событий и для построения рекомендаций. Значение по умолчанию — false. | Нет |
| param name="is_online" | Boolean | Признак онлайн-события. Используется для фильтрации событий и для построения рекомендаций. | Нет |
| param name="has_tickets" | Boolean | Доступна ли покупка билетов на данное событие. Если вход свободный, укажите true. Значение по умолчанию — true. | Нет |
| param name="place_name" | String | Название места проведения. Отображается в подробной информации о событии. | Да |
| param name="place_address" | String | Полный адрес места проведения: населенный пункт, улица, дом. Отображается в подробной информации о событии. | Да |
| param name="place_city" | String | Город места проведения. | Да |
| param name="place_country_code" | String | Код страны места проведения в формате ISO-3166 apha-2. Сейчас поддерживается только регион RU. | Да |
| param name="place_lon" | Float | Долгота места проведения. Используется для отображения точки на карте. | Нет |
| param name="place_lat" | Float | Широта места проведения. Используется для отображения точки на карте. | Нет |
| param name="place_timezone" | String | Временная зона места проведения в формате IANA. | Да |
| param name="place_phones" | String | Список телефонов организаторов события. | Нет |
| parma name="place_urls" | String | Список ссылок на сайты места проведения. В список можно добавить, например, ссылку на место проведения на вашем сервисе, ссылку на страницу места проведения в социальной сети, на собственный сайт места проведения. | Нет |
| param name="start_date" | String | Дата начала события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-07. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет только при условии заданного поля param name="end_date", иначе событие отображаться не будет. |
| param name="start_time" | String | Время начала события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
| param name=”duration_min” | Int | Длительность события в минутах. | Нет |
| param name="end_date" | String | Дата конца события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-17. Используется для выбора событий за конкретную дату или интервал. Это поле особенно важно для корректной фильтрации продолжительных событий, например выставок. Может быть пустым для непродолжительных событий, например для спектаклей. | Нет только при условии заданного поля param name="start_date", иначе событие отображаться не будет. |
| param name="end_time" | String | Время конца события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
| param name="prices" | Float | Список цен билетов на это время в этом месте. Список целых чисел, разделённых точкой с запятой, например: 100;200;300. Используется для выбора событий по цене и для построения рекомендаций. Для продолжительных событий достаточно указать список всех цен, без уточнения в разные дни недели. Цены — это дробные числа, с точностью до двух знаков, после запятой. | Нет |
| param name="offer_url" | String | Ссылка для покупки билетов на событие. Используется для перехода на покупку билетов. Если поле не задано, то используется ссылка на страницу события (url). | Нет |
| Элемент | Тип | Описание | Обязательно |
|---|---|---|---|
| categoryId | Int | Идентификатор категории события. Берется из списка categories в описании shop. Используется для категоризации, фильтрации и релевантных рекомендаций событий. | Да |
| currencyId | String | Символьный код валюты в формате ISO 4217. Например: USD, RUB, EUR. | Да |
| price | Float | Минимальная цена билетов на событие. Если вход бесплатный, укажите 0 и в значение param name="is_free" укажите true. Если указан только 0, цена считается неопределенной. | Да |
| name | String | Название события на русском языке. Отображается в превью события и в подробной информации. | Да |
| description | String | Полное описание события с HTML-разметкой. Отображается в подробной информации о событии. | Да |
| url | String | Ссылка на страницу события. Например: https://kudago.com/msk/event/teatr-vernuvshiesya-inaya-realnost/. | Да |
| picture | String | Ссылки на оригинальные изображения события. | Да |
| param name="short_name" | String | Короткое название события на русском языке. Отображается на превью события в поиске. | Нет |
| param name="short_description" | String | Короткое описание события с HTML-разметкой. Пока не используется. | Нет |
| param name="event_id" | String | Уникальный идентификатор события. Используется для построения рекомендаций. | Да |
| param name="tags" | String | Список тегов события, разделенных точкой с запятой, например: мелодрама;комедия. Используется для фильтрации событий и построения персональных рекомендаций. Теги влияют на качество рекомендаций. Событие с большим количеством общих тегов может проиграть более специфичным событиям в выбранной пользователем категории. Событие с очень специфичными тегами может не найти свою аудиторию. | Нет |
| param name="participants" | String | Список участников события в формате: Имя участника 1,Роль участника 1;Имя участника 2,Роль участника 2. Например: Колин Фаррелл,actor;Вуди Харрельсон,actor;Мартин Макдона,director. | Нет |
| param name="age_restriction" | String | Возрастное ограничение. Отображается в превью и подробной информации о событии. Возможные значения: 0+, 6+, 12+, 16+, 18+. | Да |
| param name="videos" | String | Список ссылок на видео о событии. Первое видео используется в качестве превью в карточке события. Остальные видео доступны в подробном описании события. | Нет |
| param name="is_free" | Boolean | Признак бесплатного события. Используется для фильтрации событий и для построения рекомендаций. Значение по умолчанию — false. | Нет |
| param name="is_online" | Boolean | Признак онлайн-события. Используется для фильтрации событий и для построения рекомендаций. | Нет |
| param name="has_tickets" | Boolean | Доступна ли покупка билетов на данное событие. Если вход свободный, укажите true. Значение по умолчанию — true. | Нет |
| param name="place_name" | String | Название места проведения. Отображается в подробной информации о событии. | Да |
| param name="place_address" | String | Полный адрес места проведения: населенный пункт, улица, дом. Отображается в подробной информации о событии. | Да |
| param name="place_city" | String | Город места проведения. | Да |
| param name="place_country_code" | String | Код страны места проведения в формате ISO-3166 apha-2. Сейчас поддерживается только регион RU. | Да |
| param name="place_lon" | Float | Долгота места проведения. Используется для отображения точки на карте. | Нет |
| param name="place_lat" | Float | Широта места проведения. Используется для отображения точки на карте. | Нет |
| param name="place_timezone" | String | Временная зона места проведения в формате IANA. | Да |
| param name="place_phones" | String | Список телефонов организаторов события. | Нет |
| parma name="place_urls" | String | Список ссылок на сайты места проведения. В список можно добавить, например, ссылку на место проведения на вашем сервисе, ссылку на страницу места проведения в социальной сети, на собственный сайт места проведения. | Нет |
| param name="start_date" | String | Дата начала события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-07. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет только при условии заданного поля param name="end_date", иначе событие отображаться не будет. |
| param name="start_time" | String | Время начала события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для событий, для которых точное время не важно или для продолжительных событий, например выставок. | Нет |
| param name=”duration_min” | Int | Длительность события в минутах. | Нет |
| param name="end_date" | String | Дата конца события по местному времени, в формате YYYY-MM-DD (ISO-8601). Например: 2023-04-17. Используется для выбора событий за конкретную дату или интервал. Это поле особенно важно для корректной фильтрации продолжительных событий, например выставок. Может быть пустым для непродолжительных событий, например для спектаклей. | Нет только при условии заданного поля param name="start_date", иначе событие отображаться не будет. |
| param name="end_time" | String | Время конца события по местному времени, в формате HH:MM:SS (ISO-8601). Например: 14:00:00. Используется для выбора событий за конкретную дату или интервал. Может быть пустым для непродолжительных событий, например для спектаклей. Это поле особенно важно для корректной фильтрации для продолжительных событий, например выставок. | Нет |
| param name="prices" | Float | Список цен билетов на это время в этом месте. Список целых чисел, разделённых точкой с запятой, например: 100;200;300. Используется для выбора событий по цене и для построения рекомендаций. Для продолжительных событий достаточно указать список всех цен, без уточнения в разные дни недели. Цены — это дробные числа, с точностью до двух знаков, после запятой. | Нет |
| param name="offer_url" | String | Ссылка для покупки билетов на событие. Используется для перехода на покупку билетов. Если поле не задано, то используется ссылка на страницу события (url). | Нет |
Загрузить фид можно:
Авторизуйтесь на Яндексе. Добавьте сайт в Вебмастер и подтвердите права на управление или получите доступ для вашего аккаунта у владельца сайта.
Яндекс Вебмастер проверит фид. Если он содержит ошибки, в Вебмастере на странице рядом с фидом появится сообщение об ошибках. Чтобы открыть их, нажмите Посмотреть. Исправьте ошибки — в течение некоторого времени Вебмастер проверит фид снова.
Условия
Сайт несет ответственность за корректность данных, соответствие предложений тематике, а также за распространение незаконной информации. В случае нарушения условий Яндекс имеет право не использовать данные сайта для изменения представления ответа в поисковой выдаче. См. подробные условия.
Дата обновления страницы: 16.01.2024.
- Изменено описание параметра place_country_code: сейчас поддерживается только регион RU.
