# Як працює SSAI.TV

> Source: https://support.adaptek.tv/docs/ssai/how-it-works · Language: Українська · Product: SSAI.TV · Access: public
>
> Архітектура, потік запитів і ролі каналу, OTT, ад-сервера та SSAI.

SSAI.TV стоїть у ланцюжку доставки контенту одразу після CDN Origin і обробляє запити плеєрів. Він не пропускає контент через себе — лише формує для кожного глядача власний маніфест, у якому рекламні сегменти замінюють оригінальні.

## Потік

![Архітектура SSAI.TV: канал → OTT → SSAI → плеєр, ад-сервер і трекінг](https://support.adaptek.tv/docs-assets/ssai/media/public/ssai-flow.uk.png)

Цифри на схемі — кроки процесу серверної вставки: [валідація, VAST-запит і відповідь, транскодування, склеювання, S2S-трекінг](https://support.adaptek.tv/docs/ssai/integration/ad-server#процес-серверної-вставки-s2s).

1. **ТВ-канал** транслює потік з мітками **SCTE-35**, що позначають початок і тривалість рекламного блоку.
2. **OTT-платформа** кодує потік у формати для плеєрів і пакує в HLS (створює маніфест `.m3u8`). Мітки зберігаються, а чанки ріжуться так, щоб межі блоку збігалися з межами сегментів — це стандартна функція пакувальників.
3. **SSAI.TV** читає маніфест, розпізнає мітки. Коли починається блок і є рішення замінити рекламу — формує індивідуальний маніфест.
4. **Плеєр глядача** запитує плейлист через посилання, яке OTT отримала від SSAI.TV. Разом із запитом передаються дані пристрою: IP (гео), User-Agent (тип пристрою), ідентифікатор пристрою (частота, охоплення).
5. **SSAI.TV звертається до ад-сервера** (VAST-запит) з параметрами блоку й глядача.
6. **Ад-сервер** визначає, чи належить глядач до цільової аудиторії кампаній, і повертає список креативів в одній відповіді.
7. **SSAI.TV** перекодовує нові креативи у всі профілі потоку (з нормалізацією гучності EBU R 128), збирає рекламний блок, у залишок ставить погоджений з каналом **філлер** і віддає глядачу новий плейлист. Якщо реклами менше за поріг **fillfloor** — вставка не виконується, іде оригінальний ефір.
8. **Трекінг:** SSAI.TV відстежує запити сегментів, рахує фактичну тривалість показу і повідомляє вимірювачів про кожен показ (або передає трекери клієнту — [Client Side Tracking](https://support.adaptek.tv/docs/ssai/integration/client-side-tracking)).

> [!NOTE]
> Перший запит на новий креатив зазвичай дає філлер: креатив спершу транскодується, а в ефір потрапляє з наступного запиту. Це штатна поведінка.

## Два варіанти розміщення

| | SSAI «за» OTT (reverse proxy) | SSAI «перед» OTT |
|---|---|---|
| Посилання для глядача | домен OTT | домен SSAI.TV |
| Хто звертається до SSAI | сервери OTT, передаючи дані глядача в заголовках | плеєр напряму |
| Сегменти контенту | абсолютні посилання на CDN OTT | абсолютні посилання на CDN OTT |
| Сегменти реклами | через CDN OTT (`/creatives/`) | через CDN OTT (`/creatives/`) |

Деталі — у [ТЗ інтеграції для OTT-платформи](https://support.adaptek.tv/docs/ssai/integration/ott).

## Ролі та відповідальність

| Сторона | Відповідає за |
|---|---|
| **Правовласник / канал** | Мітки SCTE-35, філлер, правила реклами — [Мітки SCTE-35 на каналі](https://support.adaptek.tv/docs/ssai/integration/scte35) |
| **Сейлзхаус / ад-сервер** | Кампанії, валідація креативів з правовласником, VAST — [Технічні умови для ад-сервера](https://support.adaptek.tv/docs/ssai/integration/ad-server) |
| **OTT-платформа** | Пакування HLS, CDN, передача даних пристрою — [ТЗ інтеграції для OTT-платформи](https://support.adaptek.tv/docs/ssai/integration/ott), [CDN — вимоги для SSAI](https://support.adaptek.tv/docs/ssai/integration/cdn) |
| **Adaptek (SSAI.TV)** | Маніпуляція маніфестом, транскодування, трекінг, звітність |

> [!IMPORTANT]
> SSAI.TV не відповідає за дотримання авторських прав і вимог власників контенту — він вставляє креатив за інструкцією ад-сервера, визначеного замовником. Валідація креативів — зона сейлзхаусу та правовласника.

## VOD і FAST

Для VOD розкладка брейків береться з медіаплану CMS або з ad rules ад-сервера (VMAP). З VOD-контенту можна зібрати FAST-канал із тією ж серверною вставкою. Точність вставки у VOD обмежена межами сегментів — див. [Реклама ріже сцену у VOD](https://support.adaptek.tv/docs/ssai/troubleshooting#реклама-ріже-сцену-у-vod).