Руководство по внедрению

Видео post-roll

Post-roll video ads

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

Ad Manager
Ad Exchange
AdSense (через Ad Manager)
внутри видеоплеера (телефон и компьютер)

Изучить формат Проверить на моём сайте

Десктоп

Мобильный

Понять за 1 минуту

Что такое видео post-roll

Знаете, когда телепередача заканчивается и перед следующей идут рекламные ролики? Post-roll это то же самое на вашем сайте: видеореклама, которая играет в конце видео, в том же плеере. Человек уже посмотрел то, что хотел, и сразу после этого появляется реклама. Pre означает «до», mid «посередине», post «после».

Секрет post-roll в том, чтобы сообщить плееру, что видео закончилось. IMA SDK, то есть пакет кода Google для размещения рекламы в плеере, сам не догадывается, что контент закончился. В руководстве Google сказано так: чтобы post-roll играл, нужно сообщить SDK, когда контент закончился, и тогда он запустит финальный рекламный блок, если он запланирован. Это сообщение нужно отправлять только когда заканчивается видео, никогда когда заканчивается реклама, потому что IMA может использовать тот же плеер для рекламы. Как давать школьный звонок только по окончании урока, а не посреди перемены.

Перерывы можно организовать правилами видеорекламы, функцией Google Ad Manager 360. В них post-roll можно включить (Включить), выключить (Отключить) или оставить на решение правила с более низким приоритетом (Отложить). С правилами ответ приходит в формате VMAP, как телепрограмма, которая сообщает, какие перерывы есть. Без правил сам плеер может сделать запрос в конце видео и указать в теге, что это post-roll.

Когда это стоит делать? Когда на сайте уже есть видео и вы хотите ещё один момент для рекламы, не прерывающий ни начало, ни середину контента. Правила любой In-stream рекламы продолжают действовать: место должно быть правильно объявлено, элементы управления нельзя скрывать, и одновременно может играть сам только один видимый плеер. А когда все блоки уже сыграли, IMA сообщает об этом отдельным событием, которое можно использовать, чтобы привести страницу в порядок.

Пошаговая инструкция

Как внедрить

Подготовьте плеер с IMAСоберите плеер с IMA SDK, как для pre-roll: скрипт IMA, блок рекламы поверх видео, AdsLoader и AdsRequest с вашим тегом.
Включите post-roll в правилеВ Ad Manager 360 перейдите в Видео, Правила рекламы, Новое правило рекламы, выберите Стандартное и отметьте видео post-roll как Включить. Затем задайте Максимальное количество объявлений и Максимальная длительность объявления.
Настройте тегС правилами рекламы тег содержит ad_rule=1. Без правил плеер делает запрос в конце видео и может передать vpos=postroll, что означает, что запрос относится к концу видео.
Сообщите об окончании контентаСлушайте окончание видео и вызывайте уведомление о завершении контента у AdsLoader. Снимайте этот обработчик, когда начинается реклама, и возвращайте, когда возвращается контент.
Завершите после рекламыIMA сообщает событием ALL_ADS_COMPLETED, что все блоки уже сыграли. Используйте это уведомление, чтобы очистить плеер, если нужно.

Пример внедрения

Код и как это выглядит на экране

Идёт вместе с кодом плеера с IMA: сообщает об окончании видео, чтобы post-roll сыграл, и управляет обработчиками, пока идёт реклама.

<script>
  var video = document.getElementById('conteudo');

  // Avisa o IMA que o CONTEÚDO acabou (nunca no fim de um anúncio)
  var contentEndedListener = function () { adsLoader.contentComplete(); };
  video.addEventListener('ended', contentEndedListener);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        adsManager = e.getAdsManager(video);

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () {
              // anúncio vai tocar: tira o ouvinte de fim do vídeo
              video.removeEventListener('ended', contentEndedListener);
              video.pause();
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () {
              // conteúdo volta: coloca o ouvinte de novo
              video.addEventListener('ended', contentEndedListener);
              if (!video.ended) { video.play(); }
            });

        adsManager.addEventListener(
            google.ima.AdEvent.Type.ALL_ADS_COMPLETED,
            function () { console.log('Todos os intervalos tocaram'); });
      });
</script>

На компьютереКогда видео доходит до конца, реклама играет в том же плеере. После рекламы видео само не начинается заново.

На мобильныхКак на компьютере: реклама играет в плеере на телефоне сразу после окончания видео.

Что рекомендует Google

Что можно и что нельзя

Можно

Показывать рекламу в конце видео, в том же плеере, с помощью IMA SDK.
Включать, отключать или оставлять на решение другому правилу post-roll в правилах видеорекламы Ad Manager 360.
Делать запрос в конце видео без правил рекламы и указывать в теге, что это post-roll.
Использовать событие завершения всей рекламы, чтобы привести страницу в порядок после последнего блока.

Нельзя

Нельзя сообщать об окончании контента, когда закончилась реклама: уведомление только для конца видео.
Нельзя оставлять элементы управления видео и рекламы закрытыми, скрытыми или неработающими.
Нельзя объявлять слот неверно: плеер с видео должен быть In-stream или Сопровождающий контент.
Нельзя иметь больше одного видимого плеера, который играет сам, одновременно.
Нельзя использовать продукты IMA, чтобы зарабатывать на видео YouTube.

Советы

Как сделать правильно

Если забыть сообщить об окончании контента, post-roll просто не сыграет.
Пример Google не сообщает об окончании контента, если в этот момент играет реклама.
Когда контент возвращается после рекламы, пример Google запускает воспроизведение, только если видео ещё не закончилось.

Осторожно

Частые ошибки

Не сообщать об окончании видео

Google говорит, что для воспроизведения post-roll SDK должен знать, что контент закончился. Без этого сообщения финальный блок не происходит.

Сообщать в конце рекламы

Если обработчик конца видео остаётся включённым, пока реклама играет в том же плеере, уведомление может уйти в неподходящий момент. Снимайте обработчик на паузе и возвращайте, когда контент вернётся.

Запускать уже закончившееся видео

После post-roll IMA просит возобновить контент. Если видео уже закончилось, не запускайте его снова, иначе оно может начаться заново без запроса человека.

Частые вопросы

Почему мой post-roll не появляется?

Возможная причина в том, что вы не сообщили IMA, что видео закончилось. Google просит, чтобы сайт сообщал об окончании контента, чтобы SDK проиграл перерыв в конце, если он запланирован.

Нужны ли правила рекламы для post-roll?

Не обязательно. С правилами (Ad Manager 360) post-roll приходит запланированным в VMAP. Без правил плеер может запросить рекламу в конце видео и указать в теге vpos=postroll.

Прерывает ли post-roll видео?

Нет. Он играет после окончания контента, в том же плеере.

Библиотека

Официальный источник Google

Всё на этой странице основано на официальной документации Google. Читайте прямо в источнике:

Ваш сайт правильно использует этот формат?

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

Запустить аудит