API монитора действий в потоке с динамической вставкой объявлений позволяет проверять отдельные сеансы просмотра прямых трансляций и видео по запросу и устранять неполадки в них.
Чтобы визуально проверить и устранить неполадки в отдельной прямой трансляции или сеансе просмотра видео по запросу, используйте монитор действий в потоке в интерфейсе Google Менеджера рекламы.
Чтобы программно получить диагностические данные для сеанса, используйте ресурс networks.daiSessions Ad Manager API.
Примеры использования
С помощью SAM API можно автоматизировать диагностику потоков и устранять проблемы с показом объявлений в интеграциях с динамической вставкой объявлений, например:
- Проверка создания сеанса трансляции. Подтвердите параметры, режим вставки (
STITCHEDилиPOD_SERVING), режим отчетов и метаданные контента, которые получает динамическая вставка объявлений Google при создании сеанса прямой трансляции или видео по запросу. - Аудит запросов объявлений и ответов на них. Проверяйте исходящие теги объявлений VAST и VMAP, коды статуса HTTP, задержки ответов, необработанные тела ответов XML и цепочки переадресации контейнеров.
- Устранение неполадок с выбором пакетов объявлений и креативов. Проверьте, какие объявления динамическая вставка объявлений Google выбирает или отклоняет для каждого пакета, какова продолжительность каждого объявления в пакете и какая рекламная система является источником креатива.
- Отслеживание выполнения предзагрузки объявлений. Вы можете узнать, выполняет ли динамическая вставка объявлений Google предзагрузку пакета объявлений, и проверить этап предзагрузки каждого пакета.
- Проверка вызовов DAI Ad Break API и Pod Serving DAI API. Сравните фактическое выполнение рекламных пауз, продолжительность показанных объявлений и длительность вставленных заставок с вызовами API, такими как DAI Ad Break API и Pod Serving DAI API.
- Проверьте отслеживание событий объявлений. Убедитесь, что сигналы отслеживания на стороне клиента или сервера успешно отправляются, и проверьте HTTP-ответы от серверов объявлений.
- Автоматизируйте мониторинг сеансов и оповещения. Анализируйте структурированные записи о результатах с уровнем серьезности
INFO,WARNINGилиERROR, чтобы обнаруживать проблемы с воспроизведением или монетизацией в автоматических тестах интеграции и конвейерах мониторинга рабочей среды.
Ресурс верхнего уровня
SAM API – это часть Google Менеджер рекламы REST API (бета-версия) в конечной точке admanager.googleapis.com, которая предоставляет доступ к методу networks.daiSessions.get, предназначенному только для чтения. Вы можете запросить ресурс DaiSession, используя идентификатор сеанса динамической вставки объявлений или специальный ключ отладки. DAI хранит записи сеансов до трех дней после воспроизведения.
SAM API не поддерживает вывод списка всех ресурсов DaiSession в сети Google Менеджера рекламы.
Как проверять ответы потоков с динамической вставкой объявлений с помощью SAM
Чтобы проверить, как динамическая вставка объявлений Google обрабатывает запросы потоков, изучите ответ DaiSession:
- Full-service DAI API. Изучите поле
creationContext.streamCreateRequest, чтобы проверить вызов регистрации потока. Проверьте картыadSelectionsиadPods, чтобы узнать, как принимаются решения о показе объявлений. Изучите картуadBreaks, чтобы подтвердить продолжительность объединенных объявлений, креативов-заставок и основного контента. - DAI API для показа пакетов. Убедитесь, что в поле
creationContext.stitchingTypeуказано значениеPOD_SERVING. Сравните полеadBreakIdв картахadPodsиadBreaksс манифестом пакета или вызовами запросов сегментов пакета. Проверьте маяки на стороне сервера или маяки проверки медиаконтента в картеtrackingPings. - DAI Ad Break API. Сопоставьте значение
breakSequenceобъектаAdBreakсо свойствомAdBreak.breakSequence.
Как отправить первый запрос
Инструкции по настройке аутентификации и получению ресурсов сеанса динамической вставки объявлений приведены в статье Как использовать Stream Activity Monitor API.