# Changelog

История изменений MADS Web SDK, важных для паблишеров.

Файлы wrapper.js и main.js распространяются через CDN-канал current/, который всегда указывает на последнюю выпущенную версию. Если нужна конкретная версия — обратитесь к команде Magnit Ads.

Формат: [версия] — дата. Изменения сгруппированы по типу: Добавлено, Изменено, Исправлено.


# [v0.1.28] — 2026-04-23

# Добавлено

  • Поддержка карусельного формата рекламы: одиночный слайд (1x1), мультиформатные сетки (2x1, 3x1, 4x1, 5x1, 6x1) и классическая карусель
  • Автопрокрутка карусели с настраиваемым интервалом
  • Навигация по слайдам: стрелки, точки пагинации, свайп и перетаскивание
  • Заголовок и подзаголовок карусели
  • Анимация загрузки перед появлением креатива
  • Каждый слайд карусели отправляет независимые события показа и видимости

# Изменено

  • Поле markingInfo в элементах креатива теперь опциональное
  • В ответе визита появилось поле header с заголовком и подзаголовком
  • Структура displayOptions зависит от формата: для карусели содержит настройки размера, автопрокрутки, скругления углов и отступов между слайдами
  • Видеоплеер при размонтировании прекращает сетевую загрузку, чтобы не тратить трафик
  • Тултип рекламной маркировки больше не обрезается у границ плеера

# Исправлено

  • Падение обработчика ошибок при системных ошибках без объекта error
  • Видеоплеер корректно сообщает об ошибках при зависании и прерывании загрузки

# [0.1.25] — 2026-04-09

# Исправлено

  • Поправлена обработка CORS при запросе ad-сервера.
  • Исправлен URL ICM-интеграции.

# [0.1.23] — 2026-04-09

# Добавлено

  • Новый блок маркировки (ОРД) с обновлённым визуальным оформлением и позиционированием относительно креатива.

# Изменено

  • Обновлена логика отправки кликов, пикселей и телеметрии.

# [0.1.22] — 2026-04-08

# Добавлено

  • SDK mode (mode: 'sdk') — программное управление воспроизведением через методы play(), pause(), resume(), stop(), skip(), mute(), destroy(). Команды буферизуются до готовности iframe. Подробнее — Быстрый старт.
  • Опция loop: true — зацикливание плейлиста в default-режиме.
  • Опция customUrl — переопределение endpoint ad-сервера.

# Изменено

  • Улучшен ресайз: плеер корректнее ужимается под ширину родителя и учитывает max-height.

# [0.1.21] — 2026-04-03

# Добавлено

  • Полноценная поддержка статичных креативов (изображений) в multiformat ленте — теперь видео и картинки могут смешиваться в одном плейлисте.

# [0.1.19] — 2026-03-25

# Изменено

  • Кеширование пикселей: одни и те же URL не отправляются повторно в рамках одного креатива (для событий с дедупликацией).

# [0.1.18] — 2026-03-24

# Добавлено

  • Базовый блок маркировки (ОРД) markingInfo — отображение метки «Реклама» с ERID на креативах, которым ad-сервер вернул соответствующие данные.

# [0.1.16] — 2026-03-06

# Добавлено

  • Формат video — отдельный полноэкранный видеоплеер для классической видеорекламы (см. Форматы).

# [0.1.12] — 2026-02-27

# Изменено

  • Внутренняя стейт-машина плеера переписана. На API паблишера это не влияет, но порядок срабатывания колбэков жизненного цикла стал более предсказуемым.

# [0.1.11] — 2026-02-25

# Изменено

  • Улучшен жизненный цикл креатива: корректные переходы loading → ready → playing → ended, более точные моменты вызова onReady/onPlayed/onCompleted.

# [0.1.9] — 2026-02-18

# Добавлено

  • Формат multiformat — лента из нескольких креативов с плавными переходами между ними.

# [0.1.7] — 2026-02-16

# Добавлено

  • Телеметрия SDK — внутренние события отправляются в mads-track.magnit.ru для мониторинга качества доставки. Не требует настройки со стороны паблишера.

# [0.1.4] — 2026-02-12

# Добавлено

  • EventPixelSender — отправка пикселей аналитики с поддержкой условных пикселей (value/pvalue/viewablePercent), макроподстановок и beacon-fallback при закрытии вкладки. Подробнее — События и трекинг.

# [0.1.0] — 2026-01-27

# Добавлено

  • Первая публичная версия SDK: window.MadsPlayer(config), default-режим с автоплеем по видимости, базовые колбэки onReady / onPlayed / onPaused / onResumed / onCompleted / onSkipped / onClicked / onStopped / onError, сервис Visit для запроса креативов с ad-сервера.