--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/android/compose/adaptive-sticky-banner.md - https://ads.yandex.com/helpcenter/ru/dev/android/compose/adaptive-sticky-banner.md - https://ads.yandex.com/helpcenter/zh/dev/android/compose/adaptive-sticky-banner.md - href: ru/dev/android/compose/adaptive-sticky-banner.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/ru/llms.txt # Адаптивный sticky-баннер Адаптивный sticky-баннер — небольшое, автоматически обновляемое рекламное объявление. Оно располагается в нижней или верхней части экрана приложения. Баннер не перекрывает основной контент и часто используется в приложениях-играх. Адаптивный sticky-баннер обеспечивает максимальную эффективность за счет оптимизации размера рекламы для каждого устройства. Данный тип рекламы позволяет разработчикам указывать максимально допустимую ширину объявления, при этом оптимальный размер рекламы определяется автоматически. {% cut "Внешний вид" %} {% endcut %} Это руководство покажет, как интегрировать адаптивный sticky-баннер в Android‐приложение с помощью расширения Jetpack Compose. В дополнение к примерам кода и инструкции оно содержит рекомендации и ссылки на дополнительные ресурсы. ## Пререквизит {#pre} 1. Выполните шаги по интеграции SDK, описанные в [Быстром старте](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md). 2. Заранее [проинициализируйте](https://ads.yandex.com/helpcenter/ru/dev/android/quick-start.md#init) рекламный SDK. 3. Убедитесь, что используете [последнюю версию Yandex Mobile Ads SDK](https://ads.yandex.com/helpcenter/ru/dev/android/changelog-android.md), а в случае использования медиации — наиболее свежую [версию единой сборки](https://ads.yandex.com/helpcenter/ru/dev/android/changelog-android.md). Для использования Compose-расширения добавьте зависимость в `build.gradle.kts`: ```kotlin dependencies { implementation("com.yandex.android:mobileads:8.2.0") implementation("com.yandex.android:mobileads-compose:8.2.0") // Compose BOM (at least 2024.01.00) implementation(platform("androidx.compose:compose-bom:2025.03.00")) } ``` ## Имплементация {#implement} Основные шаги по интеграции адаптивного sticky-баннера: 1. Использовать composable `Banner` с размером `BannerSize.Sticky`. 2. При необходимости передать `BannerEvents` для отслеживания событий рекламы. ## Особенности подключения адаптивного sticky-баннера {#features} 1. Все вызовы методов Yandex Mobile Ads SDK выполняйте из главного потока. 2. Если вы получили ошибку в коллбэке `onAdFailedToLoad()`, не пытайтесь загрузить новое объявление снова. Если это необходимо сделать, ограничьте число повторных попыток загрузки рекламы, чтобы избежать неудачных запросов и проблем с подключением. 3. Адаптивные sticky-баннеры лучше всего работают при использовании всей доступной ширины. В большинстве случаев это будет полная ширина экрана используемого устройства. Учитывайте применимые в приложении отступы (padding) и безопасные зоны (safe area) дисплея. 4. Размер рекламы задается через `BannerSize.Sticky(width)`, где ширина передается как `Dp` (например, `320.dp`), а высота рассчитывается автоматически. Context для расчета разрешается внутри composable автоматически. 5. Если у вас включена медиация, прежде чем рассчитывать размеры sticky-баннера, дождитесь завершения инициализации. До окончания инициализации доступен только предварительный размер, который может измениться после получения актуальных настроек. 6. Размер sticky-баннера остается постоянным для одного и того же устройства. Протестировав макет приложения на конкретном устройстве, вы можете быть уверены, что размер объявления не изменится. 7. Высота адаптивного sticky-баннера не менее 50 dp, но не превышает 15% высоты экрана. 8. Состояние баннера создается через `rememberBannerAdState()`, загрузка выполняется явным вызовом `loadAd()`. Если `adSize` меняется — `BannerAdView` пересоздается автоматически. ## Загрузка и отображение рекламы {#load} Для отображения sticky-баннера создайте состояние через `rememberBannerAdState()` с размером `BannerSize.Sticky`, затем передайте его в composable `Banner`. Загрузку запускайте явным вызовом `loadAd()`. Для загрузки рекламы потребуется идентификатор рекламного места, полученный в интерфейсе Рекламной сети Яндекса. Расширить параметры запроса за рекламой можно через `AdRequest.Builder()`. Для этого передайте в запросе данные об интересах пользователя, контекстные данные страницы, локацию или другие дополнительные данные. Контекстные данные могут значительно улучшить качество рекламы. Подробнее читайте в разделе [Таргетирование рекламы](https://ads.yandex.com/helpcenter/ru/dev/android/target.md). ### Пример отображения адаптивного sticky-баннера После успешной загрузки баннер отобразится автоматически: ```kotlin @Composable fun MyScreen() { val bannerState = rememberBannerAdState( adSize = BannerSize.Sticky(width = 320.dp), ) LaunchedEffect(Unit) { bannerState.loadAd(AdRequest.Builder("your-ad-unit-id").build()) } Banner( state = bannerState, modifier = Modifier.fillMaxWidth(), ) } ``` Для отслеживания событий рекламы передайте `BannerEvents` при создании состояния: ```kotlin @Composable fun MyScreen() { val bannerState = rememberBannerAdState( adSize = BannerSize.Sticky(width = 320.dp), events = BannerEvents( onAdLoaded = { Log.d("YandexAds", "Баннер загружен") }, onAdFailedToLoad = { error -> Log.e("YandexAds", error.description) }, onAdClicked = { Log.d("YandexAds", "Клик по баннеру") }, onImpression = { data -> Log.d("YandexAds", "Показ: ${data?.rawData}") }, ), ) LaunchedEffect(Unit) { bannerState.loadAd(AdRequest.Builder("your-ad-unit-id").build()) } Banner( state = bannerState, modifier = Modifier.fillMaxWidth(), ) } ``` Если вы размещаете рекламу через систему Adfox, после загрузки баннера данные `campaignId`, `bannerId` и `placeId` доступны из объектов `BannerAdView` через свойство `adAttributes` типа `AdAttributes`. ## Тестирование интеграции адаптивного sticky-баннера {#test} ### Использование демоблоков для тестирования рекламы {#demo-blocks} Для проверки корректной интеграции адаптивного sticky-баннера и тестирования вашего приложения используйте тестовую рекламу. Для гарантированного возврата тестовых объявлений на каждый запрос за рекламой вы можете использовать специальный демонстрационный идентификатор рекламного места. Демонстрационный adUnitId: `demo-banner-yandex`. {% note warning %} Убедитесь, что перед выкладыванием приложения в магазин вы заменили демонстрационный идентификатор рекламного места на настоящий, полученный в интерфейсе Рекламной сети Яндекса. {% endnote %} Список всех доступных демонстрационных идентификаторов рекламного места доступен в разделе [Демоблоки для тестирования](https://ads.yandex.com/helpcenter/ru/dev/android/demo-blocks.md). ### Проверка корректной интеграции рекламы {#test-int} Проверить корректность интеграции адаптивного sticky-баннера можно через встроенный в SDK анализатор. Подробный отчет о проверке выведется в лог. Для просмотра отчета, выполните поиск по ключевому слову YandexAds в инструменте отладки Android-приложений [Logcat](https://developer.android.com/studio/command-line/logcat). ```bash adb logcat -v brief '*:S YandexAds' ``` В случае успешной интеграции вы увидите следующее сообщение: ```bash adb logcat -v brief '*:S YandexAds' mobileads$ adb logcat -v brief '*:S YandexAds' I/YandexAds(13719): [Integration] Ad type banner was integrated successfully ``` В случае обнаружения проблем при интеграции баннерной рекламы вы получите подробный отчет о проблемах и рекомендации по их устранению. ## Дополнительные ресурсы {#resources} * Ссылка на [github](https://github.com/yandexmobile/yandex-ads-sdk-android).