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

Почему я не получаю объявления для всех форматов?
Тестовые теги объявлений настроены так, чтобы всегда возвращать объявления по действительным запросам. Это поможет вам интегрировать и тестировать запросы и показ рекламы. Однако объявления не всегда доступны в каждом формате для вашего сайта, аккаунта или рекламного блока. Если интеграция работает правильно для тестового тега, но не для вашего собственного, причина может быть в следующем:
  • Вы показываете в своей среде видео в неподдерживаемом формате. Например, вы показываете только объявления HTML5 на устройствах iOS или Android.
  • Если вы используете Менеджер рекламы, возможно, в данный момент для вашего идентификатора издателя нет объявлений. Также убедитесь, что вы одобрили нужные объявления и креативы в Менеджере рекламы.
  • Если вы используете AdSense, то для вашего сайта или тестовой страницы могут быть заданы критерии таргетинга, для которых нет активных объявлений. Чаще всего это происходит из-за использования частных сайтов, которые не сканируются поисковыми роботами.
  • Если вы используете управление партнерскими ресурсами Ad Exchange и параметр descriptionURL не задан или не включен в список управляемых доменов, принадлежащих вам или управляемых вами, объявления не будут показываться на этом домене.
  • Проверьте пороговые значения minCPM, заданные в Ad Exchange Video. Если цена за тысячу показов будет слишком высокой, заполняемость может оказаться очень низкой. Чтобы исправить это, попробуйте удалить из запроса объявления минимальную цену за тысячу показов или параметр рекламного блока (например, 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 перехода. Если вы видите эту ошибку, убедитесь, что URL перехода на сайт правильно экранирован в ответе VAST.
Можно ли сделать так, чтобы в SDK для Android и iOS все видеообъявление было кликабельным?
Что касается отслеживания кликов по всему видео, то стандартный пользовательский опыт для мобильных видео заключается в том, что при нажатии на видео оно либо приостанавливается, либо открываются элементы управления проигрывателем. Чтобы избежать случайных кликов по объявлениям, когда пользователи хотят получить доступ к элементам управления проигрывателя, в IMA используется кнопка Подробнее. Нажав на нее, пользователь может перейти на страницу с дополнительной информацией о рекламируемом товаре.
Почему появляется ошибка "Пустой документ VAST"?
Эта ошибка возникает, когда тег объявления возвращает пустой документ VAST, что указывает на неправильный показ объявления. Обратитесь к менеджеру аккаунта или представителю сервера объявлений, чтобы узнать, почему не работает тег объявления.
Можно ли изменить размер или текст кнопки Пропустить рекламу или других элементов интерфейса?
IMA SDK не поддерживают изменение макета, размера или контента элементов пользовательского интерфейса. Подробнее об элементах интерфейса… AdsManager.uiElements
Почему я не могу изменить громкость рекламы на устройстве iOS?
В iOS нельзя задать громкость программно. Если вы используете HTML5 SDK, adsManager.setVolume() не влияет на работу. По этой причине в iOS SDK нет функции установки громкости в IMAAdsManager.
Можно ли использовать несколько потоков для инициализации и управления интерфейсом?
Инициализация интерфейса должна выполняться в основном потоке. После инициализации вы можете реализовать фоновое воспроизведение объявлений.