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

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

Используя инспектор рекламы в версиях Mobile Ads SDK ниже20.2.0, вы можете:

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

Для Mobile Ads SDK версии 20.2.0 и выше вы также можете:

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

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

Предпосылки

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

  • Заполните руководство по началу работы .

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

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

Инспектор объявлений можно запустить из любого места вашего приложения. Существует три разных способа запуска инспектора объявлений.

  1. Используйте жест, выбранный в пользовательском интерфейсе AdMob, при регистрации тестового устройства .

  2. Программно с использованием предоставленного API .

  3. Используйте кнопку запуска из меню отладки.

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

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

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

Запустить программно

Инспектор объявлений также можно запустить программно:

MobileAds.openAdInspector(context, new OnAdInspectorClosedListener() {
  public void onAdInspectorClosed(@Nullable AdInspectorError error) {
    // Error will be non-null if ad inspector closed due to an error.
  }
});

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

Просмотр результатов последних запросов объявлений по рекламным блокам

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

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

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

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

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

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

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

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

Требования: Google Mobile Ads SDK 20.2.0 или выше.

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

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

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

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

  • Далее идут рекламные сети с проблемами. Вы можете выполнить шаги по устранению неполадок.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Остановить тестирование одного источника объявлений

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

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

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