Добавление Rich-контента JSON


Последнее обновление 12 мая 2021
Читать 0 минут
Rich контент JSON

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

Rich-контент повышает интерес потенциальных покупателей к товарам. С его помощью вы также можете акцентировать внимание на отдельных характеристиках или достоинствах товара.

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

Посмотрите, как изменится описание на карточке товара, если добавить Rich-контент:

Шаблон для заполнения в формате JSON

Документация к Rich-контенту

Преимущества загрузки Rich-контента в формате JSON:

  • использование стилей Ozon: если правильно заполнить шаблон, описание товара будет корректно отображаться на разных типах устройств;
  • безопасная и быстрая загрузка контента без использования iframe.

# Как заполнить шаблон JSON

Вы можете воспользоваться партнёрским сервисом, который позволяет генерировать JSON с помощью конструктора и хранить изображения и видео, используемые в Rich-контенте.

  1. Откройте шаблон.

  2. Выберите вкладку Песочница. Вы увидите макет с фото, текстовыми подписями к фото и видео. Все изменения, которые вы внесете в редакторе, отобразятся на макете.

  3. Нажмите Открыть редактор.

  4. Внесите необходимые изменения в редакторе: добавьте прямые ссылки на изображения, вставьте текст, укажите размер фото. Чтобы добавить видео, укажите прямую ссылку или ID видео на YouTube. Копируйте и добавляйте подходящие виджеты. Удалите из редактора те виджеты, которые вы не используете.

    В редактор мы добавили несколько разных виджетов. Например, чтобы добавить изображение с текстом под фото, заполните параметры:

    • scr — прямая ссылка на изображение, которое отображается на сайте;
    • srcMobile — прямая ссылка на изображение, которое отображается в мобильной версии сайта или в приложении;
    • width — ширина изображения на сайте;
    • height — высота изображения на сайте;
    • widthMobile — ширина изображения в мобильной версии;
    • heightMobile — высота изображения в мобильной версии;
    • title — подпись к изображению (заголовок);
    • content — подпись к изображению (текст).

Внимательно следите за тем, чтобы каждой открытой скобке соответствовала закрытая скобка.

Пример одного заполненного виджета:

{
	"widgetName": "raShowcase",
	"type": "billboard",
	"blocks": [
		{
			"img": {
				"src": "http://images.vfl.ru/ii/1606379704/a96fe979/32445109.jpg",
				"srcMobile": "http://images.vfl.ru/ii/1606379948/4124d073/32445157.jpg",
				"width": 1280,
				"height": 853,
				"widthMobile": 640,
				"heightMobile": 640
			},
			"title": "Подойдет начинающим",
			"text": {
				"content": [
					"Классическая гитара обладает не таким громким звучанием по сравнению с акустикой, но благодаря более мягким нейлоновым струнам идеальна для начинающих."
				]
			}
		},
	]
},

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

  1. Добавьте Rich-контент любым способом:

# Как добавить Rich-контент через API

Чтобы отправлять запросы через Ozon Seller API, вам нужен идентификатор пользователя и ключ API. Для этого:

  1. В личном кабинете перейдите на страницу НастройкиAPI ключи.

  2. Идентификатор пользователя — Client Id.

  3. Чтобы создать ключ API, в разделе API key выберите тип токета Товары, введите название ключа и нажмите Создать ключ.

  4. Используйте запрос POST /v1/products/update для добавления Rich-контента.

# Как пользоваться документацией к Rich-контенту

В документации вы можете найти дополнительную информацию о разных виджетах. Например, вы можете уточнить, сколько блоков можно добавить в тип виджета «chess».

  1. Откройте документацию к Rich-контенту.

  2. Выберте виджет WidgetShowCaseChess.

  3. В разделе Properties перечислены все параметры, которые необходимо указать для выбранного виджета. Параметр blocks добавляет изображение и подпись к нему. Минимальное количество блоков в виджете «chess» — 2. Максимальное количество блоков — 6 в одном виджете.

# Как получить прямую ссылку на изображение

Если у вас есть собственный сайт, дайте прямые ссылки на изображения, загруженные на вашем сайте. Или воспользуйтесь бесплатным сайтом-фотохостингом. Например, vfl.ru. Выберите нужное изображение и нажмите Загрузить. В блоке Прямая ссылка на изображение скопируйте ссылку и добавьте в редактор.