--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ads.yandex.com/helpcenter/en/dev/android/compose/rewarded.md - https://ads.yandex.com/helpcenter/ru/dev/android/compose/rewarded.md - https://ads.yandex.com/helpcenter/zh/dev/android/compose/rewarded.md - href: ru/dev/android/compose/rewarded.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 # Реклама с вознаграждением Реклама с вознаграждением — популярный полноэкранный формат объявления, за просмотр которого пользователь получает поощрение. Показ рекламы активируется пользователем, например, для получения бонуса или дополнительной жизни в игре. Высокая мотивация пользователя делает такой формат рекламы наиболее популярным и прибыльным в бесплатных приложениях. {% cut "Внешний вид" %} {% list tabs %} - Комбинаторные объявления - Видеореклама {% endlist %} {% endcut %} Это руководство покажет, как интегрировать рекламу с вознаграждением в 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} Основные шаги по интеграции рекламы с вознаграждением: 1. Использовать `rememberRewardedAdLoader()` для создания загрузчика рекламы. 2. Загрузить рекламу через suspend-функцию `loadAd()` с обработкой результата `RewardedAdLoadResult`. 3. Зарегистрировать слушатель методов обратного вызова событий рекламного объявления `RewardedAdEventListener`. 4. Показать объявление `RewardedAd`. 5. Выдать пользователю награду за просмотр рекламы. ## Особенности подключения рекламы с вознаграждением {#features} 1. Все вызовы методов Yandex Mobile Ads SDK выполняйте из главного потока. 2. Если вы получили ошибку в результате `RewardedAdLoadResult.Failure`, не пытайтесь загрузить новое объявление снова. Если это необходимо сделать, ограничьте число повторных попыток загрузки рекламы, чтобы избежать неудачных запросов и проблем с подключением. 3. Удерживайте сильную ссылку на рекламу на протяжении всей жизни экрана, в рамках которого происходит взаимодействие с рекламой. 4. Когда composable покидает дерево, `cancelLoading()` вызывается автоматически. Явно освобождать ресурсы загрузчика не нужно. ## Загрузка рекламы {#load} Для загрузки рекламы с вознаграждением используйте `rememberRewardedAdLoader()`. Загрузка выполняется через suspend-функцию `loadAd()`, которая возвращает `RewardedAdLoadResult`. Для загрузки рекламного объявления потребуется идентификатор рекламного места, полученный в интерфейсе Рекламной сети Яндекса (adUnitId). Расширить параметры запроса за рекламой можно через `AdRequest.Builder()`, передав в запросе данные об интересах пользователя, контекстные данные страницы, локацию или другие дополнительные данные. Дополнительные контекстные данные на запросе могут значительно улучшить качество рекламы. Подробнее читайте в разделе [Таргетирование рекламы](https://ads.yandex.com/helpcenter/ru/dev/android/target.md). ### Пример загрузки рекламы с вознаграждением ```kotlin @Composable fun MyScreen(activity: Activity) { var rewardedAd by remember { mutableStateOf(null) } val loader = rememberRewardedAdLoader() LaunchedEffect(Unit) { val adRequest = AdRequest.Builder("your-ad-unit-id").build() when (val result = loader.loadAd(adRequest)) { is RewardedAdLoadResult.Success -> rewardedAd = result.ad is RewardedAdLoadResult.Failure -> { // Ad failed to load with AdRequestError. // Attempting to load a new ad from here is strongly discouraged. } } } } ``` ## Показ объявления {#ad-view} Rewarded-реклама — стимулирующий формат рекламы, который позволяет пользователю получить вознаграждение за ее просмотр. В качестве вознаграждения может быть дополнительная жизнь или переход на следующий уровень в игре. Формат вознаграждения определяется приложением. Для отслеживания событий жизненного цикла rewarded-рекламы и получения награды, объекту класса `RewardedAd` необходимо установить слушатель методов обратного вызова `RewardedAdEventListener`. Награда передается напрямую в коллбэк `onRewarded` при вызове метода `show()`: ```kotlin @Composable fun MyScreen(activity: Activity) { var rewardedAd by remember { mutableStateOf(null) } val loader = rememberRewardedAdLoader() LaunchedEffect(Unit) { val adRequest = AdRequest.Builder("your-ad-unit-id").build() when (val result = loader.loadAd(adRequest)) { is RewardedAdLoadResult.Success -> rewardedAd = result.ad is RewardedAdLoadResult.Failure -> { // Ad failed to load with AdRequestError. } } } LaunchedEffect(rewardedAd) { rewardedAd?.apply { setAdEventListener(object : RewardedAdEventListener { override fun onAdShown() { // Called when ad is shown. } override fun onAdFailedToShow(adError: AdError) { // Called when an RewardedAd failed to show. // Now you can preload the next rewarded ad. loadRewardedAd() } override fun onAdDismissed() { // Called when ad is dismissed. // Now you can preload the next rewarded ad. loadRewardedAd() } override fun onAdClicked() { // Called when a click is recorded for an ad. } override fun onAdImpression(impressionData: ImpressionData?) { // Called when an impression is recorded for an ad. } override fun onRewarded(reward: Reward) { // Called when the user can be rewarded. } }) show(activity) } } } ``` ## Тестирование интеграции рекламы с вознаграждением {#test} ### Использование демоблоков для тестирования рекламы {#demo-blocks} Для проверки корректной интеграции rewarded-объявлений и тестирования приложения используйте тестовую рекламу. Для гарантированного возврата тестовых объявлений на каждый запрос за рекламой вы можете использовать специальный демонстрационный идентификатор рекламного места. Демонстрационный adUnitId: `demo-rewarded-yandex`. {% note warning %} Убедитесь, что перед выкладыванием приложения в магазин вы заменили демонстрационный идентификатор рекламного места на настоящий, полученный в интерфейсе Рекламной сети Яндекса. {% endnote %} Список всех доступных демонстрационных идентификаторов рекламного места доступен в разделе [Демоблоки для тестирования](https://ads.yandex.com/helpcenter/ru/dev/android/demo-blocks.md). ### Проверка корректной интеграции рекламы {#test-int} Проверить корректность интеграции рекламы с вознаграждением можно через встроенный в 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 rewarded was integrated successfully ``` В случае обнаружения проблем при интеграции рекламы с вознаграждением вы получите подробный отчет о проблемах и рекомендации по их устранению. ## Дополнительные ресурсы {#resources} * Ссылка на [github](https://github.com/yandexmobile/yandex-ads-sdk-android).