Рекомендация по карточке товара полезна, только если из неё понятно, какое поле нужно исправить. Общая задача «дозаполнить контент» заставляет сотрудника повторно проверять весь товар и не объясняет результат. API Яндекс Маркета позволяет связать тип замечания с основными параметрами или конкретными категорийными характеристиками.

Прочитать тип рекомендации

Рекомендации приходят в поле recommendations ответа offer-cards. Сначала определите recommendations.type и прочитайте значение этого типа в документации. Не считайте все замечания одинаковыми: они могут относиться к разным частям описания и требовать разных данных от поставщика.

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

Разделить два маршрута исправления

Если замечание касается основного параметра товара, официальная инструкция предлагает изменить его через offer-mappings/update. Если речь о категорийных характеристиках, сначала запрашивается category parameters. Из ответа выбирают те характеристики, у которых массив recommendationTypes содержит нужный тип.

Например, при рекомендации MAIN выбираются характеристики с MAIN в recommendationTypes. Это сопоставление типов, а не разрешение придумать недостающую информацию. Значение должно описывать реальный товар. Отсутствующие сведения сначала запросите у ответственного за ассортимент или производителя, затем передавайте согласованную характеристику через offer-cards/update.

Не смешивать исправление с массовым улучшением текста

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

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

Как принять выполненную задачу

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

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