API для рекламных пауз при динамической вставке объявлений

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

С помощью DAI Ad Break API можно:

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

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

На приведенной ниже схеме показана хронология объекта AdBreak с момента создания до завершения.

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

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

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

В следующих разделах описаны переходы между состояниями рекламных пауз при использовании полного сервиса динамической вставки объявлений и показа пакетов.

Как работает динамическая вставка объявлений с полным сервисом

При использовании динамической вставки объявлений с полным набором услуг Google управляет как манифестом контента, так и пакетами объявлений.

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

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

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

Как показываются пакеты объявлений

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

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

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

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

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

Как отправить первый запрос

Чтобы настроить доступ к API и создать первый запрос, ознакомьтесь с разделом Как использовать DAI Ad Break API.