Это уникальный идентификатор, который вы присваиваете каждому объявлению в файле. Он помогает Авито распознавать объявления от загрузки к загрузке.
Идентификаторы не должны повторяться и их нельзя менять — тогда вы избежите блокировок и других ошибок. Присвоить Id можно двумя способами:
Если вы создаёте свой файл или используете шаблон Авито, придумайте Id самостоятельно. Заранее подумайте над правилами, по которым будете составлять его, — так будет проще добавлять новые Id. Например, можно использовать нумерацию по порядку.
Если вы работаете в CRM, ERP или другой системе, там есть идентификатор товара или объявления. Можно использовать его.
Id может состоять из цифр, русских и английских букв, а также символов , \ / ( ) [ ] - =. Всего — не более 100 знаков.
<Id>xjfdge4735202</Id>
Это дата и время размещения объявления. Чтобы оно опубликовалось в начале дня по Москве, укажите дату в одном из форматов:
— dd.MM.yyyy
— dd.MM.yy
— yyyy-MM-dd
Чтобы публикация произошла с точностью до часа, добавьте время через пробел в формате HH:mm:ss или HH:mm.
Если хотите явно указать часовой пояс, используйте формат ISO 8601: YYYY-MM-DDTHH:mm:ss+hh:mm.
Несколько важных моментов:
— Если в указанную дату автозагрузка будет выключена или тариф не оплачен, объявление не опубликуется.
— Если дата из DateBegin ещё не наступила, а объявление уже размещено, оно закроется. Когда эта дата наступит, объявление снова опубликуется.
— Публикация объявления по DateBegin не зависит от расписания загрузки вашего файла и произойдёт в указанную дату и время.
<DateBegin>24.09.24 13:00</DateBegin>
Это дата и время окончания размещения. Чтобы объявление закрылось в конце дня по Москве, укажите дату в одном из форматов:
— dd.MM.yyyy
— dd.MM.yy
— yyyy-MM-dd
Чтобы объявление закрылось с точностью до часа, добавьте время через пробел в формате HH:mm:ss или HH:mm.
Если хотите явно указать часовой пояс, используйте формат ISO 8601: YYYY-MM-DDTHH:mm:ss+hh:mm.
Если вы укажете уже прошедшую дату, автозагрузка не обработает объявление.
<DateEnd>24.09.24 13:00</DateEnd>
Вариант платного размещения
- Package -- размещение объявления осуществляется только при наличии подходящего пакета размещения
- PackageSingle -- при наличии подходящего пакета оплата размещения объявления произойдет с него; если нет подходящего пакета, но достаточно денег на кошельке Авито, то произойдет разовое размещение
- Single -- только разовое размещение, произойдет при наличии достаточной суммы на кошельке Авито; если есть подходящий пакет размещения, он будет проигнорирован
<ListingFee>PackageSingle</ListingFee>
Услуга продвижения
Чтобы услуга подключилась, в кошельке на Авито должно быть достаточно рублей или бонусов.
За загрузку к объявлению можно подключить только одну услугу. Пока она действует, добавить ещё одну такую же не получится. Если вы попробуете это сделать, они подключатся по очереди. Разные услуги, которые увеличивают просмотры, тоже не сочетаются друг с другом.
- Free -- обычное объявление, услуги не подключаются
- Highlight -- «Выделение цветом» (действует 7 дней)
- XL -- «XL-объявление» (действует 7 дней)
- x2_1 -- «До 2 раз больше просмотров на 1 день»
- x2_7 -- «До 2 раз больше просмотров на 7 дней»
- x5_1 -- «До 5 раз больше просмотров на 1 день»
- x5_7 -- «До 5 раз больше просмотров на 7 дней»
- x10_1 -- «До 10 раз больше просмотров на 1 день»
- x10_7 -- «До 10 раз больше просмотров на 7 дней».
- x15_1 -- «До 15 раз больше просмотров на 1 день». Доступно в некоторых регионах и категориях.
- x15_7 -- «До 15 раз больше просмотров на 7 дней». Доступно в некоторых регионах и категориях.
- x20_1 -- «До 20 раз больше просмотров на 1 день». Доступно в некоторых регионах и категориях.
- x20_7 -- «До 20 раз больше просмотров на 7 дней». Доступно в некоторых регионах и категориях.
<AdStatus>x10_7</AdStatus>
Это номер объявления на Авито.
Если вы добавляете в файл новое объявление, не заполняйте AvitoId. Номер присвоится автоматически.
Вы заполняете AvitoId сами, только если добавляете в файл уже размещённое объявление. Причины могут быть разные — например, вы размещали его не через автозагрузку или у него изменился Id. Тогда Авито сможет сопоставить объявления, а вы избежите ошибок.
Есть два способа узнать AvitoId. Первый — скачать файл с объявлениями в настройках автозагрузки. Второй — поискать номер в объявлении, он будет либо внизу, либо вверху страницы.
Если у вас появились проблемы с заполнением поля AvitoId, можете указать его в поле Description в формате: «AvitoId: ХХХ», где ХХХ — это номер объявления. Пользователи Авито не увидят эту информацию.
Вариант 1. Отдельный элемент <AvitoId>742817810</AvitoId>
Вариант 2. Внутри элемента Description <Description> Автомобиль покупался новым в мае 2013 года, все ТО пройдены по регламенту. AvitoId: 742817810 </Description>
Контактный телефон — строка, содержащая только один российский номер телефона. Обязательно указать код города или мобильного оператора:
— Код города должен указываться с +7 или 8 в начале
— Код мобильного оператора можно без 8 и 7 в начале
Корректные примеры:
— +7 (495) 777-10-66
— (81374) 4-55-75
— 8 905 207 04 90
— +7 905 2070490
— 88123855085
<ContactPhone>+7 495 777-10-66</ContactPhone>
Широта в градусах — десятичные дроби
Вместе с параметром Longitude используется для указания точки на карте с помощью географических координат.
Является альтернативой элементу Address.
<Latitude>55.778669</Latitude>
Долгота в градусах — десятичные дроби
Вместе с параметром Latitude используется для указания точки на карте с помощью географических координат.
Является альтернативой параметру Address.
<Longitude>37.587964</Longitude>
Включение интернет-звонков через Авито. По объявлениям смогут звонить по интернету. Вы не пропустите звонки и не потеряете клиентов: если интернет плохой, в объявлении покажем временный номер, а вся история вызовов сохранится в чате.
Интернет-звонки работают корректно, если вы укажете устройство для приёма звонков в параметре CallsDevices.
Преимущества интернет-звонков:
— Легко отличить важные вызовы от спама: видно кто звонит и по какому объявлению.
— Сделки совершаются быстрее: пользователи с включенными интернет-звонками получают на 24% больше звонков.
Входящие интернет-звонки через Авито можно отключить для всех объявлений в Настройках в любое время.
- Да
- Нет
<InternetCalls>Да</InternetCalls>
Идентификатор (ID) мобильного устройства, на которые будут приходить интернет-звонки. Можно выбрать одно или несколько для каждого объявления.
Идентификатор устройства (ID) можно посмотреть в Настройках (на мобильных устройствах — в профиле) → «Устройства для приёма звонков через Авито».
Если ничего не выбрать, звонки будут поступать на первое устройство из списка.
<CallsDevices><Option>123456789</Option><Option>67890123</Option></CallsDevices>
Текстовое описание объявления в соответствии с правилами Авито — строка не более 7500 символов.
Для объявлений, параметры которых соответствуют оплаченному тарифу, вы можете использовать дополнительное форматирование с помощью HTML-тегов. Для формата XML описание должно быть внутри CDATA. Использовать можно только HTML-теги из списка: p, br, strong, em, ul, ol, li.
Важно:
<Description>Передний бампер Ауди А4 Б8 рестайлинг 2011-2015 под фароомыватели
- Доставка по всей России.
- Запчасти продаются оптом и в розницу. Цена на б/у бампер передний Audi A4 4 B8 (2007-2015) рестайлинг 2011-2015 под фароомыватели (MW-000186810219052016) зависит от состояния запчасти и не является фиксированной. Действуют скидки для постоянных покупателей. Гарантия качества. </Description>
<Description><![CDATA[ <p>Артикул 967 MB (модель Brabus 850)</p> <p>Диски R-22 модель Brabus 850 для Мерседес Геленваген (Mercedes Gelandewagen) G-класса (W-463). В сборе с высокоскоростными шинами. Колеса совершенно новые, отбалансированы и готовы к установке.</p> <ul> <li>Оплата наличным или безналичным расчетом. <li>Доставка в пределах МКАД-бесплатно, за МКАД – 30 руб./км <li>Доставка в регионы осуществляется транспортной компанией. <li>При покупке комплекта колес установка и балансировка бесплатно! </ul>]]></Description>
Цена в рублях --- целое число.
Что бы назначить скидку для автомобилей используйте элементы:
Цена со скидкой рассчитывается автоматически как разница между Price и MaxDiscount. Для б/у автомобилей скидки доступны только на Тарифах+.
` <Price>25000</Price>
Фотографии — вложенные элементы, по одному элементу «Image» на каждое изображение. На файл фотографии можно ссылаться с помощью (указание обоих атрибутов не допускается):
— прямой HTTP-ссылки или ссылки на Яндекс Диск (подробнее) — атрибут «url»;
— названия файла с указанием расширения — атрибут «name». Такой способ используется при загрузке файла с объявлениями и архива с фотографиями вручную через Личный кабинет.
Допустимые графические форматы: JPEG, PNG.
Максимальный размер одного изображения – 25 Мб.
К одному объявлению можно добавить не более 10 фотографий, остальные будут проигнорированы.
При загрузке фото по ссылке проверьте, что изображение уже доступно и его можно открыть или скачать.
Чтобы изменить фотографию в объявлении, используйте другую ссылку. Новое изображение по прежнему url-адресу не будет загружено.
<Images> <Image url="http://img.test.ru/8F7B-4A4F3A0F2BA1.jpg" /> <Image url="http://img.test.ru/8F7B-4A4F3A0F2XA3.jpg" /> </Images>
<Images> <Image name="a1.jpg"/> <Image name="a2.jpg"/> <Image name="a3.jpg"/> </Images>
Видеофайл в виде:
— прямых HTTP-ссылок, заканчивающихся на название формата загружаемого видео(.mp4, .mov, .webm, .ogg);
— приватных или публичных ссылок на Яндекс Диск (подробнее).
Для формата XML ссылка на видео должна быть внутри CDATA.
Длительность видео должна составлять от 5 секунд до 3 минут, а размер файла не должен превышать 500 МБ. Иначе видео не загрузится.
Допустимые форматы видео: MP4, MOV, WebM, Ogg.
Загруженный видеоролик будет проигрываться на первом месте в галерее на странице объявления. Также пользователи увидят видео в результатах поиска, но только первые 5 секунд.
Загрузка видео доступна пользователям, имеющим Тариф+.
` <VideoFileURL><![CDATA[https://example.com/filename.mp4]]></VideoFileURL>
Поколение --- числовой идентификатор из Справочника.
Обратите внимание, что только для элементов GenerationId, ModificationId и ComplectationId требуется указывать числовой идентификатор, для остальных, таких как Make и Model мы ожидаем строковое значение элемента (см. примеры в соответствующих разделах документации).
` <GenerationId>334847</GenerationId>
Поколение
` <Generation>I (2017—2021)</Generation>
Модификация --- числовой идентификатор из Справочника.
Обратите внимание, что только для элементов GenerationId, ModificationId и ComplectationId требуется указывать числовой идентификатор, для остальных, таких как Make и Model мы ожидаем строковое значение элемента (см. примеры в соответствующих разделах документации).
` <ModificationId>339991</ModificationId>
Модификация
` <Modification>3.6 FSI AT (249 л.с.)</Modification>
Комплектация --- числовой идентификатор из Справочника.
Обратите внимание, что только для элементов GenerationId, ModificationId и ComplectationId требуется указывать числовой идентификатор, для остальных, таких как Make и Model, мы ожидаем строковое значение элемента (см. примеры в соответствующих разделах документации).
` <ComplectationId>415537</ComplectationId>
Комплектация
` <Complectation>Exclusive</Complectation>
Коробка передач
` <Transmission>Автомат</Transmission>
Внимание: при указании элементов GenerationId и ModificationId значение элемента EngineSize игнорируется, фактическое значение будет взято из Справочника для соответствующей модификации и поколения.
Обязательно для всех двигателей кроме электрических: объем двигателя, л --- десятичное число.
` <EngineSize>3.5</EngineSize>
Год выпуска --- в соответствии со значениями Справочника.
Конкретное значение должно соответствовать выбранной модификации и поколению автомобиля, заданными элементами ModificationId и GenerationId.
Для указанных в примере из справочника модификации и поколения допустимо указывать значения от 2008 до 2012 (включительно)
` <Year>2021</Year>
Количество дверей --- в соответствии со значениями из Справочника.
Конкретное значение должно соответствовать выбранной модификации и поколению автомобиля, заданными элементами ModificationId и GenerationId.
Для указанных в примере из справочника модификации и поколения допустимо указывать значения 3 и 5.
` <Doors>3</Doors>
Тип кузова --- в соответствии со значениями из Справочника.
Конкретное значение должно соответствовать выбранной модификации и поколению автомобиля, заданными элементами ModificationId и GenerationId.
Для указанных в примере из справочника модификации и поколения допустимо указывать значения "Хетчбэк" и "Универсал".
` <BodyType>Универсал</BodyType>
Внимание: при указании элементов GenerationId и ModificationId значение элемента Power игнорируется, фактическое значение будет взято из Справочника для соответствующей модификации и поколения.
Мощность двигателя, л.с. --- целое число.
` <Power>249</Power>
Управление климатом (дополнительные опции)
- Управление на руле
- Атермальное остекление
` <ClimateControlOptions> <Option>Атермальное остекление</Option> <Option>Управление на руле</Option> </ClimateControlOptions>
Электропривод
- Передних сидений
- Задних сидений
- Зеркал
- Рулевой колонки
- Складывания зеркал
` <ElectricDrive> <Option>Передних сидений</Option> <Option>Зеркал</Option> <Option>Складывания зеркал</Option> </ElectricDrive>
Помощь при вождении
- Автоматический парковщик
- Датчик дождя
- Датчик света
- Парктроник задний
- Парктроник передний
- Система контроля слепых зон
- Камера заднего вида
- Круиз-контроль
- Бортовой компьютер
` <DrivingAssistance> <Option>Датчик дождя</Option> <Option>Датчик света</Option> <Option>Парктроник задний</Option> </DrivingAssistance>
Активная безопасность
- Антиблокировка тормозов
- Антипробуксовка
- Курсовая устойчивость
- Распред. тормозных усилий
- Экстренное торможение
- Блок. дифференциала
- Обнаружение пешеходов
` <ActiveSafety> <Option>Антиблокировка тормозов</Option> <Option>Антипробуксовка</Option> <Option>Курсовая устойчивость</Option> </ActiveSafety>
Мультимедиа и навигация
- CD/DVD/Blu-ray
- MP3
- Радио
- TV
- Видео
- Управление на руле
- USB
- AUX
- Bluetooth
- GPS-навигатор
` <Multimedia> <Option>CD/DVD/Blu-ray</Option> <Option>MP3</Option> <Option>Управление на руле</Option> </Multimedia>
VIN или номер кузова (vehicle identification number) --- строка из 17 символов.
Объявления в профиле автоматически связываются по VIN, чтобы избежать блокировок за повторное размещение одного и того же автомобиля и сохранить историю просмотров при смене ID в файле автозагрузки.
Для автомобилей, которые еще не поступили в дилерский центр (<Availability>В пути</Availability>) и нет возможности указать VIN, нужно указать его уникальный Frame/Serial Number.
Подробности — в Помощи.
` <VIN>1FTWR72P1LVA41777</VIN>
Спецусловия кредита
Правила подходят для всех параметров, описывающих спецпредложения.
Описание появится, если в объявлении под списком предложений нажать «Узнать подробности». Пример
— В каждом описании должно быть 10–160 символов.
— В конце каждого текстового блока должна стоять точка.
— В тексте не должно быть смайликов и эмодзи.
У всех участников программы «Авито Селект» не будет видно предложений в объявлениях.
` <OfferSpecialLoanConditions> Этот автомобиль можно оформить в кредит на специальных условиях. Свяжитесь с продавцом, чтобы узнать подробности. </OfferSpecialLoanConditions>
Гарантия на ремонт
Правила подходят для всех параметров, описывающих спецпредложения.
Описание появится, если в объявлении под списком предложений нажать «Узнать подробности». Пример
— В каждом описании должно быть 10–160 символов.
— В конце каждого текстового блока должна стоять точка.
— В тексте не должно быть смайликов и эмодзи.
У всех участников программы «Авито Селект» не будет видно предложений в объявлениях.
` <OfferRepairGuarantee> Если один из ключевых узлов выйдет из строя в течение 6 месяцев, мы бесплатно отремонтируем автомобиль. </OfferRepairGuarantee>