API обслуживания модулей обеспечивает доступ к модулям видеорекламы с адаптивным битрейтом, подготовленным таким образом, что их можно вставлять непосредственно в пользовательский плейлист мультимедиа HLS или MPEG DASH.
Этот API предназначен для опытных издателей и партнеров по видеотехнологиям. Использование этого API в большом масштабе требует разработки и реализации сложного рабочего процесса обслуживания мультимедиа, который выходит за рамки этой документации.
Предварительные условия
Прежде чем обрабатывать прямую трансляцию через DAI Podserving API, вам необходимо создать прямую трансляцию с помощью пользовательского интерфейса Google Ad Manager или API прямых трансляций.
Компоненты
Любая реализация Pod Serving API состоит из трех компонентов: Google Ad Manager, клиентского видеоплеера и сервера манифестов манифеста.
Менеджер рекламы
Менеджер рекламы отвечает за доставку рекламы пользователю, и им можно управлять через SDK Менеджера рекламы или его веб-интерфейс. На службу возложены следующие обязанности:
- Получение запросов потока от клиентского видеоплеера, принятие решений по рекламе и предоставление воспроизведений в соответствии с вашими профилями кодирования контента.
- Ответ на запросы рекламного сегмента от клиентского видеоплеера и предоставление соответствующей части рекламного модуля данному пользователю.
- Получение и обработка пингов отслеживания от клиентского видеоплеера
Клиентский видеоплеер
Клиентский видеопроигрыватель — это приложение или веб-сайт, который клиенты используют для воспроизведения полученного видеопотока. Игрок имеет следующие обязанности:
- Инициализация ресурса потока из Менеджера рекламы и получение объекта потока, представляющего один сеанс воспроизведения определенного события прямой трансляции.
- Запрос манифеста потока с сервера манифестов, который начинает воспроизведение
- Периодический опрос метаданных рекламного модуля из Менеджера рекламы, описывающих рекламные события, встроенные в рекламные сегменты потока.
- Прослушивание синхронизированных событий метаданных, создаваемых проигрывателем и содержащих идентификаторы рекламных носителей. При обнаружении этих событий игрок пересылает их в Менеджер рекламы, чтобы убедиться, что рекламные события произошли успешно.
Чтобы узнать больше о правильной реализации клиентского видеоплеера, см. руководство по обслуживанию модулей для вашей платформы:
Информацию о пользовательских реализациях см. в нашем руководстве по клиенту обслуживания модулей для DAI API .
Сервер манипуляции манифестами
Сервер манипулирования манифестом — это сервер, отвечающий за размещение манифеста потока, предоставляемого клиентскому видеоплееру. Сервер имеет следующие обязанности:
- Обработка доставки манифеста клиентскому видеоплееру
- Запрос шаблона периода у Менеджера рекламы (только для потоков MPEG DASH) для заполнения сегментами объявлений.
- Вставка URL-адресов рекламных сегментов, размещенных в Менеджере рекламы, в манифест видеопотока (для HLS) или рекламный период (для MPEG DASH) во время рекламных пауз.
- Передача измененного манифеста клиентскому видеоплееру.
Дополнительные сведения о реализации пользовательского сервера манипулятора манифеста см. в руководстве по манипуляции манифестами .
Глоссарий
- Событие прямой трансляции : событие, в котором сохраняются важные данные конфигурации прямой трансляции, например профили кодирования. Прямые трансляции создаются с помощью Менеджера рекламы.
- Объект потока : объект, представляющий один сеанс воспроизведения определенного видеоресурса. Известные свойства включают идентификатор потока и URL-адрес проверки мультимедиа.
- Рекламный блок : группировка рекламных видеороликов, показываемых в рекламной паузе.
- Сегменты рекламы : файлы медиасегментов для рекламной паузы.
- Метаданные рекламного модуля : метаданные рекламной паузы, используемые для отображения пользовательского интерфейса рекламы на клиенте; например, скрыть кнопки поиска во время рекламы
- Идентификатор рекламного носителя : метаданные, закодированные в виде тегов ID3 в файлах рекламных сегментов. Эти метаданные используются для определения того, когда во время воспроизведения произошли определенные события, связанные с рекламой, например начало или середина рекламы.