开屏广告

开屏广告是一种特殊的广告形式，通过应用程序的初始屏幕盈利。用户可随时关闭这些广告，其设计是用户在前台开启应用程序时展示广告，而无论是在启动时还是从后台返回时。

本指南将展示如何将开屏广告集成到 Unity 应用中。除了代码示例和说明之外，它还包含特定格式的建议和其他资源的链接。

限制

开屏广告只能投放在垂直方向的应用程序中。对于水平方向，不会选择这种广告。

布局

开屏广告包含 登录应用程序 按钮，以便用户知道他们正在使用您的应用并可以关闭广告。以下是广告的示例：

前提条件

按照快速入门中的流程集成 Yandex Mobile Ads Unity 插件。
确保您运行的是最新的 Yandex Mobile Ads Unity 插件版本。如果您使用聚合，请同时确保您运行的是最新版本的统一构建。

术语和定义

冷启动 是指启动一个不在 RAM 中的应用，创建一个新的应用会话。
热启动 是指当应用在 RAM 中暂停时，将应用从后台模式切换到前台模式。

实施

创建 AppOpenAdLoader 广告加载器并注册广告加载事件的监听器。
在 AdRequestConfiguration 中设置广告加载参数。
使用 AppOpenAdLoader.LoadAd(AdRequestConfiguration) 方法加载广告。
注册用户与您的广告互动的事件的监听器。
使用 AppStateObserver 处理应用状态更改并显示开屏广告。
通过调用 AppOpenAd.Show() 方法展示广告。
释放资源。

主要步骤

创建 AppOpenAdLoader 广告加载器并注册广告加载事件的监听器。

using UnityEngine;
using YandexMobileAds;
using YandexMobileAds.Base;

public class YandexMobileAdsAppOpenAdDemoScript : MonoBehaviour
{
    private AppOpenAdLoader appOpenAdLoader;
    private AppOpenAd appOpenAd;

    private void SetupLoader()
    {
        appOpenAdLoader = new AppOpenAdLoader();
        appOpenAdLoader.OnAdLoaded += HandleAdLoaded;
        appOpenAdLoader.OnAdFailedToLoad += HandleAdFailedToLoad;
        // ...
    }

    public void HandleAdLoaded(object sender, AppOpenAdLoadedEventArgs args)
    {
        // 广告加载成功。现在您可以处理它了。
        appOpenAd = args.AppOpenAd;
    }

    public void HandleAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
    {
        // 广告 {args.AdUnitId} 加载失败，原因是 {args.Message}
        // 强烈建议不要尝试从 OnAdFailedToLoad 事件加载新广告。
    }
}

在 AdRequestConfiguration 中设置广告加载参数。
```
string adUnitId = "demo-appopenad-yandex"; // 替换为 "R-M-XXXXXX-Y"
AdRequestConfiguration adRequestConfiguration = new AdRequestConfiguration.Builder(adUnitId).Build();
```
AdUnitId：在合作伙伴界面中发布的唯一标识符，格式为：RM-XXXXXX-Y。

提示

出于测试目的，您可以使用演示广告单元 ID："demo-appopenad-yandex"。在发布广告之前，请确保将演示单元 ID 替换为真实的广告单元 ID。

您可以通过 AdRequestConfiguration.Builder 传递用户兴趣、上下文应用数据、位置详细信息或其他数据来扩展广告请求参数。在请求中提供额外的上下文数据可以显著提高您的广告质量。
使用 LoadAd 方法加载广告，并将 AdRequestConfiguration 作为参数传递。
```
appOpenAdLoader.LoadAd(adRequestConfiguration);
```

注册用户与您的广告互动的事件的监听器。

using System;

// ...
appOpenAd.OnAdClicked += HandleAdClicked;
appOpenAd.OnAdShown += HandleAdShown;
appOpenAd.OnAdFailedToShow += HandleAdFailedToShow;
appOpenAd.OnAdDismissed += HandleAdDismissed;
appOpenAd.OnAdImpression += HandleImpression;
// ...

public void HandleAdClicked(object sender, EventArgs args)
{
    // 记录广告点击时调用。
}

public void HandleAdShown(object sender, EventArgs args)
{
    // 广告展示时调用。
}

public void HandleAdFailedToShow(object sender, AdFailureEventArgs args)
{
    // 广告展示失败时调用。
}

public void HandleAdDismissed(object sender, EventArgs args)
{
    // 广告关闭时调用。
}

public void HandleImpression(object sender, ImpressionData impressionData)
{
    // 记录广告展示次数时调用。
}

使用 AppStateObserver 处理应用状态更改并显示开屏广告。

using YandexMobileAds;

public class YandexMobileAdsAppOpenAdDemoScript : MonoBehaviour
{
     public void Awake()
     {
         // 使用 AppStateObserver 监听应用打开/关闭事件。
         AppStateObserver.OnAppStateChanged += HandleAppStateChanged;
     }

     public void OnDestroy()
     {
         // 取消订阅事件以避免内存泄漏。
         AppStateObserver.OnAppStateChanged -= HandleAppStateChanged;
     }
}

通过调用 AppOpenAd.Show() 方法展示广告。

private void HandleAppStateChanged(object sender, AppStateChangedEventArgs args)
{
     if (!args.IsInBackground)
     {
         ShowAppOpenAd();
     }
}

private void ShowAppOpenAd()
{
     if (appOpenAd != null)
     {
         appOpenAd.Show();
     }
}

对显示的广告调用 Destroy()，并清除当前场景中不再使用的链接。

这可以释放资源并防止内存泄漏。

public void DestroyAppOpenAd()
{
     if (appOpenAd != null)
     {
         appOpenAd.Destroy();
         appOpenAd = null;
     }
}

完整代码示例

using System;
using UnityEngine;
using UnityEngine.UI;
using YandexMobileAds;
using YandexMobileAds.Base;

public class YandexMobileAdsAppOpenAdDemoScript : MonoBehaviour
{
    private AppOpenAdLoader appOpenAdLoader;
    private AppOpenAd appOpenAd;
    private var isColdStartAdShown = false;

    private void Awake()
    {
        DontDestroyOnLoad(gameObject);
        SetupLoader();
        AppStateObserver.OnAppStateChanged += HandleAppStateChanged;
        RequestAppOpenAd();
    }

    private void OnDestroy()
    {
        AppStateObserver.OnAppStateChanged -= HandleAppStateChanged;
    }

    private void SetupLoader()
    {
      appOpenAdLoader = new AppOpenAdLoader();
      appOpenAdLoader.OnAdLoaded += HandleAdLoaded;
      appOpenAdLoader.OnAdFailedToLoad += HandleAdFailedToLoad;
    }

    private void HandleAppStateChanged(object sender, AppStateChangedEventArgs args)
    {
        if (!args.IsInBackground)
        {
            ShowAppOpenAd();
        }
    }

    private void ShowAppOpenAd()
    {
      if (appOpenAd != null)
      {
          appOpenAd.Show();
      }
    }

    private void RequestAppOpenAd()
    {
        string adUnitId = "demo-appopenad-yandex"; // 替换为 "R-M-XXXXXX-Y"
        AdRequestConfiguration adRequestConfiguration = new AdRequestConfiguration.Builder(adUnitId).Build();
        appOpenAdLoader.LoadAd(adRequestConfiguration);
    }

    public void HandleAdLoaded(object sender, AppOpenAdLoadedEventArgs args)
    {
        // 广告加载成功。现在您可以处理它了。
        appOpenAd = args.AppOpenAd;

        // 为广告操作添加事件处理程序
        appOpenAd.OnAdClicked += HandleAdClicked;
        appOpenAd.OnAdShown += HandleAdShown;
        appOpenAd.OnAdFailedToShow += HandleAdFailedToShow;
        appOpenAd.OnAdDismissed += HandleAdDismissed;
        appOpenAd.OnAdImpression += HandleImpression;

        if (!isColdStartAdShown) {
            ShowAppOpenAd();
            isColdStartAdShown = true;
        }
    }

    public void HandleAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
    {
        // 广告 {args.AdUnitId} 加载失败，原因是 {args.Message}
        // 强烈建议不要尝试从 OnAdFailedToLoad 事件加载新广告。
    }

    public void HandleAdDismissed(object sender, EventArgs args)
    {
        // 广告关闭时调用。

        // 广告关闭后清除资源。
        DestroyAppOpenAd();

        // 现在您可以预加载下一个广告。
        RequestAppOpenAd();
    }

    public void HandleAdFailedToShow(object sender, AdFailureEventArgs args)
    {
        // 广告展示失败时调用。

        // 清除资源。
        DestroyAppOpenAd();

        // 现在您可以预加载下一个广告。
        RequestAppOpenAd();
    }

    public void HandleAdClicked(object sender, EventArgs args)
    {
        // 记录广告点击时调用。
    }

    public void HandleAdShown(object sender, EventArgs args)
    {
        // 广告展示时调用。
    }

    public void HandleImpression(object sender, ImpressionData impressionData)
    {
        // 记录广告展示次数时调用。
    }

    public void DestroyAppOpenAd()
    {
        if (appOpenAd != null)
        {
            appOpenAd.Destroy();
            appOpenAd = null;
        }
    }
}

开屏广告集成的特点

加载可能需要一段时间，因此如果广告尚未加载，请勿增加冷启动时间。
预加载广告以便后续在热启动期间显示。
我们不建议您在应用启动期间同时加载开屏广告和其他广告格式，因为此时应用可能正在下载运营数据。这可能会使设备和互联网连接超载，从而导致广告加载时间变长。
如果您在 onAdFailedToLoad 事件中收到错误，请不要尝试再次加载新广告。如果必须这样做，请限制广告重新加载尝试的次数。这将有助于避免出现限制时持续出现不成功的请求和连接问题。

在发布时测试广告集成

Android

iOS

使用演示广告单元进行广告测试

我们建议使用测试广告来测试开屏广告集成和应用本身。

为了保证为每个广告请求返回测试广告，我们创建了一个特殊的演示广告版位 ID。用它来检查您的广告集成。

演示广告单元 ID：demo-appopenad-yandex。

重要

在商店中发布您的应用之前，请确保将演示广告版位 ID 替换为从 Partner Interface 获取的真实广告版位 ID。

您可以在用于测试的演示广告单元版块找到可用的演示广告版位 ID 列表。

测试广告集成

您可以使用 SDK 的内置分析器检查开屏广告集成。

该工具可确保您的开屏广告正确集成，并向日志输出详细报告。要查看报告，请在用于 Android 应用调试的 Logcat 工具中搜索“YandexAds”关键字。

adb logcat -v brief '*:S YandexAds'

如果集成成功，您将看到以下消息：

adb logcat -v brief '*:S YandexAds'
mobileads$ adb logcat -v brief '*:S YandexAds'
I/YandexAds(13719): [Integration] Ad type App Open Ad was integrated successfully

如果您在集成广告时遇到问题，您将获得有关问题的详细报告以及如何解决这些问题的建议。

使用演示广告单元进行广告测试

我们建议使用测试广告来测试开屏广告集成和应用本身。

为了保证为每个广告请求返回测试广告，我们创建了一个特殊的演示广告版位 ID。用它来检查您的广告集成。

演示广告单元 ID：demo-appopenad-yandex。

重要

在商店中发布您的应用之前，请确保将演示广告版位 ID 替换为从 Partner Interface 获取的真实广告版位 ID。

您可以在用于测试的演示广告单元版块找到可用的演示广告版位 ID 列表。

测试广告集成

您可以使用本机控制台工具测试广告集成。

要查看详细日志，请调用 YMAMobileAds 类的 enableLogging 方法。

YMAMobileAds.enableLogging()

要查看 SDK 日志，请前往控制台工具并设置 sybsystem = com.yandex.mobile.ads.sdk。您还可以按类别和错误级别过滤日志。

如果您在集成广告时遇到问题，您将获得有关问题的详细报告以及如何解决这些问题的建议。

建议

不要在启动屏幕之前呈现开屏广告。

通过显示启动屏幕，您可以增强用户的应用体验，使其更加流畅，令用户愉悦。这将避免用户感到惊讶或困惑，并确保他们打开了正确的应用。在同一屏幕上，您可以提醒用户即将展示的广告。使用加载指示器或简单的文本信息告知用户他们将在广告结束后继续查看应用内容。
如果请求和呈现广告之间存在延迟，用户可能会短暂打开您的应用，然后意外地看到与内容无关的广告。这会对用户体验产生负面影响，因此需要避免。一种解决方案是在显示主应用内容之前使用启动屏幕，并从该屏幕开始广告呈现。如果应用在启动屏幕后打开一些内容，则最好不要呈现广告。
等到新用户打开应用并使用几次后，再呈现开屏广告。仅向应用中满足特定条件的用户呈现广告（例如，通过了特定级别、打开了特定次数的应用或未参与奖励优惠）。不要在用户安装应用后立即呈现广告。
根据应用用户行为调节广告呈现频率。不要在每次冷/热应用启动时呈现广告。
仅当应用在后台运行一段时间（例如 30 秒、2 分钟、15 分钟）时才呈现广告。
确保运行了彻底的测试，因为每款应用都是独特的，并且需要特殊的方法来最大限度地提高收入，而不降低用户留存率或减少花费在应用上的时间。用户行为和参与度可能会随着时间的推移而发生变化，因此我们建议定期测试您用于开屏广告的策略。

其他资源

GitHub 链接。

这篇文章是否有用？

激励广告

GDPR