Как принять исправленный товарный фид: проверка после работы разработчика

Разработчик прислал «исправленный фид»: ошибок стало ноль. Одновременно товаров стало на 37 меньше. Формально отчёт зелёный, но магазин потерял ровно те позиции, на которых раньше возникала ошибка. Контрольная суммакороткий цифровой отпечаток файла, который меняется вместе с его содержимым помогает доказать, какую версию проверяли.

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

Учебный кейс

В первой версии учебного фида было 1 200 офферов и 37 ошибок связи с категорией. Во второй — 1 163 оффера и ноль ошибок. Сравнение ID показало, что проблемные товары отфильтровали.

Версию не приняли. В третьей снова 1 200 уникальных ID, категория 99 появилась в справочнике, цены и наличие совпали с выборкой карточек, а платформа обработала новый файл без блокирующих ошибок. Доказательством стали хеш файла, два отчёта анализатора и время загрузки в кабинет.

Что попросить вместе с исправлением

Разработчику достаточно передать четыре вещи:

• ссылку или файл новой версии;
• список исправленных пунктов;
• пример товара, на котором проверялась правка;
• время генерации и окружение, если есть тестовый и боевой фиды.

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

Шаг 1. Убедитесь, что проверяете новую версию

Откройте URL напрямую и посмотрите время генерации, размер ответа и первые строки. Исключите кэш браузера, CDN и рекламной системы. При работе с файлом сохраните его под новым именем.

Полезный паспорт проверки:

Контрольная сумма нужна для внутренней приёмки. Рекламной системе её передавать не требуется.

Шаг 2. Повторите прежний сценарий

Возьмите исходный отчёт и снова проверьте те же товары и поля. У каждого замечания должен появиться один из статусов:

• исправлено;
• частично исправлено;
• воспроизводится;
• больше неприменимо, потому что согласованно изменилось требование.

Статус «не найдено» требует осторожности. Товар мог исчезнуть из фида, и ошибка пропала вместе с ним. Сравните ассортимент до и после.

Шаг 3. Сверьте общую структуру

Локальная правка иногда повреждает соседний участок XML или CSV. Проверьте:

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

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

Шаг 4. Сравните состав товаров

Сопоставьте до и после:

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

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

Шаг 5. Проверьте значения на странице

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

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

Шаг 6. Ищите новые ошибки

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

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

Шаг 7. Передайте проверенную версию в систему

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

Сохраните ID загрузки или время обновления. Если платформа показывает старую ошибку, сначала убедитесь, что она забрала новую версию.

Критерий готовности

Фид можно принять, когда выполнены условия:

1. Проверена точная версия источника.
2. Исходные ошибки закрыты на прежних примерах и по всему подходящему набору.
3. Количество и состав товаров объяснимы.
4. Новых блокирующих ошибок нет.
5. Критичные значения совпадают с карточками выбранных товаров.
6. Рекламная система обработала новую версию.

Анализатор фидов WiseLab позволяет повторить проверку по ссылке, файлу или вставленному коду и выгрузить отчёт для разработчика. Сохраните первый отчёт рядом со вторым: разница между ними станет доказательством приёмки.

Что забрать в работу

Фиксируйте URL или файл, время получения, размер и контрольную сумму; сравнивайте ошибки и состав товаров; затем дождитесь обработки платформой. Готовность подтверждает точная версия, а не обещание разработчика и не зелёный отчёт на другом файле. Это защищает выручку от тихого выпадения ассортимента.