Unity激励广告

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

要实现激励广告：

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

下载并导入模块

now.gg激励广告Unity模块包含在Unity包文件（NowGGUnitySdk.unitypackage）。
将模块添加到您的 Unity 项目：

下载包含最新版本 Unity 用 now.gg 激励广告模块的安装包。
接下来，将该安装包导入到 Unity 项目中。操作步骤如下：
- 点击 Assets > Import Package > Custom Package。
  - 从系统中选择 NowGGUnitySdk.unitypackage。
- 默认情况下，所有模块都会被勾选。取消选择不需要的模块，然后点击 Import，如下图所示：
添加所需依赖项
- 点击 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");
      }
}

重要信息

请继续阅读测试集成章节以测试您的集成。
我们还提供了激励广告的演示工程，您可以在此找到。

开始集成

测试集成