Примеры фидов для Директа: YML, Google Shopping, Авто.ру

В справке есть четыре примера кода: офер YML (упрощённый тип), офер YML для приложений, формат Google Shopping (RSS 2.0) и автомобиль для Авто.ру (XML). Примеров YML для категорий «Образование» и «Медицина» и готового CSV-фида в тексте нет. Какие элементы обязательны, примеры не говорят.

Цифры

Какие примеры есть

ФорматКорень и вложенностьГде пример
YML, упрощённый тип<offer id="…" available="true"> внутри <offers>страница «Требования к YML-фиду»
YML для приложенийтот же <offer>, в <url> трекинговая ссылкастраница про YML для приложений
Google Shopping<channel> → <item>, поля с префиксом g:страница «Продажа товаров. Прочие типы»
Авто.ру<data> → <cars> → <car>страницы «Примеры фидов» и «Другие категории»
Отели (CSV)первая строка — названия столбцовфайл скачивают на странице «Другие категории»

Подробности

YML, упрощённый тип

Элементы офера в примере: url (со ссылкой на страницу и UTM-метками), price, oldprice, currencyId, categoryId, несколько picture, store, pickup, delivery, name, vendor, vendorCode, description, video, sales_notes, manufacturer_warranty, country_of_origin, age (с атрибутом unit="year"), property (с атрибутом name). У самого офера атрибуты id и available.

YML для продвижения приложений

Набор элементов тот же, кроме property. В url стоит ссылка трекера с параметрами advertising_id, pid, clickid, deep_link_value.

Google Shopping

Внутри канала: title и link магазина, дальше каждый товар в <item>. Поля товара в примере: g:link, g:id, g:price (число с кодом валюты), g:sale_price, g:condition (new), g:availability (in_stock), g:product_type, g:image_link, g:brand, g:google_product_category, g:title, g:description.

Авто.ру

Поля автомобиля в примере: mark_id, folder_id, modification_id, url, images, body_type, color, availability, custom, year, price, currency (RUR), vin, owners_number. В примере нового автомобиля на странице примеров есть ещё max_discount.

Отели

В тексте страницы только ссылка «Скачать пример фида для отелей в формате CSV». Столбцы и их смысл описаны в статье про требования к фидам.

Важно знать

  • Страница примеров заявляет примеры для категорий в YML и для автомобилей в XML, но по тексту на ней только автомобиль. YML-примеры лежат на страницах требований.
  • В примерах не отмечено, какие элементы обязательны. Обязательность смотреть в требованиях и в отчёте об ошибках при загрузке.
  • В примерах для YML каждая картинка записана отдельным <picture>, а валидация требует, чтобы элемент встречался не больше одного раза. Подробности — в статье про требования.
  • На странице «Другие категории» у примера Авто.ру в тексте виден один вариант, хотя предусмотрены вкладки «Для нового» и «Для подержанного».