Дошка безкоштовних оголошень
XML імпорт для Автосалонів
Сервіс автоматичного завантаження оголошень про продаж легкових автомобілів у форматі XML надається на GVANGA.COM безкоштовно* для Автосалонів та Автомобільних дилерів.
Для підключення до сервісу завантаження оголошень XML досить просто зареєструватися на GVANGA і надіслати нам посилання на Ваш XML файл.
Як це працює?
Ви реєструєтеся на порталі GVANGA.COM та в Особистому кабінеті в розділі "XML фіди" - налаштування XML завантаження відправляєте посилання на XML фід.
Додане посилання на Ваш XML файл пройде перевірку на коректність, і всі оголошення протягом 24 годин будуть імпортовані на наш портал. Наступне оновлення даних файлу проходитиме один раз на добу. Перегляд та редагування всіх завантажених оголошень буде доступно з Вашого Особистого кабінету.
Публікація всіх оголошень здійснюється після перевірки службою модерації.
Технічні вимоги до фіду
- URL фіда має бути постійним та доступним за протоколом HTTP.
- Імпорт даних Вашого XML фіду буде здійснюватися 1 раз на добу.
- Фід повинен бути створений у кодуванні UTF-8.
- Не допускається наявність у фіді HTML-коду.
- У текстових полях не повинні використовуватися перші 32 символи з ASCII-кодами (за винятком значень 9, 10 та 13).
- Крім того, ряд символів для файлу необхідно замінювати кодами:
| Символ | Код |
| " | " |
| & | & |
| > | > |
| < | < |
| ' | ' |
Опис формату 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 оголошень. При підключенні імпорту кожного додаткового фіда діє платна послуга, вартість якої включає тариф за підключення та щомісячний платіж під час дії послуги.
** Для агрегаторів та інформаційних систем діють спеціальні платні умови підключення. Вартість щомісячного платежу залежить від загальної кількості активних для публікації оголошень.