# Как работает SSAI.TV

> Source: https://support.adaptek.tv/docs/ssai/how-it-works?lang=ru · 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.en.png)

Цифры на схеме — шаги процесса серверной вставки: [валидация, VAST-запрос и ответ, транскодирование, склейка, S2S-трекинг](https://support.adaptek.tv/docs/ssai/integration/ad-server?lang=ru#процес-серверної-вставки-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?lang=ru)).

> [!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?lang=ru).

## Роли и ответственность
| Сторона | Отвечает за |
|---|---|
| **Правообладатель / канал** | Метки SCTE-35, филлер, правила рекламы — [Метки SCTE-35 на канале](https://support.adaptek.tv/docs/ssai/integration/scte35?lang=ru) |
| **Сейлзхаус / ад-сервер** | Кампании, валидация креативов с правообладателем, VAST — [Технические условия для ад-сервера](https://support.adaptek.tv/docs/ssai/integration/ad-server?lang=ru) |
| **OTT-платформа** | Упаковка HLS, CDN, передача данных устройства — [ТЗ интеграции для OTT-платформы](https://support.adaptek.tv/docs/ssai/integration/ott?lang=ru), [CDN — требования для SSAI](https://support.adaptek.tv/docs/ssai/integration/cdn?lang=ru) |
| **Adaptek (SSAI.TV)** | Манипуляция манифестом, транскодирование, трекинг, отчётность |

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

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