Узнайте больше об API DAI Ad Break

API для динамической вставки рекламы (DAI) позволяет создавать и управлять временем показа и данными о таргетинге предстоящих рекламных пауз в ваших прямых трансляциях.

С помощью API DAI Ad Break вы можете делать следующее:

  • Повысьте коэффициент заполнения рекламы в часы пиковой нагрузки : предоставьте сервисам динамической вставки рекламы (DAI) больше времени для выбора наиболее эффективных объявлений для ваших прямых трансляций. Мы рекомендуем использовать API DAI Ad Break, если ваши прямые трансляции содержат большое количество одновременных показов, динамических рекламных тегов или рекламы с высокой задержкой.
  • Получите полный контроль над рекламными паузами : создавайте, обновляйте и удаляйте рекламные паузы заранее, что обеспечивает большую гибкость, чем сигнализация рекламы в манифесте, и более высокий коэффициент заполнения показов в блоках по сравнению с принятием решений «точно в срок».
  • Обеспечьте непрерывное взаимодействие со зрителем : минимизируйте ошибки воспроизведения рекламы, такие как недостаточное или избыточное заполнение рекламных блоков, предоставляя точную информацию о рекламных паузах.

В этом руководстве описаны методы API DAI для рекламных пауз и подробно описан жизненный цикл рекламных пауз для потоков DAI Full Service и Pod Serving.

Изучите методы 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 : Сервисы DAI запустили процесс выбора рекламы для рекламной паузы. Вы не можете изменить рекламную паузу, но можете отменить её, что может негативно сказаться на работе рекламных серверов.
  • BREAK_STATE_COMPLETE : Пользователям показана рекламная пауза.

На следующей диаграмме показана хронология создания объекта AdBreak , от начала до конца.

От создания до завершения рекламной паузы.

Вы можете создать объект AdBreak за период от 1 до 300 минут до предполагаемого начала рекламной паузы.

  • Избегайте создания рекламной паузы менее чем за минуту до предполагаемого времени ее начала, поскольку у Google DAI может не хватить времени для принятия решения по рекламе, что приведет к снижению коэффициента заполнения рекламы.
  • Избегайте создания рекламной паузы более чем за 6 часов до предполагаемого времени её начала, так как рекламные серверы могут аннулировать запрошенные объявления.

В следующих разделах рассматриваются переходы состояний рекламной паузы в потоках DAI Full Service и Pod Serving.

Разберитесь в полном цикле обслуживания DAI.

Сервис Google Full Service DAI управляет как контентным манифестом, так и рекламными блоками.

Для настройки таргетинга рекламы используйте API DAI Ad Break, чтобы создать объект AdBreak перед соответствующим рекламным маркером в манифесте потока контента.

  • Этот период времени позволяет сервисам Google DAI использовать ваши данные AdBreak для принятия решения о показе рекламы.
  • Когда Google DAI обнаруживает маркер явного объявления, система принимает решения по объявлению, используя данные сущности AdBreak , и переводит состояние сущности в BREAK_STATE_COMPLETE .

Вставка рекламы прерывает процесс от создания до завершения в потоке обслуживания пода.

Разберитесь в процессе обслуживания Pod-ов.

В этом процессе вы управляете манифестом потокового контента или используете сторонний сервис для манифестирования, чтобы обнаружить рекламные маркеры в манифесте.

Вызовите API DAI Ad Break до предполагаемого времени начала рекламной паузы, чтобы создать сущность AdBreak заранее, до того, как вам потребуется запросить сегменты рекламных блоков или манифест рекламы.

Когда ваш инструмент для сшивания видео обнаруживает маркер объявления в манифесте и отправляет запросы на сегменты рекламы с идентификатором рекламной паузы, Google DAI использует данные AdBreak с тем же идентификатором для принятия решений по рекламе.

После того, как ваш клиент запросит рекламный контент, созданный вами через API объект AdBreak перейдет в состояние BREAK_STATE_COMPLETE .

Рекламная пауза, состояние завершения объекта

Сделайте свой первый запрос

Чтобы настроить доступ к API и отправить первый запрос, см. раздел «Использование API DAI для рекламных пауз» .