Ozon: обновление контента карточек

Контент карточки напрямую влияет на конверсию и выдачу Ozon, а поддерживать его вручную для большого ассортимента невозможно. Разберём, как обновлять названия, атрибуты, фото и rich-контент карточек Ozon из каталога 1С-Битрикс программно.

Что относится к контенту

Под контентом карточки Ozon понимают всё, что видит покупатель и учитывает поиск площадки:

• Название — формируется по правилам категории;
• Атрибуты — характеристики из дерева категории (бренд, цвет, размер, состав и т. д.);
• Описание — текст карточки;
• Медиа — фотографии, видео, 360°;
• Rich-контент — оформленное описание с блоками и картинками (JSON).

Методы обновления

Основной инструмент — тот же, что и при создании товара, но с фокусом на атрибуты и медиа:

Rich-контент передаётся отдельным атрибутом карточки (в виде JSON-структуры блоков). Обновление идёт по offer_id: повторный product/import с тем же артикулом перезаписывает контент, а не плодит дубли.

Маппинг атрибутов из Битрикса

Самая трудоёмкая часть — сопоставление свойств инфоблока с атрибутами категории Ozon. Атрибуты бывают трёх типов:

1. Строковые/числовые — передаём значение как текст (value).
2. Словарные — передаём dictionary_value_id из справочника категории.
3. Комплексные — группы связанных значений (complex_id).

{
  "offer_id": "SKU-10241",
  "attributes": [
    {"id": 85, "values": [{"dictionary_value_id": 971082156}]},
    {"id": 4191, "values": [{"value": "нержавеющая сталь"}]}
  ]
}

Фото и rich-контент

Изображения Ozon скачивает по URL, поэтому они должны быть публично доступны — обычно отдаются из /upload/iblock/ Битрикса или из подготовленного хранилища нужного размера.

• порядок картинок в массиве images задаёт порядок в галерее; первая — главная;
• для обновления только фото удобно использовать /v1/product/import/pictures;
• rich-контент собирается как JSON блоков (тексты, картинки, таблицы) и передаётся в соответствующем атрибуте.

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

Реализация на 1С-Битрикс

Обновление контента вписывается в общий модуль обмена с Ozon:

1. отслеживаем изменения контентных свойств элемента (событие OnAfterIBlockElementUpdate или флаг «контент изменён»);
2. собираем объект с изменёнными атрибутами/описанием/картинками;
3. отправляем /v3/product/import пачками;
4. по task_id проверяем результат через /v1/product/import/info;
5. логируем ошибки модерации по конкретным offer_id.

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

Модерация и контроль

Любое изменение контента проходит модерацию Ozon, поэтому обновление — не «отправил и забыл»:

• после product/import статус смотрим через product/import/info и product/info;
• отклонённые изменения возвращают причину — её нужно логировать и показывать контент-менеджеру;
• обязательные атрибуты категории должны быть заполнены, иначе карточка не пройдёт;
• полезно раз в период сверять контент на Ozon с эталоном в каталоге.

Итог

Обновление контента карточек Ozon из Битрикса держится на трёх вещах: точном маппинге свойств инфоблока на атрибуты категории (особенно словарных), корректной передаче медиа и rich-контента и обязательном контроле модерации через import/info. Инкрементальное обновление по offer_id при изменении контентных свойств делает процесс автоматическим.

Мы в B2Bsite настраиваем контентную синхронизацию с Ozon: описываем маппинг атрибутов и словарей, реализуем обновление описаний, фото и rich-контента из каталога, ставим контроль модерации. Карточки остаются актуальными без ручной правки в кабинете площадки.