Ad Break API для динамической вставки объявлений (DAI) позволяет создавать рекламные паузы в прямых трансляциях и управлять их временем, а также данными таргетинга объявлений.
С помощью API рекламных пауз DAI вы можете:
- Повышение заполняемости рекламных мест в периоды пикового трафика. Сервисы динамической вставки объявлений получают больше времени на выбор наиболее доходных объявлений для ваших прямых трансляций. Рекомендуем использовать DAI Ad Break API, если у вас много одновременных трансляций, динамические теги объявлений или объявления с высокой задержкой.
- Полный контроль над рекламными паузами. Вы можете заранее создавать, обновлять и удалять рекламные паузы. Это дает больше гибкости, чем передача сигналов о рекламных паузах в манифесте, и позволяет повысить заполняемость при показе пакетов по сравнению с принятием решений в реальном времени.
- Обеспечьте непрерывный просмотр. Предоставляйте точную информацию о рекламных паузах, чтобы минимизировать ошибки воспроизведения, связанные с рекламой, например неполные или переполненные пакеты объявлений.
В этом руководстве описаны методы DAI Ad Break API и жизненный цикл рекламной паузы при использовании полного пакета услуг по динамической вставке объявлений и показе пакетов с динамической вставкой объявлений.
Методы API для рекламных пауз DAI
API предоставляет следующие стандартные методы для управления ресурсами AdBreak:
Create– определяет новый объектAdBreakдля объектаLiveStreamEvent. При необходимости задайте свойствоexpectedStartTime, чтобы запланировать принятие решения о показе объявления в течение 60 секунд до начала рекламной паузы.Get– позволяет получить сведения об определенном объектеAdBreak, в том числе метаданные о состоянии и времени рекламной паузы.List– возвращает список объектовAdBreak, ранее созданных с помощью API для определенного объектаLiveStreamEvent, в обратном хронологическом порядке. Обратите внимание, что API не возвращает рекламные паузы, определенные только в манифесте потока контента.Update– изменяет существующий объектAdBreakдо начала выбора объявления.Delete– отменяет решение о показе рекламы для ранее созданного объектаAdBreak.
Жизненный цикл рекламной паузы
Объект AdBreak может иметь следующие статусы:
BREAK_STATE_UNSPECIFIED– статус по умолчанию.BREAK_STATE_SCHEDULED– рекламная пауза создана и запланирована для выбора объявления.BREAK_STATE_DECISIONED– сервисы динамической вставки объявлений начали процесс выбора объявлений для рекламной паузы. Вы не можете изменить рекламную паузу, но можете отменить ее, что может привести к неблагоприятным последствиям для серверов объявлений.
BREAK_STATE_COMPLETE– рекламная пауза была показана пользователям.BREAK_STATE_EXPIRED– срок действия рекламной паузы истек до показа. Этот параметр доступен, только если вы включили планирование нескольких рекламных пауз в рамках трансляции. Подробнее о настройках рекламных пауз в середине видео… По умолчанию срок действия рекламных пауз истекает через 30 минут после значения, указанного в полеexpectedStartTime, или через 30 минут после начала принятия решений, если вы не заполнили полеexpectedStartTime. Вы можете изменить этот период с помощью поляexpireDuration.
На следующей диаграмме показана хронология объекта AdBreak от создания до завершения.

Объект AdBreak можно создать за 1–300 минут до ожидаемого начала рекламной паузы.
- Не создавайте рекламную паузу менее чем за минуту до ее ожидаемого начала. В противном случае у системы динамической вставки объявлений может не хватить времени на подбор рекламы, что приведет к снижению заполняемости.
- Не создавайте рекламную паузу более чем за шесть часов до ее ожидаемого начала, поскольку серверы объявлений могут аннулировать запрошенные объявления.
В разделах ниже описаны переходы между состояниями рекламной паузы в процессах полного обслуживания и показа пакетов при динамической вставке объявлений.
Как работает динамическая вставка объявлений в видеоконтент
При использовании динамической вставки объявлений Google Full-service DAI управляет как манифестом контента, так и пакетами объявлений.
Чтобы настроить таргетинг объявлений, используйте DAI Ad Break API для создания объекта AdBreak перед соответствующим маркером объявления в манифесте прямой трансляции контента.
- Это время позволяет сервисам динамической вставки объявлений Google использовать данные
AdBreakдля принятия решения о показе рекламы. - Когда система динамической вставки объявлений Google обнаруживает маркер объявления в манифесте, она принимает решения о показе рекламы на основе данных объекта
AdBreakи переводит объект в состояниеBREAK_STATE_COMPLETE.
Если вы включите планирование нескольких рекламных пауз в трансляции, то сможете задать поле matchParams в объекте AdBreak. Этот процесс позволяет Google DAI сопоставлять обнаруженные маркеры объявлений в манифесте с рекламными паузами в состоянии BREAK_STATE_SCHEDULED или BREAK_STATE_DECISIONED.

Как работает показ пакетов
В этом процессе вы управляете манифестом прямой трансляции контента или используете сторонний инструмент управления манифестом, чтобы обнаруживать маркеры объявлений в манифесте.
Вызовите DAI Ad Break API до ожидаемого времени начала рекламной паузы, чтобы создать объект AdBreak до того, как вам потребуется запросить сегменты пакета объявлений или манифест объявления.
Когда инструмент склейки видео обнаруживает маркер объявления в манифесте и запрашивает сегменты объявлений с идентификатором рекламной паузы, динамическая вставка объявлений Google использует данные AdBreak с тем же идентификатором для принятия решений о показе рекламы.
После того как клиент запросит рекламные медиафайлы, объект AdBreak, созданный вами с помощью API, перейдет в состояние BREAK_STATE_COMPLETE.

Как отправить первый запрос
Информацию о том, как настроить доступ к API и создать первый запрос, можно найти в статье Как использовать DAI Ad Break API.