Настройка автоматического закачивания объявлений возможна только при участии вашего программиста. Если у вас есть такой человек, то передайте ему эту инструкцию. Он настроит выгрузку и далее объявления будут размещаться без вашего участия.
Обмен данными по выставляемым объявлениям будет производиться автоматически. По мере появления на вашем сайте новых предложений (или изменения статуса продано/не продано, информации по уже выставленным объявлениям) специальная программа с нашей стороны проверяет с установленной периодичностью ваш сайт (например, 1 раз в день) и вносит изменения в вашу карточку.
Преимуществом данного способа выгрузки является оперативное поступление объявлений в нашу базу и изменение данных о продаже без участия человека в любое время (т.е. разница во времени с другими городами и выходные дни не влияют на работу).
Смотрите также: ответы на частые вопросы.
Для автозакачивания объявлений вам нужен файл-справочник, данные которого понадобятся для создания файла своих объявлений. Файл-справочник содержит в себе списки марок, моделей, городов и прочей информации, которую нужно использовать при описании объявлений.
Обращаем ваше внимание на то, что для каждого раздела из списка ниже используется свой справочник. Справочник марок и моделей находится внутри каждого справочника для раздела.
Версия свежего справочника всегда доступна на сайте:
Примеры файла объявлений:
bulls.xml — файл с объявлениями для закачки, который вам нужно будет генерировать и размещать на своем сайте. Пример такого файла для легковых автомобилей можно скачать здесь.
Название файла может быть любым (в документе назван bulls.xml), используемая кодировка должна быть указана в заголовке xml-файла. Соответственно, текстовые данные в файле должны быть в выбранной кодировке.
Главная секция называется avtoxml, и состоит из следующих секций:
Содержит набор полей для описания одного объявления по продаже легкового авто.
Все поля, названия которых начинаются с id (idMark, idModel, idCountry, idCity, idMarket, idFrameType, idWheelType, idEngineType, idTransmission, idDriveType, idHaulRussiaType), содержат числовые идентификаторы из соответствующих секций файла ref.xml. Все остальные поля содержат числовые и текстовые данные.
Список полей в объявлении (жирным шрифтом помечены обязательные поля):
Название поля | Значение |
---|---|
idOffer | уникальный id объявления в вашей базе данных |
idMark | id марки авто (см. файл-справочник); если не можете указать id, то укажите название марки текстом в поле sMark |
idModel | id модели авто (см. файл-справочник); если не можете указать id, то укажите название модели текстом в поле sModel |
sMark | название марки авто (Toyota, Honda, BMW и т.п.); указывать обязательно только в том случае, если не можете указать idMark |
sModel | название модели авто (Land Cruiser, Accord, X5 и т.п.); указывать обязательно только в том случае, если не можете указать idModel |
idCountry | id страны, где находится авто (см. файл-справочник, по умолчанию — 0) |
idCity | id города, в котором находится авто (см. файл-справочник) |
sCity | название города, в котором находится авто (см. файл-справочник) |
YearOfMade | год выпуска ТС (только год, 4 цифры: 1995, 2003, 2018 и т.п.) |
VIN | VIN или номер кузова, если VIN отсутствует |
Price | цена в рублях |
NewType | признак, что автомобиль новый; 1 — новый, 0 — не новый (с пробегом) |
Volume | объем двигателя в куб.см (пример: 599, 1300, 2631 и т.п.) |
FrameType | тип кузова (см. файл-справочник) |
Color | цвет кузова (см. файл-справочник) |
idTransmission | id типа трансмиссии (см. файл-справочник) |
sTransmission | название типа трансмиссии |
idEngineType | id типа двигателя (см. файл-справочник) |
sEngineType | название типа двигателя |
idHybridType | гибрид (см. файл-справочник) |
sHybridType | гибрид (да, нет) |
idGbo | ГБО (см. файл-справочник) |
sGbo | ГБО (да, нет) |
idDriveType | id типа привода (см. файл-справочник) |
sDriveType | название типа привода |
idWheelType | id положения руля (см. файл-справочник) |
sWheelType | положение руля (левый, правый) |
Haul | пробег (показания одометра в километрах) |
idHaulRussiaType | пробег по РФ (1 - с пробегом по РФ, 0 - без пробега по РФ) |
sComplectation | название комплектации (в соответствии с каталогом) |
idComplectation |
id комплектации на Дроме (в соответствии с каталогом) |
Additional | текстовое описание ТС (комплектация, оснащение, тюнинг и т.п.), здесь можно указать сссылку на видео, размещенное на YouTube |
Photos | секция со списком фотографий (ниже есть подробное описание секции) |
Phone | номер телефона (поле не должно быть больше 20 символов) |
Whereabouts | авто в наличии или под заказ (см. файл-справочник) |
Power | мощность автомобиля в лошадиных силах |
CertProgram | программа сертификации (см. файл-справочник) |
DamagedType | признак для поврежденных автомобилей (0 - небитые, 1 - битые или не на ходу) |
SOR | номер свидетельства о регистрации ТС для авто с пробегом (10 символов) |
Примечание:
На Дроме существуют два раздела продажи легковых автомобилей:
В зависимости от того, какая схема продажи будет использована, нужно соответствующим образом указать город и страну в данных объявления. Возможны ситуации:
Убедительно просим вас соблюдать эти правила и размещать объявления в соответствующих разделах! В случае нарушений правил размещения будут приниматься меры, вплоть до удаления объявлений с сайта.
Содержит набор полей для описания одного объявления для публикации в раздел Грузовики и Спецтехника.
Все поля, названия которых начинаются с id (idModelSpec, idCountry, idCity, idMarket и т.д.), содержат числовые идентификаторы из соответствующих секций справочного файла. Все остальные поля содержат числовые и текстовые данные.
Раздел публикации определяется автоматически по указанному типу техники, например, <idFrameTypeSpec>8</idFrameTypeSpec> определит объявление в раздел «Грузовики».
Для удобства сопоставления Типов техники с разделом можно посмотреть этот справочник.
Список полей в объявлении (жирным шрифтом помечены обязательные поля):
Название поля | Значение | Обязательность | |||||||||||
idOffer | Уникальный id объявления в вашей базе данных | Обязательное | |||||||||||
VIN | VIN или номер кузова/шасси или заводской номер машины. Используется во всех разделах, но обязательно для:
|
Обязательное за исключением объявлений со статусом «В пути» и «Под заказ» |
|||||||||||
idFrameTypeSpec | id типа техники, по которому определяется раздел публикации (см. файл-справочник) | Обязательное | |||||||||||
idModelSpec | id модели авто (см. файл-справочник). Марка определяется автоматически по модели, указывать дополнительно не нужно. | Обязательное | |||||||||||
idWheelType | id положения руля (см. файл-справочник). Используется в разделах:
|
Обязательное | |||||||||||
YearOfMade | Год выпуска ТС (только год, 4 цифры: 1995, 2003, 2018 и т.п.) | Обязательное | |||||||||||
idWheelFormulaType |
id колесной формулы (см. файл-справочник). Используется в разделах:
|
Обязательное | |||||||||||
Price | Цена (по умолчанию в рублях). Если нужно указать цену в валюте, используется idCurrency. | Обязательное | |||||||||||
idCurrency | id валюты (см. файл-справочник) | Необязательное | |||||||||||
idCity | id города, в котором находится авто (см. файл-справочник) | Обязательное | |||||||||||
idCountry | id страны, где находится авто (см. файл-справочник, по умолчанию — 0). Указывается для объявлений в статусе «В пути» и «Под заказ» | Необязательное | |||||||||||
Whereabouts | Авто в наличии или под заказ (см. файл-справочник) | Необязательное | |||||||||||
Additional | Текстовое описание ТС (комплектация, оснащение, тюнинг и т.п.). Здесь можно указать сссылку на видео, размещенное на YouTube. | Необязательное | |||||||||||
Photos | Секция со списком фотографий (ниже есть подробное описание секции) | Необязательное | |||||||||||
Phone | Номер телефона (поле не должно быть больше 20 символов). По умолчанию берется телефон из Карточки продавца. | Необязательное | |||||||||||
DriveTypeSpec | id привода (см. файл-справочник). Используется в разделах:
|
Обязательное | |||||||||||
Axles | id количества осей. Используется в разделах:
|
Обязательное | |||||||||||
idEngineTypeSpec | id типа топлива. Используется в разделах:
|
Необязательное | |||||||||||
idTransmissionSpec | id коробки передач. Используется в разделах:
|
Необязательное | |||||||||||
Volume | Объем двигателя в куб.см (пример: 599, 1300, 2631 и т.п.). Используется в разделах:
|
Необязательное | |||||||||||
Power | Мощность в лошадиных силах (пример: 249, 17, 199 и т.п.). Используется в разделах:
|
Необязательное | |||||||||||
SeatCount | Количество мест в штуках. Используется в разделе Автобусы. | Необязательное | |||||||||||
Haul | Пробег (показания одометра в километрах). Используется в разделах:
|
Необязательное | |||||||||||
idHaulRussiaType | Без пробега по РФ. Используется в разделах:
|
Необязательное | |||||||||||
idNewType | Признак, что ТС новое; 1 — новый, 0 — не новый (с пробегом/наработкой) | Необязательное | |||||||||||
idCabType | id типа кабины для раздела Грузовики; 1 — однокабинная, 2 — двухкабинная/грузопассажирская | Необязательное | |||||||||||
ArrowPayload | Грузоподъемность стрелы в килограммах. Используется в разделах:
|
Необязательное | |||||||||||
ArrowLength | Длина стрелы в метрах. Используется в разделах:
|
Необязательное | |||||||||||
FrameLength | Длина кузова в метрах. Используется для разделов:
|
Необязательное | |||||||||||
BodyLiftingCapacity | Грузоподъемность кузова в килограммах. Используется в разделах:
|
Необязательное | |||||||||||
Weight | Снаряженная масса ТС в килограммах. Используется в разделах:
|
Необязательное | |||||||||||
VehicleCategory | Признак Категории «В» ТС. Используется в разделе Грузовики; 1 – Категория Б, иначе 0. (По умолчанию – 0) | Необязательное | |||||||||||
SleeperPresence | Признак наличия спальника. Используется в разделах:
|
Необязательное | |||||||||||
idEquipment | id дополнительного оборудования, оформляется в блок Equipments, см. пример файла .xml
|
Необязательное | |||||||||||
FrameVolume | Объем цистерны/объем кузова в кубических метрах. Используется в разделах:
|
Необязательное | |||||||||||
idRefrigeratorType | id класса рефрижератора. Используется для типа техники «Фургон рефрижератор» в разделе Грузовики. | Необязательное | |||||||||||
idRefrigeratorBrand | id бренда ХОУ (Холодильно-отопительной установки). Используется для типа техники «Фургон рефрижератор» в разделе Грузовики. | Необязательное | |||||||||||
ChassisType | id ходовой части. Используется в разделах:
|
Необязательное | |||||||||||
Width | Рабочая ширина в метрах. Используется в разделах:
|
Необязательное | |||||||||||
OperationTime | Наработка в моточасах. Используется в разделах:
|
Необязательное | |||||||||||
LiftHeight | Высота подъема в метрах. Используется в разделах:
|
Необязательное | |||||||||||
DrillDepth | Глубина бурения в метрах. Используется в разделе Дорожно-строительная техника для типов:
|
Необязательное | |||||||||||
DrillDiameter | Диаметр бурения в миллиметрах. Используется в разделе Дорожно-строительная техника для типов:
|
Необязательное | |||||||||||
BucketVolume | Объем ковша в метрах кубических. Используется в разделах:
|
Необязательное | |||||||||||
ProducerCountry | id страны производства. Используется в разделах:
|
Необязательное | |||||||||||
TowerHeight | Высота вышки в метрах. Используется в разделах:
|
Необязательное | |||||||||||
SaddleHeight | Высота седла в миллиметрах. Используется в разделах:
|
Необязательное | |||||||||||
idDamagedType | Признак для поврежденных ТС (0 - небитые, 1 - битые или не на ходу), по умолчанию 0. | Необязательное | |||||||||||
HasNoDocs | Признак для проблем с документами (0 - документы в порядке, 1 - документы с проблемами или отсутствуют), по умолчанию 0. | Необязательное |
Секция фотографий имеет следующую структуру:
<Photos
PhotoDir="{сайт и директория с фотографиями}"
PhotoMain="{файл главного фото}"
>
<Photo>{фото 1}</Photo>
...
<Photo>{фото N}</Photo>
</Photos>
где должны быть указаны адрес сайта и директория с файлами фотографий с расширением .jpg или .jpeg, файл главной фотографии и всех остальных. Если фотографий в объявлении нет, эту секцию можно опустить.
Тег Photos может содержать следующие атрибуты:
Фотографии из вашего xml-файла загружаются один раз. Чтобы обновить фотографии в объявлении, загрузите их по новым ссылкам и замените старые ссылки на новые в xml-файле.
Секция Dealers нужна в том случае, если вы хотите изменить данные в карточке продавца через файл автозакачки.
В секции Dealers может быть указан только один блок Dealer.
<Name>ФИО лица или название организации</Name>
<Address>адрес</Address>
<Url>адрес сайта</Url>
</Dealer>
Секция Discounts нужна в том, случае, если в вашей базе есть новые автомобили, на которые действуют скидки, и вашей карточке продавца присвоен статус «Официальный дилер».
Блок Discounts состоит из отдельных подсекций Discount с данными по каждой скидке.
<Discount>
<idDiscount> уникальный id скидки </idDiscount>
<VIN>VIN или номер кузова авто, на которое распространяется скидка</VIN>
<discount> размер скидки </discount>
<idDiscountType> 1 — скидка в процентах, 2 — скидка в рублях </idDiscountType>
<name> название скидки </name>
<description> описание скидки </description>
</Discount>
Скидка распространится на все объявления в базе пользователя, которые подойдут под условия, заполненные в полях скидки.
Жирным шрифтом помечены обязательные поля.
Также блок Discounts может содержать тег MaxDiscount, аналогичный блоку Discount, но показывающий, какая максимальная скидка предлагается для продаваемого авто. Тег полезен в тех случаях, когда есть много различных условий снижения цены, но их невозможно применить одновременно. Название для такой скидки задать нельзя.
<MaxDiscount>
<idMaxDiscount> уникальный id скидки </idMaxDiscount>
<VIN>VIN или номер кузова авто, на которое распространяется скидка</VIN>
<maxDiscount> размер скидки </maxDiscount>
<idDiscountType> 1 — скидка в процентах, 2 — скидка в рублях </idDiscountType>
</MaxDiscount>
В объявление можно добавить видео с YouTube, тогда оно появится рядом с фотографиями продаваемого авто. Для этого укажите ссылку на видеоролик в поле Additional секции Offer.
Файл-справочник содержит в себе все необходимые данные для генерации ваших xml-файлов. В нем приведены названия фирм, моделей, городов, авторынков характеристик ТС. Каждому из значений сопоставлен идентификатор, который используется в вашем xml-файле объявлений. Если в полях объявления указаны значения, отсутствующие в справочнике, то объявление не будет добавлено (либо соотв. поля данных в нем будут пустыми).
Свежая версия справочника для легковых авто (обновляется по мере добавления новых данных в наши базы) всегда доступна для скачивания по этому адресу: www.drom.ru/cached_files/autoload/files/ref.xml.
Справочники для раздела грузовиков и спецтехники:
Если в ваших объявлениях встречаются фирмы/модели/города/авторынки, отсутствующие в нашем справочнике, просим написать об этом по e-mail: client@drom.ru.
Важное уточнение: модельные ряды в нашем справочнике не включают в себя комплектации автомобилей, поэтому мы не будем добавлять такие модели, как Hyundai New Avante XD (поскольку в справочнике уже есть модель Hyundai Avante) или Nissan Skyline GT-S 2.5 (есть модель Nissan Skyline). Модельный ряд Mercedes-Benz также представлен в виде линеек (A-Class, B-Class и т.д.). Иными словами, прежде чем писать письмо с просьбой добавить модели, внимательно посмотрите на уже имеющиеся.
При использовании специальных символов стандарт строго требует кодировать их следующим образом:
Перед публикацией XML-файла его стоит проверить на корректность, используя XML схему автозакачки. Получить схему можно по адресу www.drom.ru/autoload/files/drom_autoload.xsd.
— Как отслеживать автовыгрузку?
Ознакомиться с отчетами по автовыгрузке можно в личном кабинете, также отчеты направляются на указанный при подключении адрес электронной почты.
— Каким образом поступить с уже размещенными до начала автовыгрузки объявлениями?
После подключения автовыгрузки текущие объявления заменятся (при условии совпадения VIN), средства дополнительно за них списываться не будут.
Если в файле автовыгрузки есть объявления, которые уже ранее были вами размещены на нашем сайте и теперь находятся в архиве, то при автовыгрузке предполагается их поднятие (за половину стоимости), а не новое размещение (за полную стоимость). Просьба это учитывать при покупке пакетов скидок.
— Какая стоимость объявлений при автовыгрузке?
Стоимость размещения объявлений варьируется в зависимости от региона, все подробности здесь: www.drom.ru/commerce/calc/
— Как начать автовыгрузку?
Для автоматической выгрузки объявлений на сайт необходимо подготовить файл по нашим настройкам: www.drom.ru/misc/autoload/
Стоимость услуг и пакеты со скидками проверьте здесь: www.drom.ru/commerce/calc/
Для подключения автоматической выгрузки нашей стороне нужна будет актуальная ссылка на файл, ID вашего кабинета на Дроме и контактный e-mail для отправки отчетов по выгрузке.
Запрос на подключение нужно отправить на client@drom.ru или своему менеджеру.
— Как часто на сайте обновляется информация по объявлениям из автовыгрузки?
Стандартная частота выгрузки составляет каждые 6 часов.
— Каким образом через файл автовыгрузки можно отметить, что автомобиль продан и/или удалить объявление?
Из файла автовыгрузки необходимо удалить информацию о неактуальном объявлении, при следующей плановой автовыгрузке объявление будет удалено.
— Возникла проблема с загрузкой фотографий: не обновляются, не загружаются, загружаются не все
При загрузке фотографий мы работаем по схеме «одно фото — одна ссылка». Если вам необходимо заменить фотографию, измените ссылку на это фото в файле автовыгрузки.
Фотографии могут загрузиться не сразу, особенно если файл автовыгрузки содержит большое количество объявлений. Если в течение 1-2 часов фотографии не загружены, напишите нам на client@drom.ru.
— Как отредактировать объявление, поданное через автовыгрузку?
Для изменения параметров в объявлении, поданном через автовыгрузку, необходимо внести исправления в файл автовыгрузки. Отредактировать объявление вручную нельзя.
— Сколько обрабатывается заявка на подключение автовыгрузки объявлений?
На обработку заявки закладывается три рабочих дня.