Библиотека форматов

Назначение библиотеки

Библиотека форматов описывает типовые варианты креативов, которые можно использовать в плейсментах Smart Placement. Формат задает состав данных для показа: изображения, видео, ссылки, товары, текстовые поля, цвета и повторяющиеся элементы.

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

Как читать описание формата

У каждого формата есть:

Поле	Описание
FormatId	Идентификатор формата в библиотеке. Используется при согласовании и настройке плейсмента.
Сценарий применения	Где формат уместен: товарная полка, баннерное место, overlay, сторис или пункт меню.
Поля рекламы	Данные, которые должен заполнить рекламодатель.

В таблицах ниже колонка Required показывает, обязательно ли поле для запуска креатива.

Типы полей

Тип	Что означает
Text	Текстовое значение: заголовок, описание, подпись кнопки или пункт меню.
Url	Ссылка на посадочную страницу. Используется для клика или тапа по креативу.
Image	Изображение креатива, баннера, иконки или poster для видео.
Video	Видеоролик для видеобаннера, слайда или промо-блока.
Color	Цвет в формате, согласованном для плейсмента, например #1D9E75.
ProductShelf	Набор идентификаторов товаров, которые площадка отрисовывает как товарные карточки.
Array<Container>	Повторяющийся набор вложенных объектов, например список слайдов в сторис.

Форматы

Товарная полка

FormatId: 01KVD1ESPJNQZW9AD4KDD6K8TQ

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

Поле	Тип	Required	Описание
productIds	ProductShelf	Да	Идентификаторы товаров, которые площадка отрисовывает в полке. Можно передать один товар или несколько товаров в нужном порядке.

Баннер

FormatId: 01KVD1K8CSBJF1FJZYKPQ4DW0R

Базовый графический формат: изображение и ссылка на посадочную страницу. Геометрию баннера задают настройки конкретного плейсмента, например горизонтальный desktop-баннер или вертикальный mobile-баннер.

Поле	Тип	Required	Описание
image	Image	Да	Изображение баннера.
targetUrl	Url	Да	Посадочная страница для перехода по клику или тапу.

Баннер с товарами

FormatId: 01KVD1S8RNMFC09K8BR82XXRSF

Формат объединяет крупный визуальный блок и товарную полку. Его используют, когда нужно показать рекламу и сразу дать пользователю товары для перехода в карточку или добавления в корзину.

Поле	Тип	Required	Описание
image	Image	Да	Изображение баннера.
targetUrl	Url	Нет	Посадочная страница для перехода по баннеру.
productIds	ProductShelf	Да	Идентификаторы товаров, которые площадка отрисовывает в полке.

Видеобаннер

FormatId: 01KVD1W2199PD9FWM48GEE9Y0R

Формат для видеокреатива. Поле image обязательно: оно используется как заставка на время загрузки видео и как fallback, если видео не воспроизвелось. Размер, длительность и кодек видео задаются в настройках плейсмента. Типовой набор ограничений для видео: 6, 15 или 30 секунд, .mp4 H.264.

Поле	Тип	Required	Описание
video	Video	Да	Основной видеоролик объявления.
image	Image	Да	Изображение-заставка для загрузки и fallback-сценария.
targetUrl	Url	Да	Посадочная страница для перехода по клику или тапу на видео или заставку.

Промо-баннер

FormatId: 01KVD20R9B8P3VQDTAPR4HJDWS

Промо-баннер используют для горизонтальной карусели в крупной зоне страницы. Каждый слайд может содержать изображение, видео, заголовок, текст, кнопку или ссылку. Количество слайдов ограничивается настройками плейсмента; типовой диапазон - от 3 до 7 слайдов.

Поле	Тип	Required	Описание
image	Image	Да	Изображение или заставка слайда. Показывается до загрузки видео и в fallback-сценарии.
video	Video	Нет	Видеоролик слайда.
title	Text	Нет	Заголовок поверх изображения или видео.
text	Text	Нет	Короткое описание предложения.
buttonText	Text	Нет	Текст кнопки призыва к действию.
buttonColor	Color	Нет	Цвет кнопки.
targetUrl	Url	Да	Посадочная страница для перехода по слайду или кнопке.

Выдвижная панель

FormatId: 01KVD2CM3DVKS1M65APE46604C

Выдвижная панель подходит для mobile-сценариев: например, блок появляется снизу поверх текущего экрана и содержит короткое предложение, основную кнопку и кнопку отказа.

Поле	Тип	Required	Описание
image	Image	Нет	Иконка или изображение рядом с текстом.
title	Text	Да	Основной заголовок предложения.
subtitle	Text	Нет	Короткое пояснение под заголовком.
buttonText	Text	Да	Текст основной кнопки.
buttonColor	Color	Нет	Цвет основной кнопки.
dismissText	Text	Нет	Текст кнопки отказа или закрытия.
backgroundColor	Color	Нет	Цвет фона панели.
targetUrl	Url	Да	Посадочная страница для перехода по основной кнопке.

Модальное окно

FormatId: 01KVD2X8HZG92RC71ZRHT1CBEE

Модальное окно используют для desktop/web-сценариев, где нужно показать предложение поверх страницы с затемнением фона. Формат подходит для промокодов, welcome-офферов и анонсов акций.

Поле	Тип	Required	Описание
image	Image	Да	Верхнее изображение или баннер модального окна.
title	Text	Да	Основной заголовок предложения.
subtitle	Text	Нет	Описание предложения, промокод или детали.
buttonText	Text	Да	Текст основной кнопки.
buttonColor	Color	Нет	Цвет основной кнопки.
dismissText	Text	Нет	Текст кнопки отказа или закрытия.
backgroundColor	Color	Нет	Цвет фона области изображения.
targetUrl	Url	Да	Посадочная страница для перехода по основной кнопке.

Сторис с товарами

FormatId: 01KVD319JPKSEBWSBPDEXH340K

Формат для вертикального fullscreen-показа из нескольких слайдов. Каждый слайд может содержать изображение или видео, заголовок, товарную полку и ссылку. Пользователь листает слайды, а при клике на товар переходит в карточку товара.

Поле	Тип	Required	Описание
slides	Array<Container>	Да	Список слайдов, которые пользователь просматривает последовательно.

Описание одного элемента slides:

Поле	Тип	Required	Описание
image	Image	Нет	Изображение слайда или poster для видео.
video	Video	Нет	Видео для слайда.
title	Text	Нет	Заголовок поверх слайда.
productIds	ProductShelf	Нет	Товары, связанные с конкретным слайдом.
targetUrl	Url	Да	Посадочная страница для перехода по слайду.

warning

Не оставляйте слайд без визуального элемента. Если в слайде нет video, передайте image; если есть video, используйте image как poster и fallback.

Ссылка в меню

FormatId: 01KVD3BS3JHTY80VND5R0XVD4R

Формат для спонсируемого пункта в меню, шапке сайта или навигации приложения. Площадка отрисовывает пункт в одном ряду с обычными разделами и добавляет рекламную маркировку в соответствии со своим UI.

Поле	Тип	Required	Описание
text	Text	Да	Текст пункта меню, который увидит пользователь.
targetUrl	Url	Да	Посадочная страница для перехода по клику или тапу.