Товарный фид для рекламы — подготовка и проверка | FITTIN
+7 (800) 444-11-27
Позвоните — обсудим ваш проект
Сергей CCO FITTIN
Сергей CCO FITTIN
Напишите мне в Telegram
Обсудить проект
Товарный фид передаёт карточки из каталога на внешние площадки — объёмная композиция с витринами и сумкой

Как подготовить товарный фид для рекламных площадок

Как подготовить товарный фид для рекламных площадок, если каталог, цены и остатки хранятся в разных системах? Начните с источников данных и правил передачи. В статье разберём поля, учебный YML-пример, обновления и проверку ошибок, чтобы команда могла контролировать актуальность предложений.


Что такое товарный фид и куда он передаёт данные

Товарный фид — файл с предложениями магазина в формате, который понимает внешняя площадка. Он связывает карточку товара с ценой, наличием, изображениями и ссылкой на покупку. Рекламная система читает эти данные и использует их при создании товарных объявлений.

В рекламе покупатель обычно переходит на сайт магазина. На маркетплейсе каталог участвует в размещении товаров внутри площадки, а продажи требуют настройки склада, доставки и обработки заказов. Совпадение формата YML не делает два подключения взаимозаменяемыми: состав полей и способы передачи изменений проверяют для конкретного кабинета и модели работы.

Начните с одного направления: например, передача товаров интернет-магазина в Яндекс Директ. Зафиксируйте формат, тип кампании и ассортимент. Затем подготовьте отдельное соответствие полей для Маркета или другой площадки. Общую исходную базу каталога можно сохранить, а правила выгрузки разделить.

Этап 1. Определите источник данных и ответственных

Этап 1 · Карта источников товарных данных

Для каждого поля определите систему, из которой оно поступает, и сотрудника, который исправляет ошибки. Это помогает устранить причину расхождений между рекламой и магазином.

Каталог может храниться в системе управления сайтом, цены и остатки — в учётной системе, фотографии — в отдельном хранилище. Выгрузка должна получать согласованные значения. Если описание обновили на сайте, а генератор продолжает читать старую копию, повторная загрузка файла сохранит ошибку.

ДанныеЧто согласоватьКто проверяет
Каталог и описанияКакие карточки разрешены к передаче, какой вариант показыватьОтветственный за каталог
ЦенаРозничная цена, валюта, условия скидкиКоммерческий отдел
НаличиеДоступный для продажи остаток с учётом резервов и регионаСклад и команда интеграции
Ссылки и изображенияДоступность роботу и соответствие варианту товараКоманда сайта
ВыгрузкаРасписание, журнал ошибок, уведомленияНазначенный технический специалист

Передавайте только данные, нужные для товарного предложения. Персональные сведения покупателей и внутренние закупочные цены в рекламный файл не включают. Если один товар доступен в нескольких регионах по разным условиям, заранее выберите схему, поддерживаемую площадкой.

Источники товарного фида — модули каталога, цен и склада передают данные в единый лоток

Этап 2. Сопоставьте идентификаторы и поля

Этап 2 · Таблица соответствия полей

Свяжите внутренние поля каталога с требованиями получателя. Рядом с каждым полем отметьте обязательность, формат и правило проверки.

Идентификатор предложения должен оставаться постоянным при изменении цены, названия или фотографии. Используйте устойчивый код варианта товара, а не номер строки выгрузки. После сортировки каталога номер строки меняется, и площадка может принять прежний товар за новый.

Варианты и устойчивые коды

Размер и цвет могут определять самостоятельное предложение: у белой футболки размера M и такой же футболки размера L разные остатки. Каждому продаваемому варианту нужен свой идентификатор и ссылка, открывающая соответствующий выбор. Объединение вариантов в группу настраивают только через механизм, описанный площадкой.

  • Название. Укажите товар и различающие характеристики, совпадающие с карточкой.
  • Цена и валюта. Передайте числовое значение без знака рубля и согласуйте валюту с настройками файла.
  • Категория. Свяжите предложение с существующей категорией; проверьте требования к классификатору получателя.
  • Ссылка. Ведите на доступную карточку нужного товара, а не на главную страницу.
  • Изображение. Передайте прямой адрес фотографии именно этого варианта.
  • Наличие. Рассчитайте возможность покупки по правилам магазина и поддерживаемым значениям площадки.

Точный перечень обязательных полей зависит от формата и типа предложения. Для товарного YML в Директе сверяйтесь с официальной спецификацией. Для Маркета отдельно проверьте правила заполнения параметров: например, там используется поле категории market_category_id. Переносить настройки рекламного фида без проверки нельзя.

Варианты товаров в фиде — две кроссовки с отдельными бирками на белых подиумах

Этап 3. Подготовьте учебный пример YML

Этап 3 · Проверяемый образец файла

Начните с небольшой выборки, в которой есть обычный товар, вариант с другим размером и недоступное предложение. Так проще проверить правила до выгрузки всего каталога.

Пример показывает устройство товарного YML для рекламы сайта в Директе: магазин, валюту, категории и одно предложение упрощённого типа. Данные вымышлены, адреса на домене example.com служат иллюстрацией. Это учебный образец структуры; перед подключением подставьте рабочие ссылки и проверьте требования своей категории.

Как выглядит фид. В сером блоке показан текст файла для одного товара — белой футболки размера M за 1 900 рублей. Названия в угловых скобках обозначают поля: например, <price>1900.00</price> передаёт цену. Площадка читает эти поля автоматически. Пример нужен, чтобы обсудить состав выгрузки с разработчиком; вручную заполнять такой файл для каждого товара не требуется.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2026-11-02 12:00">
  <shop>
    <name>Учебный магазин</name>
    <company>Учебная компания</company>
    <url>https://example.com/</url>
    <currencies><currency id="RUR" rate="1"/></currencies>
    <categories><category id="10">Футболки</category></categories>
    <offers>
      <offer id="TS-WHT-M" available="true">
        <url>https://example.com/catalog/ts-white?size=M</url>
        <price>1900.00</price>
        <currencyId>RUR</currencyId>
        <categoryId>10</categoryId>
        <picture>https://example.com/images/ts-white.jpg</picture>
        <name>Футболка белая, размер M</name>
        <vendor>Учебный бренд</vendor>
        <description>Хлопковая футболка белого цвета.</description>
        <param name="Размер">M</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Как читать структуру файла

Корневой элемент yml_catalog содержит дату формирования. Внутри shop находятся сведения о магазине и справочники. Значение currencyId ссылается на валюту из currencies, а categoryId — на категорию из categories. Элемент offers объединяет предложения offer.

В примере id="TS-WHT-M" обозначает белую футболку размера M, available="true" — доступность покупки. price содержит цену; picture — адрес изображения. Размер вынесен в param. При добавлении размера L создайте отдельное предложение с другим id и соответствующей ссылкой.

Специальные символы

Формируйте XML библиотекой сериализации, чтобы корректно экранировать специальные символы. Например, амперсанд в ссылке с несколькими параметрами должен попасть в XML как &. После чтения файла площадка получит обычный символ &. YML в этом контексте построен на XML; YAML-конфигурация приложения для этой загрузки не подходит.

Структура товарного фида — открытая папка с иерархией оранжевых карточек и коробкой

Этап 4. Настройте первичную загрузку и обновления

Этап 4 · Регламент передачи изменений

Отдельно проверяйте создание файла, его скачивание площадкой и применение данных. У каждого шага должен быть наблюдаемый результат.

Для первой загрузки выберите небольшой ассортимент и дождитесь отчёта обработки. Сравните число переданных, принятых и отклонённых предложений. Затем откройте несколько карточек на сайте и сопоставьте варианты, цены и доступность с тем, что получила площадка.

Директ позволяет загрузить файл или указать ссылку на него. Согласно инструкции по добавлению фида, файл, загруженный вручную, автоматически не обновляется. Для регулярного обмена организуйте формирование файла по доступному роботу адресу и контролируйте его обработку. Расписание генератора магазина и расписание скачивания площадки могут различаться.

Частоту выбирают по скорости изменения ассортимента. В учебном сценарии магазин формирует фид каждый час; это решение магазина, а не обещание обновления рекламы за час. Изменение проходит путь от учётной системы до сайта, файла, загрузчика и объявления. Допустимую задержку и действия при её превышении согласуют до запуска.

Новую версию сначала запишите во временный файл, проверьте и только потом замените рабочую целиком. Это защищает от скачивания половины документа. При ошибке формирования сохраните последнюю корректную версию и отправьте уведомление ответственному. При этом старый файл тоже имеет срок допустимой актуальности: длительный сбой требует отдельного решения по рекламе.

Недоступные товары

Для временно отсутствующего товара в товарном YML Директа используют поддерживаемый признак недоступности. Удаление предложения из файла и изменение наличия — разные действия; заранее проверьте результат обработки. Для Маркета цены, остатки и прекращение продажи настраивают по его инструкции и модели работы. Один рекламный атрибут не заменяет управление складскими остатками маркетплейса.

Обновление товарного фида — циклические стрелки вокруг товара и часы контроля актуальности

Этап 5. Проверьте файл и найдите причины отклонений

Этап 5 · Отчёт проверки и список исправлений

Проверяйте синтаксис, правила площадки и соответствие сайту последовательно. Успешное чтение XML подтверждает только корректность его структуры.

Сохраните отчёт площадки вместе с датой и версией файла. Для каждой ошибки выпишите идентификатор предложения, поле, текущее значение и источник данных. Исправляйте правило выгрузки или исходный каталог, чтобы следующая генерация сохранила исправление.

СимптомЧто проверитьКак подтвердить исправление
Файл не загружаетсяАдрес, авторизация, сертификат, ответ сервера и размерПовторная загрузка роботом завершилась успешно
Ошибка XMLКодировка, закрывающие теги, экранирование символовXML разбирается без ошибок, площадка читает файл
Предложение отклоненоОбязательные поля и допустимые значенияПричина исчезла в новом отчёте обработки
Цена расходится с сайтомИсточник цены, скидки, регион, задержка обновленияЦена совпала в источнике, файле и карточке
Нет изображенияПрямая ссылка, доступ роботу, формат и соответствие товаруИзображение доступно и принято площадкой
Товары пропали массовоФильтр ассортимента, справочник категорий, сбой источникаЧисло принятых предложений вернулось к ожидаемому

Проверка страниц и изображений

Проверка ссылки должна учитывать конечную страницу после перенаправлений. Ответ HTTP 200 ещё не означает, что покупатель увидит товар: сервер может отдавать заглушку или страницу входа. Для фотографий дополнительно проверьте доступ из внешней сети и ограничения защиты от роботов.

Перед массовой заменой данных сравните новую выгрузку с предыдущей: число предложений, исчезнувшие идентификаторы и необычные изменения цен. Порог остановки выбирают для своего каталога. Например, резкое сокращение ассортимента может быть как запланированной распродажей, так и ошибкой фильтра; решение должен подтвердить ответственный.

Диагностика товарного фида — лупа проверяет карточку и состояние соединения

Чек-лист перед подключением и дальнейший контроль

Подключение готово к проверке, когда команда может показать корректный образец, успешный отчёт обработки и порядок действий при сбое. Пройдите список на тестовой выборке, затем повторите проверку для полного ассортимента.

  • Выбраны площадка, формат и сценарий использования; обязательные поля сверены с официальной документацией.
  • Назначены ответственные за каталог, цены, наличие и техническую передачу.
  • Идентификаторы уникальны и сохраняются между выгрузками; варианты различаются.
  • Категории существуют, цены и валюта корректны, недоступные товары обрабатываются по согласованному правилу.
  • Ссылки открывают нужные карточки; изображения доступны извне и соответствуют вариантам.
  • Проверены XML, кодировка, специальные символы и правила заполнения полей.
  • Получен отчёт площадки; отклонения разобраны, принятые предложения сверены с сайтом.
  • Настроены обновления, хранение последней корректной версии и уведомления об ошибках.
  • Проверен сценарий изменения цены, исчезновения остатка, добавления и прекращения продажи товара.

После запуска контролируйте время последней успешной генерации и обработки, число предложений и причины отклонений. Учебный регламент: технические проверки после каждого обновления, просмотр отчёта ответственным каждый рабочий день, выборочная сверка карточек раз в неделю и после изменений интеграции. Частоту и дежурство в выходные адаптируют к темпу продаж и риску устаревших данных.

При сбое сначала определите, где остановилась цепочка: в источнике, генераторе, доступе к файлу или обработке площадкой. Зафиксируйте время последней корректной передачи, оцените затронутый ассортимент и согласуйте временные действия. После исправления повторите проблемный сценарий и проверьте фактически принятые данные.

Чек-лист товарного фида — планшет с галочками, коробка, щит и шестерня

Что подготовить для обсуждения интеграции

Товарный фид становится управляемым каналом передачи, когда у него есть устойчивые идентификаторы, согласованные источники и контроль применения изменений. Для обсуждения интеграции подготовьте пример каталога, список площадок, систему учёта и допустимую задержку обновления.

Команда FITTIN поможет обсудить передачу товарных данных и границы интеграции интернет-магазина. Пришлите описание каталога и площадок, чтобы определить состав работ и проверки перед запуском.

Часто задаваемые вопросы

Можно ли передавать один товарный фид на все площадки?

Общую исходную базу использовать можно. Для каждого получателя проверяют формат, обязательные поля, категории и правила обновления. Даже два YML-файла могут отличаться назначением и составом данных. Удобнее хранить отдельные настройки выгрузки и проверять результат в каждом кабинете.

Как часто обновлять цены и остатки в фиде?

Частоту выбирают по скорости изменения данных и допустимой задержке. Учитывают получение данных из учётной системы, формирование файла и обработку площадкой. Проверять нужно время последней успешной передачи на каждом участке, поскольку запуск генератора сам по себе не подтверждает обновление объявления.

Почему корректный XML отклоняется площадкой?

XML-проверка подтверждает структуру документа. Площадка дополнительно оценивает обязательные поля, допустимые значения, ссылки и изображения. Причину ищут в отчёте обработки по идентификатору предложения; исправление проверяют новой загрузкой и сверкой принятой карточки.

Что делать с товаром, который закончился?

Используйте механизм недоступности, предусмотренный выбранным форматом и площадкой. Для товарного YML Директа проверьте атрибут available; для маркетплейса отдельно настройте передачу остатков и прекращение продажи. После изменения убедитесь, что площадка его обработала. Удаление строки из файла требует отдельной проверки результата.

Нужно ли менять идентификатор после обновления цены?

Для того же предложения идентификатор сохраняют. Цена, описание и фотография могут изменяться без создания нового товара. Отдельный продаваемый вариант получает собственный устойчивый код; связь вариантов задают средствами, которые поддерживает получатель.

Источники и дата проверки

Официальная документация проверена 2 ноября 2026 года. Перед подключением повторно сверьте требования выбранного типа кампании и категории товара.

Материал подготовлен для редакционной проверки. Пример и регламент учебные; требования площадки сверяйте перед подключением.

ДАВАЙТЕ ОБСУДИМ
ВАШ ПРОЕКТ

Мобильное приложение