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

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

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

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

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

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

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



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

Чтобы ваши предложения попадали в такие ответы, необходимо передавать Яндексу актуальную информацию о них. Для этого нужно подготовить и разместить на своем сайте фид в формате YML и передать ссылку на него в Вебмастере. Стандарт YML разработан Яндексом и основан на стандарте XML.

Названия элементов shop и offer нужны для обратной совместимости с YML-фидами и не несут дополнительной смысловой нагрузки.

Ограничения для фида
Размер YML-файла 200 МБ
Общее количество изображений 50 000
Количество изображений в одном элементе offer 200
Количество элементов offer

30 000. Данные из фида, который содержит больше предложений, для дополнительного представления использованы не будут. Сам фид загрузится с ошибкой. Чтобы предложения участвовали в поиске, разбейте фид на несколько частей.

Не дублируйте предложения с одним и тем же URL-адресом в нескольких фидах, а также не переносите предложения из одного фида в другой — данные из перенесенного предложения могут временно пропасть из поиска.

Количество элементов set 1 млн
Количество всех YML-файлов (фиды услуг и предложений, RSS для контентных Турбо-страниц) суммарно для сайта и его поддоменов 1000
Пример фида
<?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&amp;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>
Формат фида
Описание shop — информация об источнике
Элемент Тип Описание Обязательно
name String Название источника. Отображается в списке цен и в подписи описания события. Да
url String Ссылка на сайт источника. Домен должен совпадать с доменом события (offer). Да
picture String

Ссылка на логотип источника. Отображается рядом с именем источника в списке цен.

Рекомендуемый размер — 32 × 32 пикселей, рекомендуемый формат — PNG. Размер влияет на качество отображения в поиске.

Да
categories List[String]

Список категорий в фиде.

Категория — это общее описание события, формат его проведения. Примерами категории могут быть: Кино, Спектакль, Концерт, Мастер-класс.

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

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

Можно взять категории и их categoryId из примера фида. Категории, для которых отсутствуют события в вашем фиде, добавлять не надо.

Да
Описание offer - информация о событии (предложении)

Предложение — это отдельный элемент расписания. Он должен содержать информацию о событии, о месте и времени проведения. Если это длительное событие, например, выставка, то достаточно указать время окончания события: 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).

Нет
Как передать фид

Загрузить фид можно:

Авторизуйтесь на Яндексе. Добавьте сайт в Вебмастер и подтвердите права на управление или получите доступ для вашего аккаунта у владельца сайта.

  1. Перейдите в Вебмастер на страницу Услуги и предложения в поиске → Фиды и ошибки.
  2. Нажмите кнопку Загрузить фид.
  3. Выберите категорию бизнеса Чем заняться.
  4. Укажите регион. Например, если предложения в фиде доступны на одинаковых условиях во всех регионах, выберите Россия.
  5. В поле Ссылка на файл с предложениями укажите URL вида https://example.com/feed.yml.

    Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: http://yandex:WE9h4FfBml@example.com/feed.yml.

  6. Нажмите Готово.

Яндекс Вебмастер проверит фид. Если он содержит ошибки, в Вебмастере на странице Услуги и предложения в поиске → Фиды и ошибки рядом с фидом появится сообщение об ошибках. Чтобы открыть их, нажмите Посмотреть. Исправьте ошибки — в течение некоторого времени Вебмастер проверит фид снова.

Условия

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

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

Предыдущие версии документа

История изменений
  • Изменено описание параметра place_country_code: сейчас поддерживается только регион RU.