Поля фидов каталога VK Рекламы по отраслям и спецификациям

Поля фида зависят от отрасли и спецификации: для товаров и лекарств есть наборы Google и Yandex, для недвижимости и транспорта — основной формат и Yandex, для авиарейсов и гостиниц — основной формат и Google, для услуг один набор. Везде обязательны уникальный ID (до 128 знаков), цена, ссылка на страницу и картинка (300–6000 px по большей стороне, рекомендуют 600 и 1:1); описание — до 256 знаков.

Цифры

Что общего у всех наборов

ПараметрЗначение
IDдо 128 знаков: латиница в обоих регистрах, цифры, нижнее подчёркивание, дефис; уникален в рамках одного фида
Цена (Google и основной формат)число и трёхбуквенный код валюты по ISO 4217 через пробел: 9.99 USD, 700.99 RUB; разделитель — точка; значение больше 0; $, € и £ вместо кода не указывают
Цена (Yandex)число без валюты, точка как разделитель, значение больше 0; валюта в отдельном поле (currencyId или currency)
ВалютыRUR или RUB, USD, EUR, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS (12 валют)
Ссылка на страницурабочая, начинается с http:// или https://, на домене сайта компании, ведёт на правильную страницу каждого объекта
Картинка: форматыJPEG, PNG, GIF, WEBP
Картинка: размерот 300 до 6000 px по большей стороне; рекомендуют 600
Картинка: пропорциирекомендуют квадрат 1:1, иначе площадка меняет размер сама
Картинка: содержимоефон однотонный, лучше белый; только сам объект, без надписей, водяных знаков и логотипов
Картинка: заменапри обновлении картинки меняют ссылку на неё, иначе изменения не распознаются
Картинка: правилаизображение должно соответствовать Правилам размещения рекламы
Картинка: весв справке не нашли
Адрес, регион, город, страна, название, бренддо 256 знаков (отличия — в таблицах по отраслям)
Описаниедо 256 знаков; без HTML и ссылок, лишних знаков препинания, текста только заглавными или только строчными, данных о доставке и компании, телефонов и электронных адресов, списков и многих абзацев
custom_labelпять полей, custom_label_0 … custom_label_4; до 256 знаков; для групп продуктов
min_price и max_priceв баннере перед минимальной ценой стоит «от», перед максимальной «до»
product_typeдо 750 знаков (товары Google, услуги, лекарства Google)

Основные поля и их названия по наборам

НаборIDНазваниеЦенаСсылка на страницуКартинка
Товары, Googleidtitlepricelinkimage_link
Товары, Yandexoffer.idmodel и vendor (name — упрощённый вариант)price и currencyIdurlpicture
Недвижимость, основной форматidtitlepricelinkimage_link
Недвижимость, Yandexoffer.internal-idотдельного поля нет: из building-name или из category, country, locality-name, addressprice (value и currency внутри)urlimage
Транспорт, основной форматidtitle (плюс brand и model)pricelinkimage_link
Транспорт, Yandexunique_id или VINотдельного поля нет: марка mark_id, модель folder_idprice и currencyurlimage внутри images
Услугиidtitlepricelinkimage_link
Авиарейсы, основной форматidorigin_city и destination_citypriceurlimage, внутри url
Авиарейсы, GoogleIDOrigin name и Destination nameFlight priceFinal URLImage URL
Гостиницы, основной форматhotel_idnamepriceurlimage, внутри url
Гостиницы, GoogleProperty IDв списке полей нетPriceFinal URL (или Destination URL, если Final URL не задан)Image URL
Лекарства, Yandexoffer.idmodel и vendor (name — упрощённый вариант)price и currencyIdurlpicture
Лекарства, Googleidtitlepricelinkimage_link

Форматы файла по наборам

НаборЧто названо на странице
Товары, GoogleXML (Atom 1.0 и RSS 2.0), CSV/TSV
Товары, Yandexформаты прямо не названы, пример — XML (YML)
Недвижимость, транспорт, услуги, основной форматXML и CSV/TSV
Недвижимость и транспорт, Yandexформаты прямо не названы, пример — XML
Авиарейсы и гостиницы, основной форматXML и CSV/TSV
Авиарейсы и гостиницы, Googleтолько CSV/TSV
Лекарства, Yandexформаты прямо не названы, пример — XML (YML)
Лекарства, GoogleXML и CSV/TSV

Поля для рекламы мобильных приложений

Шесть полей обязательны в каталогах для мобильных приложений; названия зависят от набора.

Что передаютТовары и лекарства Google; недвижимость, транспорт, услуги (основной формат)Yandex: товары, недвижимость, транспорт, лекарстваАвиарейсы и гостиницы, основной форматАвиарейсы и гостиницы, Google
Трекинг-ссылка для Androidandroid_tracking_urlandroid_tracking_urlandroid_tracking_urlandroid_tracking_url
Трекинг-ссылка для iOSios_tracking_urlios_tracking_urlios_tracking_urlios_tracking_url
Идентификатор Android-приложенияandroid_app_linkbundle_idandroid_package (атрибут applink)Android app link
Идентификатор iOS-приложенияmobile_ios_app_store_idios_app_store_idios_app_store_id (атрибут applink)iOS app store ID
Диплинк для Androidmobile_android_app_linkandroid_urlandroid_url (атрибут applink)Mobile android app link
Диплинк для iOSmobile_ios_app_linkios_urlios_url (атрибут applink)iOS app link
ТребованиеЗначение
Трекинг-ссылкирабочие, начинаются с http:// или https://, домен по используемому трекеру
Домены трекеровMyTracker — trk.mail.ru; Adjust — app.adjust.com; Appsflyer — app.appsflyer.com; AppMetrica — redirect.appmetrica.yandex.com
Идентификаторы приложений (Android и iOS)требований нет
ДиплинкиURL-схемы Android и iOS совпадают; диплинк корректно открывается (рабочий)

Подробности

В таблицах ниже «да» значит поле из списка обязательных на странице, «нет» — из списка необязательных. Общие правила для ID, цены, ссылки, картинки, описания и custom_label даны в первой таблице статьи и здесь только упомянуты. Поля для мобильных приложений вынесены в отдельную таблицу выше.

Товары, спецификация Google

Форматы: XML (спецификации Atom 1.0 и RSS 2.0, в примерах поля с префиксом g) и CSV/TSV.

ПолеОбязательноеЧто в нём
idдастрока, уникальный ID товара; до 128 знаков; пример 10000000179185
titleданазвание товара; до 256 знаков; не только заглавными и не только строчными; пример Футболка
priceдацена по общему правилу; пример 9.99 USD или 700.99 RUB
linkдаURL страницы товара на сайте компании, где о товаре можно узнать больше или купить его
image_linkдаURL основного изображения; требования к картинке общие
brandданазвание бренда; до 256 знаков; пример Sokolov
availabilityнетTrue (в наличии) или False (нет в наличии)
descriptionнетописание; до 256 знаков; правила описания общие
conditionнетnew / новый, refurbished / после ремонта, used / б/у; по-русски или по-английски
age_groupнетadult / взрослые, all ages / любой возраст, teen / подростки, kids / дети старше 3 лет, toddler / дети от 1 до 3 лет, infant / грудные дети, newborn / новорожденные; по-русски или по-английски
genderнетfemale / женский, male / мужской, unisex / унисекс, детский (только по-русски); регистр любой
sale_priceнетцена со скидкой; формат как у price
min_priceнетминимальная цена; в баннере перед ценой «от»; формат как у price; пример 1000 RUB
max_priceнетмаксимальная цена; в баннере перед ценой «до»; формат как у price; пример 5000 RUB
product_typeнеткатегория по системе категоризации рекламодателя (варианты fb_product_category или google_product_category); до 750 знаков; пример Home & Garden > Kitchen & Dining > Appliances > Refrigerators
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков; для групп продуктов; пример Летняя распродажа
ratingнетчисло с плавающей точкой, только положительное, от 1 до 5 включительно; пример 4.0

Товары, спецификация Yandex

Пример на странице — YML: корень yml_catalog, внутри shop, currencies, categories и offers. Если фид сделан по спецификации Яндекс, а товарные позиции имеют произвольный тип (vendor.model), в теге offer обязательно указывают атрибут type со значением vendor.model.

ПолеОбязательноеЧто в нём
offer.idдауникальный ID товара; до 128 знаков; пример 10000000179185
modelдамодель товара; до 256 знаков, рекомендуют до 40; пример Onitsuka Tiger
vendorданазвание производителя; до 256 знаков; пример ASICS
priceдацена числом без валюты; точка вместо запятой; без $, € и £; больше 0; пример 900
currencyIdдавалюта: RUR или RUB, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS; пример RUB
urlдаURL страницы товара на сайте компании
pictureдаURL основного изображения; требования к картинке общие
typePrefixнеттип продукта; до 256 знаков; пример Кроссовки
offer.availableнетTrue (в наличии) или False (нет в наличии)
nameнетназвание товара в упрощённом описании; использовать только если нельзя применить typePrefix, vendor и model; по умолчанию название собирается из этих трёх элементов; не указывать name вместе с ними; пример Ноутбук HP Pavilion 15-n064sr
descriptionнетописание; до 256 знаков; правила описания общие
oldpriceнетстарая цена; формат как у price; пример 900
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
param name="Пол" или param name="Gender"нетпол: female / женский, male / мужской, unisex / унисекс, детский (только по-русски); регистр любой
ratingнетположительное число с плавающей точкой от 1 до 5 включительно; пример 4.0
currenciesнетсписок идентификаторов валют: RUR или RUB, USD, EUR, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS

Недвижимость, основной формат

Форматы: XML и CSV/TSV. В XML-примере корень channel, объект в item, адресные поля и метро внутри location.

ПолеОбязательноеЧто в нём
idдауникальный ID объекта; до 128 знаков
titleданазвание объекта; до 256 знаков; не только заглавными и не только строчными; пример Жилой комплекс «Семейный»
locationдаместорасположение; внутри address, locality, region, country
address (внутри location)даулица; до 256 знаков; пример 3-я улица Строителей, 55
locality (внутри location)данаселённый пункт; до 256 знаков; пример Санкт-Петербург
region (внутри location)дарегион; до 256 знаков
country (внутри location)дастрана; до 256 знаков; пример Россия
priceдацена продажи или аренды по общему правилу; пример 1000000 RUB
image_linkдаURL основного изображения
linkдаURL страницы объекта на сайте компании
brandнетназвание компании-застройщика; до 256 знаков; пример СМУ-88
metro (внутри location)нетближайшая станция метро; если станций несколько, каждая в отдельном элементе
name (внутри metro)нетназвание станции; пример Удельная
sale_priceнетцена со скидкой или специальная; формат как у price
min_priceнетминимальная цена; в баннере перед ценой «от»; пример 9500000 RUB
max_priceнетмаксимальная цена; в баннере перед ценой «до»; пример 11000000 RUB
descriptionнетописание; до 256 знаков
num_roomsнетобщее число комнат (float); требований нет; пример 3
floorнетэтаж (int); требований нет
floors_totalнетвсего этажей в здании (int); требований нет
property_typeнетapartment / квартира, condo / многоквартирный дом, house / дом, land / земля, manufactured / промышленный объект, other / другое, townhouse / таунхаус, office / офис
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
listing_typeнетfor_rent_by_agent / аренда от агента, for_rent_by_owner / аренда от собственника, for_sale_by_agent / продажа от агента, for_sale_by_owner / продажа от собственника, foreclosed / конфискованный, new_construction / новостройка, new_listing, продажа, аренда
area_sizeнетплощадь (int); требований нет; пример 250
area_unitнетsq_ft / кв. фут, sq_m / кв. м, sq. m / кв. м - сотка (так на странице), hectare / гектар; пример sq_m
yearнетгод постройки; строка до 256 знаков; пример 2020
availabilityнетTrue (в наличии) или False (нет в наличии)

Недвижимость, спецификация Yandex

Пример на странице — realty-feed: объявление в теге offer с атрибутом internal-id. Название объекта собирается так: если поле building-name не пустое, берут его значение; если пустое — составное название из category, country, locality-name и address.

ПолеОбязательноеЧто в нём
offer.internal-idдауникальный ID объекта; до 128 знаков
locationдаместорасположение; внутри address, locality-name, region, country
address (внутри location)даулица; до 256 знаков
locality-name (внутри location)данаселённый пункт; до 256 знаков
region (внутри location)дарегион; до 256 знаков
country (внутри location)дастрана; до 256 знаков
priceдацена продажи или аренды; внутри value и currency
value (внутри price)дацена числом (int); точка вместо запятой; больше 0; пример 4000000
currency (внутри price)дакод валюты: RUR или RUB, USD, EUR, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS; не символами $, € и £; пример RUR
imageдаURL основного изображения
urlдаURL страницы объекта на сайте компании
organizationнетназвание компании-застройщика; до 256 знаков
metro (внутри location)нетближайшая станция; несколько станций — каждая в отдельном элементе
name (внутри metro)нетназвание станции
descriptionнетописание; до 256 знаков
roomsнетобщее число комнат (float); требований нет
floorнетэтаж (int); требований нет
floors_totalнетвсего этажей в здании (int); требований нет
categoryнетapartment / квартира, condo / многоквартирный дом, house / дом, land / земля, manufactured / промышленный объект, other / другое, townhouse / таунхаус, office / офис
typeнеттип объявления: продажа или аренда
areaнетплощадь; внутри value и unit
value (внутри area)нетзначение площади; требований нет; пример 250
unit (внутри area)неткв. м / sq. m, сотка, гектар / hectare; пример sq_m
built-yearнетгод постройки; строка до 256 знаков
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков

Транспорт, основной формат

Форматы: XML и CSV/TSV. В XML-примере корень channel, машина в item, адресные поля и метро внутри location, пробег внутри mileage.

ПолеОбязательноеЧто в нём
idдауникальный ID транспортного средства; до 128 знаков; пример 1FADP5AU6DL536022
titleдаполное название: год, марка, модель, комплектация; до 256 знаков; пример Volvo XC-90 2022
linkдаURL страницы транспортного средства на сайте
brandдамарка или производитель; до 256 знаков; пример Volvo
modelдамодель; до 256 знаков; пример XC90
image_linkдаURL изображения транспортного средства
priceдацена по общему правилу; пример 1800000 RUB
state_of_vehicleдаnew / новый, used / с пробегом, cpo / с пробегом сертифицированный
yearдагод производства; строка до 256 знаков; пример 2020
descriptionнеткороткое описание; до 256 знаков; нельзя рекламный текст, ссылки и текст заглавными
exterior_colorнетцвет кузова; до 256 знаков; пример Black, White, Blue, Red
mileageнетпробег; внутри value и unit
value (внутри mileage)нетзначение пробега (int); требований нет; пример 50000
unit (внутри mileage)нетmi / мили, km / км; пример KM
body_styleнетconvertible / кабриолет, coupe / купе, hatchback / хэтчбек, minivan / минивэн, truck / грузовик, suv / внедорожник, sedan / седан, van / фургон, wagon / универсал, crossover / кроссовер, small_car / небольшой автомобиль, other / другое; затем без английской пары: кабриолет, компактвэн, купе, купе-хардтоп, фастбек, фургон, хэтчбек, ландо, лифтбек, лимузин, микровэн, минивэн, внедорожник, фаэтон-универсал, пикап, родстер, седан, тарга, седан-хардтоп, спидстер, внедорожник открытый, универсал, фаэтон
vinнетVIN-номер; требований нет
conditionнетexcellent / отличное, good / хорошее, fair / среднее, poor / требует ремонта, other / другое
sale_priceнетцена со скидкой или специальная; формат как у price; пример 2500000 RUB
min_priceнетминимальная цена; в баннере перед ценой «от»; пример 2000000 RUB
max_priceнетмаксимальная цена; в баннере перед ценой «до»; пример 5000000 RUB
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
availabilityнетв наличии или на заказ
vehicle_typeнетcar_truck / автомобиль, boat / лодка, commercial / коммерческий транспорт, motorcycle / мотоцикл, powersport / пауэрспорт, rv_camper / автодом, trailer / прицеп, other / другое
locationнетместорасположение; внутри address, country, region, locality, metro
address, country, region, locality (внутри location)нетдо 256 знаков каждое; примеры 3-я улица Строителей, 55; Россия; Республика Татарстан; Казань
metro (внутри location)нетближайшая станция; до 256 знаков; пример Проспект Победы
name (внутри metro)нетназвание станции; пример Удельная

Транспорт, спецификация Yandex

Пример на странице: корень data, внутри cars и car; картинки внутри images.

ПолеОбязательноеЧто в нём
unique_id или VINдауникальный идентификатор транспортного средства; до 128 знаков; пример 1FADP5AU6DL536022
urlдаURL страницы транспортного средства на сайте компании
mark_idдамарка или производитель; до 256 знаков; пример Volvo
folder_idдамодель; до 256 знаков; пример XC90
priceдацена числом без валюты; точка вместо запятой; больше 0; пример 1800000
image (внутри images)даURL изображения; требования к картинке общие
currencyдакод валюты: RUR или RUB, USD, EUR, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS; пример BYN
owners_numberдадля новых строго «Не было владельцев»; для с пробегом одно из: Один владелец, Два владельца, Три владельца, Четыре и более
yearдагод производства; строка до 256 знаков
vinдаVIN-номер; требований нет
colorнетбежевый, белый, голубой, желтый, зеленый, золотой, коричневый, красный, оранжевый, пурпурный, розовый, серебряный, серый, синий, фиолетовый, черный
runнетпробег (int); требований нет; пример 10000
body_typeнетКабриолет, Компактвэн, Купе, Купе-хардтоп, Фастбек, Фургон, Хэтчбек, Ландо, Лифтбек, Лимузин, Микровэн, Минивэн, Внедорожник, Фаэтон-универсал, Пикап, Родстер, Седан, Тарга, Седан-хардтоп, Спидстер, Внедорожник открытый, Универсал, Фаэтон
stateнетотличное, хорошее, среднее, требует ремонта, другое
descriptionнеткороткое описание; до 256 знаков; не только заглавными и не только строчными
poi_idнетадрес (название улицы); до 256 знаков; пример 3-я улица Строителей, 55
availabilityнетВ наличии или На заказ
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков

Сервисы услуг

Форматы: XML и CSV/TSV. В XML-примере корень channel, услуга в item, адрес и метро внутри location.

ПолеОбязательноеЧто в нём
idдауникальный ID услуги; до 128 знаков
titleданазвание услуги; до 256 знаков; не только заглавными и не только строчными; пример Доставка воды
priceдацена услуги по общему правилу; пример 9.99 USD или 700.99 RUB
linkдаURL страницы услуги на сайте компании, где можно узнать больше
image_linkдаURL основного изображения
brandданазвание бренда компании, которая оказывает услугу; до 256 знаков; пример Клиника Семейной Медицины
worker_typeдатип исполнителя: physical / физическое лицо, juridical / юридическое лицо
descriptionнетописание услуги; до 256 знаков; правила описания общие
locationнетместо оказания услуг; внутри address, locality, region, country, metro
address, locality, region, country (внутри location)нетадрес исполнителя, населённый пункт, регион, страна; до 256 знаков каждое
metro (внутри location)нетближайшая станция; если станций несколько, каждая в отдельном элементе
name (внутри metro)нетназвание станции; пример Удельная
min_priceнетминимальная цена; в баннере перед ценой «от»; пример 1500 RUB
max_priceнетмаксимальная цена; в баннере перед ценой «до»; пример 2500 RUB
product_typeнеткатегория по системе рекламодателя; до 750 знаков; пример Ремонт > Плиточники
ratingнетрейтинг исполнителя (float); требований нет; пример 4.8
reviews_countнетколичество отзывов (int); требований нет; пример 500
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков

Авиарейсы, основной формат

Форматы: XML и CSV/TSV. В XML-примере корень listings, рейс в listing. Полное название рейса: origin_city, пробел, тире, пробел, destination_city, например Москва — Санкт-Петербург.

ПолеОбязательноеЧто в нём
idдауникальный идентификатор рейса; до 128 знаков; пример 100500
origin_cityдагород отправления; до 256 знаков; пример Москва
destination_cityдагород прибытия; до 256 знаков; пример Казань
imageдаданные об изображениях рейса; внутри url
url (внутри image)дассылка на изображение рейса; требования к картинке общие
urlдассылка на внешний сайт с информацией о рейсе; на домене сайта компании; пример https://example.ru/
priceдацена билета вместе с валютой; пример 5000 RUB
origin_airportнеткод IATA аэропорта отправления; до 256 знаков; пример SVO
destination_airportнеткод IATA аэропорта прибытия; до 256 знаков; пример KZN
sale_priceнетцена со скидкой или специальная; формат как у price; пример 3000 RUB
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
descriptionнеткраткое описание маршрута; до 256 знаков; не только заглавными и не только строчными
brandнетназвание авиакомпании; до 256 знаков; пример Аэрофлот

Авиарейсы, спецификация Google

Только CSV/TSV. Набор полей основан на спецификации Google для авиарейсов с тремя изменениями: добавлено обязательное поле ID; необязательные в Google Origin name и Destination name здесь обязательны; добавлено необязательное поле brand. Полное название рейса: Origin name, пробел, тире, пробел, Destination name.

ПолеОбязательноеЧто в нём
IDдауникальный идентификатор рейса; до 128 знаков; пример 100500
Origin nameдагород отправления; до 256 знаков; пример Москва
Destination nameдагород прибытия; до 256 знаков; пример Казань
Image URLдаданные об изображениях рейса; требования к картинке общие
Final URLдассылка на внешний сайт с информацией о рейсе; на домене сайта компании
Flight priceдацена билета вместе с валютой; пример 5000 RUB
Origin IDнеткод IATA аэропорта отправления; до 256 знаков; пример SVO
Destination IDнеткод IATA аэропорта прибытия; до 256 знаков; пример KZN
Sale Priceнетцена со скидкой или специальная; формат как у price; пример 3000 RUB
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
Flight descriptionнеткраткое описание маршрута; до 256 знаков; не только заглавными и не только строчными
brandнетназвание авиакомпании; до 256 знаков; пример Аэрофлот

Гостиницы, основной формат

Форматы: XML и CSV/TSV. В XML-примере корень listings, гостиница в listing; адрес и метро внутри location, оценка внутри guest_rating.

ПолеОбязательноеЧто в нём
hotel_idдауникальный идентификатор гостиницы в каталоге; до 128 знаков; пример 322223
nameданазвание гостиницы; до 256 знаков; пример IBIS Dynamo Moscow
urlдассылка на внешний сайт, где можно забронировать номер; на домене сайта компании
imageдаизображение гостиницы; внутри url
url (внутри image)даURL изображения гостиницы; требования к картинке общие
locationдаместорасположение; внутри address, locality, region, country
address, locality, region, country (внутри location)даосновной адрес, населённый пункт, регион, страна; до 256 знаков каждое; пример Зеленая ул., 35
priceдастоимость проживания по общему правилу; пример 1000000 RUB
metro (внутри location)нетближайшее метро
name (внутри metro)нетназвание станции; до 4 станций, каждая в отдельном теге metro; до 256 знаков
categoryнеттип гостиницы; до 256 знаков; значения: Отель, Хостел, Апартаменты, Гостевой дом, Коттедж, Вилла, Бунгало, Кемпинг, Глэмпинг
sale_priceнетцена проживания за ночь со скидкой (int); формат как у price; пример 3000 RUB
min_priceнетминимальная цена предложения (int); в баннере перед ценой «от»; пример 3000 RUB
max_priceнетмаксимальная цена предложения (int); в баннере перед ценой «до»; пример 5000 RUB
descriptionнеткраткое описание гостиницы; до 256 знаков; пример Отель в центре Москвы
brandнетбренд сети гостиниц; до 256 знаков; пример Moscow Hotels
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
guest_ratingнетпользовательский рейтинг; внутри score
score (внутри guest_rating)нетзначение рейтинга (float); положительное число от 1 до 10 включительно; пример 5.1

Гостиницы, спецификация Google

Только CSV/TSV.

ПолеОбязательноеЧто в нём
Property IDдауникальный идентификатор гостиницы в каталоге; до 128 знаков; пример 52639
Final URLдассылка на внешний сайт, где можно забронировать номер; на домене сайта компании
Destination URLда, если не задан Final URLссылка на внешний сайт для бронирования; те же требования
Image URLдаURL изображения гостиницы; требования к картинке общие
Addressдаадрес гостиницы; до 256 знаков; пример Зеленая ул., 35
Localityданаселённый пункт; до 256 знаков
Regionдарегион; до 256 знаков
Countryдастрана; до 256 знаков
Priceдастоимость проживания по общему правилу; пример 1000000 RUB
Metroнетназвание станции метро; несколько станций через вертикальную черту; до 256 знаков; пример Удельная
Sale Priceнетцена предложения со скидкой; формат как у price; пример 3000 RUB
Min Priceнетминимальная цена предложения; в баннере перед ценой «от»; пример 3000 RUB
Max Priceнетмаксимальная цена предложения; в баннере перед ценой «до»; пример 5000 RUB
Descriptionнеткраткое описание гостиницы; до 256 знаков
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
Scoreнетпользовательский рейтинг (float); положительное число от 1 до 10 включительно; пример 5.1

Лекарства, спецификация Yandex

Пример на странице — YML: корень yml_catalog, внутри shop, currencies и offers. Для произвольного типа позиций действует то же правило, что у товаров: в теге offer атрибут type со значением vendor.model.

ПолеОбязательноеЧто в нём
offer.idдауникальный ID лекарственного средства; до 128 знаков
modelданазвание лекарственного средства; до 256 знаков, рекомендуют до 40; пример Звездочка гель для наружного применения 1 % 30 г 1 шт
vendorданазвание производителя; до 256 знаков; пример Московский завод лекарственных средств
priceдацена числом без валюты; точка вместо запятой; больше 0; пример 900
currencyIdдавалюта: RUR или RUB, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS
urlдаURL страницы лекарственного средства на сайте компании
pictureдаURL основного изображения; требования к картинке общие
pharma_reg_numberдарегистрационный номер в государственном реестре лекарственных средств; до 256 знаков; пример П N012507/01
typePrefixнеттип продукта; до 256 знаков; пример Гель для наружного применения
offer.availableнетTrue (в наличии) или False (нет в наличии)
nameнетназвание в упрощённом описании; использовать только если нельзя применить typePrefix, vendor и model; не указывать вместе с ними
descriptionнетописание; до 256 знаков; правила описания общие
oldpriceнетстарая цена; формат как у price; пример 900
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
genderнетпол: female / женский, male / мужской, unisex / унисекс, детский (только по-русски); задаётся как param name="Пол" или param name="Gender"; регистр любой
ratingнетположительное число с плавающей точкой от 1 до 5 включительно
currenciesнетсписок идентификаторов валют: RUR или RUB, USD, EUR, UAH, BYN, KZT, MDL, AZN, UZS, AMD, TJS, KGS
dosageнетдозировка; до 256 знаков; пример 680 мг+80 мг
form_factorнетформа выпуска; до 256 знаков; пример таблетки

Лекарства, спецификация Google

Форматы: XML (в примерах RSS и Atom) и CSV/TSV.

ПолеОбязательноеЧто в нём
idдауникальный ID товара; до 128 знаков
titleданазвание; до 256 знаков; не только заглавными и не только строчными
priceдацена по общему правилу; пример 9.99 USD или 700.99 RUB
linkдаURL страницы товара на сайте компании
image_linkдаURL основного изображения; требования к картинке общие
brandданазвание бренда; до 256 знаков
pharma_reg_numberдарегистрационный номер в государственном реестре лекарственных средств; до 256 знаков; пример П N012507/01
availabilityнетTrue (в наличии) или False (нет в наличии)
descriptionнетописание; до 256 знаков; правила описания общие
conditionнетnew / новый, refurbished / после ремонта, used / б/у; по-русски или по-английски
age_groupнетadult / взрослые, all ages / любой возраст, teen / подростки, kids / дети старше 3 лет, toddler / дети от 1 до 3 лет, infant / грудные дети, newborn / новорожденные
genderнетfemale / женский, male / мужской, unisex / унисекс, детский (только по-русски); регистр любой
sale_priceнетцена со скидкой; формат как у price
min_priceнетминимальная цена; в баннере перед ценой «от»; пример 1000 RUB
max_priceнетмаксимальная цена; в баннере перед ценой «до»; пример 5000 RUB
product_typeнеткатегория по системе рекламодателя (варианты fb_product_category или google_product_category); до 750 знаков; пример Каталог → Лекарства и БАД → Простуда и грипп → Боль в горле
custom_labelнетcustom_label_0 … custom_label_4; до 256 знаков
ratingнетположительное число с плавающей точкой от 1 до 5 включительно
dosageнетдозировка; до 256 знаков; пример 680 мг+80 мг
form_factorнетформа выпуска; до 256 знаков; пример таблетки

Какие примеры файлов есть на страницах

  • Товары Google: XML Atom 1.0, XML RSS 2.0, CSV и фрагмент с мобильными параметрами (RSS).
  • Товары Yandex: XML (yml_catalog) и фрагмент с мобильными параметрами.
  • Недвижимость: XML и CSV; Yandex — XML (realty-feed).
  • Транспорт: XML и CSV; Yandex — XML (data, cars, car).
  • Услуги: XML и CSV.
  • Авиарейсы: XML и CSV; Google — CSV.
  • Гостиницы: XML и CSV; Google — CSV.
  • Лекарства Yandex: XML (yml_catalog) и фрагмент с диплинками и трекинговыми ссылками; лекарства Google: XML RSS, XML Atom и CSV.
  • Файлы CSV предлагают скачать со страницы.

Важно знать

  • Форматы файла: страницы гостиниц и авиарейсов (основной формат) называют XML и CSV/TSV. В статье про общие требования к каталогу для CSV перечислены товары, недвижимость, транспорт и услуги, а для гостиниц и авиарейсов назван только TSV. Для наборов Google по авиарейсам и гостиницам страницы однозначны: только CSV/TSV. Что принимает загрузка, проверить в кабинете.
  • Наличие: в таблицах полей availability для товаров, недвижимости и лекарств принимает True или False, а в XML-примерах товаров и лекарств Google стоит in stock (в примере недвижимости — true). Какое значение принимает импорт, проверить в кабинете.
  • Yandex для товаров и лекарств: model и vendor стоят в обязательных, но name разрешён вместо typePrefix, vendor и model, и в XML-примере товаров есть только name. Пройдёт ли фид без model и vendor, справка не говорит.
  • Валюты: в currencyId для товаров и лекарств Yandex названы 10 валют без USD и EUR, в поле currencies — 12 валют с ними; у недвижимости и транспорта Yandex в поле currency USD и EUR есть.
  • Недвижимость Yandex: в таблице поле floors_total, а в XML-примере floors; в примере есть ещё property-type, apartment и generation-date, которых нет в таблицах. Поле building-name, от которого зависит название объекта, в списке полей не описано.
  • Площадь в основном формате недвижимости: значение «sq. m / кв. м - сотка» записано на странице неоднозначно, как оно читается, проверить в кабинете.
  • Максимальная цена: в описании max_price на страницах товаров Google, транспорта, обоих наборов гостиниц и лекарств Google сказано «при добавлении минимальной цены… предлог «до»». Предлог «до» относится к max_price, а в тексте, вероятно, опечатка.
  • Формат цены в основном формате транспорта: на странице сказано про число, код валюты через пробел и значение больше 0, а правил про точку как разделитель и про запрет символов $, € и £, которые есть на остальных страницах с форматом «число и код», нет.
  • Тип sale_price: на страницах транспорта, авиарейсов и гостиниц указан int, но формат «как у price», и в примерах значение с кодом валюты (2500000 RUB). Для min_price и max_price гостиниц то же.
  • Транспорт: в title должны быть год, марка, модель, комплектация, а в XML-примере title без года (Volvo XC-90). В примере значения записаны иначе, чем в таблицах: Новый, SUV, KM.
  • Транспорт Yandex: идентификатор задаётся как unique_id или VIN, и при этом vin стоит отдельной строкой среди обязательных; в XML-примере присутствуют оба поля.
  • Поля в XML-примерах, которых нет в таблицах: phone у услуг и гостиниц, sale_price у услуг, applink у гостиниц (описан только в блоке мобильных приложений), google_product_category у лекарств Google.
  • Диплинки в примерах Yandex (товары, лекарства) записаны так: ios_url без двоеточия (clips//clip/105207/), android_url с двоеточием; требование о совпадении схем в таком примере не выполняется. В XML-примерах также есть незакрытые теги. Копировать как есть нельзя.
  • Диплинки лекарств Google: в примерах кроме схемы приложения есть обычная https-ссылка.
  • Трекинговые ссылки в XML-примере товаров Google записаны без префикса g, остальные поля с префиксом g.
  • Google, гостиницы: поле Destination URL стоит среди обязательных, но нужно только если не задан Final URL; названия гостиницы (name) в списке полей Google нет.
  • Картинки: требования одинаковы для всех отраслей, включая недвижимость, авиарейсы и гостиницы («только сам продукт», без надписей и логотипов); как это относится к таким объектам, справка не уточняет. Предельного веса файла на страницах нет.
  • Рейтинг: у товаров и лекарств допустимо от 1 до 5, у гостиниц от 1 до 10, у исполнителей услуг требований нет.