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


Почему мне не возвращаются объявления для всех форматов?
Теги тестовых объявлений настроены так, чтобы всегда возвращать объявления по действительным запросам. Это предназначено для облегчения интеграции и упрощения проверки того, как ваш проигрыватель запрашивает и отображает рекламу. Однако объявления не всегда доступны во всех форматах для вашего сайта, учетной записи или рекламного блока. Если ваша интеграция работает правильно для тестового тега, но не для вашего собственного тега, причина может быть одной из следующих:
  • Вы показываете в своей среде видео неподдерживаемого формата. Например, вы показываете только объявления HTML5 для iOS или Android.
  • Если вы используете Менеджер рекламы, в настоящее время для вашего идентификатора издателя может не быть объявлений, ориентированных на него. Кроме того, убедитесь, что вы одобрили соответствующие объявления и креативы в Менеджере рекламы.
  • Если вы используете AdSense, критерии таргетинга для вашего сайта или тестовой страницы могут не содержать активной рекламы. Наиболее распространенной причиной является использование частных, непросканированных веб-сайтов.
  • Если вы используете управление партнерскими сетями Ad Exchange, а descriptionURL не задан или отсутствует в списке управления собственными или управляемыми доменами, объявления не показываются для этого.
  • Проверьте пороговые значения minCPM, заданные в Ad Exchange Video. Довольно высокая цена за тысячу показов может привести к очень низкой заполняемости. Чтобы исправить это, попробуйте либо удалить минимальную цену за тысячу показов, либо удалить параметр рекламного блока из запроса объявления (например, название рекламного места), чтобы проверить, влияет ли это на заполняемость.
Как выглядит хороший descriptionUrl ?
Чтобы быть наиболее эффективным, содержимое страницы, на которое указывает descriptionUrl , должно состоять не из набора слов или фраз, а из 1–3 абзацев, фактически описывающих содержимое и вашу роль в его предоставлении. Один из методов, который был успешным в прошлом, заключается в динамическом объединении содержимого страницы descriptionUrl из предопределенных блоков. Например, несколько предложений о содержании, несколько предложений о предложениях вашего сайта, а затем несколько предопределенных фрагментов, связанных с каждым каналом AdSense (например, "Развлечения" или "Спорт"). В результате каждый фрагмент контента имеет связанный с ним достаточно отчетливый URL-адрес 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 возвращается изображение grey.gif размером 1 x 1 пиксель , вам необходимо проверить настройки таргетинга в Менеджере рекламы.
Я хочу запросить рекламу с использованием одного и того же тега несколько раз, но получаю рекламу только при первом запросе. Как это исправить?
Когда вы запрашиваете рекламу более одного раза, вам нужно сообщить серверу объявлений, что это законные запросы, а не случайные дубликаты. 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.
Почему я вижу ошибку «VAST Document Empty»?
Эта ошибка возникает, когда тег объявления возвращает пустой документ VAST, указывающий на то, что объявление не было показано должным образом. Поговорите со своим менеджером по работе с клиентами или представителем рекламного сервера, чтобы узнать, почему ваш рекламный тег не работает.
Могу ли я изменить размер/текст поля « Пропустить рекламу » или других элементов пользовательского интерфейса?
IMA SDK не поддерживают изменение макета, размера или содержимого элементов пользовательского интерфейса. Дополнительные сведения об элементах пользовательского интерфейса см. в разделе AdsManager.uiElements .
Поддерживаются ли встроенные элементы управления видео в SDK HTML5?
Нет, HTML5 SDK не поддерживает собственные элементы управления.
Я вижу «Не удалось выполнить« воспроизведение »на« HTMLMediaElement »: API может быть инициирован только жестом пользователя» в моей реализации HTML5. Как это исправить?
На мобильных устройствах вы должны вызвать adDisplayContainer.initialize() в результате действия пользователя (например, касания). Если вы видите эту ошибку, вы, скорее всего, вызываете ее в контексте, не инициированном пользователем. Обратите внимание, что это должно быть прямым результатом действия пользователя. Например, если вы отвечаете на событие "tap" воспроизведением видео, а затем используете событие "play" видеопроигрывателя для вызова initialize() , SDK возвращает эту ошибку. Вы должны вызвать initialize() как результат самого события касания.
Как обрабатывать фокус клавиатуры при кликах по объявлениям?
Если вы используете элементы управления с клавиатуры для своего проигрывателя, вы можете заметить, что они больше не будут работать после нажатия на adDisplayContainer . Это связано с тем, что после нажатия на объявление фокус клавиатуры переключается на iframe IMA. Чтобы сохранить фокус клавиатуры на проигрывателе содержимого, используйте событие CLICK , чтобы вернуть фокус клавиатуры на нужный контейнер. Дополнительные сведения см. в следующем фрагменте кода:
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });
  
.