Инспектор объявлений


Инспектор рекламы — это встроенное в приложение окно, позволяющее авторизованным устройствам в режиме реального времени анализировать тестовые запросы рекламы непосредственно в мобильном приложении. Он входит в состав Google Mobile Ads SDK версии 9.1.0 и выше и может быть активирован без необходимости написания кода.

В этом руководстве показано, как запускать и использовать различные функции инспектора рекламы.

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

Для использования инспектора рекламы вам необходимо:

  • Используйте Google Mobile Ads SDK версии 9.1.0 или выше.

Запустить инспектор рекламы

Инспектор рекламы может быть запущен из любого места в вашем приложении следующими способами:

  1. Используйте жест, выбранный в пользовательском интерфейсе AdMob при регистрации тестового устройства .
  2. Программно, используя предоставленный API .
  3. Воспользуйтесь кнопкой запуска из меню отладки.

Запуск с помощью жестов

Для запуска инспектора рекламы с помощью жеста в вашем приложении не требуется никаких изменений; просто выполните жест (двойное движение пальцем или встряхивание), который вы настроили в AdMob для данного тестового устройства. Подробнее

После установки жеста в пользовательском интерфейсе AdMob (и ожидания 15 минут для его распространения) вашему приложению необходимо отправить запрос на показ рекламы в SDK Google Mobile Ads, чтобы получить информацию о ваших настройках жеста. Если указанный вами жест не работает, попробуйте загрузить рекламу, перезапустить приложение и протестировать жест снова.

Запуск программным способом

Инспектор рекламы также может быть запущен программно:

Этот API работает для тестовых устройств, зарегистрированных программно или в пользовательском интерфейсе AdMob.

Просмотр и устранение неполадок рекламных блоков.

После запуска появляется главный экран инспектора рекламы, содержащий список всех рекламных блоков в пользовательском интерфейсе AdMob, связанных с вашим идентификатором приложения AdMob, для которых настроены ставки или медиация:

Мы рекомендуем инициализировать SDK Google Mobile Ads перед использованием инспектора объявлений.

Просмотрите подробную информацию о порядке обработки запросов на медиацию для рекламного блока.

Нажмите на рекламный блок, чтобы просмотреть журнал запросов SDK, в котором содержится подробная информация о последовательности обработки запросов до момента, когда объявление было заполнено (или последовательность завершилась без заполнения) для последних запросов на рекламу.

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

В случае сторонних источников рекламы сообщения об ошибках отправляются непосредственно из источника рекламы. Если вам нужна дополнительная информация, обратитесь к своему стороннему источнику рекламы.

Просмотреть подробности торгов для рекламного блока

Если вы новичок в участии в тендерах, ознакомьтесь с обзором .

В журнале запросов SDK можно увидеть источники рекламы, участвующие в аукционе. Коснитесь рекламного блока в журнале запросов SDK, чтобы просмотреть подробную информацию о каждом источнике рекламы в аукционе.

Результаты торгов отсортированы таким образом, чтобы наиболее актуальные позиции находились ближе к началу списка:

  • Вверху находится рекламная сеть, выигравшая аукцион.

  • Далее перечислены рекламные сети, в которых возникли проблемы. Вы можете следовать инструкциям по устранению неполадок .

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

  • Наконец, в самом низу списка находятся рекламные сети, проигравшие аукцион.

В рамках каскадной модели медиации источник рекламы, выигравший аукцион, может быть размещен в соответствии с его значением eCPM.

Когда в каскадной схеме медиации вызывается источник рекламы, он может показывать объявления. Чтобы узнать больше о том, как работает назначение ставок в каскадной схеме медиации, см. пример 2 и пример 3 , демонстрирующие назначение ставок и источники рекламы в каскадной схеме медиации в группе медиации.

Расширенная отладка рекламных блоков

При устранении неполадок в рекламных блоках может быть полезно изучить запрос и ответ на объявление, чтобы определить, где именно возникает ошибка, или поделиться ими со службой поддержки Google для помощи в отладке. Нажмите на значок меню в верхней части цепочки «водопад» и выберите «Поделиться запросом и ответом на объявление» , чтобы экспортировать полный запрос и ответ на объявление. Это избавит вас от необходимости запускать трассировку сети в собственном приложении.

Кроме того, вы можете просмотреть декодированные параметры сторонних торгов, нажав на опцию « Параметры сторонних торгов» в том же меню, что и строка запроса. Это позволит получить подробную информацию о том, какие параметры сторонних торгов могут вызывать проблемы, что поможет вам отладить приложение или убедиться в успешном сборе сигналов сетью.

Посмотреть доступные адаптеры

Перейдите на вкладку «Адаптеры» , чтобы просмотреть список всех сторонних адаптеров, связанных с источниками рекламы в конфигурациях назначения ставок или медиации в вашем приложении. Затем разверните карточки, чтобы просмотреть их статусы инициализации и версии SDK. Помимо поддерживаемых сторонних адаптеров, вы также можете просмотреть адаптеры пользовательских событий.

Пользовательские события позволяют издателям использовать рекламные сети, которые не поддерживаются AdMob. Пользовательские события отличаются от стандартных сторонних адаптеров в списке адаптеров своими уникальными именами классов. Помимо предоставления информации об имени класса и статусе, инспектор рекламы также отображает метки, присвоенные этим пользовательским событиям, в веб-интерфейсе AdMob.

В случае, если адаптер не обнаружен или не инициализируется, см. раздел «Устранение неполадок, обнаруженных с помощью инспектора рекламы» для получения дополнительной информации.

Протестируйте свои рекламные блоки.

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

Тестирование рекламы

Описанные в этом разделе тесты рекламных объявлений в инспекторе объявлений — отличный инструмент для проверки базового рекламного процесса и подтверждения правильности конфигурации медиации при использовании тестирования с одним источником объявлений.

Когда вы будете готовы протестировать свой рекламный блок, нажмите кнопку «Запросить тестовый рекламный блок» в верхней части экрана инспектора рекламы, чтобы запустить тестирование. Результаты теста затем появятся в журнале запросов SDK под заголовком «Запрошено из инспектора рекламы» .

Узнайте, как использовать инспектор рекламы в вашем приложении.

Тестирование одного источника рекламы

В Ad Inspector есть функция, позволяющая ограничить запросы рекламы в вашем приложении показом только рекламы из одного источника, использующего систему торгов или каскадной медиации. Это позволяет убедиться в правильности реализации стороннего адаптера и в том, что источник рекламы работает должным образом.

Чтобы включить эту функцию, переключите тумблер « Тестирование одного источника рекламы» в нижней части экрана. После этого отобразится диалоговое окно выбора источника рекламы:

Для тестирования рекламы из одного источника необходимо инициализировать SDK Google Mobile Ads .

Затем вы можете выбрать один источник рекламы для тестирования. После выбора источника рекламы появится следующий экран:

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

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

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

В режиме тестирования с одним источником рекламы вы можете нажать на рекламный блок, чтобы просмотреть журнал запросов SDK. Это позволит вам узнать, выполнил ли источник рекламы запросы к рекламным блокам, сделанные после включения тестирования с одним источником рекламы. Если источнику рекламы не удалось загрузить рекламу, появится сообщение об ошибке с описанием причины.

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

Остановить тестирование одного источника рекламы

Чтобы остановить тест, выключите переключатель:

Затем на экране перезагрузки появляется подтверждающее сообщение:

Мы рекомендуем принудительно перезапустить приложение после остановки теста, чтобы аннулировать кэшированные рекламные объявления для тестируемого источника рекламы.

Отладка настроек конфиденциальности

Необходимые условия: Google Mobile Ads SDK версии 9.6.0 или выше.

С помощью инспектора рекламы вы можете просмотреть следующие сигналы конфиденциальности, передаваемые в запросе на показ рекламы в рамках интеграции издателя с IAB Europe TCF :

  • Применяется GDPR ( IABTCF_gdprApplies )
  • Строка AC ( IABTCF_AddtlConsent )
  • Строка TC ( IABTCF_TCString )

После загрузки рекламы или тестирования рекламы в инспекторе рекламы коснитесь значка меню запроса в разделе «Журнал запросов SDK» . Затем выберите параметр « Сигналы конфиденциальности» .

На экране «Сигналы конфиденциальности» отображаются сигналы конфиденциальности, переданные в запросе на показ рекламы.

Чтобы узнать больше о строке AC, см. техническую спецификацию Google «Дополнительное согласие» . Чтобы просмотреть подробные сведения о согласии в строке TC, такие как идентификатор CMP и список идентификаторов поставщиков, давших согласие и связанных с IAB, нажмите «Декодировать» , чтобы открыть кодировщик/декодировщик IAB GPP .

Если вы столкнетесь с какими-либо ошибками, выполните действия, описанные в разделе «Понимание вопросов конфиденциальности» , для устранения неполадок.

Скопировать весь вывод отладки

Инспектор рекламы поддерживает копирование JSON-строки, содержащей полные отладочные данные инструмента, включая подробную информацию о вашем приложении AdMob, статусы инициализации адаптера и результаты тестирования всех рекламных блоков.

Для этого нажмите на значок приложения семь раз, пока не появится сообщение «Скопировано JSON-файл инспектора рекламы в буфер обмена» .