Вставка реклами на стороні клієнта (CSAI) з розбором маркерів SCTE-35 та інтеграцією мультиплатформного плеєра

Ми розробили кросплатформний фреймворк CSAI з уніфікованим рівнем оркестрації реклами, який розбирає маркери SCTE-35 з маніфестів HLS/DASH, взаємодіє з рекламними серверами VAST/VMAP та керує життєвим циклом відтворення реклами на веб (Video.js/Shaka), iOS (AVPlayer), Android (ExoPlayer) та плеєрах підключених телевізорів.

Архітектура

• Доставка контенту: потоки HLS/DASH з маркерами SCTE-35 через AWS MediaPackage + CloudFront
• Сервер прийняття рішень щодо реклами: Google Ad Manager (GAM) / SpotX з підтримкою VAST 4.2 та VMAP
• Веб-плеєр: Video.js з кастомним парсером сигналів SCTE-35 та інтеграцією Google IMA SDK
• Плеєр iOS: AVPlayer з слухачем AVDateRangeMetadataGroup та IMA iOS SDK
• Плеєр Android: ExoPlayer з слухачем MetadataOutput та IMA Android SDK
• Підключені телевізори: Нативні плеєри платформ (Roku RAF, Fire TV IMA, Apple TV AVKit) з адаптерами рекламних фреймворків
• Аналітика реклами: Кастомний конвеєр подій для відстеження показів, квартилів, завершень, кліків та видимості
• Відкат: Доставка заставки/внутрішньої реклами, коли заповнення реклами недоступне або виявлено блокувальник реклами

Розбір SCTE-35 на стороні клієнта

Маркери маніфестів HLS

Сигнали SCTE-35 з'являються в маніфестах HLS у двох форматах, обидва розбираються клієнтом:

EXT-X-DATERANGE (HLS v7+)

• Плеєр слухає теги #EXT-X-DATERANGE з атрибутами SCTE35-OUT та SCTE35-IN
• Атрибути включають PLANNED-DURATION для тривалості рекламної паузи та ID для кореляції подій
• Переважний формат для сучасних плеєрів (AVPlayer, ExoPlayer, Shaka)

EXT-X-CUE-OUT / EXT-X-CUE-IN (Legacy)

• #EXT-X-CUE-OUT:DURATION= позначає початок рекламної паузи
• #EXT-X-CUE-IN позначає повернення до контенту
• Підтримується для зворотної сумісності зі старими плеєрами та кодерами

Маркери маніфестів DASH

• Сигнали SCTE-35 з'являються як елементи у DASH MPD з schemeIdUri="urn:scte:scte35:2013:xml"
• Елементи містять presentationTime, duration та двійкове корисне навантаження SCTE-35, закодоване в base64
• Shaka Player та ExoPlayer розбирають їх нативно через свої API слухачів подій

Потік обробки маркерів

1. Виявлення — Слухач метаданих плеєра виявляє подію сигналу SCTE-35 під час розбору маніфесту
2. Вилучення — Тривалість паузи, ID події та тип сегментації вилучаються з маркера
3. Рекламний запит — Запит VAST/VMAP надсилається до сервера прийняття рішень щодо реклами з параметрами таргетингу (ID контенту, жанр, тип пристрою, сегмент користувача, гео)
4. Планування рекламного блоку — Відповідь реклами розбирається для побудови рекламного блоку (впорядкований список рекламних креативів, що заповнюють тривалість паузи)
5. Попереднє завантаження — Рекламні креативи попередньо завантажуються під час відтворення контенту для усунення затримки на початку рекламної паузи
6. Пауза та перемикання — Відтворення контенту призупиняється в точці сигналу, плеєр перемикається на відтворення реклами
7. Відтворення реклами — Реклама відтворюється послідовно з відстеженням квартилів, відображенням супутнього банера та обробкою переходів за кліком
8. Відновлення — Після завершення рекламного блоку відтворення контенту відновлюється з точного кадру після точки сигналу

Реалізації для конкретних платформ

Веб (Video.js + IMA SDK)

• Кастомний плагін Video.js перехоплює метадані #EXT-X-DATERANGE через події зміни сигналу textTrack
• Google IMA HTML5 SDK керує рекламними запитами VAST, відтворенням реклами та рендерингом супутніх матеріалів
• Накладка рекламного контейнера розташована над відеоелементом для підтримки переходів за кліком та кнопки пропуску
• Виявлення блокувальника реклами за допомогою канарного запиту — при виявленні відкат до внутрішньої реклами або відновлення контенту
• Підтримка preroll, midroll та postroll через VMAP або ручне планування точок сигналу

iOS (AVPlayer + IMA SDK)

• AVPlayerItem.navigationMarkerGroups та AVDateRangeMetadataGroup використовуються для виявлення сигналів SCTE-35
• Делегат AVPlayerItemMetadataOutput спрацьовує на кожну подію сигналу з розібраним таймінгом та корисним навантаженням
• Google IMA iOS SDK обробляє запити VAST та відтворення реклами в окремому екземплярі AVPlayer
• Функція «Картинка в картинці» (PiP) призупиняється під час рекламних пауз відповідно до рекламної політики платформи
• Обробляється фоновий звук — реклама не відтворюється у фоновому режимі

Android (ExoPlayer + IMA SDK)

• Player.Listener.onMetadata() з MetadataOutput захоплює події SCTE-35 з HLS/DASH
• Google IMA Android SDK інтегрований через розширення ExoPlayer ImaAdsLoader
• Відтворення реклами використовує окремий MediaSource, щоб уникнути забруднення буфера контенту
• Обробляє життєвий цикл Activity — стан реклами зберігається при змінах конфігурації та роботі у фоновому режимі
• Android TV та мобільні пристрої використовують одну й ту ж логіку реклами з адаптаціями на рівні UI

Платформи підключених телевізорів

Roku (RAF — Roku Ad Framework)

• Нативна бібліотека RAF від Roku розбирає маркери SCTE-35 безпосередньо з маніфестів HLS
• RAF.setAdUrl() налаштовується з кінцевою точкою VAST; RAF обробляє рекламний запит, побудову рекламного блоку та відтворення
• Підтримка супутньої реклами через колбеки RAF renderStitchedAd та renderTrackingEvent
• Сертифікація Roku вимагає використання RAF — кастомні рекламні плеєри відхиляються під час перевірки

Fire TV (IMA SDK)

• Використовує реалізацію Android ExoPlayer + IMA SDK, адаптовану для Leanback UI Fire TV
• Навігація за допомогою D-pad для кнопки пропуску та переходу за кліком «Дізнатися більше» на рекламних накладках
• Fire TV Ad ID використовується для таргетингу реклами в запитах VAST

Apple TV (AVKit + Custom)

• AVPlayerViewController з interstitialTimeRanges для нативних UI-індикаторів рекламних пауз
• Сигнали SCTE-35 розбираються за допомогою AVPlayerItemMetadataCollector
• Відтворення реклами керується в окремому AVQueuePlayer для чіткого розділення контенту та реклами
• Обробник кліків з пульта tvOS для інтерактивних рекламних елементів

Керування рекламними блоками

• Заповнення блоку — Кілька оголошень VAST об'єднуються для заповнення сигналізованої тривалості паузи
• Водоспад — Якщо основний рекламний сервер повертає «без заповнення», послідовно запитуються вторинні/третинні джерела попиту
• Підбір тривалості — Складальник блоків вибирає комбінації оголошень, які вписуються в тривалість паузи (допуск ±0.5с)
• Дедуплікація — Один і той же рекламний креатив не відображається двічі в одному блоці
• Обмеження частоти — Обмеження на користувача, на сесію застосовуються на стороні клієнта, щоб уникнути втоми від реклами
• Бамперна реклама — Короткі бамперні креативи («Ми скоро повернемося» / «Ласкаво просимо назад») обрамляють рекламні блоки

Відстеження рекламних подій та аналітика

• Стандартні події VAST — impression, start, firstQuartile, midpoint, thirdQuartile, complete, skip, clickThrough
• Видимість — Пікселі видимості MOAT/IAS спрацьовують на основі видимості рекламного вікна та порогових значень тривалості
• Кастомні події — Події на рівні додатка (початок/кінець рекламної паузи, показник заповнення блоку, час попереднього завантаження, спрацювання відкату)
• Серверний конвеєр — Клієнт надсилає події легкому збирачу подій, який розподіляє їх до GAM, MOAT та внутрішнього аналітичного сховища
• Звірка — Звірка журналів на стороні сервера з подіями на стороні клієнта для виявлення розбіжностей

Обробка блокувальників реклами (Веб)

• Виявлення — Канарний запит VAST до відомого рекламного домену; тайм-аут або блокування вказує на блокувальник реклами
• Стратегія відкату — Показувати внутрішню рекламу або рекламні трейлери з домену власного CDN
• Захист контенту — Опціональний м'який захист: пропонувати користувачу додати сайт до білого списку перед відтворенням контенту
• Аналітика — Частота виявлення блокувальників реклами відстежується за браузером, географією та сторінкою

Ключові особливості

1. Кросплатформна CSAI — Уніфікована вставка реклами на веб, iOS, Android, Roku, Fire TV та Apple TV
2. Розбір SCTE-35 на стороні клієнта — Розбір HLS EXT-X-DATERANGE, CUE-OUT/IN та DASH EventStream
3. Інтерактивна реклама — Клікабельні накладки, супутні банери та кнопки пропуску на всіх платформах
4. Оркестрація рекламних блоків — Заповнення багатослотових рекламних пауз за допомогою водоспадної моделі, підбору тривалості та дедуплікації
5. Попереднє завантаження — Рекламні креативи попередньо завантажуються під час відтворення контенту для переходів реклами без затримок
6. Відстеження видимості — Інтеграція MOAT/IAS для відповідності вимогам преміальних покупців реклами щодо видимості
7. Відповідність вимогам підключених телевізорів — Інтеграції Roku RAF, Fire TV IMA та Apple TV AVKit, що відповідають вимогам сертифікації
8. Стійкість до блокувальників реклами — Виявлення та відкат до внутрішньої реклами від першої сторони на веб