Фиды для транспортных средств поддерживаются в форматах XML и CSV/TSV. Примеры файлов представлены ниже.
Обязательные поля
| Название, тип и описание | Требования |
|---|---|
| id (строка) - уникальный идентификатор транспортного средства | Максимальное число символов: 128 ID товара должен быть уникальным в рамках одного товарного фида ID товара может включать все символы латинского алфавита в верхнем и нижнем регистре, символы нижнего подчеркивания и дефис, а также цифры Например: 1FADP5AU6DL536022 |
| title (строка) - полное название транспортного средства. В нем должны быть указаны год, марка, модель, комплектация | Максимальное число символов: 256 Например: Volvo XC-90 2022 |
| link (строка) - URL страницы транспортного средства на сайте | Ссылки должны быть рабочими, начинаться с http:// или https:// и размещаться на домене сайта вашей компании Они должны вести на правильную страницу Например: https://www.volvocars.com/ru/v/cars/xc90-hybrid |
| brand (строка) - Марка или производитель транспортного средства | Максимальное число символов: 256 Например: Volvo |
| model (строка) - модель транспортного средства | Максимальное число символов: 256 Например: XC90 |
| image_link (строка) - URL изображения транспортного средства | Допустимые форматы файла изображения — JPEG, PNG, GIF, WEBP Рекомендуемый размер: 600px по большей стороне Минимальный размер: 300px по большей стороне Максимальный размер: 6000px по большей стороне Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: https://somesite.ru/item/10000000188131.jpeg При обновлении изображения обязательно измените ссылку на него, иначе изменения не будут распознаны. Изображение товара должно соответствовать требованиям Правил размещения рекламы. См. также Пояснения к Правилам размещения рекламы |
| price(строка) - цена транспортного средства | Цена в виде числа с трехбуквенным кодом валюты согласно стандарту ISO 4217 через пробел. Значение поля должно быть более 0 Поддерживаемые коды валют:
Например: 1800000 RUB |
| state_of_vehicle (строка) - текущее состояние транспортного средства | Одно из значение:
Например: new |
| year (строка) - год производства | Максимальное число символов: 256 Например: 2020 |
Необязательные поля
| Название и тип | Требования |
|---|---|
| description (строка) - короткое описание транспортного средства | Максимальное число символов: 256 Запрещено использовать рекламный текст или ссылки, а также текст заглавными буквами Например: Absolutely brand new Volvo XC-90, available now |
| exterior_color (строка) - цвет кузова | Максимальное число символов: 256 Например: Black, White, Blue, Red |
| mileage - пробег | |
value (int) - значение пробега (вложено в mileage)
| Требований нет Например: 50000 |
unit (строка) - единица измерения пробега (вложено в mileage)
| Допустимые значения:
Например: KM |
| body_style (строка) - тип кузова | Допустимые значения:
Например: SUV |
| vin (строка) - VIN-номер | Требований нет Например: 1FADP5AU6DL536022 |
| condition (строка) - состояние транспортного средства | Допустимые значения:
Например: GOOD |
| sale_price (int) - цена со скидкой или специальная цена | Требования к содержимому и форматированию аналогичны полю price Например: 2500000 RUB |
| min_price (строка) - минимальная цена транспортного средства. При добавлении минимальной цены товара в баннер перед ценой указывается предлог «от» | Требования к содержимому и форматированию аналогичны полю price Например: 2000000 RUB |
| max_price (строка) - максимальная цена транспортного средства. При добавлении максимальной цены товара в баннер перед ценой указывается предлог «до» | Требования к содержимому и форматированию аналогичны полю price Например: 5000000 RUB |
custom_label (строка) - пользовательские поля с дополнительной информацией. Используются при создании групп продуктов Варианты: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
| Максимальное число символов: 256 Например: Летняя распродажа |
| availability (строка) - текущая доступность транспортного средства | Допустимые значения:
Например: в наличии |
| vehicle_type (строка) - вид транспортного средства | Допустимые значения:
Например: car_truck |
| location - месторасположение товара | |
address (строка) - адрес (название улицы) (вложено в location)
| Максимальное число символов: 256 Например: 3-я улица Строителей, 55 |
country (строка) - страна (вложено в location)
| Максимальное число символов: 256 Например: Россия |
region (строка) - регион (вложено в location)
| Максимальное число символов: 256 Например: Республика Татарстан |
locality (строка) - населенный пункт (вложено в location)
| Максимальное число символов: 256 Например: Казань |
metro (строка) - ближайшая станция метро (вложено в location)
| Максимальное число символов: 256 Например: Проспект Победы |
(вложено в metro) | Например: Удельная |
Обязательные поля для мобильных приложений
| Название, тип и описание | Требования |
|---|---|
| android_tracking_url (строка) - трекинг-ссылка для Android | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int |
| ios_tracking_url (строка) - трекинг-ссылка для iOS | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/id1154436683?pid=mail.ru_int |
| android_app_link (строка) - идентификатор Android приложения | Требований нет Например: ru.sunlight.sunlight |
mobile_ios_app_store_id (строка) - идентификатор iOS приложения | Требований нет Например: 1068913968 |
| mobile_android_app_link (строка) - диплинк для Android | URL-схемы полей mobile_android_app_link и mobile_ios_app_link должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
| mobile_ios_app_link (строка) - диплинк для iOS | URL-схемы полей mobile_android_app_link и mobile_ios_app_link должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
Пример каталога для транспортных средств — XML
<?xml version="1.0" encoding="UTF-8"?><channel> <title>Sample Vehicles Feed</title> <link rel="self" href="https://www.example.com/dealers/cars/1234/?r=vddn" /> <item> <id>3456553</id> <title>Volvo XC-90</title> <description>Позвольте себе совершенно иной уровень комфорта и безопасности за рулем нового Volvo XC-90</description> <link>https://www.volvocars.com/ru/v/cars/xc90-hybrid</link> <brand>Volvo</brand> <model>XC-90</model> <year>2022</year> <image_link>https://www.example.com/1234/image_1.jpg <image_link> <mileage> <value>0</value> <unit>KM</unit> </mileage> <vin>1A2BCDEF3GH456789</vin> <body_style>SUV</body_style> <price>6000000 RUB</price> <location> <address>3-я улица Строителей, 55</address> <locality>Санкт-Петербург</locality> <region>Ленинградская область</region> <country>Россия</country> <metro> <name>Удельная</name> </metro> </location> <exterior_color>Белый</exterior_color> <state_of_vehicle>Новый</state_of_vehicle> </item></channel>