Реклама при открытии приложения (App Open Ad)

Реклама при открытии приложения — специальный формат рекламы для монетизации экранов загрузки своих приложений. Такие объявления могут быть закрыты в любое время и предназначены для показа, когда пользователи выводят ваше приложение на передний план (foreground), либо при запуске, либо при возврате в него из фонового режима (background).

Это руководство покажет, как интегрировать рекламу при открытии в iOS-приложение. В дополнение к примерам кода и инструкции оно содержит рекомендации по использованию данного формата рекламы, а также ссылки на дополнительные ресурсы.

Ограничение

Рекламу при открытии можно разместить только в приложении с вертикальной ориентацией. Для горизонтальной ориентации объявления подбираться не будут.

Дополнительно об интеграции рекламы при открытии приложения смотрите в видео:

Внешний вид

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

Пререквизит

  1. Выполните шаги по интеграции sdk, описанные в Быстром старте.
  2. Заранее проинициализируйте рекламный SDK.
  3. Убедитесь, что используете самую актуальную версию Yandex Mobile Ads SDK, а в случае использовании медиации — наиболее свежую версию единой сборки.

Термины

  • Холодный старт — старт приложения, при отсутствии его в оперативной памяти, создание новой сессии приложения.
  • Горячий старт — перевод приложения из фонового режима (background), когда приложение приостановлено в оперативной памяти, в активный режим (foreground).

Имплементация

  1. Инициализируйте SDK на старте работы приложения.
  2. Создайте и сконфигурируйте объект загрузки рекламы AppOpenAdLoader.
  3. Установите делегат методов обратного вызова AppOpenAdLoaderDelegate для уведомления об успешной или неудачной загрузке рекламы.
  4. Загрузите рекламное объявление используя метод loadAd(with: AdRequestConfiguration).
  5. Используйте метод класса AppDelegate applicationDidBecomeActive(_ application: UIApplication) для показа рекламы во время его открытия.
  6. Перед показом объявления установите делегат методов обратного вызова рекламного объявления AppOpenAdDelegate.
  7. Покажите рекламу используя метод show.

Основные шаги

  1. Инициализируйте SDK на старте работы приложения.

    // wait for sdk initialization before loading ads
MobileAds.initializeSDK(completionHandler: completionHandler)

  2. Создайте и сконфигурируйте объект загрузки рекламы AppOpenAdLoader.

    Потребуется идентификатор рекламного места, полученный вами в ПИ (AD_UNIT_ID).

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

     private lazy var appOpenAdLoader: AppOpenAdLoader = {
     let loader = AppOpenAdLoader()
     loader.delegate = self
     return loader
 }()

  3. Установите делегат методов обратного вызова AppOpenAdLoaderDelegate для уведомления об успешной или неудачной загрузке рекламы.

     extension AppOpenAdController: AppOpenAdLoaderDelegate {
     func appOpenAdLoader(_ adLoader: AppOpenAdLoader, didLoad appOpenAd: AppOpenAd) {
         // The ad was loaded successfully. Now you can show loaded ad.
         self.appOpenAd = appOpenAd
         self.appOpenAd?.delegate = self
     }

     func appOpenAdLoader(_ adLoader: AppOpenAdLoader, didFailToLoadWithError error: AdRequestError) {
         // Ad failed to load with AdRequestError.
         // Attempting to load a new ad from the onAdFailedToLoad() method is strongly discouraged.
     }
 }

  4. Загрузите рекламное объявление используя метод loadAd(with: AdRequestConfiguration).

     func loadAd() {
     // Replace demo-appopenad-yandex with actual Ad Unit ID
      let configuration = AdRequestConfiguration(adUnitID: "demo-appopenad-yandex")
      self.appOpenAdLoader.loadAd(with: configuration)
 }

  5. Используйте метод класса AppDelegate для показа рекламы во время его открытия.

    func applicationDidBecomeActive(_ application: UIApplication)

  6. Перед показом объявления установите делегат методов обратного вызова рекламного объявления AppOpenAdDelegate.

     extension AppOpenAdController: AppOpenAdDelegate {
     func appOpenAd(_ appOpenAd: AppOpenAd, didFailToShowWithError error: Error) {
         // Called when an ad failed to show.

         // Load next ad after fail to show with error
         loadAd()
     }

     func appOpenAdDidShow(_ appOpenAd: AppOpenAd) {
         // Called when ad did shown.
     }

     func appOpenAdDidDismiss(_ appOpenAd: AppOpenAd) {
         // Called when ad is dismissed.

         // Load next ad after dismiss
         loadAd()
     }

     func appOpenAdDidClick(_ appOpenAd: AppOpenAd) {
         // Called when a click is recorded for an ad.
     }

     func appOpenAd(_ appOpenAd: AppOpenAd, didTrackImpressionWith impressionData: ImpressionData?) {
         // Called when an impression is recorded for an ad.
     }
 }

  7. Покажите рекламу используя метод show.

    self.appOpenAd?.show(from: self)

Особенности подключения рекламы при открытии приложения

  1. Все вызовы методов Yandex Mobile Ads SDK необходимо выполнять из главного потока.
  2. Загрузка может занимать продолжительное время, поэтому не стоит увеличивать время холодного старта, если реклама не загрузилась.
  3. Заранее предзагружайте объявление для последующего показа при горячем старте.
  4. Не рекомендуется одновременно загружать рекламу App Open Ad и другие форматы рекламы при старте приложения, так как приложение в этот момент может скачивать необходимые для работы данные. Это может перегрузить устройство и интернет-соединение, делая загрузку рекламы дольше.
  5. Если вы получили ошибку в коллбэке appOpenAdLoader(_ adLoader: AppOpenAdLoader, didFailToLoadWithError error: AdRequestError), не пытайтесь загрузить новое объявление снова. Если все же необходимо это сделать, ограничьте число повторных попыток загрузки рекламы. Это поможет избежать постоянных неудачных запросов и проблем с подключением в случае ограничений.

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

Использование демоблоков для тестирования рекламы

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

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

Демонстрационный adUnitId: demo-appopenad-yandex.

Важно

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

Список всех доступных демонстрационных идентификаторов рекламного места доступен в разделе Демоблоки для тестирования.

Проверка корректной интеграции рекламы

Проверить корректность интеграции рекламы можно через нативный инструмент Console.

Чтобы получить возможность просматривать расширенные логи, необходимо вызвать метод enableLogging класса YMAMobileAds.

YMAMobileAds.enableLogging()

Для просмотра логов SDK в инструменте Console установите sybsystem = com.yandex.mobile.ads.sdk. Так же вы можете фильтровать логи по категории и по уровню ошибки.

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

Рекомендации

  1. Не стоит показывать объявление при открытии приложения до экрана загрузки (Splash screen).

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

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

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

  4. Регулируйте частоту показов, основываясь на поведении пользователя приложения. Не стоит показывать рекламу на каждый холодный/горячий старт приложения.

  5. Показывайте рекламу только в том случае, если приложение находится в фоновом режиме в течение определенного промежутка времени (например, 30 секунд, 2 минуты, 15 минут).

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

Дополнительные ресурсы

Предыдущая
Интеграция InStream API
Следующая
Таргетирование рекламы