Часто задаваемые вопросы о Google Interactive Media Ads SDK

Почему я не получаю объявления для всех форматов?
Тестовые теги объявлений настроены так, чтобы всегда возвращать объявления для действительных запросов. Это поможет вам интегрировать и тестировать запросы и показ рекламы. Однако объявления не всегда доступны в каждом формате для вашего сайта, аккаунта или рекламного блока. Если тестовый тег работает правильно, а ваш – нет, причина может быть в следующем:
  • Вы показываете в своей среде видео в неподдерживаемом формате. Например, вы показываете только объявления HTML5 на устройствах iOS или Android.
  • Если вы используете Менеджер рекламы, возможно, в данный момент для вашего идентификатора издателя нет объявлений. Кроме того, убедитесь, что вы одобрили релевантные объявления и креативы в Менеджере рекламы.
  • Если вы используете AdSense, то для вашего сайта или тестовой страницы могут быть заданы критерии таргетинга, для которых нет активных объявлений. Чаще всего это происходит из-за использования частных сайтов, которые не сканируются поисковыми роботами.
  • Если вы используете управление партнерскими ресурсами Ad Exchange и параметр descriptionURL не задан или не включен в список управляемых доменов, принадлежащих вам или управляемых вами, объявления не будут показываться на этом домене.
  • Проверьте пороговые значения minCPM, заданные в Ad Exchange Видео. Довольно высокая цена за тысячу показов может привести к очень низкому уровню заполняемости. Чтобы исправить это, попробуйте удалить из запроса объявления минимальную цену за тысячу показов или параметр рекламного блока (например, slotname) и проверьте, повлияет ли это на заполняемость.
Как выглядит хороший descriptionUrl?
Чтобы страница, на которую указывает descriptionUrl, была максимально эффективной, ее контент должен представлять собой не набор слов или фраз, а 1–3 абзаца, описывающих контент и вашу роль в его предоставлении. Один из эффективных методов – динамически объединять контент страницы descriptionUrl из предварительно заданных блоков. Например, несколько предложений о контенте, несколько предложений о предложениях вашего сайта, а затем несколько предопределенных фрагментов, связанных с каждым каналом AdSense (например, «Развлечения» или «Спорт»). В результате каждый фрагмент контента имеет достаточно четкую descriptionUrl, связанную с ним, которая предоставляет как общую информацию (например, дескрипторы жанра), так и конкретную информацию (контент непосредственно о контенте).

HTML-код метаданных должен быть простым, например:

<html>
  <head>
    <title>Domain.com - Your tag line here!</title>
  </head>
  <body>
    <h1>Descriptions</h1>
    <h2>About this Content</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
    <h2>About Domain.com</h2>
      <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
  </body>
</html>
Почему я получаю сообщение об ошибке "Ответ на запрос объявления не содержит допустимый тип объявления"?
Обычно эта ошибка возникает, если на определенный publisherId не настроен таргетинг объявлений (в течение заданного периода времени). Это условие может меняться в течение дня или нескольких дней по мере начала и окончания кампаний. Убедитесь, что срок действия объявления, на которое вы хотите настроить таргетинг, не истек и что критерии таргетинга указаны правильно. Если объявления правильно запрашиваются, получаются и показываются с помощью тестового publisherId, то можно быть уверенным, что при показе объявлений с помощью рабочего publisherId они будут обрабатываться правильно.
Есть ли у вас тег видеообъявления Менеджера рекламы, который я могу использовать для тестирования?
Примеры тегов можно найти на странице Примеры тегов.
Нужно ли задавать для параметров adSlotWidth и adSlotHeight те же значения, что и для параметра sz в теге объявления Менеджера рекламы?
Необязательно. Значения параметров adSlotWidth и adSlotHeight должны соответствовать ширине и высоте проигрывателя или области, которую должны заполнять ваши объявления. AdSense использует эти данные, чтобы определить, какие объявления можно разместить в этом рекламном блоке. Пара "ключ-значение" sz в рекламном теге Менеджера рекламы является параметром таргетинга и не обязательно влияет на показываемый креатив (подробнее ниже).
Демоверсия тега объявления работает отлично, но когда я заменяю ее своим тегом, объявление не показывается.
Проверьте, чтобы в тег объявления, который вы запрашиваете, было добавлено что-либо. Проще всего это сделать, отслеживая HTTP-трафик. Если в блоке HTML-якоря возвращается пиксель отслеживания 1x1 pixel grey.gif, проверьте настройки таргетинга в Менеджере рекламы.
Я хочу запрашивать объявления, используя один и тот же тег несколько раз, но получаю объявления только по первому запросу. Что мне делать?
Если вы запрашиваете объявления несколько раз, вам нужно сообщить серверу объявлений, что это не случайные дубликаты, а легитимные запросы. SDK делает это за вас с помощью двух быстрых вызовов API:
  1. Вызовите destroy() в экземпляре AdsManager. Это предотвратит показ видеорекламы в конце ролика при вызове contentComplete(). Вы получите новый код AdsManager при следующем запросе.
  2. Позвоните на номер contentComplete() в экземпляре AdsLoader. Это позволяет сбросить настройки SDK, чтобы новый запрос объявления не выглядел как дубликат предыдущего.
После выполнения двух описанных выше вызовов можно вызвать requestAds() в экземпляре AdsLoader, чтобы получить ещё один набор объявлений для нового видео.
Как запрашивать объявления AdSense с наложением и объявления в полноразмерном рекламном месте с помощью IMA SDK?

Чтобы запрашивать объявления AdSense с помощью SDK, сначала нужно получить тег объявления AdSense. Подробнее об этом можно узнать на странице AdSense для видео. После того как вы получите тег, вам нужно выполнить следующие действия, чтобы создать запрос объявления с наложением или полноразмерного объявления:

Оверлеи
  1. В файле AdsRequest задайте для ViewModes значение NORMAL.
  2. Добавьте в тег объявления параметр overlay=1.
Объявления, занимающие все рекламное место
  1. В файле AdsRequest задайте для параметра ViewModes значение FULLSCREEN.
  2. Добавьте в рекламный тег параметр overlay=0.
При нажатии на объявление появляется сообщение об ошибке "Недействительный URL перехода по клику". В чем может быть причина?
Чаще всего эта ошибка возникает из-за неправильно экранированного URL перехода. Если вы видите эту ошибку, убедитесь, что в ответе VAST правильно экранирован URL перехода по клику.
Почему появляется ошибка "Пустой документ VAST"?
Эта ошибка возникает, когда тег объявления возвращает пустой документ VAST, указывая на то, что объявление не было показано должным образом. Чтобы узнать, почему тег объявления не работает, обратитесь к менеджеру аккаунта или представителю сервера объявлений.
Можно ли изменить размер или текст кнопки Пропустить рекламу или других элементов интерфейса?
В IMA SDK нельзя изменять макет, размер или контент элементов интерфейса. Подробнее об элементах интерфейса рассказывается в статье AdsManager.uiElements.
Поддерживаются ли элементы управления нативными видеообъявлениями в HTML5 SDK?
Нет, HTML5 SDK не поддерживает встроенные элементы управления.
В моей реализации HTML5 появляется сообщение "Failed to execute 'play' on 'HTMLMediaElement': API can only be initiated by a user gesture" (Не удалось выполнить команду play для элемента HTMLMediaElement: API может быть запущен только жестом пользователя). Что мне делать?
На мобильных устройствах вы должны вызывать adDisplayContainer.initialize() в результате действия пользователя (например, нажатия). Если вы видите эту ошибку, скорее всего, вы вызываете метод в контексте, не инициированном пользователем. Обратите внимание, что это должно быть прямым результатом действий пользователя. Например, если вы отвечаете на событие "нажатие" воспроизведением видео, а затем используете событие "воспроизведение" видеопроигрывателя для вызова initialize(), SDK возвращает эту ошибку. Вы должны вызывать initialize() в результате самого события нажатия.
Как управлять фокусом клавиатуры при кликах по объявлениям?
Если вы используете для управления проигрывателем клавиатуру, то после нажатия на значок adDisplayContainer заметите, что клавиши перестали работать. Это связано с тем, что после клика по объявлению фокус клавиатуры переключается на фрейм IMA. Чтобы фокус клавиатуры оставался на проигрывателе контента, используйте событие CLICK, чтобы вернуть фокус клавиатуры в нужный контейнер. Подробнее о том, как это сделать, рассказывается в следующем фрагменте кода: 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });