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

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

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

Внимание

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

Внешний вид

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

Пререквизит

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

Термины

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

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

Инициализируйте SDK на старте работы приложения.
На корневом View (например, внутри WindowGroup) добавьте модификатор .appOpenAd(request:onEvent:).
Управляйте загрузкой через Binding<AdRequest?>: ненулевое значение запускает загрузку.
После успешной загрузки объявление показывается автоматически при переходе приложения в активное состояние (foreground), пока request не сброшен.
Обрабатывайте события жизненного цикла в onEvent (AppOpenAdEvent).
После закрытия объявления, ошибки показа или ошибки загрузки request сбрасывается в nil — задайте новый AdRequest, когда нужна следующая загрузка (часто в обработчике смены фазы сцены).

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

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

// дождитесь инициализации SDK перед загрузкой рекламы
MobileAds.initializeSDK(completionHandler: completionHandler)

Подключите модификатор к корневому представлению и храните состояние запроса.

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

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

Пример для iOS 14+ с ScenePhase (перезагрузка после сброса request в nil):
```
import SwiftUI
import YandexMobileAds

@main
struct MyApp: App {
    @State private var adRequest: AdRequest?
    @Environment(\.scenePhase) private var scenePhase

    var body: some Scene {
        WindowGroup {
            ContentView()
                .appOpenAd(request: $adRequest) { event in
                    if case .didFailToLoad = event {
                        // при необходимости — отложенный повтор, см. рекомендации ниже
                    }
                }
        }
        .onChange(of: scenePhase) {
            if scenePhase == .active, adRequest == nil {
                adRequest = AdRequest(adUnitID: "demo-appopenad-yandex")
            }
        }
    }
}
```
На iOS 13 вместо scenePhase используйте уведомление UIApplication.didBecomeActiveNotification или эквивалентную логику жизненного цикла, чтобы выставлять новый AdRequest после nil.

События загрузки и показа приходят в onEvent:

.appOpenAd(request: $adRequest) { event in
    switch event {
    case .didLoad:
        // Объявление готово; показ произойдёт при следующем foreground
        break
    case .didShow:
        break
    case .didDismiss:
        // request уже сброшен модификатором
        break
    case .didFailToShow:
        break
    case .didFailToLoad:
        // request сброшен; не рекомендуется немедленно перезагружать в цикле
        break
    case .didClick:
        break
    case .didTrackImpression(_):
        break
    }
}

Примечание

Если реклама уже показана, после вызова метода show(from:) в AppOpenAdDelegate.appOpenAd(_:didFailToShowError:) вернется ошибка показа.

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

Загрузка может занимать продолжительное время, поэтому не стоит увеличивать время холодного старта, если реклама не загрузилась.
Заранее предзагружайте объявление для последующего показа при горячем старте. Пока в binding передан nil, загрузка не выполняется — задайте AdRequest, когда нужна фоновая подготовка объявления к показу.
Не рекомендуется одновременно загружать рекламу App Open Ad и другие форматы рекламы при старте приложения, так как приложение в этот момент может скачивать необходимые для работы данные. Это может перегрузить устройство и интернет-соединение, делая загрузку рекламы дольше.
Если вы получили ошибку в событии .didFailToLoad, не пытайтесь сразу в цикле загружать новое объявление. Если все же необходимо это сделать, ограничьте число повторных попыток загрузки рекламы. Это поможет избежать постоянных неудачных запросов и проблем с подключением в случае ограничений.

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

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

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

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

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

Важно

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

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

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

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

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

YMAMobileAds.enableLogging()

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

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

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

Ссылка на github.

Была ли статья полезна?

Реклама с вознаграждением