Настройка автоматического закачивания объявлений на Дром
Настройка автоматического закачивания объявлений возможна только при участии вашего программиста. Если у вас есть такой человек, то передайте ему эту инструкцию. Он настроит выгрузку и далее объявления будут размещаться без вашего участия.
Обмен данными по выставляемым машинам будет производиться автоматически. По мере появления на вашем сайте новых машин (или изменения статуса продано/не продано, информации по уже выставленным объявлениям) специальная программа с нашей стороны проверяет с установленной периодичностью ваш сайт (например, 1 раз в день) и вносит изменения в вашу карточку.
Преимуществом данного способа выгрузки является оперативное поступление машин в нашу базу и изменение данных о продаже машин без участия человека в любое время (т.е. разница во времени с другими городами и выходные дни не влияют на работу).
Информация для программиста
- Обмен данными осуществляется с помощью XML-файла, в котором в определенном виде предоставляется вся необходимая информация о продаваемых вами автомобилях.
- Вы обновляете xml-файл на своей стороне с любой периодичностью, например, каждый раз, когда добавляется новая машина или продается одна из уже выставленных. Периодичность и способ генерации выбираете вы сами.
- Drom.ru с заданной периодичностью обрабатывает выложенную информацию.
- Все закачанные ранее объявления, которых нет в текущем xml-файле, будут автоматически удалены. Все объявления, данные которых были изменены, обновятся на сайте.
Для автозакачивания объявлений вам нужен файл-справочник, данные которого понадобятся для создания файла своих объявлений. Файл-справочник содержит в себе списки фирм, моделей, городов и прочей информации, которую нужно использовать при описании объявлений.
Версия свежего справочника всегда доступна на сайте Drom.ru по этому адресу.
Пример файла объявлений можно получить здесь.
Устройство файла объявлений (bulls.xml)
bulls.xml — файл с объявлениями для закачки, который Вам нужно будет генерировать и размещать на своем сайте. Пример такого файла можно скачать здесь.
Название файла может быть любым (в документе назван bulls.xml), используемая кодировка должна быть указана в заголовке xml-файла. Соответственно, текстовые данные в файле должны быть в выбранной кодировке.
Главная секция называется avtoxml, и состоит из следующих секций:
- lastBuildDate — содержит дату/время создания файла
- Offers — секция со списком объявлений (секции Offer)
- Dealers — секция дилера, может отсутствовать
- Discounts — секция со списком скидок, может отсутствовать
Секция Offer
Содержит набор полей для описания одного объявления.
Все поля, названия которых начинаются с id (idMark, idModel, idCountry, idCity, idMarket, idFrameType, idWheelType, idEngineType, idTransmission, idDriveType, idHaulRussiaType), содержат числовые идентификаторы из соответствующих секций файла ref.xml. Все остальные поля содержат числовые и текстовые данные.
Список полей в объявлении (жирным шрифтом помечены обязательные поля):
id комплектации на Дроме (в соответствии с каталогом)
На сайте Drom.ru существуют два раздела продажи автомобилей:
-
— автомобиль находится в РФ либо будет привезен из-за рубежа в один из городов РФ. — автомобиль находится за рубежом, его цена не включает в себя стоимость доставки, таможенные пошлины и т.д.
В зависимости от того, какая схема продажи будет использована, нужно соответствующим образом указать город и страну в данных объявления. Возможны ситуации:
- авто находится в Новосибирске будет означать, что авто в настоящее время действительно находится в Новосибирске, объявление будет размещено в разделе Продажа авто в России.
- авто находится за рубежом, но будет привезено для продажи в один из городов РФ, цена будет включать в себя все расходы, связанные с доставкой и растаможкой. В этом случае в поле idCountry нужно указать страну, в которой сейчас находится авто, а в поле idCity — город в РФ, куда автомобиль будет привезен. Пример: авто в Сингапуре, будет привезено во Владивосток, конечная цена 1 000 000. Объявление будет размещено в разделе Продажа в России, при этом будет указана страна происхождения (Сингапур -> Владивосток)
- авто находится за рубежом, его стоимость не включает в себя расходы, связанные с доставкой и растаможкой. Объявление будет размещено в разделе Авто под заказ. В этом случае нужно указать страну местонахождения автомобиля и указать код города 0.
Убедительно просим вас соблюдать эти правила и размещать объявления в соответствующих разделах! В случае нарушений правил размещения будут приниматься меры, вплоть до удаления объявлений с сайта.
Секция Photos
Секция фотографий имеет следующую структуру:
где должны быть указаны адрес сайта и директория с файлами фотографий с расширением .jpg или .jpeg, файл главной фотографии и всех остальных. Если фотографий в объявлении нет, эту секцию можно опустить.
Тег Photos может содержать следующие атрибуты:
- PhotoMain. В нем должно быть указано наименование основного фото. Если оно отсутствует в списке фотографий, то будет добавлено.
- PhotoDir. Префикс, который будет добавляться ко всем адресам фотографий (в том числе и к главному фото).
Фотографии из вашего xml-файла загружаются один раз. Чтобы обновить фотографии в объявлении, загрузите их по новым ссылкам и замените старые ссылки на новые в xml-файле.
Секция Dealers
Секция Dealers нужна в том случае, если вы хотите изменить данные в карточке продавца через файл автозакачки.
В секции Dealers может быть указан только один блок Dealer.
<idCity>id города</idCity> <Name>ФИО лица или название организации</Name> <Info>дополнительная информация о дилере</Info> <Address>адрес</Address>
Секция Discounts
Секция Discounts нужна в том, случае, если в вашей базе есть машины, на которые действуют скидки и вашей карточке продавца присвоен статус «Официальный дилер».
Блок Discounts состоит из отдельных подсекций Discount с данными по каждой скидке.
<idDiscount> уникальный id скидки </idDiscount> <VIN>VIN или номер кузова авто, на которое распространяется скидка</VIN> <discount> размер скидки </discount> <idDiscountType> 1 — скидка в процентах, 2 — скидка в рублях </idDiscountType> <name> название скидки </name> <description> описание скидки </description>
Скидка распространится на все объявления в базе пользователя, которые подойдут под условия, заполненные в полях скидки.
Жирным шрифтом помечены обязательные поля.
Также блок Discounts может содержать тег MaxDiscount, аналогичный блоку Discount, но показывающий, какая максимальная скидка предлагается для продаваемого авто. Тег полезен в тех случаях, когда есть много различных условий снижения цены, но их невозможно применить одновременно. Название для такой скидки задать нельзя.
<idMaxDiscount> уникальный id скидки </idMaxDiscount> <VIN>VIN или номер кузова авто, на которое распространяется скидка</VIN> <maxDiscount> размер скидки </maxDiscount> <idDiscountType> 1 — скидка в процентах, 2 — скидка в рублях </idDiscountType>
Видео
В объявление можно добавить видео с YouTube, тогда оно появится рядом с фотографиями продаваемого авто. Для этого укажите ссылку на видеоролик в поле Additional секции Offer.
Устройство файла-справочника (ref.xml)
Файл-справочник содержит в себе все необходимые данные для генерации ваших 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-файла его стоит проверить на корректность, используя 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 для отправки отчетов по выгрузке.
— Как часто на сайте обновляется информация по объявлениям из автовыгрузки?
Стандартная частота выгрузки составляет каждые 6 часов.
— Каким образом через файл автовыгрузки можно отметить, что автомобиль продан и/или удалить объявление?
Из файла автовыгрузки необходимо удалить информацию о неактуальном объявлении, при следующей плановой автовыгрузке объявление будет удалено.
— Возникла проблема с загрузкой фотографий: не обновляются, не загружаются, загружаются не все
При загрузке фотографий мы работаем по схеме «одно фото — одна ссылка». Если вам необходимо заменить фотографию, измените ссылку на это фото в файле автовыгрузки. Фотографии могут загрузиться не сразу, особенно если файл автовыгрузки содержит большое количество объявлений. Если в течение 1-2 часов фотографии не загружены, напишите нам на client@drom.ru.
— Как отредактировать объявление, поданное через автовыгрузку?
Для изменения параметров в объявлении, поданном через автовыгрузку, необходимо внести исправления в файл автовыгрузки. Отредактировать объявление вручную нельзя.
— Сколько обрабатывается заявка на подключение автовыгрузки объявлений?