Рейтинг@Mail.ru
MixTo.ru

Технические требования к фиду "MixTo.ru.Объявления"

Формат выгрузки "MixTo.ru.Объявления"

Общие требования к фиду

Фид должен быть составлен на языке XML. Все поддерживаемые элементы описаны ниже, в подразделе Описание формата фида.

Общие технические требования к наполнению фида:

  • В фиде должны передаваться все актуальные объявления, доступные на сайте.
  • Для каждого объявления следует передавать максимальный набор опрсаний - в файле должны отражаться все параметры, указанные в объявлении на сайте.
    Количество и точность передаваемых параметров влияет на релевантность объявлений. Более релевантные объявления ставятся выше в результатах поиска и получают больше внимания пользователей.
  • В текстах объявлений и в описании характеристик объектов не должно быть HTML-кода.
  • Если для объявления есть несколько значений одного параметра (например, несколько фото), то нужно передавать несколько одинаковых тегов.
  • Стоимость предложения следует передавать только в той валюте, которую указал владелец объявления.

Язык описания товаров

Фид с предложениями для "MixTo.ru.Объявления" должен быть составлен на языке XML (Extensible Markup Language).

Язык XML не позволяет использовать первые 32 ASCII-символа в текстовых полях (исключения - табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы:

Символ в текстеКод для XML-файла
    ""
   &&
   >>
   <&lt;
   '&apos;

Формат даты

Все даты и время следует указывать согласно стандарту ISO 8601. В общем случае дата и время по этому стандарту следует указывать в формате YYYY-MM-DDTHH:mm:ss+00:00, где

  • YYYY - год;
  • MM - месяц;
  • DD - день;
  • HH - час;
  • mm - минута;
  • ss - секунда;
  • +00:00 - указание часового пояса (для Москвы - +03:00).

Кодировка

Файл фида должен быть создан в кодировке UTF-8.

Описание формата фида

Заголовок документа

XML-документ должен начинаться (с нулевого символа первой строки) со стандартного XML-заголовка.

<?xml version="1.0" encoding="utf-8"?>

Корневой элемент

 <mixto-ru-notice>
  <generation-date>2019-05-05T16:36:00+04:00</generation-date>
 <offer>
    ...
 </offer>
    ...
 </mixto-ru-notice>

Корневой элемент XML-фида - mixto-ru-notice - должен содержать элемент generation-date с датой создания фида и элементы offer, в каждом из которых должна находиться информация из одного объявления.

Ниже описаны все возможные элементы фида, сгруппированные по их назначению в языке XML. Также приведен исчерпывающий пример корректно составленного фида.

Общая информация об объявлении

У элемента offer есть обязательный атрибут internal-id, который должен быть уникальным для каждого объявления. Этот атрибут можно заполнять, например, идентификатором объявления в вашей базе данных.

 <offer internal-id="1245">
    ...

Элементы с пометкой «строго ограниченные значения», должны содержать только значения из приведенного набора. Использование других значений приведет к ошибке обработки фида.

Элементы

Описание

category* Категория объявления (строго ограниченные значения «1-к.кв. Продаю», «1-к.кв. Сдам», «2-к.кв. Продаю», «2-к.кв. Сдам», «3-к.кв. Продаю», «3-к.кв. Сдам», «4-к.кв. и более, Продаю», «4-к.кв. и более, Сдам», «Комнату, Продаю», «Комнату, Сдам», «Дом, Продаю», «Дом, Сдам», «Участок, Продаю», «Участок, Сдам», «Нежилое помещение, Продаю», «Нежилое помещение, Сдам», «Одежда, Продаю», «Детские вещи, Продаю», «Мебель, Продаю», «Бытовая техника, Продаю», «Разное, Продаю», «Компьютерная и мобильная техника, Продаю», «Автомобиль, Продаю», «Автомобиль, Сдам», «Автозапчасти, Продаю», «Строительство, Окна и двери», «Строительство, Электрика», «Стройматериалы», «Отделочные работы и сантехника», «Климатическое оборудование», «Строительство, Инструменты», «Собаки, Отдам в добрые руки», «Собаки, Находки», «Кошки, Отдам в добрые руки», «Кошки, Находки», «Услуги, Здоровье и красота», «Услуги, Отдых и путешествия», «Услуги, Разнопрофильные услуги», «Работа, Вакансии»...).
category-id* ID Категории объявления. Reference-Category-ID.xml
category-id
category
111
1-к.кв. Продаю
115
1-к.кв. Сдам
121
2-к.кв. Продаю
125
2-к.кв. Сдам
131
3-к.кв. Продаю
135
3-к.кв. Сдам
141
4-к.кв. и более, Продаю
145
4-к.кв. и более, Сдам
151
Комнату, Продаю
155
Комнату, Сдам
161
Дом, Продаю
165
Дом, Сдам
171
Участок, Продаю
175
Участок, Сдам
181
Нежилое помещение, Продаю
185
Нежилое помещение, Сдам
211
Одежда, Продаю
221
Детские вещи, Продаю
231
Мебель, Продаю
241
Бытовая техника, Продаю
251
Разное, Продаю
261
Компьютерная и мобильная техника, Продаю
311
Автомобиль, Продаю
315
Автомобиль, Сдам
321
Гараж, Продаю
325
Гараж, Сдам
331
Автозапчасти, Продаю
341
Автосервис
351
Транспорт
611
Ремонтно-строительные работы
621
Строительство, Окна и двери
631
Строительство, Электрика
641
Стройматериалы
651
Отделочные работы и сантехника
661
Климатическое оборудование
671
Строительство, Инструменты
711
Собаки, Отдам в добрые руки
713
Собаки, Находки
721
Кошки, Отдам в добрые руки
723
Кошки, Находки
811
Услуги, Перевозки
821
Услуги, Обучение
831
Услуги, Здоровье и красота
841
Услуги, Компьютерная помощь
851
Услуги, Праздники
861
Услуги, Бытовое обслуживание
871
Услуги, Отдых и путешествия
881
Услуги, Разнопрофильные услуги
901
Работа, Вакансии
Внимание! Одно из полей - category или category-id обязательно должно быть заполнено.

Элементы

Описание

title* Тема объявления.
Внимание! Телефоны и ссылки в этом поле приведут к ошибке в обработке фида и последующему бану.
description* Дополнительная информация (описание в свободной форме, оставленное подателем объявления).
url * URL страницы с объявлением.
creation-date* Дата создания объявления (в формате YYYY-MM-DDTHH:mm:ss+00:00).
last-update-date Дата последнего обновления объявления (в формате YYYY-MM-DDTHH:mm:ss+00:00).
image Фотография (может быть несколько тегов).
phone* Контактный номер телефона. Если номеров несколько, каждый из них необходимо передавать в отдельном элементе phone.
Внимание! Для агентств недвижимости обязательно должны быть указаны прямые телефоны агентов.
email Электронный адрес продавца.
latitude Географическая широта. Например для Москвы: 55.7514. Обязательно для недвижимости*
longitude Географическая долгота. Например для Москвы: 37.6228. Обязательно для недвижимости*

Информация об условиях сделки

Элементы

Описание

price* Информация о стоимости.
value* Цена (сумма указывается без пробелов).
currency*

Валюта, в которой указана цена.

Поддерживаемые значения:

  • «RUR» или «RUB» - российский рубль;
  • «EUR» - евро;
  • «USD» - американский доллар;

Пример передачи данных о стоимости квартиры:

 <price>
   <value>4000000</value>
   <currency>RUR</currency>
 </price>

Набор элементов location, описывающих местоположение объекта. (Обязательно для недвижимости*).

location* Набор элементов, описывающих местоположение объекта.
country* Страна, в которой расположен объект.
region

Регион указанной страны (необязательно для Москвы и Санкт-Петербурга).

  • Для России - название субъекта РФ.
  • Для Украины, Белорусии и Казахстана - название области.
district

Район указанного региона.

  • Для России - название района субъекта РФ.
  • Для Украины, Белорусии и Казахстана - название района области.
locality-name Название населенного пункта.
sub-locality-name Район населенного пункта.
address Улица и номер дома.
direction Шоссе (только для Москвы).
distance Расстояние по шоссе до МКАД (указывается в километрах).
metro Ближайшая станция метро (если таковых несколько, каждая должна быть указана в отдельном элементе).
name Название станции метро.
time-on-transport Время до метро в минутах на транспорте.
time-on-foot Время до метро в минутах пешком.
railway-station Ближайшая ж/д станция (для загородной недвижимости).

В зависимости от типа недвижимости (городская или загородная) обязательны разные параметры, описывающие адрес.

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

  • district (обязателен для городов, находящихся в областях субъектов РФ);
  • locality-name (название населенного пункта);
  • address (улица или улица и дом)
    или
    metro и time-on-foot (метро и время ходьбы до него).

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

  • district (район субъекта РФ)
    или
    locality- name (название населенного пункта)
    или
    direction (шоссе - для Москвы)
    или
    railway-station (ближайшая ж/д станция).

Пример заполнения использования тегов <region>, <district> и <sub-locality-name> при описании адреса

 <location>
   <country>Россия</country>
   <region>Московская область</region>
   <district>Одинцовский район</district>
   <locality-name>Одинцово</locality-name>
       <sub-locality-name>Центральный</sub-locality-name>
       <non-admin-sub-locality>Центр</non-admin-sub-locality>
   <address>Пушкинская ул., д. 12</address>
   <direction>Минское шоссе</direction>
 </location>

Пример использования тега <metro> при описании городской недвижимости

 <location>
      <country>Россия</country>
      <locality-name>Санкт-Петербург</locality-name>
      <sub-locality-name>Адмиралтейский</sub-locality-name>
      <address>Измайловский пр., 16</address>
      <metro>
         <name>Технологический институт</name>
         <time-on-foot>10</time-on-foot>
         <time-on-transport>5</time-on-transport>
      </metro>
 </location>

Пример использования тегов <direction> и <distance> при описании загородной недвижимости (для Москвы)

 <location>
      <country>Россия</country>
      <region>Московская область</region>
      <district>Истринский район</district>
      <locality-name>деревня Подушкино</locality-name>
      <direction>Рублево-Успенское шоссе</direction>
      <distance>10</distance>
 </location>

Информация о продавце или арендодателе. (Обязательно для недвижимости*).

Элементы

Описание

sales-agent* Информация о продавце или арендодателе.
name Имя продавца/арендодателя или агента.
phone* Контактный номер телефона. Если номеров несколько, каждый из них необходимо передавать в отдельном элементе phone.
Внимание! Для агентств недвижимости обязательно должны быть указаны прямые телефоны агентов.
sales-category

Тип продавца или арендодателя («владелец», «агентство», «застройщик»).

organization Название агентства.
email Электронный адрес продавца.
photo Ссылка на фотографию агента или логотип компании.

Пример корректного XML-файла

<?xml version="1.0" encoding="UTF-8"?>
 <mixto-ru-notice>
   <generation-date>2019-05-11T12:00:00+04:00</generation-date>
   <!-- Описание питомца для пристройства -->
   <offer internal-id="4657">
       <category-id>251</category-id>
       <title>АЛИСА - Загадочная пушистая красотка, бесплатно</title>
       <description>Красивая молоденькая кошечка Алиса,
          3-4 месяца. Светлая с пятнистыми перчаточками и мордашкой.
          Глаза голубые. Приучена к лотку и когтеточке.
          По характеру кошечка ласковая, добродушная, нежная.
          Абсолютно спокойна к другим кошкам, не реагирует на собак.
          В туалет ходит в лоток с наполнителем.
          Отдадим в добрую и ответственную семью.</description>
       <url>https://www.mixto.ru/good_hands/mess/9858/</url>
       <creation-date>2019-05-11T12:32:05+04:00</creation-date>
       <image>https://www.mixto.ru/u/9/ms_9858_alisa0.jpg</image>
       <image>https://www.mixto.ru/u/9/ms_9858_alisa1.jpg</image>
       <image>https://www.mixto.ru/u/9/ms_9858_alisa2.jpg</image>
       <image>https://www.mixto.ru/u/9/ms_9858_alisa3.jpg</image>
       <phone>8-903-234-5678</phone>
       <email>alisa11@mail.ru</email>
       <price>
           <value>0</value>
           <currency>RUR</currency>
       </price>
   </offer>
   <!-- Описание кабака -->
   <offer internal-id="123">
       <category-id>251</category-id>
       <title>Доставка живого пива и закусок!</title>
       <description>Магазин "Хмельной погребок" приглашает в гости
          любителей и ценителей хорошего разливного пива.
          Более 15 сортов разливного и 15 видов бутылочного
          пива - на любой вкус. Большой выбор копченой и вяленой
          рыбы, других закусок, и конечно - живые раки.</description>
       <url>https://www.mixto.ru/notice/18453/</url>
       <creation-date>2019-05-13T12:32:45+04:00</creation-date>
       <image>https://www.mixto.ru/u/18/ms_18453_dscn0150.jpg</image>
       <image>https://www.mixto.ru/u/18/ms_18453_magnitik_mal.jpg</image>
       <image>https://www.mixto.ru/u/18/ms_18453_don.jpg</image>
       <image>https://www.mixto.ru/u/18/ms_18453_dscn0298.jpg</image>
       <phone>8-495-234-5678</phone>
       <phone>8-495-123-4567</phone>
       <email>hmelpogrebok@mail.ru</email>
       <latitude>56.002888</latitude>
       <longitude>37.205235</longitude>
       <price>
           <value>150</value>
           <currency>RUR</currency>
       </price>
   </offer>
   <!-- Описание детской одежды -->
   <offer internal-id="123">
       <category-id>221</category-id>
       <title>Комплект для фигурного катания</title>
       <description>Комплект для фигурного катания
          ФК 00-000 (ФК), модель № 00. В состав комплекта входят:
          Купальник для фигурного катания (рукав три четверти,
          вшитая мини-юбка, воротник стоечка под горло,
          спинка на молнии), Легенсы для фигуристов
          (с фиксацией на стопе), Повязка на голову, Чехлы для коньков.
          Комплект для фигурного катания сшит из итальянского эластичного
          бархата с жатым эффектом, производства компании CARVICO,
          и соответствует самым высоким требованиям. Идеальная посадка,
          высокая устойчивость к пилингу, хорошая воздухопроницаемость и абсолютная свобода
          Производитель: KORRI
          Артикул: ФК
          Материал: Полиамид - 87%, Эластан - 13%
          Размерный ряд: 28-44</description>
       <url>http://www.korri.ru/products/5/</url>
       <creation-date>2019-05-13T12:32:45+04:00</creation-date>
       <image>http://www.korri.ru/upload/iblock/116/1166d741e871bbd90d1bd269be9acba6.jpg</image>
       <phone>8(495)614-99-08</phone>
       <email>group@korri.ru</email>
       <latitude>55.780613</latitude>
       <longitude>37.578136</longitude>
       <price>
           <value>3900</value>
           <currency>RUR</currency>
       </price>
   </offer>
   <!-- Квартира на вторичном рынке -->
   <offer internal-id="1245">
       <category>2-к.кв. Продаю</category>
       <title>Продается 2х. квартира в Москве</title>
       <description>Очень приличная чистая квартира. Имеется все.</description>
       <url>http://yandex.ru/3/</url>
       <creation-date>2019-05-13T12:32:45+04:00</creation-date>
       <latitude>55.748452</latitude>
       <longitude>37.645519</longitude>
       <location>
           <country>Россия</country>
           <locality-name>Москва</locality-name>
           <address>Яузская улица</address>
       </location>
       <price>
           <value>9500000</value>
           <currency>RUR</currency>
       </price>
       <sales-agent>
           <phone>8-495-589-8013</phone>
       </sales-agent>
   </offer>
   <!-- Комната/комнаты -->
   <offer internal-id="3">
       <category-id>121</category-id>
       <url>http://yandex.ru/2/</url>
       <title>Продается 2-к.кв.г.Выборг</title>
       <description>Продам 2 комн. квартиру.
          Общая площадь 62 кв.м. Квартира без отделки, свободной планировки,
          этажи на выбор. Дом на половину заселён. Отличный район! </description>
       <creation-date>2019-05-13T12:32:45+04:00</creation-date>
       <latitude>60.713405</latitude>
       <longitude>28.729497</longitude>
       <location>
           <country>Россия</country>
           <region>Ленинградская область</region>
           <district>Выборгский район</district>
           <locality-name>Выборг</locality-name>
           <address>улица сторожевой башни, 2</address>
       <price>
           <value>8456000</value>
           <currency>RUR</currency>
       </price>
       <sales-agent>
           <phone>8-910-428-5459</phone>
           <category>владелец</category>
       </sales-agent>
   </offer>
 </mixto-ru-notice>

Частые ошибки

Автоматический редирект со страницы удаленного объявления на страницу с другим объявлением

Нельзя перенаправлять со страницы удаленного объявления на другое объявление. На странице удаленного объявления должно быть указано, что объявление было удалено.

Сокращение слов

В элементах с текстовыми полями не рекомендуется сокращать слова: например, в элементе building-type (тип дома) лучше писать «кирпичный», а не «кирп.».

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

Неправильное заполнение элемента location

Внимательно ознакомьтесь с правилами заполнения элемента location.

Для адресов в городе элемент location должен выглядеть следующим образом:

 <location>
   <country>Россия</country>
   <region>Свердловская область</region>
   <locality-name>Екатеринбург</locality-name>
   <non-sub-locality-name>Завокзальный</non-sub-locality-name>
   <sub-locality-name>Октябрьский</sub-locality-name>
   <address>Ивановская ул., д. 6</address>
   <metro>Уральская </metro>
   <time-on-foot>30</time-on-foot >
   <time-on-transport>10</time-on-transport>
 </location>

Если нужно указать адрес в городе, входящем в состав большего города (например в московском Зеленограде или в петербургском Зеленогорске), заполните элемент location следующим образом:

 <location>
   <country>Россия</country>
   <locality-name>Москва</locality-name>
   <address>Зеленоград, 1-й микрорайон, Панфиловский пр., 21</address>
 </location>

Для загородных объектов элемент location должен быть заполнен следующим образом:

 <location>
   <country>Россия</country>
   <region>Московская область</region>
   <district>Мытищинский район</district>
   <locality-name>Федоскино</locality-name>
   <address>ул.Ленина, д. 1</address>
   <direction>Дмитровское шоссе</direction>
   <distance>20</distance>
 </location>

Неправильное заполнение поля phone элемента sales-agent

Поле phone должно содержать только один номер телефона. Чтобы указать несколько номеров, укажите каждый из них в отдельном поле phone:

 <sales-agent>
   <name>Роман</name>
   <phone>+7 (916) 123 45 67</phone>
   <phone>+7 (916) 123 45 68</phone>
   <phone>+7 (916) 123 45 69</phone>
   <category>owner</category>
 </sales-agent>

В элементе phone можно передать только номер телефона. Любые другие или дополнительные данные будут считаться ошибкой фида.

Неправильный формат времени подачи объявления

Время подачи объявления должно быть оформлено по стандарту ISO 8601: YYYY-MM-DDTHH:mm:ss+HH:mm, где

  • YYYY - год;
  • MM - месяц;
  • DD - день;
  • HH - час;
  • mm - минута;
  • ss - секунда.
  • +HH:mm - указание часового пояса (часовой пояс Москвы обозначается как +04:00).

Например, объявление было подано из Владивостока 15 мая 2019 года в 15 часов 18 минут 30 секунд. В фиде время должно быть оформлено следующим образом: 2019-05-15Т15:18:30+11:00.

Отсутствие обязательных тегов

В технических требованиях все обязательные элементы и поля помечены звездочками (символ «*»). Все обязательные элементы должны присутствовать в каждом объявлении фида. Если в объявлении отсутствует хотя бы одно обязательное поле, объявление не пройдет модерацию и не будет выводиться в результатах поиска.

Произвольные значения в полях со строго ограниченными значениями

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

Фид содержит запрещенные символы

Определенные символы в фиде следует заменять на соответствующие коды, согласно общим требованиям к XML-документам.

Символ в текстеКод для XML-файла
    "&quot;
   &&amp;
   >&gt;
   <&lt;
   '&apos;

Неполная информация в фиде

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

Ранее использованный идентификатор объявления

Генерируйте уникальный идентификатор для каждого нового объявления - идентификатор, который никогда ранее не использовался в вашем фиде. В противном случае новое объявление со старым идентификатором не будет обработано.