Сервіс автоматичного завантаження оголошень про продаж легкових автомобілів у форматі XML надається на GVANGA.COM безкоштовно* для Автосалонів та Автомобільних дилерів.
Для підключення до сервісу завантаження оголошень XML досить просто зареєструватися на GVANGA і надіслати нам посилання на Ваш XML файл.
Як це працює?
Ви реєструєтеся на порталі GVANGA.COM та в Особистому кабінеті в розділі "XML фіди" - налаштування XML завантаження відправляєте посилання на XML фід.
Додане посилання на Ваш XML файл пройде перевірку на коректність, і всі оголошення протягом 24 годин будуть імпортовані на наш портал. Наступне оновлення даних файлу проходитиме один раз на добу. Перегляд та редагування всіх завантажених оголошень буде доступно з Вашого Особистого кабінету.
Публікація всіх оголошень здійснюється після перевірки службою модерації.
Технічні вимоги до фіду
Символ | Код |
" | " |
& | & |
> | > |
< | < |
' | ' |
Опис формату XML файлу для авто
Заголовок фіда має починатися зі стандартного XML-заголовка:
<?xml version="1.0" encoding="utf-8"?>
У файлі має бути кореневий елемент auto-catalog - <auto-catalog> …</auto-catalog> з датою створення фіда:
<generation-date>YYYY-MM-DD HH:mm:ss+04:00</generation-date>
Кожне оголошення у фіді формується елементом offer, для якого необхідно вказувати унікальний ідентифікатор internal-id:
<offer internal-id="Номер id"> ... </offer>
Опис обов'язкових параметрів елемента offer:
Елемент | Описання |
<url> | Посилання на сторінку з оголошенням |
<mark> | Марка автомобіля |
<model> | Модель автомобіля |
<date> | Дата створення оголошення – формат дати: YYYY-MM-DDTHH:mm:ss+04:00 |
<year> | Рік випуску (чотиризначне число) |
<displacement> | Об'єм двигуна (у літрах, через кому) |
<horse-power> | Потужність двигуна (кінські сили) |
<price>
</price> | Елементи показника «Ціна» |
<value> | Ціна (без пропусків) |
<currency> | Валюта: «RUR» або «RUB», «USD», «EUR», «UAH» |
<steering-wheel> | Розташування керма («правий» або «RHD», «лівий» або «LHD») |
<transmission> | Тип коробки («механіка» або «MT», «автомат» або «AT», «варіатор» або «CVT») |
<additional-info> | Описання |
Додаткові параметри.
Рекомендується включати у фід усі елементи пропозицій, щоб Ваші оголошення краще потрапляли у результати пошуку користувачів сайту – Ваших потенційних клієнтів.
Елемент | Описання |
<title> | Заголовок оголошення |
<engine-type> | Тип двигуна («бензин» або «gasoline», «дизель» або «diesel», «гібрид» або «hybrid», «електро» або «electro», «газ» або «gas») |
<generation> | Покоління автомобіля (II, E70, J1, ...) |
<wheel-drive> | Наявність повного приводу 4WD (так - «так», «true», «1», «+»; ні - «ні», «false», «0», «-») |
<body-type> | Тип кузова (седан, хетчбек, універсал...) |
<doors-count> | Кількість дверей (ціле число) |
<state> | Стан автомобіля ("новий" або "new", "з пробігом" або "used", "аварійний" або "crashed") |
<run> | Пробіг автомобіля (в кілометрах) |
<custom-house-state> | Митне оформлення (розмитнений - «розмитнений», «так», «true», «1», «+»; ні – «не розмитнений», «ні», «false», «0», «-») |
<color> | Колір кузова (білий, чорний, жовтий, зелений, …) |
<update-date> | Дата поновлення оголошення |
<valid-thru-date> | Дата, до якої дійсно оголошення. |
<vin> | Ідентифікаційний номер автомобіля. |
<modification> | Модифікація автомобіля (GTI, ST, Alltrack ...). |
<equipment> | Комплектація автомобіля – для кожного параметра потрібно створювати окремий тег |
<image> | Фотографія - для кожної фотографії потрібно створювати окремий тег з адресою url (може бути завантажено до 4 зображень). |
<dealer>
</dealer> | Набір елементів контактних даних дилера - Ви можете заповнити контактні дані для оголошень в особистому кабінеті користувача GVANGA, щоб вони фігурували у всіх завантажуваних оголошеннях без додаткового заповнення даних елементів у фіді. Якщо ж контакти дилера відрізняються від зазначених раніше на нашому сайті, додайте цей елемент до вашого XML файлу.. |
<country> | Країна |
<region> | Область |
<city> | Місто |
<address> | Вулиця (або вулиця та будинок) |
<name> | Ім'я представника дилера |
<company-name> | Назва організації |
<phone> | Номер телефону |
<email> | Електронна адреса |
Приклад коректного XML фіда:
<?xml version="1.0" encoding="UTF-8"?> <auto-catalog> <creation-date>2016-02-21 22:22:22 GMT+4</creation-date> <host>gvanga.com</host> <offers> <offer internal-id="1"> <url>https://gvanga.com/ad/citroen-jumpy-20d-mt-109-ls.html</url> <date>2016-02-21 22:22:22 GMT+4</date> <update-date>2016-03-16 11:11:11 GMT+4</update-date> <valid-thru-date>20.04.2016</valid-thru-date> <mark>Citroen</mark> <model>Jumpy</model> <year>2001</year> <run>175000</run> <additional-info> Автомобиль в хорошем состоянии, родная краска, есть небольшие сколы на бамперах. </additional-info> <doors-count>5</doors-count> <generation>IV</generation> <modification>GTI</modification> <state>Отличное</state> <color>Черный</color> <body-type>Хэтчбек</body-type> <engine-type>Дизель</engine-type> <displacement>2.0</displacement> <transmission>MT</transmission> <steering-wheel>Левый</steering-wheel> <custom-house-state>Растаможен</custom-house-state> <equipment>Магнитола (CD)</equipment> <equipment>Электрозеркала</equipment> <equipment>Электростеклоподъемники (все)</equipment> <image>https://gvanga.com/images/682cd2cc.jpg</image> <vin>WAUJC68E82A012</vin> <horse-power>109</horse-power> <price> <value>140000</value> <currency>USD</currency> </price> <dealer> <name>Иван Иванович</name> <country>Россия</currency> <region>Московская</region> <city>Москва</city> <phone>(495) 000-00-00</phone> <email>gvanga@gvanga.com</email> </dealer> </offer> </offers> </auto-catalog>
Завантажити: https://gvanga.com/examples/xml/car.xml
Для завантаження оголошень на наш портал можна використовувати XML файл формату Яндекс.Авто.
У разі виникнення додаткових питань та пропозицій щодо XML завантаження оголошень на порталі GVANGA.COM, будь ласка, звертайтесь до нас через форму «Зворотній зв'язок» нижче і ми зв'яжемося з Вами найближчим часом.
* Для Автосалонів та Автомобільних дилерів безкоштовним є завантаження оголошень лише з одного XML фіда до 250 оголошень. При підключенні імпорту кожного додаткового фіда діє платна послуга, вартість якої включає тариф за підключення та щомісячний платіж під час дії послуги.
** Для агрегаторів та інформаційних систем діють спеціальні платні умови підключення. Вартість щомісячного платежу залежить від загальної кількості активних для публікації оголошень.