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

Видео mid-roll

Mid-roll video ads

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

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

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

Десктоп

Мобильный

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

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

Представьте футбольный матч по телевизору: в перерыве идет реклама, а потом игра продолжается. Mid-roll это рекламный перерыв в видео вашего сайта. Видео останавливается в оговоренном месте, в том же плеере играют одно или несколько объявлений, а затем воспроизведение продолжается ровно с того места, где остановилось. Когда подряд идет несколько объявлений, Google называет эту группу набором объявлений (по-английски ad pod), как рекламный блок.

Кто решает, когда делать паузы? В Ad Manager это делают правила видеорекламы, ad rules. Они определяют, когда и как реклама показывается внутри видео. Можно выбрать фиксированное время, например 60, 120 и 180 секунд, или интервал через каждые несколько секунд. Можно также использовать cue points, то есть метки внутри видео с лучшими местами для остановки, например конец сцены. Плеер получает этот план в ответе VMAP, который работает как сетка времени пауз, а IMA SDK воспроизводит каждую паузу в нужный момент.

Есть важные детали. Правила видеорекламы существуют только в Google Ad Manager 360 с расширенным видеоконтрактом. Чтобы mid-roll работал, Ad Manager должен знать, сколько длится видео и где точки остановки. Можно зарегистрировать видео в Ad Manager (это называется загрузкой контента) и передавать в теге коды cmsid и vid. Либо без такой регистрации передавать длительность видео в секундах (vid_d) и список точек остановки в миллисекундах (allcues). Google сообщает, что для mid-roll длительность нужно передавать обязательно.

IMA также нужно знать, на какой секунде находится видео. Поэтому вы передаете IMA сам элемент видео и включаете менеджер рекламы до начала контента, потому что именно с этого момента он начинает отсчитывать время. Mid-roll имеет смысл в видео, которые человек смотрит долго. Всегда думайте о зрителе: Ad Manager позволяет ограничивать, сколько объявлений попадает в каждый перерыв и сколько длится каждое, а также использовать ограничения частоты по перерыву, по видео или по обоим.

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

Как внедрить

Включите правила рекламыВ Ad Manager 360 перейдите в Администратор, Видео и аудио, Настройки аудио и видео. Включите опцию Правила рекламы и сохраните.
Создайте стандартное правилоПерейдите в Видео, Правила рекламы, Новое правило рекламы. Укажите название, выберите тип Стандартное, выберите приоритет и отметьте Видео mid-roll как Включить.
Выберите, когда начинаются паузыВ частоте mid-roll выберите В фиксированное время, Каждые n секунд, В фиксированных точках вставки или Каждые n точек вставки. Затем задайте набор: Максимальное количество объявлений и Максимальная длительность объявления. Время должно быть целым числом.
Передайте длительность и точки в тегеВ теге запросите правила рекламы с помощью ad_rule=1. Если видео не зарегистрированы в Ad Manager, укажите длительность в секундах (vid_d) и точки остановки в миллисекундах (allcues). Если видео зарегистрированы, передайте cmsid и vid.
Свяжите IMA с видеоПередайте IMA видеоэлемент, который сообщает текущее время видео. Запустите менеджер рекламы до воспроизведения контента, потому что именно с этого момента IMA начинает отслеживать время.
Ставьте на паузу и возобновляйте во время паузСтавьте видео на паузу, когда IMA запрашивает паузу, и продолжайте воспроизведение, когда он просит продолжить. Так каждая пауза начинается и заканчивается вовремя.

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

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

Это делается в том же коде плеера с IMA: меняется только тег (с ad_rule=1, vid_d и allcues), а видеоэлемент передаётся IMA, чтобы он знал время.

<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script>
  // Vídeo de 10 minutos (vid_d=600)
  // com intervalos em 2 e 5 minutos (allcues em ms)
  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = 'https://pubads.g.doubleclick.net/gampad/ads?' +
      'iu=/1234567/exemplo&sz=640x480&env=vp&gdfp_req=1' +
      '&ad_rule=1&output=vmap&vid_d=600&allcues=120000,300000' +
      '&unviewed_position_start=1&vpa=click&vpmute=0&plcmt=1' +
      '&description_url=https%3A%2F%2Fwww.exemplo.com%2Fvideo&correlator=';
  adsRequest.linearAdSlotWidth = 640;
  adsRequest.linearAdSlotHeight = 400;
  adsLoader.requestAds(adsRequest);

  adsLoader.addEventListener(
      google.ima.AdsManagerLoadedEvent.Type.ADS_MANAGER_LOADED,
      function (e) {
        // O próprio <video> informa o tempo atual (currentTime) ao IMA
        adsManager = e.getAdsManager(video);
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_PAUSE_REQUESTED,
            function () { video.pause(); });
        adsManager.addEventListener(
            google.ima.AdEvent.Type.CONTENT_RESUME_REQUESTED,
            function () { video.play(); });
      });

  // No clique de play: init() antes de tocar o conteúdo
  // adDisplayContainer.initialize();
  // adsManager.init(640, 360, google.ima.ViewMode.NORMAL);
  // adsManager.start();
</script>

На компьютереВидео останавливается в отмеченной точке, реклама воспроизводится в том же плеере, а когда она заканчивается, контент продолжается с того места, где остановился.

На мобильныхРаботает так же в плеере на телефоне. Если человек перемотает видео вперёд, а плеер это не обработает, несколько пауз могут сработать одна за другой.

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

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

Можно

Выбирать паузы по фиксированному времени, через каждые N секунд, по фиксированным cue points или через каждые N cue points.
Показывать mid-roll без регистрации видео в Ad Manager, передавая в теге vid_d и allcues.
Определять, сколько реклам входит в каждую паузу и сколько может длиться каждая.
Использовать ограничение частоты по паузе, по видео или по обоим параметрам.
Отключить автоматический запуск пауз в IMA и решать в момент показа, воспроизводить ли каждую готовую паузу.

Нельзя

Нельзя показывать mid-roll без указания длительности контента: Google сообщает, что для mid-roll нужно передавать vid_d.
Правила сессии не подходят для mid-roll: их можно применять только к pre-roll.
Нельзя оставлять элементы управления видео и рекламы закрытыми, скрытыми или неработающими.
Нельзя сообщать об окончании контента, когда закончилась реклама: такое уведомление только для конца видео.

Советы

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

Когда человек перематывает видео, запомните время, с которого он начал, и сообщайте это время IMA, пока видео не вернётся в обычный режим. Так не сработает несколько пауз подряд.
В мобильном Safari обнаружение перемотки видео работает неправильно. В руководстве по IMA показан ручной способ определить перемотку.
Если вы добавляете видео в Ad Manager, проверьте в разделе Видео, Контент, правильно ли импортированы Длительность и Точки вставки рекламы в середине видео.
Есть бета-опция Указать настройки последнего рекламного блока в середине видео, чтобы у последнего перерыва были свои настройки. Она не учитывается в прогнозе инвентаря.

Осторожно

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

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

Уведомление об окончании контента предназначено только для момента, когда видео заканчивается. Поскольку IMA может использовать тот же плеер для рекламы, уведомление в конце рекламы путает SDK.

Запускать видео до запуска IMA

IMA начинает отслеживать время только после запуска менеджера рекламы. Поэтому Google просит всегда запускать его до воспроизведения контента.

Плеер, который меняет время во время перемотки

Если ваш плеер обновляет время при перетаскивании полосы, Google рекомендует передать IMA собственный объект, который сообщает правильное время.

Поиск правил рекламы в аккаунте без 360

Правила видеорекламы есть только в Google Ad Manager 360 с расширенным видеоконтрактом. В обычном аккаунте этой опции нет.

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

Нужно ли регистрировать мои видео в Ad Manager?

Нет. Google сообщает, что загрузка контента не обязательна для mid-roll с правилами рекламы. Без неё передавайте в теге длительность (vid_d) и точки остановки (allcues).

Что такое cue point?

Это метка в определённой точке видео, показывающая, что здесь может начаться пауза. В теге cue points передаются в миллисекундах через запятую, например 10000,20000.

Можно ли показывать mid-roll без правил рекламы?

Google говорит, что правила рекламы нужны, чтобы Ad Manager возвращал mid-roll, и это функция Ad Manager 360. Также нужно передавать длительность видео (vid_d).

Сколько реклам входит в каждую паузу?

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

Библиотека

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

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

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

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

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