---
metadata:
- name: generator
content: Diplodoc Platform v5.55.0
alternate:
- https://ads.yandex.com/helpcenter/en/dev/ios/swiftui/rewarded.md
- https://ads.yandex.com/helpcenter/ru/dev/ios/swiftui/rewarded.md
- https://ads.yandex.com/helpcenter/zh/dev/ios/swiftui/rewarded.md
- href: ru/dev/ios/swiftui/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
[//]: # (Эта страница переводится также на бразильский португальский — pt-BR)
# Реклама с вознаграждением (SwiftUI)
Реклама с вознаграждением — популярный полноэкранный формат объявления, за просмотр которого пользователь получает поощрение.
Показ рекламы активируется пользователем, например, для получения бонуса или дополнительной жизни в игре.
Высокая мотивация пользователя делает такой формат рекламы наиболее популярным и прибыльным в бесплатных приложениях.
{% cut "Внешний вид" %}
{% list tabs %}
- Комбинаторные объявления
- Видеореклама
{% endlist %}
{% endcut %}
Это руководство покажет, как интегрировать рекламу с вознаграждением в iOS-приложение на SwiftUI. В дополнение к примерам кода и инструкции оно содержит рекомендации и ссылки на дополнительные ресурсы.
## Пререквизит {#pre}
1. Выполните шаги по интеграции SDK, описанные в [Быстром старте](https://ads.yandex.com/helpcenter/ru/dev/ios/quick-start.md).
2. Заранее [проинициализируйте](https://ads.yandex.com/helpcenter/ru/dev/ios/quick-start.md#init) рекламный SDK.
3. Убедитесь, что используете [последнюю версию Yandex Mobile Ads SDK](https://ads.yandex.com/helpcenter/ru/dev/platforms.md), а в случае использования медиации — актуальную [версию единой сборки](https://ads.yandex.com/helpcenter/ru/dev/platforms.md).
## Имплементация {#implement}
Основные шаги по интеграции рекламы с вознаграждением в SwiftUI:
1. Добавить модификатор `.rewardedAd(isPresented:request:onEvent:)`.
1. Управлять загрузкой через `Binding` и показом через `Binding`.
1. Обрабатывать события `RewardedAdEvent` в замыкании `onEvent`.
1. Выдать пользователю награду за просмотр рекламы при событии `.didReward`.
## Особенности подключения рекламы с вознаграждением {#features}
1. Если вы получили ошибку в событии `.didFailToLoad`, не пытайтесь загрузить новое объявление снова. Если необходимо повторить загрузку из обработчика ошибки, ограничьте число повторных попыток загрузки рекламы, чтобы избежать неудачных запросов и проблем с подключением.
2. Держите модификатор на `View`, который работает на протяжении сценария показа.
## Загрузка рекламы {#load}
Для загрузки рекламы с вознаграждением задайте ненулевой `AdRequest` в `Binding`, переданный в `.rewardedAd`.
Для уведомления об успешной или неудачной загрузке и остальных этапах используйте `onEvent` с `RewardedAdEvent`.
```swift
import SwiftUI
import YandexMobileAds
struct RewardedView: View {
@State private var adRequest: AdRequest?
@State private var isPresented = false
var body: some View {
VStack {
Button("Загрузить и показать") {
adRequest = AdRequest(adUnitID: "R-M-XXXXX-YY")
}
}
.rewardedAd(isPresented: $isPresented, request: $adRequest) { event in
switch event {
case .didLoad:
isPresented = true
case .didDismiss, .didFailToShow, .didFailToLoad:
adRequest = nil
default:
break
}
}
}
}
```
Для загрузки рекламного объявления потребуется идентификатор рекламного места, полученный вами в интерфейсе Рекламной сети Яндекса (adUnitId).
Расширить параметры запроса за рекламой можно через `AdRequest`. Для этого передайте в запросе данные об интересах пользователя, контекстные данные страницы, локацию или другие дополнительные данные. Контекстные данные могут значительно улучшить качество рекламы. Подробнее читайте в разделе [Таргетирование рекламы](https://ads.yandex.com/helpcenter/ru/dev/ios/target.md).
## Показ объявления {#ad-view}
Rewarded-реклама — стимулирующий формат рекламы, который позволяет пользователю получить вознаграждение за ее просмотр. В качестве вознаграждения может быть дополнительная жизнь или переход на следующий уровень в игре. Формат вознаграждения определяется приложением.
После успешной загрузки приходит событие `.didLoad`. Установите `isPresented = true`, чтобы отобразить рекламу или заранее выставьте флаг показа. Если загрузка не завершена, показ отложится.
```swift
struct RewardedView: View {
@State private var adRequest: AdRequest?
@State private var isPresented = false
var body: some View {
ContentView()
.rewardedAd(isPresented: $isPresented, request: $adRequest) { event in
switch event {
case .didLoad:
isPresented = true
case .didDismiss, .didFailToShow, .didFailToLoad:
adRequest = nil
default:
break
}
}
}
}
```
## Выдача награды {reward-send}
Если показ объявления успешно засчитан, в `onEvent` приходит `.didReward(Reward)`. Используйте его, чтобы выдать награду пользователю приложения. Награду следует выдавать в обработчике `.didReward`, а не полагаться только на `.didDismiss`.
```swift
struct RewardedView: View {
@State private var adRequest: AdRequest?
@State private var isPresented = false
var body: some View {
ContentView()
.rewardedAd(isPresented: $isPresented, request: $adRequest) { event in
switch event {
case .didReward(let reward):
sendReward(reward)
case .didDismiss, .didFailToShow, .didFailToLoad:
adRequest = nil
default:
break
}
}
}
private func sendReward(_ reward: Reward) {
// Выдать награду
}
}
```
## Тестирование интеграции рекламы с вознаграждением {#test}
### Использование демоблоков для тестирования рекламы
Для проверки корректной интеграции рекламы и тестирования вашего приложения используйте тестовую рекламу. Для гарантированного возврата тестовых объявлений на каждый запрос за рекламой вы можете использовать специальный демонстрационный идентификатор рекламного места.
Демонстрационный adUnitId: `demo-rewarded-yandex`.
{% note warning %}
Убедитесь, что перед выкладыванием приложения в магазин вы заменили демонстрационный идентификатор рекламного места на настоящий, полученный в интерфейсе Рекламной сети Яндекса.
{% endnote %}
Список всех доступных демонстрационных идентификаторов рекламного места доступен в разделе [Демоблоки для тестирования](https://ads.yandex.com/helpcenter/ru/dev/ios/demo-blocks.md).
### Проверка корректной интеграции рекламы
Проверить корректность интеграции рекламы можно через нативный инструмент Console.
Чтобы получить возможность просматривать расширенные логи, необходимо вызвать метод `enableLogging` класса `YandexAds`.
```swift
YandexAds.enableLogging()
```
Для просмотра логов SDK в инструменте Console установите `Subsystem = com.mobile.ads.ads.sdk`. Вы можете фильтровать логи по категории и уровню ошибки.
В случае обнаружения проблем при интеграции рекламы вы увидите подробный отчет о проблемах и рекомендации по их устранению.
## Дополнительные ресурсы {#resources}
*
Ссылка на [github](https://github.com/yandexmobile/yandex-ads-sdk-ios/blob/master/Examples/YandexMobileAdsExample/YandexMobileAdsExample/Yandex/Rewarded/RewardedAdViewController.swift).