Unity激励广告

使用now.gg的Unity 激励广告(Rewarded Ads)模块,您可以在Unity游戏中实现应用内激励广告。

要实现激励广告:

  1. 下载并导入now.gg激励广告Unity模块。
  2. 添加必要的依赖项。
  3. 将now.gg激励广告集成到您工程中。

下载并导入模块

now.gg激励广告Unity模块包含在Unity包文件(nowgg-rewarded-ads.unitypackage)。
将模块添加到您的 Unity 项目:

  1. 下载包,获取最新版本的 now.gg Unity 激励广告模块。
  2. 下载完成后,将该模块导入到 Unity 项目中。方法如下:
    • 点击 Assets > Import Package > Custom Package
    • 选择刚才下载的 nowgg-rewarded-ads.unitypackage
    • 选择所有文件,然后点击Import
  3. 添加所需依赖项
    • 点击 Assets > External Dependency Manager > Android Resolver > Resolve
      此操作会使用 Unity External Dependency Manager 将所有所需依赖项下载并添加到项目的 /Assets/Plugins/Android 目录中。

重要信息

  • 导入所有模块文件后,项目的 Assets 文件夹根目录下会新增一个名为 ‘NowGGSdk‘ 的文件夹。
  • 请勿修改 NowGGSdk 文件夹,因为其中包含了 now.gg 激励广告模块的所有相关资源。

实现now.gg激励广告

以下章节说明了可以从Unity应用或游戏中调用的now.gg激励广告函数的实现方法。

当now.gg激励广告模块导入并添加了必要的依赖项后,您可以将应用或游戏与now.gg激励广告模块集成。

1. 初始化模块

在应用展示广告之前,必须先初始化模块。

首先,创建一个包含now.gg激励广告实现的类,并将其附加到一个可以用来初始化模块的游戏对象上,如下所示:

void Start()
   {
       NowGGAdsManager.Instance.OnInitSuccess += OnInitSuccess;
       NowGGAdsManager.Instance.OnInitFailed += OnInitFailed;
       NowGGAdsManager.Instance.OnNowGGRewardedAdDismissed += OnAdDismissed;
       NowGGAdsManager.Instance.OnNowGGRewardedAdFailedToLoad += OnAdFailedToLoad;
       NowGGAdsManager.Instance.OnNowGGRewardedAdShownToUser += OnAdShownToUser;
       NowGGAdsManager.Instance.OnUserEarnedReward += OnUserEarnedReward;
      
       NowGGAdsManager.Instance.Initialize();
   }

注意:

  • 您应只初始化一次SDK模块,理想情况下是在应用启动时进行。
  • Initialize() 函数是 NowGGAdsManager 类的一部分,用于初始化激励广告。
  • 模块的响应通过回调函数记录,如上面的示例所示。

2. 显示激励广告

一旦模块成功初始化后,您就可以展示应用内的激励广告了。

根据需求,您可以通过调用 NowGGAdsManager.Instance.ShowRewardedAd() 函数在应用中显示激励广告。

now.gg激励广告使用以下回调函数来告知激励广告请求的状态:

  • void OnAdShownToUser(); – 广告已在用户屏幕上显示。
  • void OnAdFailedToLoad(String error); – 广告加载失败。
  • void OnAdDismissed(bool rewardEarned); – 广告被关闭。继续应用的操作。
    • 如果广告被用户过早关闭,rewardEarned 将为False
    • 如果广告完整播放并且用户赚取奖励,rewardEarned 将为True
  • void OnUserEarnedReward(); 用户赚取奖励。

注意:

  • 回调函数不会在主线程上调用,请确保所有UI操作都在主线程上执行。

以下代码段演示了上述回调函数及其实现:

public class RewardsSDKDemo : MonoBehaviour
{
   
// 展示广告    
   public void ShowAd()
   {
       NowGGAdsManager.Instance.ShowRewardedAd();
   }

// 初始化成功
   private void OnInitSuccess()
   {
       Debug.Log("OnInitSuccess");
   }

// 初始化失败 
   private void OnInitFailed(string error)
   {
       Debug.Log("OnInitFailed.. " + error);
   }

// 广告展示在用户屏幕上
   private void OnAdShownToUser()
   {
       Debug.Log("OnAdShownToUser");
   }

// 广告加载失败
   private void OnAdFailedToLoad(string error)
   {
       Debug.Log("OnAdFailedToLoad.." + error);
   }

// 广告被用户关闭;继续应用操作。
   private void OnAdDismissed(bool rewardEarned)
   {
       Debug.Log("OnAdDismissed.." + rewardEarned);
   }

// 用户赚取奖励  
   private void OnUserEarnedReward()
      {
          Debug.Log("OnUserEarnedReward");
      }
}

重要信息

×
文本已复制到剪贴板
copyLinkText
有疑问?请通过以下方式联系我们: dev-support@now.gg