在 Unity 应用中添加激励视频广告

使用 Audience Network，您的 Android 和 iOS 应用可以通过展示 Facebook 广告实现创收。激励视频广告是一种全屏体验，用户可选择观看视频广告以换取有价物，例如虚拟货币、应用内物品和独家内容等等。此广告体验是一段短片，且广告的结束画面会显示行动号召。用户完整观看视频后，您将收到一个回调，以向用户发放建议的奖励。

显示奖励式视频广告的步骤

第 1 步：初始化激励视频广告

第 2 步：添加回调事件

第 3 步：加载广告

第 4 步：显示广告

第 1 步：初始化激励视频广告

显示激励视频广告的第一步是在 C# 脚本中创建一个 RewardedVideoAd 对象，并附加到 GameObject。

...
using AudienceNetwork;
...

public class RewardedVideoAdTest : MonoBehaviour
{
    public void LoadRewardedVideo()
    {
        // Create the rewarded video unit with a placement ID (generate your own on the Facebook app settings).
        // Use different ID for each ad placement in your app.
        this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID");

        this.rewardedVideoAd.Register(this.gameObject);

        // Set delegates to get notified on changes or when the user interacts with the ad.
        this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
            Debug.Log("RewardedVideo ad loaded.");
            this.isLoaded = true;
        });
        this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
            Debug.Log("RewardedVideo ad failed to load with error: " + error);
        });
        this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
            Debug.Log("RewardedVideo ad logged impression.");
        });
        this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
            Debug.Log("RewardedVideo ad clicked.");
        });

        this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
            Debug.Log("Rewarded video ad did close.");
            if (this.rewardedVideoAd != null) {
                this.rewardedVideoAd.Dispose();
            }
        });

        // Initiate the request to load the ad.
        this.rewardedVideoAd.LoadAd();
    }
}

RewardedVideoAd 的构造函数有以下参数：

• placementId - 这个激励视频广告单元的 Audience Network 版位编号。

第 2 步：添加回调事件

然后，您可以执行几次回调，以订阅广告的生命周期事件。通过注册事件委派来聆听这些事件，如下列所示：

...
// Set delegates to get notified on changes or when the user interacts with the ad.
this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
    Debug.Log("RewardedVideo ad loaded.");
    this.isLoaded = true;
});
this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
    Debug.Log("RewardedVideo ad failed to load with error: " + error);
});
this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
    Debug.Log("RewardedVideo ad logged impression.");
});
this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
    Debug.Log("RewardedVideo ad clicked.");
});

this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
    Debug.Log("Rewarded video ad did close.");
    if (this.rewardedVideoAd != null) {
        this.rewardedVideoAd.Dispose();
    }
});
...

第 3 步：加载广告

在对 RewardedVideoAd 进行实例化之后，下一步骤就是加载广告。此操作需要通过调用 loadAd 方法来完成。

针对上述示例，以下说明如何对广告加载进行初始化：

...
this.rewardedVideoAd.LoadAd();
...

第 4 步：显示广告

最后，广告加载完成后，您可以调用 Show 方法将激励视频广告呈现在屏幕上。例如，您可以为 ShowRewardedVideo 创建一个函数，并在显示广告时调用该函数：

public void ShowRewardedVideo()
{
    if (this.isLoaded) {
        this.rewardedVideoAd.Show();
        this.isLoaded = false;
    } else {
        Debug.Log("Ad not loaded. Click load to request an ad.");
    }
}

服务器端奖励验证

概览

如果您在服务器端管理自己的用户奖励，Facebook 可提供解决方案，帮助您使用验证技术安全地执行此项操作。我们的服务器将与指定的 https 端点通信，以验证每一次广告展示，并验证是否应发放奖励。

1. Audience Network SDK 要求激励视频广告使用以下参数：
   • placementId：Audience Network 版位编号
   • RewardData - RewardData 对象由代表用户编号的 UserId 以及代表真实游戏奖励的 Currency 组成。
2. 用户观看完视频后，Facebook 服务器会将这些值连同应用密钥和唯一交易编号一并转发到您指定的端点。
3. 收到这些信息后，服务器将验证请求并作出如下回复：
   • 200 response：请求有效，应发放奖励
   • Non 200 response：请求无效，不应发放奖励。
4. 用户观看完视频后，系统将显示结束画面，并触发下列事件之一。
   • RewardedVideoAdDidSucceed — 仅在第 3 步收到 200 响应时触发。
   • RewardedVideoAdDidFail — 在第 3 步收到非 200 响应时触发。

工作流程将如下所示：

实施

初始化激励视频广告对象后，您需要将用户编号和奖励金额传入奖励式广告数据中，然后才能加载广告。这可以通过 RewardData 类来实现。用户编号和奖励金额均为字符串。例如：

public class RewardedVideoAdTest : MonoBehaviour
{
  ...
  private bool isLoaded;
  private RewardedVideoAd rewardedVideoAd;

  public void LoadRewardedVideo()

    //Set the rewarded ad data
    RewardData rewardData = new RewardData();
    rewardData.UserId = "USER_ID";
    rewardData.Currency = "REWARD_ID";

    // Instantiate RewardedVideoAd with reward data
    this.rewardedVideoAd = new RewardedVideoAd("YOUR_PLACEMENT_ID", rewardData);
    this.rewardedVideoAd.Register(this.gameObject);

    // Set delegates to get notified on changes or when the user interacts with the ad.
    this.rewardedVideoAd.RewardedVideoAdDidLoad = (delegate() {
        Debug.Log("RewardedVideo ad loaded.");
        this.isLoaded = true;
    });
    this.rewardedVideoAd.RewardedVideoAdDidFailWithError = (delegate(string error) {
        Debug.Log("RewardedVideo ad failed to load with error: " + error);
    });
    this.rewardedVideoAd.RewardedVideoAdWillLogImpression = (delegate() {
        Debug.Log("RewardedVideo ad logged impression.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClick = (delegate() {
        Debug.Log("RewardedVideo ad clicked.");
    });
    this.rewardedVideoAd.RewardedVideoAdDidClose = (delegate() {
        Debug.Log("Rewarded video ad did close.");
        if (this.rewardedVideoAd != null) {
            this.rewardedVideoAd.Dispose();
        }
    });

    // For S2S validation you need to register the following two callback
    this.rewardedVideoAd.RewardedVideoAdDidSucceed = (delegate() {
        Debug.Log("Rewarded video ad validated by server");
    });
    this.rewardedVideoAd.RewardedVideoAdDidFail = (delegate() {
        Debug.Log("Rewarded video ad not validated, or no response from server");
    });       

    this.rewardedVideoAd.loadAd();
  }
  ...
}

为了通知您的应用程序奖励是否有效，除了 RewardedVideoAd 的其他回调，您还需要实施 RewardedVideoAdDidSucceed 和 RewardedVideoAdDidFail 回调。

加载广告后，您可以使用 Show 方法呈现广告，就像普通的 RewardedVideoAd 一样。