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

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

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

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

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

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

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

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

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

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

• Создайте учетную запись AdMob и настройте приложение .

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

• Используйте версию 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.
  }
});

Котлин

MobileAds.openAdInspector(context) { error ->
  // Error will be non-null if ad inspector closed due to an error.
}

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

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

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

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

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

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

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

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

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

Предварительные требования: Google Mobile Ads SDK. 20.2.0 или выше

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

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

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

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

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

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

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

  

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

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

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

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

Примечание. Экспортировать ответ на объявление можно только после того, как выдобавьте тестовое устройство в интерфейс AdMob .

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

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

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

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

Примечание. Более ранние реализации пользовательских событий до API. версия v20.0.0,API-интерфейсы этого подкласса не поддерживают инициализацию и отображаются как «Проблема обнаружена» в инспекторе объявлений. Если вы видите это предупреждение в инспекторе объявлений, хотя ваша интеграция настраиваемых событий работает, проверьте, не использует ли ваше приложение устаревшие интерфейсы, такие как CustomEventBanner и замените их новыми Adapter сорт.

Проверьте свои рекламные блоки

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

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

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

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

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

Примечание. Чтобы использовать функцию запроса тестового объявления , инициализируйте Google Mobile Ads SDK с контекстом Activity .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Копирование всех результатов отладки

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

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