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