---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://ads.yandex.com/helpcenter/en/dev/ios/rewarded.md
- https://ads.yandex.com/helpcenter/pt/dev/ios/rewarded.md
- https://ads.yandex.com/helpcenter/ru/dev/ios/rewarded.md
- https://ads.yandex.com/helpcenter/zh/dev/ios/rewarded.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt
# 激励广告
激励广告是一种受欢迎的全屏广告格式，用户观看广告后会获得奖励。
广告展示采用主动选择机制：例如，用户可以主动触发广告以获取游戏奖励或额外生命值。
强烈的用户动机使这种广告格式成为免费应用中最受欢迎且盈利能力最强的广告格式。
{% cut "外观" %}
{% list tabs %}
- 文字和图片广告
- 视频广告
{% endlist %}
{% endcut %}
本指南将展示如何将激励广告集成到 iOS 应用中。除了代码示例和说明之外，它还包含特定格式的建议和其他资源的链接。
## 前提条件 {#pre}
1. 请按照 [快速入门](https://ads.yandex.com/helpcenter/zh/dev/ios/quick-start.md) 中描述的 SDK 集成步骤进行操作。
2. 提前 [初始化](https://ads.yandex.com/helpcenter/zh/dev/ios/quick-start.md#init) 您的广告 SDK。
3. 确保您运行的是最新的 [Yandex Mobile Ads SDK](https://ads.yandex.com/helpcenter/zh/dev/platforms.md) 版本。如果您使用聚合，请同时确保您运行的是最新版本的 [统一构建](https://ads.yandex.com/helpcenter/zh/dev/platforms.md)。
## 实施 {#implement}
集成激励广告的关键步骤：
* 创建并配置 `RewardedAdLoader` 广告加载器。
* 设置委托并实施所需的 `AdRewardedAdLoaderDelegate` 方法。
* 加载广告。
* 如果需要，请设置广告对象的委托并实施所需的 `AdRewardedAdDelegate` 方法。
* 呈现广告。
* 奖励观看广告的用户。
## 激励广告集成的特点 {#features}
1. 所有调用 Yandex Mobile Ads SDK 方法的操作必须在主线程中完成。
2. 我们强烈建议您不要在 `func rewardedAdLoader(_ adLoader: RewardedAdLoader, didFailToLoadWithError error: AdRequestError)` 方法中收到错误时尝试加载新广告。如果您需要从 `func rewardedAdLoader(_ adLoader: RewardedAdLoader, didFailToLoadWithError error: AdRequestError)` 加载广告，请限制广告加载重试，以避免由于网络连接限制而重复出现失败的广告请求。
3. 我们建议您在与广告交互的屏幕的整个生命周期内保持对广告及其加载器的强引用。
## 加载广告 {#load}
要加载激励广告，请创建 `RewardedAdLoader` 类的实例。
要在广告加载成功或失败时发出通知，请设置 `RewardedAdLoader` 类的委托属性并实施 `RewardedAdLoaderDelegate` 委托。
```swift
final class RewardedViewController: UIViewController {
private lazy var rewardedAdLoader: RewardedAdLoader = {
let loader = RewardedAdLoader()
loader.delegate = self
return loader
}()
}
extension RewardedViewController: RewardedAdLoaderDelegate {
func rewardedAdLoader(_ adLoader: RewardedAdLoader, didLoad rewardedAd: RewardedAd) {
// 加载成功后将调用该方法
}
func rewardedAdLoader(_ adLoader: RewardedAdLoader, didFailToLoadWithError error: AdRequestError) {
// 加载广告时出现任何错误后将调用此方法
}
}
```
要加载广告，您需要来自 Yandex Advertising Network 界面 (adUnitId) 的广告单元 ID。
您可以通过 `AdRequest` 传递用户兴趣、上下文页面数据、位置详细信息或其他信息来扩展广告请求参数。在请求中提供额外的上下文数据可以显著提高您的广告质量。请参阅[广告定位](https://ads.yandex.com/helpcenter/zh/dev/ios/target.md)版块了解更多信息。
以下示例展示了如何从视图控制器加载激励广告。
```swift
final class RewardedViewController: UIViewController {
private lazy var rewardedAdLoader: RewardedAdLoader = {
let loader = RewardedAdLoader()
loader.delegate = self
return loader
}()
func loadAd() {
let configuration = AdRequestConfiguration(adUnitID: "R-M-XXXXX-YY")
rewardedAdLoader.loadAd(with: configuration)
}
}
```
## 广告呈现 {#ad-view}
激励广告是一种激励型广告格式，允许用户通过观看广告来获得奖励。这些奖励可能包括额外生命值或游戏中的晋级机会。具体奖励形式由应用自身决定。
激励广告加载成功后，将调用 `RewardedAdDelegate` 委托的 `func rewardedAdLoader(_ adLoader: RewardedAdLoader, didLoad rewardedAd: RewardedAd)` 方法。使用此方法来显示激励广告。
```swift
final class RewardedViewController: UIViewController {
private var rewardedAd: RewardedAd?
func showAd() {
rewardedAd?.show(from: self)
}
}
extension RewardedViewController: RewardedAdLoaderDelegate {
func rewardedAdLoader(_ adLoader: RewardedAdLoader, didLoad rewardedAd: RewardedAd) {
self.rewardedAd = rewardedAd
self.rewardedAd.delegate = self
showAd()
}
}
```
## 奖励发放 {reward-send}
计算的展示次数会触发 `RewardedAdDelegate` 委托的 `rewardedAd(_ rewardedAd: RewardedAd, didReward reward: Reward)` 方法。使用此方法来奖励应用用户。
```swift
final class RewardedViewController: UIViewController {
private var rewardedAd: RewardedAd?
}
extension RewardedViewController: RewardedAdDelegate {
func rewardedAd(_ rewardedAd: RewardedAd, didReward reward: Reward) {
sendReward(reward)
}
}
```
## 测试激励广告集成 {#test}
### 使用演示广告单元进行广告测试
我们建议使用测试广告来测试您的广告集成和应用本身。
为了保证为每个广告请求返回测试广告，我们创建了一个特殊的演示广告版位 ID。用它来检查您的广告集成。
演示广告单元 ID：`demo-rewarded-yandex`。
{% note warning %}
在商店中发布您的应用程序之前，确保将演示版位 ID 替换为您在 Yandex Advertising Network 界面中获得的真实 ID。
{% endnote %}
您可以在 [用于测试的演示广告单元](https://ads.yandex.com/helpcenter/zh/dev/ios/demo-blocks.md) 版块找到可用的演示广告版位 ID 列表。
### 测试广告集成
您可以使用本机控制台工具测试广告集成。
要查看详细日志，请调用 `YMAMobileAds` 类的 `enableLogging` 方法。
```swift
YMAMobileAds.enableLogging()
```
要查看 SDK 日志，请前往控制台工具并设置 `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) 链接。