YML-фид агрегатора для галереи услуг Директа
Чтобы продвигать специалистов в галерее услуг, сервис-агрегатор должен подходить по пяти условиям (тематики, защита от мошенничества, контроль качества, модерация контента, версия для телефонов) и отдать фид в формате YML. Размер файла — до 200 МБ, данные обновлены не более месяца назад, отзывов на специалиста не больше 100. Обязательны 14 полей, включая рейтинг, число отзывов, регион, годы опыта и конверсию.
Цифры
Требования к фиду
| Параметр | Значение |
|---|---|
| Формат | YML |
| Размер файла | до 200 МБ |
| Актуальность данных | обновлены не более месяца назад |
| Отзывов на специалиста | не более 100 последних |
| Атрибут date у yml_catalog | `YYYY-MM-DD hh:mm`, время генерации файла |
| Идентификатор offer | уникальный id у каждого предложения |
| Порядок | currencies, sets и categories — до списка offers |
| Расхождения с данными сервиса | незначительные из-за устаревания допускаются (рейтинг, число отзывов, цена) |
Обязательные элементы offer
| Элемент | Что передавать |
|---|---|
| name | имя специалиста, название организации или ИП |
| url | ссылка на страницу предложения, может совпадать со ссылкой на профиль |
| picture | логотип или фото специалиста |
| set-ids | идентификаторы наборов услуг через запятую, например «1,2,3» |
| categoryId | идентификатор категории услуг |
| price | цена; атрибут from="true" означает минимальную цену |
| currencyId | валюта, например RUR |
| description | описание профиля или услуги |
| param «Рейтинг» | число по пятибалльной шкале, 5.0 — максимум |
| param «Число отзывов» | число |
| param «Регион» | строка: страна, область, город, район города или станция метро |
| param «Годы опыта» | число |
| param «Конверсия» | произвольное число, можно «1» |
| param «Ссылка на профиль исполнителя» | ссылка на профиль, может совпадать с url |
Необязательные элементы offer
| Элемент | Что передавать |
|---|---|
| sales_notes | заметки, например «Цена договорная», «Цена за метр» |
| expiry | срок гарантии в формате ISO 8601 (например, P1Y2M10DT2H — 1 год, 2 месяца, 10 дней, 2 часа); без элемента считается, что гарантии нет |
| param «Исполнитель проверен» | true или false, по умолчанию false |
| param «Фото» unit «пример работ» и unit «диплом» | списки ссылок через точку с запятой |
| param «Ссылка на телефон» | формат `tel:+79001111111` |
| param «Контакты» unit whatsapp, telegram, viber | ссылки на профили |
| param «Предпочтительный способ связи» | phone, whatsapp, telegram, viber |
| param «Организация», «Выполняется удаленно», «Выполняется по адресу заказчика», «Выполняется по адресу исполнителя», «Бригада» | true или false, по умолчанию false |
| param «Отзыв на исполнителя - X» | unit: «Текст», «Оценка», «Автор», «Аватар автора», «Дата» (ISO 8601), «Ответ»; X — номер отзыва |
Подробности
Условия для сервиса
- Подходящие тематики: услуги из перечня галереи (ремонт и строительство, ремонт и установка техники, репетиторы, красота, перевозки и курьеры, хозяйство и уборка, дизайнеры, юристы, тренеры, фото, видео, аудио, организация мероприятий).
- Защита от мошенничества: проверка документов специалистов (паспорт или ОГРН) и система антифрода.
- Контроль качества: проверка качества услуг и достоверности информации о специалистах, например автоматические опросы в интерфейсе или звонки call-центра.
- Модерация контента: пользовательский контент проверяется на нецензурную лексику, оскорбления, непристойные материалы и нарушения законодательства РФ.
- Адаптация: версия для компьютера и мобильная версия сайта либо мобильное приложение.
Структура файла
Корневой элемент yml_catalog, внутри shop. В shop сначала currencies, sets и categories, затем offers с отдельными offer. Фид должен содержать список специалистов, которых нужно продвигать. Данные должны точно соответствовать информации на сервисе: несоответствия, например неверные рейтинги, могут привести к отклонению объявлений модерацией.
Важно знать
- Страница заканчивается примером фида: как загрузить фид и создать кампанию агрегатору, в скачанном тексте не описано.
- В примере фида есть элементы, которых нет в таблице: param «Ссылка на создание заказа», «Ссылка на чат», «Об исполнителе». Какие из них учитываются, справка не уточняет.
- В примере `expiry` заполнен значением 1, а таблица требует формат ISO 8601; в примере даты отзывов записаны как 22.04.2020 22:21:00, тогда как в таблице указан ISO 8601.
- Во втором offer примера оценки отзывов записаны как unit="4" и unit="5", а не как unit «Оценка» из таблицы.
- Как рассчитывается элемент «Конверсия» и на что он влияет, справка не поясняет, указано лишь, что подойдёт произвольное число.
- Для специалистов без отзывов или с неполными данными правила заполнения обязательных полей (рейтинг, число отзывов) в справке не нашли.
Источник: Справка Директа: Как агрегатору продвигать специалистов в Директепроверено 02.11.2026