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

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

С помощью инспектора объявлений вы можете:

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

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

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

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

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

Запустить инспектор объявлений

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

  1. Используйте кнопку запуска из меню отладки.
  2. Используйте жест, который вы выбрали в настройках инспектора объявлений.
  3. Программно с использованием предоставленного API .

Запуск через меню отладки

Для запуска инспектора объявлений через меню отладки в вашем приложении не требуется никаких изменений; просто найдите объявление, показываемое в вашей сети Менеджера рекламы, коснитесь и удерживайте его двумя пальцами, чтобы открыть меню отладки. Затем выберите «Открыть инспектор объявлений» .

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

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

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

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

Быстрый 

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Цель-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

Убедитесь, что контроллер представления, переданный в этот API, уже полностью виден на экране ( был вызван viewDidAppear: ). Если переданный контроллер представления находится в процессе отображения, например, когда API вызывается в функции viewDidLoad контроллера представления, представление инспектора рекламы завершается с ошибкой.

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

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

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

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

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

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

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

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

Если вы новичок в назначении ставок, прочитайте введение в Open Bidding .

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

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

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

  • Далее идут рекламные сети с проблемами. Инструкции по устранению неполадок можно найти в конце раздела «Часто задаваемые вопросы о ставках».

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

  • Наконец, в конце списка располагаются рекламные сети, проигравшие аукцион.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

С помощью инспектора объявлений вы можете:

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

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

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

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

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

Запустить инспектор объявлений

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

  1. Используйте кнопку запуска из меню отладки.
  2. Используйте жест, который вы выбрали в настройках инспектора объявлений.
  3. Программно с использованием предоставленного API .

Запуск через меню отладки

Для запуска инспектора объявлений через меню отладки в вашем приложении не требуется никаких изменений; просто найдите объявление, показываемое в вашей сети Менеджера рекламы, коснитесь его и удерживайте двумя пальцами, чтобы открыть меню отладки. Затем выберите «Открыть инспектор объявлений» .

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

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

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

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

Быстрый 

GADMobileAds.sharedInstance().presentAdInspector(from: viewController) { error in
  // Error will be non-nil if there was an issue and the inspector was not displayed.
}

Цель-C

[GADMobileAds.sharedInstance presentAdInspectorFromViewController:viewController
  completionHandler:^(NSError *error) {
    // Error will be non-nil if there was an issue and the inspector was not displayed.
}];

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

Убедитесь, что контроллер представления, переданный в этот API, уже полностью виден на экране ( был вызван viewDidAppear: ). Если переданный контроллер представления находится в процессе отображения, например, когда API вызывается в функции viewDidLoad контроллера представления, представление инспектора рекламы завершается с ошибкой.

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

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

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

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

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

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

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

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

Если вы новичок в назначении ставок, прочитайте введение в Open Bidding .

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

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

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

  • Далее идут рекламные сети с проблемами. Инструкции по устранению неполадок можно найти в конце раздела «Часто задаваемые вопросы о ставках».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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