С помощью инспектора объявлений вы можете:
- Проверьте свои рекламные блоки
- Проверьте, заполняются ли ваши объявления должным образом.
- Выявление ошибок и просмотр подробностей о том, как их устранить.
- Просмотр сведений о каждой рекламной сети Open Bidding по запросу.
- Просмотр сведений о медиации для каждой рекламной сети по запросу.
- Тестирование отдельных сторонних источников объявлений Open Bidding или каскадной медиации.
- Убедитесь, что вы правильно настроили каждый рекламный блок для Open Bidding и каскадной медиации.
В этом руководстве показано, как запускать и использовать различные функции инспектора объявлений.
Предварительные условия
Чтобы использовать Инспектор объявлений, вам необходимо:
- Заполните руководство по началу работы .
- Используйте версию Google Mobile Ads SDK 20.2.0 или выше.
- Включите тестовый режим или свяжите свое устройство с Менеджером рекламы . Инспектор объявлений запускается только на тестовых или связанных устройствах.
Запустить инспектор объявлений
Инспектор объявлений можно запустить из любого места вашего приложения следующими способами:
- Используйте кнопку запуска из меню отладки.
- Используйте жест, который вы выбрали в настройках инспектора объявлений.
- Программно с использованием предоставленного API .
Запуск через меню отладки
Для запуска инспектора объявлений через меню отладки в вашем приложении не требуется никаких изменений; просто найдите объявление, показываемое в вашей сети Менеджера рекламы, коснитесь его и удерживайте двумя пальцами, чтобы открыть меню отладки. Затем выберите «Открыть инспектор объявлений» .
Если вы не связали свое устройство , вам может быть предложено войти в свой аккаунт Менеджера рекламы.
Вы также можете выбрать настройки инспектора объявлений в настройках отладки и выбрать жест, который позволит открыть инспектор объявлений в будущем без необходимости проходить через меню отладки.
Запустить программно
Инспектор объявлений также можно запустить программно:
Ява
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 работает для тестовых устройств , зарегистрированныхпрограммно.
Просмотр и устранение неполадок рекламных блоков
После запуска появляется главный экран инспектора объявлений, содержащий список всех рекламных блоков. устройство отправляло запросы объявлений с тех пор, как во время этого сеанса приложения был включен инспектор объявлений. В списке также содержатся рекламные блоки с включенным Open Bidding, упорядоченные в хронологическом порядке: сначала самые недавно выполненные запросы, а также блоки без завершенных запросов объявлений (затенены):
Мы рекомендуем инициализировать Google Mobile Ads SDK перед использованием инспектора объявлений.
Просмотр сведений о каскаде медиации для рекламного блока
Коснитесь рекламного блока, чтобы просмотреть журнал запросов SDK, в котором представлены сведения о каскаде медиации до момента, когда объявление было заполнено (или каскад завершился без заполнения) для последних запросов объявлений.
Каждый запрос можно расширить с помощью индикатора раскрытия, чтобы отобразить результаты каскада медиации для этого запроса, а также любые ошибки и задержки, применимые для этого запроса.
Для сторонних источников объявлений сообщения об ошибках отправляются непосредственно из источника объявлений. Если вам нужна дополнительная информация, обратитесь к стороннему источнику объявлений.
Просмотр сведений о ставках для рекламного блока
Если вы новичок в Open Bidding, прочитайте введение в Open Bidding .
В журнале запросов SDK вы можете увидеть Open Bidding источники объявлений, которые вызываются в запросе объявления. Коснитесь рекламного блока в журнале запросов SDK, чтобы просмотреть подробную информацию о каждом источнике объявлений в журнале запросов SDK. Open Bidding аукцион.
Open Bidding результаты сортируются таким образом, чтобы элементы, требующие действий, оказались ближе к началу списка:
Вверху — рекламная сеть, выигравшая аукцион.
Далее идут рекламные сети с проблемами. Вы можете следить задействия по устранению неполадок в конце Open Bidding Часто задаваемые вопросы.
Кроме того, есть рекламные сети, которым не была возвращена реклама или которые не предлагали ставки. Это возможный индикатор множества различных проблем с источником объявлений, поскольку ему может не быть назначена ставка из-за его настройки или решения. Вы можете обратиться к руководству по настройке источника объявлений илиЧасто задаваемые вопросы по Open Bidding, чтобы получить дополнительную поддержку.
Наконец, в конце списка находятся рекламные сети, потерявшие популярность.Open Bidding аукцион.
Водопад медиации может разместить источник объявлений, выигравшийOpen Bidding аукцион в соответствии со значением эффективной цены за тысячу показов.
Водопад медиации – это результат конкуренции нескольких групп доходности за один и тот же инвентарь. В одну группу доходности можно добавить до десяти сторонних партнеров по доходности, включая партнеров по доходности Open Bidding и медиацию для партнеров по доходности мобильных приложений.
Расширенная отладка рекламных блоков
При устранении неполадок с рекламными блоками может быть полезно изучить запрос объявления и ответ, чтобы определить, где что-то не так, или поделиться со службой поддержки Google, чтобы помочь в отладке. Коснитесь значка меню в верхней части каскадной цепочки и выберите « Поделиться запросом и ответом на объявление», чтобы экспортировать полный запрос и ответ на объявление. Это избавит вас от необходимости запускать сетевую трассировку в вашем собственном приложении.
Кроме того, вы можете просмотреть декодированные сторонние параметры ставок, нажав параметр «Сторонние параметры ставок» в том же меню, что и строка запроса. Это дает подробную информацию о том, с какими сторонними параметрами назначения ставок могут возникнуть проблемы, что помогает вам отладить приложение или проверить, успешно ли сеть собирает его сигналы.
Посмотреть доступные адаптеры
Перейдите на вкладку «Адаптеры» , чтобы просмотреть список всех сторонних адаптеров, связанных с источниками объявлений в конфигурациях ставок или посредничества в вашем приложении. Затем разверните карточки, чтобы просмотреть их статусы инициализации и версии SDK. Наряду с поддерживаемыми адаптерами сторонних производителей вы также можете просматривать пользовательские адаптеры событий. Пользовательские события позволяют издателям использовать рекламные сети, которые Ad Managerне поддерживает. Пользовательские события отличаются от стандартных адаптеров сторонних производителей в списке адаптеров по уникальным именам классов. Помимо предоставления названия класса и информации о статусе, инспектор объявлений также отображает метки, назначенные этим пользовательским событиям, вAd Manager веб-интерфейс.
Если адаптер не найден или не удается инициализировать, см.Проверка показа рекламы в мобильных приложенияхдля получения дополнительной информации.
Проверьте свои рекламные блоки
Если вы хотите протестировать свой рекламный блок, не переходя к нему в пользовательском интерфейсе приложения, инспектор объявлений поддерживает это непосредственно на экране сведений о рекламном блоке. Кроме того, вы можете тестировать несколько рекламных блоков одновременно, асинхронно загружать и просматривать тестовые запросы объявлений и даже выполнять тестирование одного источника объявлений.
Тестирование рекламы
Тесты объявлений в Инспекторе объявлений, описанные в этом разделе, — отличный инструмент для проверки базового качества рекламы и проверки конфигурации медиации при использовании с тестированием одного источника объявлений.
Когда вы будете готовы протестировать свой рекламный блок, нажмите кнопку «Запросить тестовое объявление» в верхней части экрана инспектора объявлений, чтобы запустить тестирование объявлений в инспекторе объявлений. Результаты тестирования затем появляются в журнале запросов SDK под заголовком Запрошено от инспектора объявлений .
Тестирование одного источника объявлений
В Инспекторе объявлений есть функция, позволяющая ограничить запросы объявлений в вашем приложении, чтобы они показывали объявления только от одного Open Bidding или источник объявлений каскадной медиации. Это позволит вам убедиться, что вы правильно внедрили сторонний адаптер и что источник объявлений работает должным образом.
Чтобы включить эту функцию, переключите переключатель «Тестирование одного источника объявлений» в нижней части экрана. Откроется следующее диалоговое окно выбора источника объявлений:
Прежде чем использовать тестирование одного источника объявлений, необходимо инициализировать Google Mobile Ads SDK .
Затем вы можете выбрать один источник объявлений для тестирования. После выбора источника рекламы появляется следующий экран:
Настройка тестирования одного источника объявлений применяется ко всем будущим запросам объявлений, которые вы сделаете в рамках того же сеанса. Однако это не относится к ранее кэшированным объявлениям в этом сеансе, которые еще не были показаны. При применении проверки одного источника объявлений рекомендуется принудительно перезапустить приложение, чтобы сделать недействительными любые кэшированные объявления, которые могут отображаться вместо получения запроса от выбранного вами источника объявлений.
После перезапуска приложения все места размещения рекламных блоков пытаются показывать рекламу только из выбранной сети. При запуске инспектора объявлений, когда активен тест одного источника объявлений, отображается активный тестовый источник объявлений:
В тестовом режиме с одним источником объявлений все запросы объявлений пытаются заполниться выбранным источником объявлений, независимо от того, настроен ли этот источник объявлений для назначения ставок или посредничества для запрошенного рекламного блока. Если тестируемый источник объявлений не входит в каскад медиации для рекламного блока, вы получите сообщение об ошибке «Нет заполнения».
При тестировании одного источника объявлений вы можете нажать на рекламный блок, чтобы просмотреть журнал запросов к его SDK. Это позволяет узнать, выполнил ли источник объявлений запросы объявлений, сделанные после включения тестирования одного источника объявлений. Если источнику объявления не удалось загрузить объявление, появится сообщение об ошибке с описанием ошибки.
Если вы добавили несколько экземпляров выбранного источника объявлений в каскад медиации, вы увидите каждый экземпляр вызова источника объявлений в каскаде до тех пор, пока объявление не заполнится или каскад не закончится без заполнения.
Остановить тестирование одного источника объявлений
Чтобы остановить тест, выключите переключатель:
Затем на следующем экране перезагрузки появится подтверждающее сообщение:
Мы рекомендуем принудительно перезапустить приложение после остановки теста, чтобы сделать недействительными все кэшированные объявления для проверенного источника объявлений.
Копирование всех результатов отладки
Инспектор объявлений поддерживает копирование строки JSON, содержащей все результаты отладки инструмента, включая сведения о вашихAd Manager app, статусы инициализации адаптера и результаты тестирования всех рекламных блоков.
Для этого коснитесь значка приложения семь раз, пока не увидите сообщение JSON инспектора объявлений скопировано в буфер обмена .