Реклама при открытии приложения (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 перед загрузкой рекламы
YandexAds.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.

Важно

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

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

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

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

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

YandexAds.enableLogging()

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

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

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

Ссылка на github.

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

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

Пример интеграции