Изображение плаката аудиорекламы

В этом руководстве показано, как использовать IMA HTML5 SDK для наложения видеопроигрывателя на изображение постера при воспроизведении аудиообъявлений. Его следует использовать, если в запросе URL-адреса VAST установлено значение ad_type=audio_video . Это позволит улучшить монетизацию рекламы, поскольку как аудио, так и видеообъявления допускаются к показу и являются полноценными. Дополнительную информацию см. в документации ad_type и разделе «Аудио в видеоконтенте» .

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

Предварительные условия

• Приложение, реализующее IMA HTML5 SDK для видеорекламы. Дополнительную информацию см. в руководстве по началу работы с HTML5 IMA .
• Изображение плаката по умолчанию, которое накладывается на видеопроигрыватель, когда аудиообъявление показывается без соответствующего наложения изображения. Чтобы изображение поместилось в видеоплеере, его ширина должна быть меньше или равна ширине видеоплеера, а его высота должна быть как минимум на 75 пикселей меньше ширины видеоплеера.

Включите функцию изображения постера

Прежде чем отправлять запрос на аудио- и видеообъявление, установите для флага функции audioPosterImageEnabled значение true , а для флага функции audioPosterImageDefaultUrl укажите URL-адрес изображения плаката по умолчанию. Сделайте это с помощью API ImaSdkSettings.setFeatureFlags() перед созданием AdDisplayContainer . Если этот параметр установлен и воспроизводится аудиообъявление, IMA автоматически накладывает изображение, связанное с объявлением, поверх видеопроигрывателя. IMA выбирает самое большое доступное изображение сопутствующего объявления, которое помещается в видеопроигрыватель и как минимум на 75 пикселей короче видеопроигрывателя. Если VAST объявления не содержит изображения, которое IMA может использовать в качестве наложения, IMA использует указанное вами изображение по умолчанию в качестве наложения.

function initializeIMA() {
  console.log('initializing IMA');
  adContainer = document.getElementById('ad-container');
  google.ima.settings.setFeatureFlags(
    {
      'audioPosterImageEnabled': true,
      'audioPosterImageDefaultUrl':'http://your-ad-overlay/image.png'
    });
  adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);
  adsLoader = new google.ima.AdsLoader(adDisplayContainer);

  // Let the AdsLoader know when the video has ended
  videoElement.addEventListener('ended', function() {
    adsLoader.contentComplete();
  });

  var adsRequest = new google.ima.AdsRequest();
  adsRequest.adTagUrl = 'http://your-audio-video-ad-tag';
  ...
  // Pass the request to the adsLoader to request ads
  adsLoader.requestAds(adsRequest);
}