Denvumo · Товарные фиды
YML, XML или CSV: как выбрать формат товарного фида
Формат фида выбирают по требованиям получателя данных. Один и тот же каталог можно представить по-разному, но площадка примет только подходящую структуру с нужными полями. Поэтому задача начинается не с сохранения файла с определённым расширением, а с выбора сценария: реклама товаров, управление ассортиментом или передача предложений в конкретный сервис.
Обновлено 2 ноября 2026 · Практическое руководство
Различайте XML и конкретную схему
XML описывает способ структурировать данные с помощью элементов и атрибутов. YML — формат Яндекса, основанный на XML и задающий правила описания магазина и предложений. Следовательно, корректный XML-файл не обязательно соответствует требованиям YML или другой площадки.
Например, произвольная выгрузка с полями «товар» и «стоимость» может успешно открываться в редакторе, но не иметь ожидаемых элементов. Для подключения нужен документ правил: какие сущности передаются, как они называются и какие сведения обязательны.
Учитывайте особенности CSV
Таблица требует согласованных правил
CSV представляет данные в виде строк и полей. Описание RFC 4180 объясняет распространённые правила разделителей и кавычек, но конкретный получатель может предъявлять дополнительные требования. Важно согласовать названия колонок, кодировку, обработку переносов строки и пустых значений.
Не меняйте расширение готового файла вместо преобразования структуры. Если описание товара содержит запятую или перенос, корректное оформление поля становится частью технической задачи. После сохранения нужно проверить, как файл прочитал получатель, а не только как таблица выглядит у автора.
Выбирайте формат для конкретного сценария
В справке Директа перечислены разные типы фидов, включая YML и CSV для определённых задач. Это не означает, что любой CSV подходит для любой кампании. Сначала выбирают тип предложений и допустимый формат, затем готовят данные по соответствующей спецификации.
Для Маркета YML также связан с назначением файла: обновление каталога и управление размещением различаются требованиями. Один универсальный экспорт для всех кабинетов может оказаться неудобным, даже если исходные товары совпадают. Разделение должно следовать задачам, а не привычке разработчика.
Сопоставьте поля с исходным каталогом
Сохраните смысл данных
Составьте таблицу: поле источника, поле назначения, преобразование и правило при отсутствии значения. Для идентификаторов, валюты, доступности и вариантов товара нужны отдельные решения. Нельзя автоматически считать пустое значение нулём или объединять разные модификации под одним предложением.
Если обязательного свойства нет в источнике, согласуйте способ его заполнения с владельцем каталога. Не подставляйте вымышленные характеристики ради прохождения проверки. Фид должен передавать подтверждённые сведения о реальном предложении.
Принимайте формат через загрузку
Проверьте синтаксис, обязательные поля и несколько сложных предложений: варианты размера, специальные символы, отсутствие необязательного свойства. Затем выполните техническую проверку в нужном кабинете и разберите сообщения. Успешное чтение файла ещё не гарантирует публикацию или показ.
В результат работ включите образец, правила генерации, назначение файла и способ обновления. Для каждой площадки сохраните ссылку на использованную спецификацию и дату проверки. Это позволит сопровождать выгрузку при изменении каталога или требований.
Что взять в работу
YML, XML и CSV описывают разные уровни формата. Совместимость подтверждается структурой, достоверностью полей и проверкой в целевом сервисе.
Официальные источники
Документация помогает уточнить возможности инструментов. Настройки, версии и состав решения проверяются для конкретного проекта.
Обсудим вашу задачу
Товарные фиды: от разбора к внедрению
Согласуем цель, исходные данные, состав работ и способ проверки результата.