Для Mobile Ads Flutter 1.3.0 и выше вы можете:
- Проверьте свои рекламные блоки
- Проверьте адаптеры сторонних производителей
- Проверьте, заполняются ли ваши объявления должным образом.
- Выявление ошибок и просмотр подробностей о том, как их устранить.
- Просматривайте сведения о назначении ставок и каскадной медиации вместе для каждой рекламной сети по каждому запросу.
- Тестируйте отдельные сторонние источники объявлений для назначения ставок и медиации.
Убедитесь, что вы правильно настроили каждый рекламный блок для назначения ставок и каскадной медиации.
Тестирование интеграции пользовательских событий
В этом руководстве показано, как запускать и использовать различные функции инспектора объявлений.
Предварительные условия
Чтобы использовать Инспектор объявлений, вам необходимо:
- Заполните руководство по началу работы .
- Используйте плагин Mobile Ads Flutter версии 1.3.0 или выше.
- Добавьте свое устройство в качестве тестового . Инспектор рекламы запускается только на тестовых устройствах.
Запустить инспектор объявлений
Инспектор объявлений можно запустить из любого места вашего приложения следующими способами:
- Используйте жест, выбранный в интерфейсе AdMob, при регистрации тестового устройства .
- Программно с использованием предоставленного API .
- Используйте кнопку запуска из меню отладки.
Запуск с помощью жестов
Чтобы запустить инспектор объявлений жестом, в вашем приложении не требуется никаких изменений; просто выполните жест (двойное пролистывание или встряхивание), который вы настроили в AdMob для этого тестового устройства. Узнать больше
После настройки жеста в пользовательском интерфейсе AdMob (и ожидания его распространения в течение 15 минут) вашему приложению необходимо отправить запрос объявления в Google Mobile Ads SDK, чтобы узнать о настройках жеста. Если указанный вами жест не работает, попробуйте загрузить рекламу, перезапустить приложение и снова протестировать жест.
Запустить программно
Инспектор объявлений также можно запустить программно:
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
Этот API работает для тестовых устройств, зарегистрированных программно или в пользовательском интерфейсе AdMob.
Просмотр и устранение неполадок рекламных блоков
После запуска появится главный экран инспектора объявлений, содержащий список всех рекламных блоков в пользовательском интерфейсе AdMob, связанных с вашим идентификатором приложения AdMob, которые имеют конфигурации ставок или медиации:
Мы рекомендуем инициализировать Google Mobile Ads SDK перед использованием инспектора объявлений.
Просмотр сведений о каскаде медиации для рекламного блока
Коснитесь рекламного блока, чтобы просмотреть журнал запросов SDK, в котором представлены сведения о каскаде медиации до момента, когда объявление было заполнено (или каскад завершился без заполнения) для последних запросов объявлений.
Каждый запрос можно расширить с помощью индикатора раскрытия, чтобы отобразить результаты каскада медиации для этого запроса, а также любые ошибки и задержки, применимые для этого запроса.
Для сторонних источников объявлений сообщения об ошибках отправляются непосредственно из источника объявлений. Если вам нужна дополнительная информация, обратитесь к стороннему источнику объявлений.
Просмотр сведений о ставках для рекламного блока
Если вы новичок в торгах, прочитайте обзор .
В журнале запросов SDK вы можете увидеть источники объявлений для назначения ставок, которые вызываются в запросе объявления. Коснитесь рекламного блока в журнале запросов SDK, чтобы просмотреть подробную информацию о каждом источнике объявлений на аукционе ставок.
Результаты ставок сортируются таким образом, чтобы элементы, требующие действий, оказались ближе к началу списка:
Вверху — рекламная сеть, выигравшая аукцион.
Далее идут рекламные сети с проблемами. Вы можете выполнить действия по устранению неполадок .
Кроме того, есть рекламные сети, которым не была возвращена реклама или которые не предлагали ставки. Это возможный индикатор множества различных проблем с источником объявлений, поскольку ему может не быть назначена ставка из-за его настройки или решения. Вы можете обратиться к руководству по настройке источника объявлений или напрямую обратиться за поддержкой к источнику объявлений .
Наконец, в конце списка располагаются рекламные сети, проигравшие аукцион.
Каскад медиации может разместить источник объявлений, выигравший аукцион, в соответствии с его значением эффективной цены за тысячу показов.
Когда источник объявлений вызывается в каскаде медиации, он может показывать рекламу. Чтобы узнать больше о том, как назначение ставок работает с каскадом медиации, см. пример 2 и пример 3 с источниками объявлений о назначении ставок и каскаде в группе медиации.
Расширенная отладка рекламных блоков
При устранении неполадок с рекламными блоками может быть полезно изучить запрос объявления и ответ, чтобы определить, где что-то не так, или поделиться со службой поддержки Google, чтобы помочь в отладке. Коснитесь значка меню в верхней части каскадной цепочки и выберите «Поделиться запросом и ответом на объявление», чтобы экспортировать полный запрос и ответ на объявление. Это избавит вас от необходимости запускать сетевую трассировку в вашем собственном приложении.
Кроме того, вы можете просмотреть декодированные параметры сторонних ставок, нажав параметр «Сторонние параметры ставок» в том же меню, что и строка запроса. Это дает подробную информацию о том, с какими сторонними параметрами назначения ставок могут возникнуть проблемы, что помогает вам отладить приложение или проверить, успешно ли сеть собирает его сигналы.
 |  |
Посмотреть доступные адаптеры
Перейдите на вкладку «Адаптеры» , чтобы просмотреть список всех сторонних адаптеров, связанных с источниками объявлений в конфигурациях ставок или посредничества в вашем приложении. Затем разверните карточки, чтобы просмотреть их статусы инициализации и версии SDK. Наряду с поддерживаемыми адаптерами сторонних производителей вы также можете просматривать пользовательские адаптеры событий. Специальные события позволяют издателям использовать рекламные сети, которые AdMob не поддерживает. Пользовательские события отличаются от стандартных адаптеров сторонних производителей в списке адаптеров по уникальным именам классов. Помимо предоставления названия класса и информации о статусе, инспектор объявлений также отображает метки, назначенные этим пользовательским событиям, в веб-интерфейсе AdMob.
Если адаптер не найден или его не удается инициализировать, дополнительную информацию см. в разделе « Устранение неполадок, обнаруженных с помощью инспектора объявлений» .
 |  |
Проверьте свои рекламные блоки
Если вы хотите протестировать свой рекламный блок, не переходя к нему в пользовательском интерфейсе приложения, инспектор объявлений поддерживает это непосредственно на экране сведений о рекламном блоке. Кроме того, вы можете тестировать несколько рекламных блоков одновременно, асинхронно загружать и просматривать тестовые запросы объявлений и даже выполнять тестирование одного источника объявлений.
Тестирование рекламы
Тесты объявлений в Инспекторе объявлений, описанные в этом разделе, — отличный инструмент для проверки базового качества рекламы и проверки конфигурации медиации при использовании с тестированием одного источника объявлений.
Когда вы будете готовы протестировать свой рекламный блок, нажмите кнопку «Запросить тестовое объявление» в верхней части экрана инспектора объявлений, чтобы запустить тестирование объявлений в инспекторе объявлений. Результаты тестирования затем появляются в журнале запросов SDK под заголовком Запрошено от инспектора объявлений .
Тестирование одного источника объявлений
В Инспекторе объявлений есть функция, позволяющая ограничить запросы объявлений в вашем приложении, чтобы они показывали объявления только из одного источника объявлений с посредничеством с одним назначением ставок или каскадом. Это позволит вам убедиться, что вы правильно внедрили сторонний адаптер и что источник объявлений работает должным образом.
Чтобы включить эту функцию, переключите переключатель «Тестирование одного источника объявлений» в нижней части экрана. Откроется следующее диалоговое окно выбора источника объявлений:
 |  |
Прежде чем использовать тестирование одного источника объявлений, необходимо инициализировать Google Mobile Ads SDK .
Затем вы можете выбрать один источник объявлений для тестирования. После выбора источника рекламы появляется следующий экран:
Настройка тестирования одного источника объявлений применяется ко всем будущим запросам объявлений, которые вы сделаете в рамках того же сеанса. Однако это не относится к ранее кэшированным объявлениям в этом сеансе, которые еще не были показаны. При применении проверки одного источника объявлений рекомендуется принудительно перезапустить приложение, чтобы сделать недействительными все кэшированные объявления, которые могут быть показаны вместо получения запроса от выбранного вами источника объявлений.
После перезапуска приложения все места размещения рекламных блоков пытаются показывать рекламу только из выбранной сети. При запуске инспектора объявлений, когда активен тест одного источника объявлений, отображается активный тестовый источник объявлений:
В тестовом режиме с одним источником объявлений все запросы объявлений пытаются заполниться выбранным источником объявлений, независимо от того, настроен ли этот источник объявлений для назначения ставок или посредничества для запрошенного рекламного блока. Если тестируемый источник объявлений не входит в каскад медиации для рекламного блока, вы получите сообщение об ошибке «Нет заполнения».
При тестировании одного источника объявлений вы можете нажать на рекламный блок, чтобы просмотреть журнал запросов к его SDK. Это позволяет узнать, выполнил ли источник объявлений запросы объявлений, сделанные после включения тестирования одного источника объявлений. Если источнику объявления не удалось загрузить объявление, появится сообщение об ошибке с описанием ошибки.
Если вы добавили несколько экземпляров выбранного источника объявлений в каскад медиации, вы увидите каждый экземпляр вызова источника объявлений в каскаде до тех пор, пока объявление не заполнится или каскад не закончится без заполнения.
Остановить тестирование одного источника объявлений
Чтобы остановить тест, выключите переключатель:
Затем на следующем экране перезагрузки появится подтверждающее сообщение:
Мы рекомендуем принудительно перезапустить приложение после остановки теста, чтобы сделать недействительными все кэшированные объявления для проверенного источника объявлений.
Копирование всех результатов отладки
Инспектор объявлений поддерживает копирование строки JSON, содержащей полные результаты отладки инструмента, включая сведения о вашем приложении AdMob, статусы инициализации адаптера и результаты тестирования всех рекламных блоков.
Для этого коснитесь значка приложения семь раз, пока не увидите сообщение JSON инспектора объявлений скопировано в буфер обмена .
,Инспектор рекламы – это оверлей внутри приложения, который позволяет авторизованным устройствам выполнять анализ тестовых запросов объявлений в режиме реального времени непосредственно в мобильном приложении. Его можно включить без необходимости кодирования.Для Mobile Ads Flutter 1.3.0 и выше вы можете:
- Проверьте свои рекламные блоки
- Проверьте адаптеры сторонних производителей
- Проверьте, заполняются ли ваши объявления должным образом.
- Выявление ошибок и просмотр подробностей о том, как их устранить.
- Просматривайте сведения о назначении ставок и каскадной медиации вместе для каждой рекламной сети по каждому запросу.
- Тестируйте отдельные сторонние источники объявлений для назначения ставок и медиации.
Убедитесь, что вы правильно настроили каждый рекламный блок для назначения ставок и каскадной медиации.
Тестирование интеграции пользовательских событий
В этом руководстве показано, как запускать и использовать различные функции инспектора объявлений.
Предварительные условия
Чтобы использовать Инспектор объявлений, вам необходимо:
- Заполните руководство по началу работы .
- Используйте плагин Mobile Ads Flutter версии 1.3.0 или выше.
- Добавьте свое устройство в качестве тестового . Инспектор рекламы запускается только на тестовых устройствах.
Запустить инспектор объявлений
Инспектор объявлений можно запустить из любого места вашего приложения следующими способами:
- Используйте жест, выбранный в интерфейсе AdMob, при регистрации тестового устройства .
- Программно с использованием предоставленного API .
- Используйте кнопку запуска из меню отладки.
Запуск с помощью жестов
Чтобы запустить инспектор объявлений жестом, в вашем приложении не требуется никаких изменений; просто выполните жест (двойное пролистывание или встряхивание), который вы настроили в AdMob для этого тестового устройства. Узнать больше
После настройки жеста в пользовательском интерфейсе AdMob (и ожидания его распространения в течение 15 минут) вашему приложению необходимо отправить запрос объявления в Google Mobile Ads SDK, чтобы узнать о настройках жеста. Если указанный вами жест не работает, попробуйте загрузить рекламу, перезапустить приложение и снова протестировать жест.
Запустить программно
Инспектор объявлений также можно запустить программно:
MobileAds.instance.openAdInspector(
(AdInspectorError? error) {
// Error will be non-null if ad inspector closed due to an error.
});
Этот API работает для тестовых устройств, зарегистрированных программно или в пользовательском интерфейсе AdMob.
Просмотр и устранение неполадок рекламных блоков
После запуска появляется главный экран инспектора объявлений, содержащий список всех рекламных блоков в пользовательском интерфейсе AdMob, связанных с вашим идентификатором приложения AdMob, которые имеют конфигурации ставок или посредничества:
Мы рекомендуем инициализировать Google Mobile Ads SDK перед использованием инспектора объявлений.
Просмотр сведений о каскаде медиации для рекламного блока
Коснитесь рекламного блока, чтобы просмотреть журнал запросов SDK, в котором представлены сведения о каскаде медиации до момента, когда объявление было заполнено (или каскад завершился без заполнения) для последних запросов объявлений.
Каждый запрос можно расширить с помощью индикатора раскрытия, чтобы отобразить результаты каскада медиации для этого запроса, а также любые ошибки и задержки, применимые для этого запроса.
Для сторонних источников объявлений сообщения об ошибках отправляются непосредственно из источника объявлений. Если вам нужна дополнительная информация, обратитесь к стороннему источнику объявлений.
Просмотр сведений о ставках для рекламного блока
Если вы новичок в торгах, прочитайте обзор .
В журнале запросов SDK вы можете увидеть источники объявлений для назначения ставок, которые вызываются в запросе объявления. Коснитесь рекламного блока в журнале запросов SDK, чтобы просмотреть подробную информацию о каждом источнике объявлений на аукционе ставок.
Результаты ставок сортируются таким образом, чтобы элементы, требующие действий, оказались ближе к началу списка:
Вверху — рекламная сеть, выигравшая аукцион.
Далее идут рекламные сети с проблемами. Вы можете выполнить действия по устранению неполадок .
Кроме того, есть рекламные сети, которым не была возвращена реклама или которые не сделали ставок. Это возможный индикатор множества различных проблем с источником объявлений, поскольку ему может не быть назначена ставка из-за его настройки или решения. Вы можете обратиться к руководству по настройке источника объявлений или напрямую обратиться за поддержкой к источнику объявлений .
Наконец, в конце списка располагаются рекламные сети, проигравшие аукцион.
Каскад медиации может разместить источник объявлений, выигравший аукцион, в соответствии с его значением эффективной цены за тысячу показов.
Когда источник объявлений вызывается в каскаде медиации, он может показывать рекламу. Чтобы узнать больше о том, как назначение ставок работает с каскадом медиации, см. пример 2 и пример 3 с источниками объявлений о назначении ставок и каскаде в группе медиации.
Расширенная отладка рекламных блоков
При устранении неполадок с рекламными блоками может быть полезно изучить запрос объявления и ответ, чтобы определить, где что-то не так, или поделиться со службой поддержки Google, чтобы помочь в отладке. Коснитесь значка меню в верхней части каскадной цепочки и выберите «Поделиться запросом и ответом на объявление», чтобы экспортировать полный запрос и ответ на объявление. Это избавит вас от необходимости запускать сетевую трассировку в вашем собственном приложении.
Кроме того, вы можете просмотреть декодированные параметры сторонних ставок, нажав параметр «Сторонние параметры ставок» в том же меню, что и строка запроса. Это дает подробную информацию о том, с какими сторонними параметрами назначения ставок могут возникнуть проблемы, что помогает вам отладить приложение или проверить, успешно ли сеть собирает его сигналы.
| |
Посмотреть доступные адаптеры
Перейдите на вкладку «Адаптеры» , чтобы просмотреть список всех сторонних адаптеров, связанных с источниками объявлений в конфигурациях ставок или посредничества в вашем приложении. Затем разверните карточки, чтобы просмотреть их статусы инициализации и версии SDK. Наряду с поддерживаемыми адаптерами сторонних производителей вы также можете просматривать пользовательские адаптеры событий. Специальные события позволяют издателям использовать рекламные сети, которые AdMob не поддерживает. Пользовательские события отличаются от стандартных адаптеров сторонних производителей в списке адаптеров по уникальным именам классов. Помимо предоставления названия класса и информации о статусе, инспектор объявлений также отображает метки, присвоенные этим пользовательским событиям, в веб-интерфейсе AdMob.
Если адаптер не найден или его не удается инициализировать, дополнительную информацию см. в разделе « Устранение неполадок, обнаруженных с помощью инспектора объявлений» .
| |
Проверьте свои рекламные блоки
Если вы хотите протестировать свой рекламный блок без необходимости перехода к нему в пользовательском интерфейсе приложения, инспектор объявлений поддерживает это непосредственно на экране сведений о рекламном блоке. Кроме того, вы можете тестировать несколько рекламных блоков одновременно, асинхронно загружать и просматривать тестовые запросы объявлений и даже выполнять тестирование одного источника объявлений.
Тестирование рекламы
Тесты объявлений в Инспекторе объявлений, описанные в этом разделе, — отличный инструмент для проверки базового качества рекламы и проверки конфигурации медиации при использовании с тестированием одного источника объявлений.
Когда вы будете готовы протестировать свой рекламный блок, нажмите кнопку «Запросить тестовое объявление» в верхней части экрана инспектора объявлений, чтобы запустить тестирование объявлений в инспекторе объявлений. Результаты тестирования затем появляются в журнале запросов SDK под заголовком Запрошено от инспектора объявлений .
Тестирование одного источника объявлений
В Инспекторе объявлений есть функция, позволяющая ограничить запросы объявлений в вашем приложении, чтобы они показывали объявления только из одного источника объявлений с посредничеством с одним назначением ставок или каскадом. Это позволит вам убедиться, что вы правильно внедрили сторонний адаптер и что источник объявлений работает должным образом.
Чтобы включить эту функцию, переключите переключатель «Тестирование одного источника объявлений» в нижней части экрана. Откроется следующее диалоговое окно выбора источника объявлений:
| |
Прежде чем использовать тестирование одного источника объявлений, необходимо инициализировать Google Mobile Ads SDK .
Затем вы можете выбрать один источник объявлений для тестирования. После выбора источника рекламы появляется следующий экран:
Настройка тестирования одного источника объявлений применяется ко всем будущим запросам объявлений, которые вы сделаете в рамках того же сеанса. Однако это не относится к ранее кэшированным объявлениям в этом сеансе, которые еще не были показаны. При применении проверки одного источника объявлений рекомендуется принудительно перезапустить приложение, чтобы сделать недействительными любые кэшированные объявления, которые могут отображаться вместо получения запроса от выбранного вами источника объявлений.
После перезапуска приложения все места размещения рекламных блоков пытаются показывать рекламу только из выбранной сети. При запуске инспектора объявлений, когда активен тест одного источника объявлений, отображается активный тестовый источник объявлений:
В тестовом режиме с одним источником объявлений все запросы объявлений пытаются заполниться выбранным источником объявлений, независимо от того, настроен ли этот источник объявлений для назначения ставок или посредничества для запрошенного рекламного блока. Если тестируемый источник объявлений не входит в каскад медиации для рекламного блока, вы получите сообщение об ошибке «Нет заполнения».
При тестировании одного источника объявлений вы можете нажать на рекламный блок, чтобы просмотреть журнал запросов к его SDK. Это позволяет узнать, выполнил ли источник объявлений запросы объявлений, сделанные после включения тестирования одного источника объявлений. Если источнику объявления не удалось загрузить объявление, появится сообщение об ошибке с описанием ошибки.
Если вы добавили несколько экземпляров выбранного источника объявлений в каскад медиации, вы увидите каждый экземпляр вызова источника объявлений в каскаде до тех пор, пока объявление не заполнится или каскад не закончится без заполнения.
Остановить тестирование одного источника объявлений
Чтобы остановить тест, выключите переключатель:
Затем на следующем экране перезагрузки появится подтверждающее сообщение:
Мы рекомендуем принудительно перезапустить приложение после остановки теста, чтобы сделать недействительными все кэшированные объявления для проверенного источника объявлений.
Копирование всех результатов отладки
Инспектор объявлений поддерживает копирование строки JSON, содержащей полные результаты отладки инструмента, включая сведения о вашем приложении AdMob, статусы инициализации адаптера и результаты тестирования всех рекламных блоков.
Для этого коснитесь значка приложения семь раз, пока не увидите сообщение JSON инспектора объявлений скопировано в буфер обмена .