Как заполнять Rich-контент JSON для Ozon

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

Стандартный редактор Ozon удобен для базовых задач, но он ограничивает творческий полет селлера. Для тех, кто хочет внедрить сложные дизайнерские решения, анимацию или нестандартную верстку, единственным выходом остается работа с кодом. Rich-контент JSON — это именно тот формат, который дает полный контроль над каждым пикселем отображаемой информации. Понимание структуры этого кода открывает доступ к созданию по-настоящему продающих описаний.

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

Что такое JSON-структура в Rich-контенте Ozon

JSON (JavaScript Object Notation) — это текстовый формат обмена данными, который легко читается как человеком, так и машиной. В контексте Озон, весь ваш богатый контент, будь то галерея изображений, текст с иконками или видео-обложка, описывается набором правил, заключенных в фигурные скобки. Система считывает этот код и рендерит его в красивую витрину на странице товара.

Основным элементом структуры является массив блоков. Каждый блок имеет свой тип (например, image_gallery или text_with_image) и набор свойств (параметров), таких как URL картинки, цвет фона или размер шрифта. Валидация кода происходит автоматически при загрузке: если вы допустите синтаксическую ошибку, например, забудете запятую или кавычку, система просто не примет изменения.

Важно понимать, что Ozon использует специфическую схему JSON, отличную от стандартных веб-разметок. Здесь нет HTML-тегов в привычном виде (<div>, <img>). Вместо этого используются объекты, описывающие контент. Например, чтобы добавить изображение, вы не пишете тег img, а указываете объект с типом"image" и ссылкой на файл в свойствах.

Основные типы блоков и их параметры

Экосистема Rich-контента Ozon базируется на ограниченном, но функциональном наборе блоков. Знание их точных названий и параметров — ключ к успешной верстке. Вы не можете inventить свои типы блоков, система распознает только строго определенные значения.

Самым популярным блоком является image_gallery. Он позволяет создавать слайдеры и галереи. Внутри него можно настраивать параметры отображения, такие как width (ширина) и height (высота). Другой востребованный тип — text_with_image_left или text_with_image_right, который комбинирует текстовое описание с визуальным рядом. Для текстовых вставок используется блок text, где можно задавать выравнивание и размер шрифта.

• 🖼️ image_gallery — создание слайдеров с фотографиями товара, настройка соотношения сторон.
• 📝 text — добавление заголовков и основного текста описания с выбором размера шрифта.
• 🎬 video — вставка ссылки на видео-обзор (требуется прямая ссылка или ID с YouTube/Vimeo).
• 📊 features — блок с иконками и преимуществами, часто используется для USP (уникальных торговых предложений).

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

Секретные параметры блоков

Некоторые блоки поддерживают параметр"background_color", который позволяет менять цвет подложки. Это полезно для разделения смысловых зон без использования изображений-разделителей.

Пошаговая инструкция: создание кода с нуля

Процесс создания JSON-кода для Ozon начинается с планирования структуры. Прежде чем писать код, определите, какие блоки и в какой последовательности будут идти. Стандартная структура начинается с открывающей скобки и объявления переменной блоков.

Первый шаг — создание базового каркаса. Вы должны объявить массив, в который будут добавляться объекты блоков. Синтаксически это выглядит как квадратная скобка, внутри которой через запятую перечисляются объекты. Каждый объект начинается с фигурной скобки и содержит ключ type, указывающий на тип блока.

{
"blocks": [
{
"type":"image_gallery",
"params": {
"images": [
"ссылка_на_фото_1",
"ссылка_на_фото_2"
],
"width":"100%"
}
}
]
}

Далее следует наполнение параметрами. В примере выше мы видим блок галереи. Обратите внимание на вложенность: параметры находятся внутри ключа params, а список изображений — это массив строк внутри параметров. Нарушение этой иерархии приведет к ошибке parsing. Синтаксическая точность здесь важнее творческого подхода: одна лишняя запятая в конце массива может"сломать" весь код.

После написания кода его необходимо вставить в редактор карточки товара. В интерфейсе Озон есть режим"Код" или"HTML/JSON", куда и вставляется полученная структура. Система попытается визуализировать результат. Если вместо картинки вы видите пустоту или ошибку, значит, структура нарушена.

Работа с изображениями и медиафайлами

Качество визуализации напрямую зависит от правильности ссылок на медиафайлы. Ozon требует, чтобы все изображения, используемые в Rich-контенте, были загружены на их сервера или находились на надежном хостинге с поддержкой протокола HTTPS. Использование прямых ссылок на картинки с других сайтов часто приводит к тому, что через некоторое время они перестают отображаться из-за защиты от hotlinking.

Лучшая практика — сначала загрузить все изображения в галерею товара или в медиафайлы личного кабинета селлера, скопировать их URL-адреса и только потом вставлять в JSON-код. Это гарантирует стабильность отображения. Оптимальный размер изображений для десктопной и мобильной версий может отличаться, поэтому рекомендуется использовать адаптивные параметры ширины, например, width:"100%", чтобы блок растягивался на всю доступную область.

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

Типичные ошибки при ручном редактировании кода

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

Вторая частая ошибка — trailing comma (висячая запятая). В многих языках программирования последняя запятая в списке допустима, но строгий стандарт JSON её запрещает. Если после последнего элемента массива или объекта стоит запятая, парсер выдаст ошибку. Также часто встречается дублирование ключей, когда в одном блоке дважды указывается один и тот же параметр, например, width.

⚠️ Внимание: Никогда не копируйте код из текстовых редакторов с"умным" форматированием (например, Word), так как они могут заменять прямые кавычки на типографские ("ёлочки"), которые система не распознает. Используйте только plain-text редакторы.

Еще одна проблема — некорректные URL. Ссылка должна быть полной, начинаться с https:// и не содержать пробелов. Если ссылка битая, блок просто не отрисуется, оставив пустое место на странице товара. Всегда проверяйте доступность изображений в режиме инкогнито перед вставкой в код.

SEO-оптимизация Rich-контента через JSON

Хотя Rich-контент в первую очередь ориентирован на визуальное восприятие, он играет важную роль в SEO-продвижении карточки. Поисковые алгоритмы Ozon и внешних поисковиков умеют индексировать текст, заложенный в JSON-структуру. Правильное использование текстовых блоков позволяет внедрить ключевые запросы в тело карточки, повышая её релевантность.

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

Кроме того, про атрибут alt для изображений. В JSON-коде для картинок часто можно прописать альтернативное описание. Это помогает поисковикам понимать, что изображено на картинке, если она не загрузится, и улучшает общую индексацию страницы. Грамотно составленный JSON-код делает карточку товара более"весомой" в глазах алгоритмов ранжирования.

Проверка и публикация изменений

После того как код написан и вставлен в редактор, необходимо тщательно проверить результат. Визуальный редактор Ozon может отображать превью, но оно не всегда на 100% соответствует тому, что увидит клиент на мобильном устройстве. Обязательно используйте предпросмотр с разных устройств.

Если после сохранения вы видите сообщение об ошибке, не паникуйте. Часто система указывает примерную строку или просто говорит"Ошибка формата". В этом случае помогает метод исключения: убирайте блоки по одному, пока ошибка не исчезнет, чтобы найти виновника. Также полезно использовать онлайн-валидаторы JSON, куда можно скопировать ваш код и проверить его на наличие синтаксических ошибок перед загрузкой на Озон.

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

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

Можно ли использовать сторонние скрипты в JSON для Ozon?

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

Что делать, если код не принимается системой?

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

Влияет ли Rich-контент на ранжирование товара?

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